MCP

Venna Code connects to Model Context Protocol (MCP) servers over Streamable HTTP to pull in external tools. Drop a ~/.venna/mcp/<name>.toml per server — the file stem is the server name, and its tools surface namespaced as mcp__<server>__<tool>.

Configure

The only required field is url; enabled defaults to true. Pick an auth mode:

url = "https://mcp.example.com"

url = "https://mcp.example.com"
auth = "bearer"
bearer_token = "…"   # redacted in logs

[headers]
X-Team = "venna"

url = "https://mcp.example.com"
auth = "oauth"        # authorization persists per server and refreshes automatically

connect_mcp_servers() opens a Streamable HTTP transport to each enabled server and discovers its tools. Plugins can ship MCP servers too — an entry under a plugin's mcp/ directory is merged namespaced under <plugin>/<server>.