Skip to content

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.