mcp/ extension — connect to Model Context Protocol servers and expose their
tools to the agent, with each live connection registered as a session
RESOURCE (footer count, F4 dialog, resource_stop).
DROPPABLE classpath plug-in. Gated behind the user-owned :mcp/enabled
toggle (ON by default — connects automatically when MCP servers are
configured; can still be turned off to short-circuit every verb).
Servers are declared natively in ~/.vis/config.edn:
{:mcp {:servers {"filesystem" {:transport :stdio :command "npx" :args ["-y" "@modelcontextprotocol/server-filesystem" "/path"]} "remote" {:transport :http :url "https://..." :headers {"Authorization" "Bearer ..."}}}}}
Five model-facing verbs under alias mcp (flat sandbox renders alias_name):
mcp__servers() — configured servers + status + tool counts
mcp__tools(server) — a server's tools (auto-connects)
mcp__call(server, tool, args) — call a tool (auto-connects)
mcp__connect(server) / mcp__disconnect(server) — manage the connection
Live connections + tool counts also ride in ctx under env.mcp.
`mcp/` extension — connect to Model Context Protocol servers and expose their
tools to the agent, with each live connection registered as a session
RESOURCE (footer count, F4 dialog, `resource_stop`).
DROPPABLE classpath plug-in. Gated behind the user-owned `:mcp/enabled`
toggle (ON by default — connects automatically when MCP servers are
configured; can still be turned off to short-circuit every verb).
Servers are declared natively in `~/.vis/config.edn`:
{:mcp {:servers {"filesystem" {:transport :stdio :command "npx"
:args ["-y" "@modelcontextprotocol/server-filesystem" "/path"]}
"remote" {:transport :http :url "https://..."
:headers {"Authorization" "Bearer ..."}}}}}
Five model-facing verbs under alias `mcp` (flat sandbox renders `alias_name`):
mcp__servers() — configured servers + status + tool counts
mcp__tools(server) — a server's tools (auto-connects)
mcp__call(server, tool, args) — call a tool (auto-connects)
mcp__connect(server) / mcp__disconnect(server) — manage the connection
Live connections + tool counts also ride in ctx under `env.mcp`.(mcp-call server tool)(mcp-call server tool args)Call a tool on an MCP server. mcp__call(server, tool, args) connects if needed and invokes tool with args (a dict matching that tool's input_schema; omit or {} for no args). Returns {"server": S, "tool": S, "content": [<MCP content blocks>], "is_error": bool}. Read text blocks via content[i]["text"].
Call a tool on an MCP server. mcp__call(server, tool, args) connects if needed and invokes `tool` with `args` (a dict matching that tool's input_schema; omit or {} for no args). Returns {"server": S, "tool": S, "content": [<MCP content blocks>], "is_error": bool}. Read text blocks via content[i]["text"].
(mcp-connect server)Explicitly connect to a configured MCP server and register it as a session resource (footer count, F4, resource_stop). Returns {"server": S, "connected": bool, "tools": N}. Usually unnecessary — mcp__tools/mcp__call auto-connect.
Explicitly connect to a configured MCP server and register it as a session resource (footer count, F4, resource_stop). Returns {"server": S, "connected": bool, "tools": N}. Usually unnecessary — mcp__tools/mcp__call auto-connect.
(mcp-disconnect server)Disconnect an MCP server: stop its session resource (closes the connection / kills the stdio process) via the canonical resource_stop path. Returns {"server": S, "result": "stopped"|"unknown"|...}.
Disconnect an MCP server: stop its session resource (closes the connection / kills the stdio process) via the canonical resource_stop path. Returns {"server": S, "result": "stopped"|"unknown"|...}.
(mcp-servers)List the Model Context Protocol servers declared in ~/.vis/config.edn (:mcp :servers) with their connection status. Returns {"servers": [{"name": S, "transport": "stdio"|"http", "connected": bool, "tools": N (when connected), "command"/"url": S}]}. Connecting happens lazily on mcp__tools/mcp__call, or explicitly via mcp__connect.
List the Model Context Protocol servers declared in ~/.vis/config.edn (:mcp :servers) with their connection status. Returns {"servers": [{"name": S, "transport": "stdio"|"http", "connected": bool, "tools": N (when connected), "command"/"url": S}]}. Connecting happens lazily on mcp__tools/mcp__call, or explicitly via mcp__connect.
(mcp-tools server)List a server's tools. mcp__tools(server) connects to the configured server if needed, then returns {"server": S, "tools": [{"name": S, "description": S, "input_schema": <JSON schema dict>}]}. Use the input_schema to shape the args for mcp__call.
List a server's tools. mcp__tools(server) connects to the configured server if needed, then returns {"server": S, "tools": [{"name": S, "description": S, "input_schema": <JSON schema dict>}]}. Use the input_schema to shape the args for mcp__call.
cljdoc builds & hosts documentation for Clojure/Script libraries
| Ctrl+k | Jump to recent docs |
| ← | Move to previous article |
| → | Move to next article |
| Ctrl+/ | Jump to the search field |