Skip to main content
The simmer-mcp server exposes tools for querying portfolio data, searching markets, executing trades, running autoresearch experiments, and invoking trading skills. Install it once and your agent gets access to the full Simmer platform via MCP. For install instructions, see Autoresearch.

Free tools

Available without a SIMMER_API_KEY:

Data query tools

Pro feature. These tools require a SIMMER_API_KEY.

get_portfolio

Get portfolio summary: balance, total value, realized and unrealized P&L, position count, and per-venue breakdown.

get_positions

Get open positions with market question, side, size, entry price, current price, and P&L.

get_expiring_positions

Get positions expiring within a time window. Use this to check what’s about to resolve so you can exit or hold.

get_fleet_summary

Get fleet overview: all agents’ positions, realized + unrealized P&L, trade counts, and active status. Use this to monitor multi-agent performance.

simmer_get_briefing

Get a consolidated agent briefing: portfolio balance, open positions, top opportunities, and recent performance.

simmer_get_markets

List or search markets available for trading.

simmer_get_market_context

Get rich context for a specific market: price history, your position, recent trades, flip-flop detection, slippage estimates, and edge analysis.

Trading tools

simmer_trade

Execute or dry-run a single direct trade. Use per-skill tools (simmer_<slug>) for strategy-driven runs. Safety triple-gate: a live trade requires (1) dry_run=false, (2) venue polymarket or kalshi, AND (3) SIMMER_MCP_ALLOW_LIVE=true env. Missing any gate coerces to sim.

simmer_cancel_order

Cancel a single open order by its order ID. Requires SIMMER_MCP_ALLOW_LIVE=true.

Autoresearch tools

See Autoresearch for the full workflow guide.

Per-skill tools

One simmer_<slug> tool per bundled trading skill. Each runs in dry-run paper mode by default. Set trading_venue to sim, polymarket, or kalshi. Run list_skills to see all available skills and their parameters.