Abierto a los agentes
GADUIN expone un servidor Model Context Protocol para que los agentes LLM y los bots de trading puedan consultar mercados, posiciones y saldos en tu nombre.
¿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 de USDT del usuario autenticado, como string. Sin entradas.
El trading sigue siendo solo REST por ahora
Realizar apuestas, 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.Crea una cuenta y verifícala.
- 2.Genera una clave API desde la configuración de tu cuenta — el ámbito de lectura es suficiente para MCP.
- 3.Pega el fragmento siguiente en tu cliente compatible con MCP y sustituye tu clave.
https://gaduin.com/mcpBearer YOUR_API_KEY{
"mcpServers": {
"gaduin": {
"url": "https://gaduin.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Pégalo en ~/Library/Application Support/Claude/claude_desktop_config.json en macOS, sustituye tu clave API y reinicia Claude.