simmer-reactor-mcp 0.2.0

MCP server for Simmer reactor — real-time whale trade events for any AI agent

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

Variable	Required	Description
SIMMER_API_KEY	Yes	Your Simmer SDK API key
SIMMER_API_URL	No	API base URL (default: https://api.simmer.markets)
REACTOR_AUTO_REACT	No	Enable auto-dispatch on auto_copy wallets (default: true)
REACTOR_VENUE	No	Trading venue for auto-react (default: sim)
REACTOR_MAX_USD	No	Max trade size per auto-react (default: 25)
REACTOR_SKILL	No	Skill slug for auto-react (default: polymarket-copytrading)
SIMMER_COPYTRADING_SKILL_DIR	No	Path to copytrading skill (auto-detected via clawhub)