demwick/polymarket-agent-mcp

**Trade, analyze, and automate Polymarket prediction markets through AI.**
The most comprehensive MCP server for Polymarket — 48 tools spanning direct trading, market discovery, smart money tracking, copy trading, backtesting, risk management, and portfolio optimization. Works with Claude Code, Cursor, or any MCP-compatible client.
---
Tool Overview
| Category | Count | Highlights |
|----------|-------|------------|
| **Discovery** | 9 | Search, trending, featured, events, related markets, smart money flow |
| **Analysis** | 8 | AI opportunity scoring, conviction rating, price history, market quality, top holders, comparison |
| **Trading** | 8 | Buy, sell, batch orders, limit orders, order management, safety limits |
| **Copy Trading** | 5 | Watch traders, auto-monitor, auto-rebalance, backtest |
| **Portfolio** | 10 | Positions, P&L, balance, risk assessment, SL/TP, optimization, market alerts |
| **Utilities** | 8 | Dashboard, config, trade history, watchlists, agent logging |
---
Quick Start
npm Install
Docker
Claude Code Config
Add to ~/.claude/settings.json:
---
Usage Examples
Just talk naturally to your AI assistant:
> "What are the trending markets today?"
> "Search for bitcoin prediction markets"
> "Buy $5 on this market"
> "Score this trader — should I copy them?"
> "Backtest this trader with $10 per trade"
> "Show smart money flow — what are the top traders buying?"
> "Set stop-loss at 0.30 on my BTC position"
> "Optimize my portfolio with a balanced strategy"
> "Scan for arbitrage opportunities"
> "Compare these two markets side by side"
---
All 48 Tools
Discovery
| Tool | Description |
|------|-------------|
| markets.search | Search markets by keyword (bitcoin, election, UFC...) |
| traders.discover | Find top traders by PnL and volume |
| markets.discover | Find markets by end date and category |
| markets.trending | Top markets by 24h/7d/30d volume |
| markets.featured | Most liquid markets by category (politics, sports, crypto...) |
| wta.discover | WTA tennis markets with stink bid prices |
| flow.discover | Smart money signals — multiple top traders buying same market |
| markets.related | Find markets related to a topic or market |
| markets.events | Browse all markets under an event |
Analysis
| Tool | Description |
|------|-------------|
| markets.analyze | AI-powered BUY/SELL/HOLD recommendation |
| traders.analyze | Detailed trader profile, win rate, P&L |
| traders.score | Conviction score (0-100) across 5 dimensions |
| markets.check | Market quality — spread, depth, price range |
| markets.price | Live bid/ask/spread prices |
| markets.price_history | Historical prices with sparkline (1h to 1m) |
| markets.holders | Biggest position holders in a market |
| markets.compare | Side-by-side comparison of 2-5 markets |
Trading
| Tool | Description |
|------|-------------|
| orders.buy | Buy shares on any market |
| orders.sell | Sell an open position |
| orders.batch | Execute up to 10 orders at once |
| wta.bid | Place limit orders at discount |
| orders.cancel | Cancel all open orders |
| orders.list | View pending limit orders |
| orders.status | Check status of a specific order |
| config.go_live | Switch from preview to live mode |
Copy Trading
| Tool | Description |
|------|-------------|
| watchlist.add | Add/remove traders from watchlist |
| monitor.start | Start automatic copy trading loop |
| monitor.stop | Stop monitoring |
| watchlist.rebalance | Remove underperforming traders |
| traders.backtest | Simulate copying a trader's past trades |
Portfolio & Risk
| Tool | Description |
|------|-------------|
| portfolio.balance | Account balance, budget, and P&L |
| portfolio.get | Multi-wallet overview with P&L per trader |