एजेंट्स के लिए खुला

MCP क्या है?

Model Context Protocol LLM क्लाइंट्स को बाहरी डेटा और टूल्स से जोड़ने के लिए एक ओपन स्टैंडर्ड है। GADUIN एक MCP एंडपॉइंट उपलब्ध कराता है, जिससे कोई भी MCP-कम्पैटिबल क्लाइंट — Claude Desktop, Claude.ai, कस्टम एजेंट — उपयोगकर्ता द्वारा जारी की गई API कुंजी के साथ कनेक्ट कर सकता है। हर कॉल प्रमाणित होती है और उसी उपयोगकर्ता तक सीमित होती है जिसने कुंजी जारी की है।

उपलब्ध टूल्स

v1 टूल कैटलॉग केवल-पढ़ने योग्य है। हर टूल अपना इनपुट स्कीमा खुद प्रकाशित करता है और LLM क्लाइंट उसे स्वचालित रूप से वायर कर लेता है — आपको हाथ से JSON लिखने की ज़रूरत नहीं।

• list_markets

  वास्तविक परिवहन परिणामों (उड़ान देरी, ट्रेन रद्दीकरण, समुद्री चोकपॉइंट थ्रूपुट) पर खुले प्रेडिक्शन मार्केट्स सूचीबद्ध करता है। वैकल्पिक इनपुट: category (FLIGHT, TRAIN, SHIP), status (डिफ़ॉल्ट OPEN), limit (1–100)। मार्केट id, श्रेणी, सवाल, मौजूदा कीमतों के साथ परिणाम, कुल वॉल्यूम और क्लोज़ टाइम लौटाता है।

• get_market

  id से एक मार्केट लाता है, मौजूदा भाव और परिणामों सहित। इनपुट: id (मार्केट UUID)।

• get_my_positions

  सभी मार्केट्स में प्रमाणित उपयोगकर्ता की खुली पोज़िशन्स सूचीबद्ध करता है। कोई इनपुट नहीं। market_id, outcome_idx, धारित शेयर्स और कुल कॉस्ट बेसिस लौटाता है।

• get_balance

  प्रमाणित उपयोगकर्ता का मौजूदा डॉलर बैलेंस string के रूप में लौटाता है। कोई इनपुट नहीं।

ट्रेडिंग फ़िलहाल केवल REST के माध्यम से

ट्रेड करना, जमा करना और निकासी जानबूझकर अभी MCP से उपलब्ध नहीं हैं — MCP-संचालित ट्रेड का जोखिम पढ़ने से अधिक है, और हम चाहते हैं कि UX सिद्ध होने तक मनुष्य लूप में रहे। प्रोग्रामेटिक ट्रेडिंग सीमित स्कोप वाली API कुंजी के साथ REST API के माध्यम से उपलब्ध है।

क्लाइंट कनेक्ट करें

1. 1.साइन अप करें और अपना खाता सत्यापित करें।
2. 2.अपनी खाता सेटिंग्स से एक API कुंजी जनरेट करें — MCP के लिए read स्कोप पर्याप्त है।
3. 3.नीचे दिया गया स्निपेट अपने MCP-कम्पैटिबल क्लाइंट में पेस्ट करें और अपनी कुंजी डालें।

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

Endpoint reference

Prefer to wire things up directly? The Model Context Protocol endpoint and the anonymous, read-only REST API are below — the same markets, order books, and prices the site and the MCP server serve.

• GET /markets

  List open markets. Filter by category (FLIGHT, TRAIN, SHIP) and status, and page through results with limit and cursor.

• GET /markets/{id}

  Fetch a single market by id, including its settlement source and evidence.

• GET /markets/{id}/book

  Order-book snapshot for a market.

• GET /markets/{id}/trades

  Recent trades for a market.

• GET /markets/{id}/price-history

  Historical price snapshots for a market.

• GET /markets/positions

  Live aggregate positions across every market.

• GET /markets/config

  Trading bounds — the minimum and maximum trade amount.

• GET /healthz

  Liveness probe.

Machine-readable discovery

Agents don't have to scrape this page. Every capability above is also described in a standards-based document served from the site root, so an MCP- or OpenAPI-aware client can discover the markets, the API, and how to authenticate on its own.

• /.well-known/mcp/server-card.json

  MCP Server Card (SEP-1649) — the Model Context Protocol endpoint, its transport, and how to authenticate.

• /.well-known/openapi.json

  OpenAPI 3.1 description of the anonymous, read-only REST API.

• /.well-known/api-catalog

  API Catalog (RFC 9727) — the linkset that ties every machine-readable surface together.

• /.well-known/oauth-protected-resource

  OAuth 2.0 Protected Resource Metadata (RFC 9728) — which authorization server issues API tokens, and the scopes they carry.

• /.well-known/oauth-authorization-server

  OAuth 2.0 Authorization Server Metadata (RFC 8414) — the issuer, token endpoint, and the API-key-to-token grant.

• /.well-known/agent-skills/index.json

  Agent Skills index — the SKILL.md guides an agent can fetch to learn how to work with the platform, each pinned by digest.

• /api/md

  Markdown rendering of any public page, via content negotiation (send Accept: text/markdown).

• /auth.md

  A human- and agent-readable walk-through of authenticating and minting a scoped API key.