MCP
List, probe, call, add and remove MCP servers from the terminal.dexto mcp works with MCP servers that you configure, without starting a chat: list them, probe
a connection, list their tools, resources and prompts, and call one tool. Each call opens the
connection and closes it afterwards. Pass --json for machine-readable output.
To make Dexto’s own tools available to a session, you do not need this: signed in, every local session
has the dexto server. See The harness.
Generated from dexto 2.0.0-beta.0.
dexto mcp
Configure and call MCP servers, or expose them through an aggregation gateway
dexto mcp | Option | What it does |
|---|---|
--config <path> | MCP-only YAML configuration (otherwise use --agent) |
-s, --strict | Require all MCP server connections to succeed |
--group-servers | Aggregate and re-expose tools from configured MCP servers (required for now) |
--transport <transport> | Gateway transport (choices: "stdio", "http", default: "stdio") |
--host <host> | HTTP gateway bind address (default: "127.0.0.1") |
--port <port> | HTTP gateway port (default: "3001") |
--no-auth | Allow HTTP access without a gateway key (external ingress must own authentication) |
--name <n> | Name for the MCP server (default: "dexto-tools") |
--version <version> | Version for the MCP server (default: "1.0.0") |
A local command: it does not follow the JSON and exit-code contract.
dexto mcp list
List configured MCP servers without connecting
dexto mcp list | Option | What it does |
|---|---|
--config <path> | MCP-only YAML configuration (default: ".dexto/mcp.yml") |
--json | Emit machine-readable JSON |
A local command: it does not follow the JSON and exit-code contract.
dexto mcp connect
Probe a server connection, then close it
dexto mcp connect <server> | Option | What it does |
|---|---|
--config <path> | MCP-only YAML configuration (default: ".dexto/mcp.yml") |
--json | Emit machine-readable JSON |
A local command: it does not follow the JSON and exit-code contract.
dexto mcp call
Call an explicitly selected upstream MCP tool, then close the connection
dexto mcp call <server> <tool> | Option | What it does |
|---|---|
--config <path> | MCP-only YAML configuration (default: ".dexto/mcp.yml") |
--json | Emit machine-readable JSON |
--arguments <json> | Tool arguments as a JSON object (default: "{}") |
A local command: it does not follow the JSON and exit-code contract.
dexto mcp tools
List upstream MCP tools and schemas
dexto mcp tools <server> | Option | What it does |
|---|---|
--config <path> | MCP-only YAML configuration (default: ".dexto/mcp.yml") |
--json | Emit machine-readable JSON |
A local command: it does not follow the JSON and exit-code contract.
dexto mcp resources
List upstream MCP resource metadata
dexto mcp resources <server> | Option | What it does |
|---|---|
--config <path> | MCP-only YAML configuration (default: ".dexto/mcp.yml") |
--json | Emit machine-readable JSON |
A local command: it does not follow the JSON and exit-code contract.
dexto mcp read-resource
Read an exact upstream MCP resource, then close the connection
dexto mcp read-resource <server> <uri> | Option | What it does |
|---|---|
--config <path> | MCP-only YAML configuration (default: ".dexto/mcp.yml") |
--json | Emit machine-readable JSON |
A local command: it does not follow the JSON and exit-code contract.
dexto mcp prompts
List upstream MCP prompt metadata
dexto mcp prompts <server> | Option | What it does |
|---|---|
--config <path> | MCP-only YAML configuration (default: ".dexto/mcp.yml") |
--json | Emit machine-readable JSON |
A local command: it does not follow the JSON and exit-code contract.
dexto mcp get-prompt
Render an exact upstream MCP prompt, then close the connection
dexto mcp get-prompt <server> <prompt> | Option | What it does |
|---|---|
--config <path> | MCP-only YAML configuration (default: ".dexto/mcp.yml") |
--json | Emit machine-readable JSON |
--arguments <json> | Prompt arguments as a JSON object of strings (default: "{}") |
A local command: it does not follow the JSON and exit-code contract.
dexto mcp add
Add MCP server configuration
dexto mcp add <server> | Option | What it does |
|---|---|
--config <path> | MCP-only YAML configuration (default: ".dexto/mcp.yml") |
--json | Emit machine-readable JSON |
--server-config <json> | Server configuration as a JSON object |
--transport <type> | stdio, http or sse (inferred from command or URL) |
--command <executable> | Local stdio server executable |
--arg <value> | Server argument (repeat; use --arg=--flag for option arguments) |
--env <NAME=VALUE> | Server environment assignment (repeat) |
--url <url> | Remote MCP endpoint |
--header <NAME=VALUE> | Remote request header (repeat) |
--replace | Replace an existing server |
A local command: it does not follow the JSON and exit-code contract.
dexto mcp remove
Remove configured MCP server
dexto mcp remove <server> | Option | What it does |
|---|---|
--config <path> | MCP-only YAML configuration (default: ".dexto/mcp.yml") |
--json | Emit machine-readable JSON |
A local command: it does not follow the JSON and exit-code contract.