Too Many Cooks MCP Server

Model Context Protocol server for the Too Many Cooks funding rates API. Use it from Claude Code, Claude Desktop, Codex, Hermes, or any MCP-compatible client to query live and historical funding rates across 25 DEX perpetuals exchanges and to find delta-neutral arbitrage opportunities.

What you get

22 tools that any MCP client can call:

| Tool | What it does | |---|---| | list_exchanges | List all supported DEX exchanges and RWA support flags. | | list_tickers | Discover tickers and the exchanges where each is listed. | | get_aggregated_markets | DB-backed cross-exchange market snapshot with filters. | | get_market_extremes | Highest and/or lowest funding rates right now. | | get_funding_spikes | Cross-exchange z-score outlier detector. | | get_ticker_markets | One ticker across exchanges, including a suggested arbitrage pair. | | compare_tickers | Batch cross-exchange snapshots for several tickers in one request. | | get_market_for_ticker_on_exchange | Single ticker on a single exchange. | | get_funding_rates | Live snapshot for one exchange; prefer DB-backed tools for analysis. | | get_historical_funding | Historical funding-rate time series for tickers on one exchange. | | find_arbitrage_strategies | Top delta-neutral arbitrage opportunities ranked by APR spread. | | find_strategy_for_ticker | Best long/short pair for one specific ticker. | | find_spot_strategies | Spot/perp cash-and-carry strategy candidates. | | simulate_strategy | Project funding and net PnL for a perp/perp pair. | | simulate_spot_strategy | Project funding and net PnL for a spot/perp pair. | | compare_exchanges_for_ticker | Backward-compatible ticker comparison wrapper. | | get_execution_cost_history | Historical slippage + fee estimates for one exchange/ticker. | | get_strategy_execution_cost_history | Round-trip execution-cost history for a delta-neutral pair. | | get_exchange_status | Data freshness and health for an exchange. | | get_platform_stats | Platform-level totals and funding-rate summary stats. | | get_plans | Public API plan catalog, quotas, limits, and pricing. | | whoami | Authenticated key, tier, and current quota. |

Get an API key

1. Sign in at https://toomanycooks.app
2. Go to Dashboard → API Keys
3. Create a key (starts on the Free tier — 100 requests/day)
4. Copy the key (shown once)

The free tier is enough to try the MCP server. Upgrade to Starter ($19/mo, 10k req/day), Pro ($79/mo, 100k req/day), or Quant ($299/mo, unlimited) at https://toomanycooks.app/pricing.

Install

The server is published as @toomanycooks/mcp-server. Most MCP clients launch it via npx so you don't need to install it globally.

Claude Desktop / Claude Code

Add to your claude_desktop_config.json (or the equivalent for Claude Code):

{
  "mcpServers": {
    "toomanycooks": {
      "command": "npx",
      "args": ["-y", "@toomanycooks/mcp-server"],
      "env": {
        "TMC_API_KEY": "tmc_live_..."
      }
    }
  }
}

Restart Claude. You should see "toomanycooks" appear in the MCP server list.

Codex (OpenAI)

Codex supports the standard MCP protocol. Add the server to your ~/.codex/mcp.json (or the path your Codex install expects):

{
  "servers": {
    "toomanycooks": {
      "command": "npx",
      "args": ["-y", "@toomanycooks/mcp-server"],
      "env": { "TMC_API_KEY": "tmc_live_..." }
    }
  }
}

Hermes (Nous Research)

Hermes accepts MCP servers through its agent runtime config. The exact JSON path varies by version — see the Hermes docs at https://hermes-agent.nousresearch.com/docs/, then point it at:

{
  "command": "npx",
  "args": ["-y", "@toomanycooks/mcp-server"],
  "env": { "TMC_API_KEY": "tmc_live_..." }
}

Generic / any MCP client

The server uses stdio transport. Any client that supports MCP stdio can launch:

TMC_API_KEY=tmc_live_... npx -y @toomanycooks/mcp-server

Example prompts

Once installed, you can ask things like:

• "What are the top 10 delta-neutral arbitrage opportunities right now, focused on exchanges with at least $10M of 24h volume?"
• "Compare BTC funding rates across HyperLiquid, Lighter, and Extended."
• "Show me the historical funding rate of ETH on HyperLiquid over the last 14 days."
• "What's my current API quota?"

Development

git clone https://github.com/toomanycooks/toomanycooks-mcp
cd toomanycooks-mcp
npm install
TMC_API_KEY=tmc_test_... npm run dev

To point at a local backend instead of production:

TMC_API_KEY=tmc_test_... TMC_API_BASE_URL=http://localhost:3001 npm run dev

Troubleshooting

• TMC_API_KEY is not set — Add the env var to your MCP server config (see install snippets above). Don't pass it as a CLI arg — MCP servers run in a sandboxed process, so the host-shell env doesn't propagate.
• Authentication failed — Your key was revoked or never existed. Generate a fresh one at https://toomanycooks.app/dashboard/api-keys.
• Rate limit exceeded — You hit your daily or monthly quota. Wait until the reset (UTC midnight for daily, 1st of next month UTC for monthly) or upgrade your plan.
• MCP server doesn't appear in Claude / Codex / Hermes — Verify the JSON config syntax (no trailing commas), restart the host app, and check the host's MCP debug logs.

License

MIT — see LICENSE.