simmer-reactor-mcp

MCP server for Simmer Reactor — real-time whale trade events from Polymarket.

Works with any agent runtime that supports MCP: OpenClaw, Hermes, Claude Code.

Install

pip install simmer-reactor-mcp

Setup

Set your Simmer API key:

export SIMMER_API_KEY=your_api_key

OpenClaw (bundle .mcp.json)

{
  "mcpServers": {
    "simmer-reactor": {
      "command": "simmer-reactor-mcp",
      "env": { "SIMMER_API_KEY": "${SIMMER_API_KEY}" }
    }
  }
}

Hermes (~/.hermes/config.yaml)

mcp_servers:
  simmer-reactor:
    command: "simmer-reactor-mcp"
    env:
      SIMMER_API_KEY: "${SIMMER_API_KEY}"

Claude Code (.claude.json)

{
  "mcpServers": {
    "simmer-reactor": {
      "command": "simmer-reactor-mcp",
      "env": { "SIMMER_API_KEY": "${SIMMER_API_KEY}" }
    }
  }
}

Tools

get_whale_events

Returns recent whale trades from tracked Polymarket wallets.

execute_reactive_skill

Runs any installed skill in reactive mode, triggered by a whale event. Defaults to polymarket-copytrading. Requires the skill installed via ClawHub.

Auto-React Mode

When enabled (default), the MCP server automatically executes reactive skills when whale events arrive for wallets with auto_copy enabled in your dashboard. No agent decision needed — trades fire within seconds of the whale's trade.

The circuit breaker pauses auto-react after 3 consecutive failures and falls back to passive mode (events still buffer for get_whale_events).

Environment Variables