Sponsored by Deepsite.site

Parsec MCP

Created By
Parsec8 days ago
Trade and monitor prediction markets across Polymarket, Kalshi, Opinion, Limitless, and PredictFun from any AI agent. Unified real-time data, live orderbook streaming, cross-exchange market matching, and order execution — one API key, one interface, five exchanges. Built in Rust for HFT-grade latency. TypeScript and Python SDKs available.
Overview

parsec-mcp

0.1.0 • Public • Published

parsec-mcp

MCP server for trading and monitoring prediction markets across Polymarket, Kalshi, Opinion, Limitless, and PredictFun — from any AI assistant.

Search markets, stream live orderbooks, preview and place trades, and manage your portfolio through natural language. Works with Claude Desktop, Cursor, VS Code Copilot, Cline, Windsurf, and any MCP-compatible client.

Quick Start

PARSEC_API_KEY=pk_live_... npx parsec-mcp serve

Get your API key at parsecapi.com.

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Cursor

Add to .cursor/mcp.json in your project:

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

VS Code / Copilot

Add to .vscode/mcp.json:

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

Windsurf / Cline

Add to your MCP configuration:

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

Environment Variables

VariableRequiredDescription
PARSEC_API_KEYYesYour Parsec API key (pk_live_... or pk_test_...)
PARSEC_API_BASE_URLNoOverride API base URL (default: https://api.parsecapi.com)
PARSEC_DISABLE_WALLET_EXPORTNoSet to 1 to disable the wallet key export tool
PARSEC_MCP_ENABLE_RAWNoSet to 1 to enable the advanced raw API escape hatch

Tools

Composite Tools (Start Here)

High-level tools designed for AI agents — these handle market resolution, multi-step workflows, and formatting automatically.

ToolDescription
parsec.market.find_marketSearch for markets by keyword, parsec_id, or exchange-native ID
parsec.market.get_market_snapshotGet market metadata + orderbook + recent trades in one call
parsec.trade.preview_orderSimulate an order with execution price and balance context
parsec.account.get_trading_setup_statusCheck if the account is ready to trade
parsec.stream.open_market_feedOne-step real-time WebSocket feed setup

Market Data

ToolDescription
parsec.market.list_exchangesList supported exchanges and their status
parsec.market.list_marketsSearch, filter, and resolve markets with cursor pagination
parsec.market.get_orderbookLive bid/ask levels for a market outcome
parsec.market.get_execution_priceEstimate fill price for a hypothetical order
parsec.market.get_priceCurrent mid-market price for an outcome
parsec.market.list_tradesRecent trades for a market
parsec.market.list_eventsList multi-market event groups

Trading

ToolDescription
parsec.trade.create_orderPlace a live order on any exchange
parsec.trade.cancel_orderCancel an open order
parsec.trade.list_ordersList orders with status/exchange filters
parsec.trade.get_orderGet order details by ID
parsec.trade.list_positionsCurrent open positions
parsec.trade.list_fillsExecuted trade fills
parsec.trade.get_balanceExchange balance (total, available, reserved)

Real-Time Streaming

Stream live orderbook snapshots, deltas, and trade activity over WebSocket.

ToolDescription
parsec.stream.open_market_feedOne-step feed setup (recommended)
parsec.stream.connectOpen a WebSocket session
parsec.stream.authAuthenticate a session
parsec.stream.subscribeSubscribe to market feeds
parsec.stream.unsubscribeRemove subscriptions
parsec.stream.resyncRequest orderbook resync
parsec.stream.readRead buffered messages
parsec.stream.closeClose a session

Account & Wallet

ToolDescription
parsec.account.pingCheck API connectivity
parsec.account.get_usageAPI usage stats
parsec.account.get_ws_usageWebSocket usage stats
parsec.account.get_user_activityRecent account activity
parsec.account.onboardComplete account onboarding
parsec.wallet.get_stateWallet and exchange link status
parsec.wallet.export_keyExport wallet private key (sensitive)

Builder (Multi-Tenant)

For platforms building on top of Parsec with per-user isolation.

ToolDescription
parsec.builder.create_userCreate an end-user
parsec.builder.list_usersList all end-users
parsec.builder.get_userGet end-user details
parsec.builder.update_userUpdate end-user profile
parsec.builder.delete_userDelete an end-user (irreversible)
parsec.builder.onboard_userOnboard end-user for trading
parsec.builder.get_poolLiquidity pool status
parsec.builder.get_escrow_configEscrow configuration

Polymarket CTF

Advanced conditional token operations (most users should use create_order instead).

ToolDescription
parsec.ctf.splitSplit USDC into conditional tokens
parsec.ctf.mergeMerge tokens back into USDC
parsec.ctf.redeemRedeem winning tokens after resolution

Example Prompts

Once connected, try asking your AI assistant:

  • "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?"

Security

  • API key is passed via environment variable, never in tool calls
  • Sensitive tools (create_order, cancel_order, export_key) are annotated as destructive
  • Wallet export can be disabled globally with PARSEC_DISABLE_WALLET_EXPORT=1
  • Internal endpoints are never exposed through the MCP surface
  • All connections use HTTPS/WSS

Troubleshooting

"PARSEC_API_KEY is required" — Set the environment variable in your MCP client configuration.

Tools not appearing — Restart your MCP client after configuration changes. Check that npx parsec-mcp serve runs successfully in your terminal.

Authentication errors — Verify your API key at parsecapi.com. Test keys (pk_test_...) work in sandbox mode only.

WebSocket session limit — Max 8 concurrent sessions. Close unused sessions with parsec.stream.close.

Development

npm install
npm run build
npm test
npm run check          # build + test + contract tests
npm run eval:smoke     # smoke test harness

License

MIT

Server Config

{
  "mcpServers": {
    "parsec": {
      "command": "npx",
      "args": [
        "-y",
        "parsec-mcp"
      ],
      "env": {
        "PARSEC_API_KEY": "pk_live_..."
      }
    }
  }
}
Recommend Servers
TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.
Jina AI MCP ToolsA Model Context Protocol (MCP) server that integrates with Jina AI Search Foundation APIs.
CursorThe AI Code Editor
ChatWiseThe second fastest AI chatbot™
WindsurfThe new purpose-built IDE to harness magic
Baidu Map百度地图核心API现已全面兼容MCP协议,是国内首家兼容MCP协议的地图服务商。
Howtocook Mcp基于Anduin2017 / HowToCook (程序员在家做饭指南)的mcp server,帮你推荐菜谱、规划膳食,解决“今天吃什么“的世纪难题; Based on Anduin2017/HowToCook (Programmer's Guide to Cooking at Home), MCP Server helps you recommend recipes, plan meals, and solve the century old problem of "what to eat today"
MCP AdvisorMCP Advisor & Installation - Use the right MCP server for your needs
RedisA Model Context Protocol server that provides access to Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized tools.
BlenderBlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.
DeepChatYour AI Partner on Desktop
MiniMax MCPOfficial MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.
Zhipu Web SearchZhipu Web Search MCP Server is a search engine specifically designed for large models. It integrates four search engines, allowing users to flexibly compare and switch between them. Building upon the web crawling and ranking capabilities of traditional search engines, it enhances intent recognition capabilities, returning results more suitable for large model processing (such as webpage titles, URLs, summaries, site names, site icons, etc.). This helps AI applications achieve "dynamic knowledge acquisition" and "precise scenario adaptation" capabilities.
AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.
Amap Maps高德地图官方 MCP Server
Serper MCP ServerA Serper MCP Server
Playwright McpPlaywright MCP server
Visual Studio Code - Open Source ("Code - OSS")Visual Studio Code
EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.
Tavily Mcp
Y GuiA web-based graphical interface for AI chat interactions with support for multiple AI models and MCP (Model Context Protocol) servers.