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.