@robot-resources/router-mcp

MCP server for managing Robot Resources Router — stats, config, and model comparison.

What is Robot Resources?

Human Resources, but for your AI agents.

Robot Resources cuts your LLM API costs by 60-90%. It runs a local proxy that classifies each prompt by task type (coding, reasoning, analysis, simple Q&A, creative, general) and routes it to the cheapest model that can handle it — across 14 models from OpenAI, Anthropic, and Google.

Your API keys never leave your machine. Free, unlimited, no tiers.

Install the full suite

npx robot-resources

One command sets up the Router proxy, configures your agents, and gets you saving immediately.

Learn more at robotresources.ai

About this MCP server

This package gives AI agents management tools for the Router proxy via the Model Context Protocol. Use it to check cost savings, compare models, and adjust routing config — all from within Claude Desktop, Claude Code, or any MCP-compatible agent.

Quick Start

npx @robot-resources/router-mcp

Requires the Router proxy running at localhost:3838 (default). Override with ROUTER_URL env var.

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "router": {
      "command": "npx",
      "args": ["-y", "@robot-resources/router-mcp"]
    }
  }
}

Claude Code

Add to your .mcp.json:

{
  "mcpServers": {
    "router": {
      "command": "npx",
      "args": ["-y", "@robot-resources/router-mcp"]
    }
  }
}

Custom Router URL

If the proxy runs on a non-default port:

{
  "mcpServers": {
    "router": {
      "command": "npx",
      "args": ["-y", "@robot-resources/router-mcp"],
      "env": {
        "ROUTER_URL": "http://localhost:4000"
      }
    }
  }
}

Tools

`router_get_stats`

Cost savings statistics for the Router proxy.

Parameter	Type	Default	Description
`period`	`"daily" \| "weekly" \| "monthly"`	`"weekly"`	Time period
`task_type`	`string`	—	Filter by task type
`provider`	`string`	—	Filter by provider

`router_compare_models`

Compare models by capability and cost for a given task type.

Parameter	Type	Default	Description
`task_type`	`string`	required	Task type to compare
`threshold`	`number`	`0.7`	Minimum capability score
`provider`	`string`	—	Filter by provider

`router_get_config`

Read current routing configuration (provider scope, thresholds, overrides).

No parameters required.

`router_set_config`

Update routing configuration at runtime. Changes are in-memory only (reset on restart).

Parameter	Type	Description
`provider_scope`	`string`	Limit to specific provider(s)
`capability_threshold`	`number`	Minimum capability score
`baseline_model`	`string`	Model for cost comparisons
`log_level`	`string`	Logging level

Pass null for any field to reset it to the env-var default.

Requirements

Node.js >= 18.0.0
Router proxy running (see @robot-resources/router)

License

MIT

@robot-resources/router-mcp