{
  "protocolVersion": "0.3.0",
  "name": "Polyman Agent API",
  "description": "Agent trading infrastructure for Polymarket prediction markets: whale signals rebuilt every 60s from realtime on-chain fill data, AI-scored trader intelligence with per-category grades, live CLOB prices, and builder-attributed order execution with hard safety caps (simulate-by-default, $1,000/order and $5,000/day launch ceilings, no fund-egress endpoints).",
  "url": "https://api.polyman.fun/mcp",
  "preferredTransport": "mcp+streamable-http",
  "additionalInterfaces": [
    {
      "transport": "rest",
      "url": "https://api.polyman.fun/v1",
      "openapi": "https://api.polyman.fun/v1/openapi.json"
    }
  ],
  "provider": {
    "organization": "Polyman",
    "url": "https://www.polyman.fun"
  },
  "documentationUrl": "https://www.polyman.fun/developers",
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "securitySchemes": {
    "apiKey": {
      "type": "http",
      "scheme": "bearer",
      "description": "Polyman Agent API key (pm_live_...) as 'Authorization: Bearer'. Created at polyman.fun (Portfolio -> Developer). Read-only MCP access works unauthenticated at 30 req/min per IP."
    }
  },
  "defaultInputModes": ["application/json"],
  "defaultOutputModes": ["application/json"],
  "skills": [
    {
      "id": "market-data",
      "name": "Prediction market data",
      "description": "Search and list active Polymarket markets with parsed outcomes, live CLOB midpoint prices (0-1 scale), volume and liquidity.",
      "tags": ["prediction-markets", "polymarket", "prices"]
    },
    {
      "id": "whale-signals",
      "name": "Whale signals",
      "description": "What top Polymarket traders just bought — position values, entry/current prices and a 0-100 trending score, rebuilt every 60 seconds from realtime on-chain fill data.",
      "tags": ["signals", "whales", "copy-trading"]
    },
    {
      "id": "trader-intelligence",
      "name": "Trader intelligence",
      "description": "AI-scored trader leaderboard (0-100, TRADE/CAUTION/AVOID) with per-category grades, win rates, and PnL that matches Polymarket's own profile display.",
      "tags": ["traders", "leaderboard", "analytics"]
    },
    {
      "id": "order-execution",
      "name": "Capped order execution",
      "description": "Place builder-attributed Polymarket orders with hard per-order and daily caps, simulate-by-default, and idempotency. Requires a 2FA-gated trade-scoped key.",
      "tags": ["trading", "orders", "execution"]
    }
  ]
}
