| name | pluto-pair |
| description | Pair Codex with Pluto.jl notebooks using MCP tools. Use for discovering visible Pluto servers, attaching to running notebooks, opening notebooks headlessly, inspecting @bind controls, setting bond values, reading compact state, or exporting HTML. |
Pluto Pair
Use the pluto-pair MCP server when a task involves Pluto.jl notebook state or controls.
If the user has a Pluto browser window open, prefer live attach first:
pluto_discover_servers to check local Pluto servers, especially port 1234.pluto_attach_session to attach to a notebook already running in that visible server.pluto_open_visible to open a notebook in the visible server and attach to it.
Live attached sessions update the same notebook the user sees in their browser.
Use headless tools for isolated checks, CI-like validation, exports, or untrusted/static previews:
pluto_list_notebooks to discover notebook files.pluto_open_notebook to open and execute a trusted notebook. Execution is the default; pass execution_allowed=false only for untrusted preview.pluto_list_bonds to inspect @bind variables.pluto_set_bonds to set bound values and trigger Pluto reactivity.pluto_read_state to summarize code, outputs, errors, logs, and bonds.pluto_export_html to write a rendered HTML export.pluto_close_notebook when finished. On live attached sessions, this only detaches and does not shut down the user's Pluto notebook.
Use browser automation only for visual smoke checks or screenshots.
