Direct access to Polymarket prediction markets with live spot prices.
CryptoConduit MCP
An MCP server that gives AI agents direct access to Polymarket Crypto prediction markets, enriched with live spot prices. Discover markets, analyze order books, paper trade strategies, track activity, and execute live trades — all through natural language.
Built in Rust. 22 tools. Mainnet-tested.
Use it as an MCP server with any MCP-compatible client, or import the core/ library directly into your own Rust bots and pipelines — zero MCP dependency.
What it does
Market Intelligence — Discover and monitor prediction markets across 6 assets (BTC, ETH, SOL, XRP, DOGE, BNB) and 8 market types (5m to monthly). Real-time Binance spot prices overlaid on Polymarket order books with tradeability scoring, spread analysis, and depth profiling.
Quantitative Analysis — Spot momentum, order book dynamics (spread trends, depth shifts, imbalance), probability-spot divergence detection, and whale flow analysis — combined into a single briefing per market. When local history isn't available, the analysis falls back to querying resolved markets on Gamma for historical volume and activity context.
Paper Trading — Fee-adjusted P&L simulation using Polymarket's fee model. Paper trading with full portfolio tracking, autonomous auto-trade execution, early exit, and position management. Test strategies risk-free before committing real capital.
Live Trading — Place and manage real orders on Polymarket via the official SDK. Triple safety gate: dry run by default, explicit confirmation required, and a risk manager with daily loss limits, drawdown tracking, and consecutive loss halts.
Monitoring — Always-on background system: whale detection on the live Polymarket trade stream, spread narrowing alerts, depth spike detection, and approaching window notifications. No manual setup required.
Tools
Discovery & Data
| Tool | What it does |
|---|---|
search_crypto_markets |
Search Polymarket for crypto prediction markets. Filter by asset, market type (5m, daily, monthly, etc.), and sort by spread or volume. Returns active markets with current prices, spreads, and liquidity. |
get_active_window |
Snapshot of the current 5m or 15m prediction window — time remaining, spot price, both UP/DOWN sides with best bid/ask, spread, and depth. |
get_window_briefing |
Richer version of active window — adds spot move since open, 1-hour volatility profile, fee breakeven calculations, and tradeability scoring per side. |
get_spot_price |
Current Binance spot price for any supported asset, with data age indicator. |
get_order_book |
Full order book for a specific market token — all bid/ask levels, total depth, concentration analysis, and slippage estimates at various trade sizes. |
get_market_analysis |
The main analysis tool. Combines 5 dimensions: spot momentum (1m/5m/15m trends, acceleration, volatility), order book dynamics (spread trends, depth asymmetry, historical stats), probability divergence (empirical model vs market price), whale flow, and recent alerts. Falls back to querying resolved markets on Gamma when local history is unavailable. Works across 5m, 15m, daily, and monthly markets. |
get_whale_activity |
Recent large trades ($5k+) on daily and monthly markets from the live Polymarket trade stream. Filters out micro-market noise and post-settlement redemptions. |
get_alerts |
Alerts generated by the background monitor: spread narrowing, depth spikes, whale trades, and windows approaching expiry. |
Simulation & Paper Trading
| Tool | What it does |
|---|---|
simulate_trade |
Fee-adjusted P&L calculator. Enter a position size and price, see exact profit/loss for win and loss scenarios, with Polymarket's taker fees, maker rebates, and settlement math. Shows breakeven win rate. |
paper_trade |
Open a simulated position at current market prices. Tracks entry price, fees, and timestamps. Positions auto-settle when the market resolves on Polymarket. |
get_paper_portfolio |
Full portfolio view — open positions with live countdown, settled results, win rate by asset and entry price bucket, total P&L, and fee tracking. |
paper_close |
Exit a paper position early at the current bid price, paying taker fee on exit. Shows realized P&L including entry and exit fees. |
set_auto_paper_trade |
Configure autonomous paper trading. Set an asset, position size, and entry conditions — the server monitors markets and opens positions automatically when conditions are met. |
get_auto_paper_trade_status |
Check which auto-traders are running, their recent trades, and aggregate stats. |
Live Trading
Requires wallet configuration. See Wallet Setup below.
| Tool | What it does |
|---|---|
approve_exchange |
One-time on-chain setup. Approves USDC and CTF token transfers for Polymarket's 3 exchange contracts. Cos |
Tools (15)
search_crypto_marketsSearch Polymarket for crypto prediction markets filtered by asset and type.get_active_windowSnapshot of the current prediction window including time remaining and depth.get_window_briefingProvides spot move, volatility profile, and tradeability scoring.get_spot_priceFetches current Binance spot price for a supported asset.get_order_bookRetrieves full order book with slippage estimates.get_market_analysisCombines spot momentum, order book dynamics, and probability divergence analysis.get_whale_activityMonitors recent large trades on daily and monthly markets.get_alertsRetrieves system alerts like spread narrowing or whale trades.simulate_tradeCalculates fee-adjusted P&L for win and loss scenarios.paper_tradeOpens a simulated position with full portfolio tracking.get_paper_portfolioViews open positions, settled results, and aggregate P&L.paper_closeExits a paper position early at the current bid price.set_auto_paper_tradeConfigures autonomous paper trading based on specific conditions.get_auto_paper_trade_statusChecks status and stats of running auto-traders.approve_exchangePerforms one-time on-chain setup for live trading.Environment Variables
POLYMARKET_API_KEYrequiredAPI key for Polymarket accessWALLET_PRIVATE_KEYrequiredPrivate key for executing live tradesConfiguration
{"mcpServers": {"crypto-conduit": {"command": "crypto-conduit", "env": {"POLYMARKET_API_KEY": "your_key", "WALLET_PRIVATE_KEY": "your_key"}}}}