Parsec

Unified prediction market trading across Polymarket, Kalshi, Opinion, Limitless, and PredictFun — real-time data, live orderbooks, and order execution from any AI agent. One API key, one interface, five exchanges.

Setup

Ask the user for their Parsec API key. If they don't have one, direct them to app.parsecapi.com to create an account. Then pick one of the options below and substitute the key. After setup, restart the session for the MCP server to become available.

Option A: Remote server (recommended)

No install needed. Add the hosted MCP server to your client config:

Claude Code:

claude mcp add parsec --transport http https://mcp.parsecapi.com/mcp -H "Authorization: Bearer pk_live_..."

Claude Desktop / Cursor / VS Code / Windsurf / Cline:

{
  "mcpServers": {
    "parsec": {
      "url": "https://mcp.parsecapi.com/mcp",
      "headers": { "Authorization": "Bearer pk_live_..." }
    }
  }
}

Option B: Local server

Run the MCP server on your machine via npx:

Claude Code:

claude mcp add parsec -- env PARSEC_API_KEY=pk_live_... npx -y parsec-mcp

Claude Desktop / Cursor / VS Code / Windsurf / Cline:

{
  "mcpServers": {
    "parsec": {
      "command": "npx",
      "args": ["-y", "parsec-mcp"],
      "env": { "PARSEC_API_KEY": "pk_live_..." }
    }
  }
}

Key Concept

parsec_id is the universal market identifier: {exchange}:{native_id} (e.g. kalshi:BTC-100K-2026, polymarket:0x1a2b...). Every tool that takes a market uses this format. Outcomes are named strings like "Yes", "No", or categorical labels.

Rules

• Start with composite tools. find_market, get_market_snapshot, preview_order, and open_market_feed handle multi-step resolution automatically — prefer them over low-level tools.
• Always preview before trading. Call parsec.trade.preview_order before parsec.trade.create_order. Never place an order without explicit user confirmation.
• Dangerous tools — create_order, cancel_order, and delete_user can lose money or are irreversible. Always confirm with the user first.
• find_market for natural language, list_markets for structured queries. Don't mix them up. list_markets requires a scope + selector — it rejects empty calls.
• Credential handling: Never echo, log, or surface API keys or exchange credentials in responses.

Workflows

Market Research

1. parsec.market.find_market — search by topic
2. parsec.market.get_market_snapshot — metadata + orderbook + recent trades in one call

Trading

1. parsec.account.get_trading_setup_status — verify account is ready
2. parsec.trade.preview_order — estimate cost, show balance
3. Get explicit user confirmation
4. parsec.trade.create_order — execute
5. parsec.trade.get_order — monitor status

Live Streaming

1. parsec.stream.open_market_feed — opens, authenticates, and subscribes in one call
2. parsec.stream.read — consume orderbook snapshots, deltas, and trades
3. parsec.stream.close — clean up when done (sessions auto-close after 10 min idle, max 8 concurrent)

Tool Reference

Composite Tools (Start Here)

Market Data

Trading

Real-Time Streaming

Account & Wallet

Builder (Multi-Tenant)

Polymarket CTF

Example Prompts

• "What prediction markets are available about Bitcoin?"
• "Show me the orderbook for the Trump 2028 market on Polymarket"
• "What's my Kalshi balance?"
• "Preview buying 50 Yes contracts on that market"
• "Open a live feed for the ETH price market"
• "Am I set up to trade?"

Pricing & Rate Limits

Free tier included — no credit card required.

Sign up at app.parsecapi.com.

Docs

Full documentation: docs.parsecapi.com