Abierto a los agentes

¿Qué es MCP?

Model Context Protocol es un estándar abierto para conectar clientes LLM a datos y herramientas externas. GADUIN expone un endpoint MCP al que cualquier cliente compatible — Claude Desktop, Claude.ai, agentes personalizados — puede conectarse usando una clave API emitida al usuario. Cada llamada se autentica y queda acotada al usuario que generó la clave.

Herramientas disponibles

El catálogo de herramientas v1 es de solo lectura. Cada herramienta publica su propio esquema de entrada y el cliente LLM lo cablea automáticamente — no tienes que escribir JSON a mano.

• list_markets

  Lista los mercados de predicción abiertos sobre resultados de transporte reales (retrasos de vuelos, cancelaciones de trenes, congestión en chokepoints marítimos). Entradas opcionales: category (FLIGHT, TRAIN, SHIP), status (por defecto OPEN), limit (1–100). Devuelve id de mercado, categoría, pregunta, resultados con precios actuales, volumen total y hora de cierre.

• get_market

  Obtiene un único mercado por id, incluyendo precios y resultados actuales. Entrada: id (UUID del mercado).

• get_my_positions

  Lista las posiciones abiertas del usuario autenticado en todos los mercados. Sin entradas. Devuelve market_id, outcome_idx, participaciones y coste base total.

• get_balance

  Devuelve el saldo actual en dólares del usuario autenticado, como string. Sin entradas.

El trading sigue siendo solo REST por ahora

Realizar operaciones, depósitos y retiradas no están expuestos todavía vía MCP — una operación dirigida por MCP tiene mayor radio de impacto que una lectura, y queremos al humano en el bucle hasta que la UX esté probada. El trading programático está disponible a través de la API REST con una clave API con permisos limitados.

Conecta un cliente

1. 1.Crea una cuenta y verifícala.
2. 2.Genera una clave API desde la configuración de tu cuenta — el ámbito de lectura es suficiente para MCP.
3. 3.Pega el fragmento siguiente en tu cliente compatible con MCP y sustituye tu clave.

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

Endpoint reference

¿Prefieres conectarlo todo directamente? Abajo están el endpoint del Model Context Protocol y la API REST anónima de solo lectura — los mismos mercados, libros de órdenes y precios que sirven el sitio y el servidor MCP.

• GET /markets

  Lista los mercados abiertos. Filtra por categoría (FLIGHT, TRAIN, SHIP) y por estado, y pagina los resultados con limit y cursor.

• GET /markets/{id}

  Obtén un único mercado por id, incluidas su regla de liquidación y sus pruebas.

• GET /markets/{id}/book

  Instantánea del libro de órdenes de un mercado.

• GET /markets/{id}/trades

  Operaciones recientes de un mercado.

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

  Instantáneas históricas de precios de un mercado.

• GET /markets/positions

  Posiciones agregadas en vivo en todos los mercados.

• GET /markets/config

  Límites de negociación — el importe mínimo y máximo por operación.

• GET /healthz

  Liveness probe.

Descubrimiento legible por máquinas

Los agentes no necesitan hacer scraping de esta página. Cada capacidad anterior también está descrita en un documento basado en estándares que se sirve desde la raíz del sitio, de modo que un cliente compatible con MCP u OpenAPI puede descubrir por sí solo los mercados, la API y cómo autenticarse.

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

  MCP Server Card (SEP-1649) — el endpoint del Model Context Protocol, su transporte y cómo autenticarse.

• /.well-known/openapi.json

  Descripción OpenAPI 3.1 de la API REST anónima de solo lectura.

• /.well-known/api-catalog

  API Catalog (RFC 9727) — el conjunto de enlaces que une todas las superficies legibles por máquinas.

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

  OAuth 2.0 Protected Resource Metadata (RFC 9728) — qué servidor de autorización emite los tokens de la API y qué ámbitos llevan.

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

  OAuth 2.0 Authorization Server Metadata (RFC 8414) — el emisor, el endpoint de tokens y la concesión de clave de API a token.

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

  Índice de Agent Skills — las guías SKILL.md que un agente puede descargar para aprender a trabajar con la plataforma, cada una fijada por digest.

• /api/md

  Renderizado en Markdown de cualquier página pública, mediante negociación de contenido (envía Accept: text/markdown).

• /auth.md

  Un recorrido legible por humanos y por agentes sobre cómo autenticarse y generar una clave de API con ámbito.