Skip to main content

Servidor MCP oficialServidor MCP de Odds API
para tu asistente de IA

Conecta Claude, Codex, Cursor o VS Code a cuotas en vivo e históricas de 450+ casas de apuestas. Pide precios, movimientos de línea, apuestas de valor o resultados de apuestas con tus propias palabras, o deja que tu asistente escriba el código.

Gratis y de código abierto · 33 herramientas · npm, Docker e instalación en un clic para Claude Desktop

Configuración

Conectado en menos de un minuto

  1. Consigue una clave API

    Elige un plan y tus casas de apuestas. Tu clave aparece en el panel en cuanto se confirma el pago.

  2. Añade el servidor a tu herramienta de IA

    Pega un comando o un bloque JSON. El servidor se ejecuta en tu propio equipo con npx o Docker y lee la clave de una variable de entorno.

  3. Pregunta con tus propias palabras

    Tu asistente elige las herramientas adecuadas, llama a la API y responde con precios en vivo. También puede escribir y probar código con los mismos datos.

Ejecútalo en tu terminal
claude mcp add odds-api \
  --env ODDS_API_KEY="your-api-key" \
  -- npx -y odds-api-mcp-server

¿Usas Claude Desktop? Descarga el archivo .mcpb de la última versión y ábrelo. Claude te pide la clave y se encarga del resto.

Ejemplos

Qué puedes preguntar

Preguntas reales, respondidas con datos en vivo. Debajo de cada una aparecen las herramientas que usa el asistente para responder.

  • ¿Qué partidos de la Premier League de este fin de semana tienen la mayor diferencia entre Bet365 y Unibet en el resultado final?

    get_eventsget_multi_odds
  • ¿Cómo se ha movido desde ayer en Bet365 la cuota de Más de 2,5 goles del Arsenal-Chelsea?

    search_eventsget_odds_movements
  • ¿Qué cuotas de la NBA están cayendo más rápido esta noche?

    get_dropping_odds
  • Enumera las apuestas de valor de Betano ahora mismo, ordenadas por valor esperado.

    get_value_bets
  • Ayer aposté al Liverpool -1 hándicap asiático y a Más de 2,5 goles en su partido de Premier League. ¿Gané las apuestas?

    get_historical_eventsgrade_bets
  • Escribe un script en Python que envíe un mensaje de Telegram cuando aparezca un arbitraje de más del 2% entre mis casas de apuestas.

    get_documentationget_arbitrage_bets
Herramientas

33 herramientas, toda la API

Las herramientas cubren toda la API v3, así que lo que tu asistente encuentre en el chat funciona igual en tu código.

Cuotas

get_odds
Todos los mercados de un evento en hasta 30 casas de apuestas
get_multi_odds
Cuotas de hasta 10 eventos en una sola llamada
get_updated_odds
Solo las cuotas que cambiaron desde una marca de tiempo
get_odds_summary
Precio mejor, medio, peor y justo por línea entre casas
get_odds_movements
Historial de precios de una línea en una casa de apuestas
get_dropping_odds
Las líneas que más cayeron desde la apertura, por deporte y liga

Eventos

get_events
Partidos por deporte, liga, equipo, fecha o estado
get_event
Un evento por su id
get_live_events
Todos los eventos en juego ahora mismo
search_events
Busca un evento por nombre de equipo

Herramientas de apuestas

get_value_bets
Precios con valor esperado positivo en una casa de apuestas
get_arbitrage_bets
Oportunidades de arbitraje entre tus casas de apuestas

Historial y liquidación

get_historical_events
Eventos terminados por deporte, liga y fecha
search_historical_events
Busca un evento terminado por nombre de equipo
get_historical_odds
Cuotas de cierre y marcador final de un evento terminado
get_closing_lines
Líneas de cierre de hasta 10 ligas de una vez
get_settlements
Estado y marcador final por periodo de hasta 50 eventos
grade_bets
Liquida hasta 50 apuestas como ganadas, perdidas, nulas o a medias

Outrights de golf

list_outrights
Torneos por circuito, con cuántas casas ofrecen precios en cada uno
get_outright_odds
Cuotas de ganador, Top 5/10/20 y pasar el corte de un torneo
get_outright_results
Posiciones finales y ganadores de cada mercado

Referencia

get_sports
Todos los deportes y su slug
get_leagues
Ligas de un deporte con el número de eventos
get_markets
Nombres exactos de mercados por deporte, prepartido y en vivo
get_bookmakers
Todas las casas de apuestas y si están activas
get_participants
Equipos y jugadores de un deporte
get_participant
Un equipo o jugador por su id
get_mappings
Los ids propios de una casa para nuestros eventos y selecciones

Tu cuenta y la documentación

get_selected_bookmakers
Las casas de apuestas de tu plan
select_bookmakers
Añade casas de apuestas a tu selección
clear_selected_bookmakers
Reinicia tu selección, una vez cada 12 horas
get_usage
Tu límite por hora, solicitudes restantes y hora de reinicio
get_documentation
La documentación completa de la API, para que el código funcione a la primera
Cómo funciona

Se ejecuta en tu equipo y lee la API en vivo

Tu clave se queda en tu equipo

El servidor se ejecuta en local por stdio y habla directamente con api.odds-api.io. No hay nada en medio, y la clave vive en tu configuración MCP.

Los mismos datos que la API

450+ casas de apuestas y 34 deportes, prepartido y en vivo, en un solo esquema JSON. Lo que ve tu asistente es lo que recibirá tu código.

Documentación que tu asistente puede leer

El servidor incluye la documentación completa y la especificación OpenAPI como recursos MCP. Cuando pides código, el asistente comprueba antes los nombres reales de los campos.

Incluido en todos los planes

El servidor MCP es gratuito y de código abierto. Las llamadas a herramientas son solicitudes normales a la API y cuentan para tus 5.000 solicitudes/hora.

Preguntas frecuentes

Preguntas sobre el servidor MCP

¿Qué es el servidor MCP de Odds API?

Es el servidor oficial de Model Context Protocol de Odds-API.io. Da a asistentes de IA como Claude, Codex y Cursor 33 herramientas para leer cuotas en vivo e históricas, eventos, apuestas de valor, arbitraje y resultados de apuestas de 450+ casas de apuestas.

¿Con qué herramientas de IA funciona?

Con cualquier cliente compatible con MCP por stdio. Eso incluye Claude Code, Claude Desktop, Codex, Cursor, VS Code con GitHub Copilot, Windsurf y Zed. Claude Desktop tiene además un archivo de instalación en un clic.

¿Necesito un plan de pago?

Sí. El servidor necesita una clave API, y las claves vienen con todos los planes de pago, desde Solo a 49 £/mes con 2 casas de apuestas. El servidor MCP en sí no cuesta nada más.

¿Qué casas de apuestas puede ver mi asistente?

Las casas seleccionadas en tu plan. Pide al asistente que ejecute get_selected_bookmakers para verlas. Los datos de referencia, como deportes, ligas y eventos, están disponibles para todas las casas.

¿Funciona con cuotas en vivo?

Sí. get_live_events lista los partidos en juego y get_odds devuelve sus precios actuales. Para recibir un stream en tu propia app, usa la API WebSocket. El asistente puede escribir ese código por ti.

¿Está segura mi clave API?

El servidor se ejecuta en tu ordenador y solo envía la clave a api.odds-api.io. No hay ningún proxy alojado. El código es abierto y está en GitHub con licencia MIT.

¿Puede el asistente hacer apuestas?

No. El servidor solo lee datos. No puede iniciar sesión en una casa de apuestas ni hacer una apuesta.

¿En qué se diferencia de la documentación en llms.txt?

llms.txt da al asistente la documentación para que pueda escribir código. El servidor MCP le permite llamar a la API y trabajar con datos en vivo mientras chateas. La mayoría de la gente usa ambos.

Dale cuotas en vivo a tu asistente

Todos los planes incluyen el servidor MCP, 5.000 solicitudes/hora y todos los deportes y mercados. Paga mensual o anualmente y cancela cualquier mes.