polymarket-agent-mcp

finance MCP Server

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.

VerifiedInstall Ready
financefinance
8 views10 stars2 forksv1.6.7MIT

Why This Matters

Discovered via list:awesome-mcp-servers-punkpeye and last synced 3mo ago.

VerifiedInstall Ready
Source
list:awesome-mcp-servers-punkpeye
Stars
10
Last synced
3mo ago
Install
Instructions detected

Install

1. Install the package

npx polymarket-agent-mcp

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "polymarket-agent-mcp": {
      "command": "npx",
      "args": [
        "polymarket-agent-mcp"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

62
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (62)

9

Search, trending, featured, events, related markets, smart money flow

assess_risk

Portfolio risk scoring and warnings

set_safety_limits

Max order size, exposure cap, spread tolerance

discover_wta

WTA tennis market discovery

Category

Scope

optimize_portfolio

AI-powered optimization (conservative/balanced/aggressive)

watch_market

Market watchlist with price alerts

get_trade_history

Trade history with filters

Mode

Activation

Variable

Required

detect_arbitrage

Find YES+NO price discrepancies

list_watchlist

Show watched wallets

set_config

Update bot settings

get_trader_positions

View a trader's open positions

MIN_CONVICTION

No

find_related

Find markets related to a topic or market

get_price_history

Historical prices with sparkline (1h to 1m)

cancel_orders

Cancel all open orders

rebalance

Remove underperforming traders

check_exits

Check positions for resolution

get_dashboard

Terminal-formatted dashboard

Path

Method

8

Dashboard, config, trade history, watchlists, agent logging

5

Watch traders, auto-monitor, auto-rebalance, backtest

10

Positions, P&L, balance, risk assessment, SL/TP, optimization, market alerts

search_markets

Search markets by keyword (bitcoin, election, UFC...)

discover_traders

Find top traders by PnL and volume

discover_markets

Find markets by end date and category

trending_markets

Top markets by 24h/7d/30d volume

featured_markets

Most liquid markets by category (politics, sports, crypto...)

discover_flow

Smart money signals — multiple top traders buying same market

get_market_events

Browse all markets under an event

analyze_opportunity

AI-powered BUY/SELL/HOLD recommendation

analyze_trader

Detailed trader profile, win rate, P&L

score_trader

Conviction score (0-100) across 5 dimensions

check_market

Market quality — spread, depth, price range

get_price

Live bid/ask/spread prices

get_top_holders

Biggest position holders in a market

compare_markets

Side-by-side comparison of 2-5 markets

buy

Buy shares on any market

sell

Sell an open position

batch_order

Execute up to 10 orders at once

place_stink_bid

Place limit orders at discount

get_open_orders

View pending limit orders

get_order_status

Check status of a specific order

go_live

Switch from preview to live mode

watch_wallet

Add/remove traders from watchlist

start_monitor

Start automatic copy trading loop

stop_monitor

Stop monitoring

backtest_trader

Simulate copying a trader's past trades

Tool

Description

get_balance

Account balance, budget, and P&L

get_portfolio

Multi-wallet overview with P&L per trader

get_positions

Open/closed positions

close_position

Manually close a position

set_exit_rules

Set stop-loss and take-profit levels

log_cycle

Log agent cycle for dashboard

SmartFlow

+-------+

POST

MCP protocol endpoint (Streamable HTTP transport)

GET

Server info with version and endpoint list

COPY_MODE

No

DAILY_BUDGET

No