com.blockether.vis.ext.foundation-mcp.core

Liking cljdoc? Tell your friends :D

Clojure only.

mcp-call
mcp-connect
mcp-disconnect
mcp-servers
mcp-tools
vis-extension

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`.

raw docstring

mcp-call^clj

(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"].

source raw docstring

mcp-connect^clj

(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.

source raw docstring

mcp-disconnect^clj

(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"|...}.

source raw docstring

mcp-servers^clj

(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.

source raw docstring

mcp-tools^clj

(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.

source raw docstring