Model Context Protocol

PredCopy MCP server

Plug PredCopy into Claude Desktop, Cursor, or any MCP-compatible client. Your AI agent can browse Polymarket whales, inspect their positions, and copy-trade them on your behalf, all from a single prompt.

PredCopy hosts a remote MCP server at https://predcopy.com/mcp. No install, no npm. Add the URL plus your PredCopy API key to your MCP client config and your agent gets nine tools: list_top_traders, get_trader, get_wallet_activity, list_my_wallets, add_wallet, start_copy, stop_copy, list_positions, list_pnl.

What the agent can do

  • "Find me the top 5 politics whales on Polymarket with >70% win rate"
  • "Add wallet 0xfedc… to my watchlist and start copying it in paper mode at 5% bet size"
  • "Show me my open paper positions and rank them by unrealized P&L"
  • "Stop copying any wallet flagged as a market maker"

1. Get your API key

Sign in at /dashboard/settings, scroll to API Key, click Generate. Copy the pc_… value, you only see it once.

2. Add to Claude Desktop

Open ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or %APPDATA%\Claude\claude_desktop_config.json on Windows, and add:

json
{
  "mcpServers": {
    "predcopy": {
      "url": "https://predcopy.com/api/mcp",
      "headers": {
        "Authorization": "Bearer pc_xxx"
      }
    }
  }
}

Restart Claude Desktop. The PredCopy tools show up in the tool picker. No npm install, no version pinning — updates ship automatically as soon as we deploy.

3. Or add to Cursor

Drop the same block into .cursor/mcp.json in your project root, or paste it into Cursor settings under MCP Servers.

Quick test with curl

Confirm the server sees you and your tools without leaving the terminal:

bash
# List available tools
curl https://predcopy.com/api/mcp \
  -H "Authorization: Bearer pc_xxx" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Call list_top_traders for crypto
curl https://predcopy.com/api/mcp \
  -H "Authorization: Bearer pc_xxx" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_top_traders","arguments":{"category":"crypto","limit":5}}}'

Tools the server exposes

ToolDescription
list_top_tradersTop traders by PolyCopy score, optionally filtered by category.
get_traderSingle trader profile by wallet address.
get_wallet_activityLast-24h activity + market-maker classification.
list_my_walletsWallets the user is currently watching.
add_walletAdd a Polymarket wallet to the watchlist.
start_copyStart copying a watched wallet (paper or live).
stop_copyStop copying a watched wallet.
list_positionsOpen positions with unrealized P&L.
list_pnlPer-wallet closed-trade P&L attribution.

Default to paper mode

The start_copy tool defaults isPaper: true. To go live, the user must say so explicitly AND have a Pro subscription plus Polymarket API credentials configured at /dashboard/settings.

See also: Developers · docs.md · llms.txt