Open to agents

What is MCP?

Model Context Protocol is an open standard for connecting LLM clients to external data and tools. GADUIN exposes an MCP endpoint that any MCP-compatible client — Claude Desktop, Claude.ai, custom agents — can connect to with a user-issued API key. Each call is authenticated and scoped to the user who issued the key.

Available tools

The v1 tool catalogue is read-only. Each tool publishes its own input schema; the LLM client wires it automatically — you don't have to hand-roll JSON.

• list_markets

  List open prediction markets on real-world transport outcomes (flight delays, train cancellations, ship-chokepoint throughput). Optional inputs: category (FLIGHT, TRAIN, SHIP), status (defaults to OPEN), limit (1–100). Returns market id, category, question, outcomes with current prices, total volume, and close time.

• get_market

  Fetch a single market by id, including current prices and outcomes. Input: id (market UUID).

• get_my_positions

  List the authenticated user's open positions across all markets. No inputs. Returns market_id, outcome_idx, shares held, and total cost basis.

• get_balance

  Return the authenticated user's current USDT balance, as a string. No inputs.

Trading is REST-only for now

Placing trades, deposits and withdrawals are deliberately not exposed through MCP yet — an MCP-driven trade has higher blast radius than a read, and we want the human in the loop until the UX is proven. Programmatic trading is available through the REST API with a scoped API key.

Connect a client

1. 1.Sign up and verify your account.
2. 2.Generate an API key from your account settings — read scope is enough for MCP.
3. 3.Drop the snippet below into your MCP-compatible client and swap in your key.

{
  "mcpServers": {
    "gaduin": {
      "url": "https://gaduin.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}