MCP Support

Model Context Protocol connects agents and model requests to tools, resources, and prompts. BitRouter supports MCP in two places:

• The open-source daemon acts as a client and gateway for MCP servers you configure.
• The public Docs MCP server lets compatible clients search BitRouter documentation and model availability.

MCP gateway

The gateway puts BitRouter between an agent or model request and its third-party MCP servers. Configure upstreams once, then expose each server directly or combine them behind one aggregate endpoint.

BitRouter OSS is the client and gateway on this path. It does not add BitRouter-owned administrative tools to the catalog.

Configure upstream servers

Add servers under mcp_servers in bitrouter.yaml. Stdio entries launch a child process; HTTP entries connect to a Streamable HTTP endpoint.

mcp_servers:
  filesystem:
    name: filesystem
    transport:
      type: stdio
      command: npx
      args: ["-y", "@modelcontextprotocol/server-filesystem", "/data"]
  context7:
    name: context7
    transport:
      type: http
      url: https://mcp.context7.com/mcp
      headers:
        Authorization: "Bearer ${CONTEXT7_TOKEN}"

A stdio child inherits the ambient environment, with configured env values added or overridden. HTTP headers are sent to that upstream on every request.

Direct and aggregate routes

The aggregate is enabled by default and can be moved or disabled:

mcp:
  aggregate:
    enabled: true
    route: /mcp

Aggregate tool and prompt names are prefixed with the server id to avoid collisions. Override the prefix or exclude one server from aggregation without disabling its direct route:

mcp_servers:
  context7:
    name: context7
    transport:
      type: http
      url: https://mcp.context7.com/mcp
    tool_prefix: "docs__"
    aggregate: false

Diagnose upstreams

bro mcp check performs a tools/list round trip and reports transport, reachability, latency, negotiated tool capability, and advertised tool names:

bro mcp check             # every configured upstream
bro mcp check context7    # one upstream

Configuration remains the source of truth; the check does not maintain a separate global tool registry.

Cache discovery, not execution

Aggregate list calls use bounded TTL caches by default. Tool execution is never cached.

Set an individual TTL to 0, or disable the cache as a whole:

mcp:
  cache:
    enabled: false

Execute tools inside a model request

The gateway normally lets an external agent call MCP tools. To let BitRouter run the tool loop, list selected upstream ids under server_tools.mcp_servers:

server_tools:
  mcp_servers: [filesystem, context7]
  max_iterations: 6

BitRouter advertises those tools to the model, executes selected calls, returns results, and continues until the model stops requesting tools or the iteration bound is reached. Declaring an upstream under mcp_servers alone does not put it into this loop. See Server tools for approval and iteration behavior.

Connect a coding agent

bro launch injects the aggregate endpoint into supported native harnesses without editing their user configuration. Claude, Codex, OpenCode, and Hermes have an injectable MCP surface; other harnesses may not.

bro launch codex

The launch summary states whether model routing and MCP injection were applied. Local filesystem skills use the agent host's normal plugin or skill mechanism; they are not served by a BitRouter origin MCP process.

Docs MCP server

BitRouter publishes a public MCP server for this documentation. An editor or agent can search docs, read a page, and check model availability without leaving its current workflow.

• Endpoint: https://bitrouter.ai/mcp
• Transport: Streamable HTTP
• Authentication: none

This service answers questions about BitRouter. It is separate from the gateway running in your own deployment.

Tools

Clients that support MCP resources can also read the curated index at bitrouter-docs://llms-index.

Add it to a client

Claude Code:

claude mcp add --transport http bitrouter-docs https://bitrouter.ai/mcp

For clients that accept an MCP server configuration:

{
  "mcpServers": {
    "bitrouter-docs": {
      "url": "https://bitrouter.ai/mcp"
    }
  }
}

Operating BitRouter from an agent

BitRouter OSS is not a first-party origin MCP server for local administrative commands. To inspect status, models, routes, or requests, install Agent Skills in a shell-capable host. The skill selects structured bro commands; the host obtains approval and executes them.