polymarket-odds-mcp

Fetches live Polymarket prediction market orderbooks, implied Yes/No probabilities, volume, and whale sentiment for macro/crypto/AI events. WHEN TO USE: Call `get_polymarket_prediction_odds` when your task requires deterministic `polymarket-odds` analysis for `topic`; use `get_agent_wallet_status` to check your remaining free trial quota or prepaid balance. WHEN NOT TO USE: Do not use for unrelated domains or binary media. PARAMETER INTERACTIONS: Pass the target `topic` as a non-empty string; omit `agent_id` and `tx_hash` during your 5 free trial calls, or supply `agent_id` (`agd_pass_...`) / `tx_hash` for paid execution. Read-only and idempotent; results are cached for 1 hour (<5ms cache hit). $0.01 per call. Pricing: the first 5 calls per agent_id are free and failed calls are never charged. After 5 calls, the tool returns a payment-required quote (not a fatal error) with a $2 Stripe top-up link and Base/Solana USDC addresses; complete payment, then retry with your agd_pass_ key in agent_id or pass tx_hash. Example: get_polymarket_prediction_odds(topic='example')

{
  "type": "object",
  "properties": {
    "topic": {
      "minLength": 1,
      "maxLength": 99999,
      "type": "string",
      "description": "Prediction market topic, event keyword, or question to query live Polymarket odds."
    },
    "agent_id": {
      "minLength": 1,
      "maxLength": 256,
      "type": "string",
      "description": "Optional agent identifier or prepaid agd_pass_ session key. Omit during your 5 free trial calls to use an ID automatically derived from your client IP, or pass your agd_pass_ key after topping up."
    },
    "tx_hash": {
      "minLength": 10,
      "maxLength": 256,
      "type": "string",
      "description": "Optional on-chain Base Mainnet (0x...) or Solana SPL USDC transaction hash. Omit unless settling an individual call directly on-chain instead of using an agd_pass_ key in agent_id."
    }
  },
  "required": [
    "topic"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "topic": "example"
    }
  ]
}

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "description": "Execution status ('ok' or 'payment_required')."
    },
    "data": {
      "type": "object",
      "description": "Structured tool output payload."
    },
    "roi_proof": {
      "type": "object",
      "description": "Token compression and cost-savings verification metrics."
    }
  },
  "required": [
    "status"
  ]
}

Inspect an agent's account ledger: remaining free trial calls (out of 5), prepaid USD balance, cumulative spend, total API calls, and total LLM tokens saved. WHEN TO USE: Call before a batch of paid tool executions or after completing a Stripe or USDC top-up to confirm your balance. WHEN NOT TO USE: Do not use to process web content, execute marketplace tools, or submit payments; use the other tools on this server for execution. PARAMETER INTERACTIONS: Omit agent_id to inspect the default trial account derived from your client IP, or pass your explicit agent_id or agd_pass_ session key to check a specific funded wallet. Free and read-only: never charges a fee or consumes a free trial call. Example: get_agent_wallet_status(agent_id='example')

{
  "type": "object",
  "properties": {
    "agent_id": {
      "minLength": 1,
      "maxLength": 256,
      "type": "string",
      "description": "Optional Agent ID or agd_pass_ session key to inspect. Omit to check the default wallet derived from your client IP."
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "agent_id": "example"
    }
  ]
}

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "description": "Execution status ('ok' or 'payment_required')."
    },
    "data": {
      "type": "object",
      "description": "Structured tool output payload."
    },
    "roi_proof": {
      "type": "object",
      "description": "Token compression and cost-savings verification metrics."
    }
  },
  "required": [
    "status"
  ]
}