ModRouter as an MCP Gateway

Overview

ModRouter can expose all connected MCP tools through a single MCP server endpoint:

https://api.modrouter.online/mcp

This is useful when a client such as Claude Desktop, Claude Code, Cursor, or another MCP-compatible app should connect to one endpoint instead of many separate MCP servers.

Connect an MCP Client

Configure your MCP client to use ModRouter as an HTTP MCP server:

{
  "mcpServers": {
    "modrouter": {
      "url": "https://api.modrouter.online/mcp"
    }
  }
}

If your deployment requires an API key, include it in the headers supported by your MCP client:

{
  "mcpServers": {
    "modrouter": {
      "url": "https://api.modrouter.online/mcp",
      "headers": {
        "Authorization": "Bearer ${MODROUTER_API_KEY}"
      }
    }
  }
}

Test the Endpoint

List available tools:

export MODROUTER_BASE_URL="https://api.modrouter.online"
export MODROUTER_API_KEY="<your-modrouter-virtual-key>"

curl --location "https://api.modrouter.online/mcp" \
  --header "Authorization: Bearer ${MODROUTER_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

Call a tool:

curl --location "https://api.modrouter.online/mcp" \
  --header "Authorization: Bearer ${MODROUTER_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "filesystem-read_file",
      "arguments": {
        "path": "/tmp/example.txt"
      }
    }
  }'

CLI Agents & Editors

MCP Gateway

ModRouter as an MCP Gateway

Overview

Connect an MCP Client

Test the Endpoint

Next Steps

​Overview

​Connect an MCP Client

​Test the Endpoint

​Next Steps

Overview

Connect an MCP Client

Test the Endpoint

Next Steps