Metadata-Version: 2.4
Name: simmer-reactor-mcp
Version: 0.2.0
Summary: MCP server for Simmer reactor — real-time whale trade events for any AI agent
License-Expression: MIT
Requires-Python: >=3.10
Requires-Dist: httpx-sse>=0.4.0
Requires-Dist: httpx>=0.25.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# 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

```bash
pip install simmer-reactor-mcp
```

## Setup

Set your Simmer API key:

```bash
export SIMMER_API_KEY=your_api_key
```

### OpenClaw (bundle .mcp.json)

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

### Hermes (~/.hermes/config.yaml)

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

### Claude Code (.claude.json)

```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) |
