MCP servers

MCP servers extend the Vibe Code CLI with external tools through the Model Context Protocol. You configure them in config.toml under mcp_servers, then their tools become available to Vibe like any built-in tool.

MCP servers are user-configured. For Mistral-managed integrations, see Connectors instead.

Information

Known limitation: the CLI does not yet support MCP servers that require OAuth authentication. Use the stdio or http transport with an API key or other static credential.

Supported transports

Transport	Use it when
`http`	The server is reachable over standard HTTP.
`streamable-http`	The server is reachable over HTTP and supports streaming responses.
`stdio`	The server is a local process you start from a command.

Add an MCP server

Append a [[mcp_servers]] table to config.toml. Required fields depend on the transport.

[[mcp_servers]]
name = "my_http_server"
transport = "http"
url = "http://localhost:8000"
headers = { "Authorization" = "Bearer my_token" }
api_key_env = "MY_API_KEY_ENV_VAR"
api_key_header = "Authorization"
api_key_format = "Bearer {token}"

[[mcp_servers]]
name = "my_http_server"
transport = "http"
url = "http://localhost:8000"
headers = { "Authorization" = "Bearer my_token" }
api_key_env = "MY_API_KEY_ENV_VAR"
api_key_header = "Authorization"
api_key_format = "Bearer {token}"

Common fields

Field	Purpose
`name`	Short alias for the server. Used as a prefix in tool names.
`transport`	One of `http`, `streamable-http`, or `stdio`.
`url`	Base URL for HTTP transports.
`command` / `args`	Command and arguments for the stdio transport.
`headers`	Extra HTTP headers for HTTP transports.
`api_key_env`	Environment variable that holds the API key.
`env`	Environment variables passed to the server process (stdio).
`startup_timeout_sec`	How long to wait for the server to start.
`tool_timeout_sec`	How long to wait for a tool call to complete.

Tool naming and permissions

MCP tools are exposed under the pattern {server_name}_{tool_name}. Configure permissions per tool just like built-in tools:

[tools.fetch_server_get]
permission = "always"

[tools.my_http_server_query]
permission = "ask"

[tools.fetch_server_get]
permission = "always"

[tools.my_http_server_query]
permission = "ask"

You can also restrict which MCP tools are active using enabled_tools and disabled_tools:

# Only enable serena's tools
enabled_tools = ["serena_*"]

# Disable all MCP tools and grep
disabled_tools = ["mcp_*", "grep"]

# Only enable serena's tools
enabled_tools = ["serena_*"]

# Disable all MCP tools and grep
disabled_tools = ["mcp_*", "grep"]

Filters support exact names, glob patterns, and regex with the re: prefix.

Browse MCP servers from the CLI

From a CLI session:

/mcp

/mcp

Pass a server name to list its tools:

/mcp fetch_server

/mcp fetch_server

Note

/connectors is an alias for /mcp.