Agents & payments

MCP server

Bull Router ships an MCP server so any MCP client - Claude Desktop, Cursor, agent frameworks - can call Bull Router models as tools: list_models, chat, embed, and estimate_cost.

Auth modes

Two auth modes, auto-detected from env. Keyed: set BULLROUTER_API_KEY to use your prepaid balance. x402: set EVM_PRIVATE_KEY (0x hex) instead and the agent pays per call in USDC on Solana from that wallet - no account at all (chat only). Use a dedicated, low-balance wallet for this.

mcp config (keyed)

{
  "mcpServers": {
    "bull-router": {
      "command": "npx",
      "args": ["-y", "@bullrouter/mcp"],
      "env": { "BULLROUTER_API_KEY": "br_sk_live_…" }
    }
  }
}

mcp config (x402 pay-per-call)

{
  "mcpServers": {
    "bull-router": {
      "command": "npx",
      "args": ["-y", "@bullrouter/mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x… private key (burner wallet)"
      }
    }
  }
}

Install

The package is on npm as @bullrouter/mcp - npx fetches it automatically, so the configs above work as-is. Restart your MCP client after adding one.