Saltar al contenido

MCP de loterías de España para Claude, ChatGPT y Codex

Loteria API tiene un servidor MCP gratuito en https://api.loteriasapi.com/mcp que conecta Claude, ChatGPT, Codex u otro agente de IA con los resultados oficiales de las loterías de España: Euromillones, La Primitiva, Bonoloto, El Gordo, Lotería Nacional y más. Sin API key da los 3 últimos sorteos y comprueba números; con key, el histórico y las estadísticas de tu plan.

Conecta tu agente al servidor MCP de Loteria API y pregúntale por los resultados de Euromillones, La Primitiva, Bonoloto, El Gordo, Lotería Nacional, EuroDreams, La Quiniela, Quinigol, Lototurf o Quíntuple Plus. El agente consulta los datos oficiales y te contesta: «¿qué salió ayer en la Primitiva?», «¿he acertado con estos números?», «¿qué números han salido más este año?».

URL del servidorhttps://api.loteriasapi.com/mcp

Dos modos: gratis o con tu API key

Sin API key (gratis)

  • Los 3 últimos sorteos de cada juego.
  • El próximo sorteo y su bote.
  • Comprobar números contra los 3 últimos sorteos.
  • Estadísticas agregadas.
  • 60 llamadas por minuto por IP.

Con API key (tu plan)

  • Histórico según tu plan: buscar por fechas, año o bote mínimo.
  • El sorteo de un día concreto con todos sus premios.
  • Comprobar números en cualquier sorteo, por fecha o por identificador.
  • Estadísticas, frecuencias de números, historial de botes y patrones.
  • Cada llamada gasta 1 petición del plan; 300 por minuto por key.

Cómo conectarlo

Claude Code

Sin key:

claude mcp add --transport http loterias https://api.loteriasapi.com/mcp

Con tu API key (la creas en el panel, en API keys):

claude mcp add --transport http loterias https://api.loteriasapi.com/mcp \
  --header "X-API-Key: $LOTERIAS_API_KEY"

API de Claude (conector MCP)

Pasa el servidor en mcp_servers con tu key en authorization_token (llega como Authorization: Bearer) y la cabecera anthropic-beta: mcp-client-2025-11-20:

{
  "model": "claude-opus-5-5",
  "max_tokens": 1024,
  "messages": [
    { "role": "user", "content": "¿Qué salió en el último Euromillones?" }
  ],
  "mcp_servers": [
    {
      "type": "url",
      "url": "https://api.loteriasapi.com/mcp",
      "name": "loterias",
      "authorization_token": "lat_..."
    }
  ],
  "tools": [{ "type": "mcp_toolset", "mcp_server_name": "loterias" }]
}

claude.ai

Añade un conector personalizado con la URL https://api.loteriasapi.com/mcp. Funciona en modo gratuito: los conectores de claude.ai todavía no permiten enviar una API key.

Codex

Sin key:

codex mcp add loterias --url https://api.loteriasapi.com/mcp

Con tu API key, que Codex envía como Authorization: Bearer:

export LOTERIAS_API_KEY=lat_...
codex mcp add loterias --url https://api.loteriasapi.com/mcp --bearer-token-env-var LOTERIAS_API_KEY

O en ~/.codex/config.toml:

[mcp_servers.loterias]
url = "https://api.loteriasapi.com/mcp"
bearer_token_env_var = "LOTERIAS_API_KEY"

ChatGPT

Añade un conector personalizado (servidor MCP remoto) con la URL https://api.loteriasapi.com/mcp y sin autenticación. Funciona en modo gratuito; según tu plan, puede que tengas que activar antes el modo desarrollador en los ajustes de conectores.

Cualquier otro cliente MCP

El servidor usa el transporte Streamable HTTP sin estado. Envía la key en la cabecera X-API-Key: lat_... o Authorization: Bearer lat_.... Sin cabecera, el cliente entra en modo gratuito. Configuración para Cursor, VS Code y el detalle de cada herramienta en la referencia del servidor MCP.

¿No programas y solo quieres preguntar a tu IA por la lotería? Mira cómo comprobar la lotería con ChatGPT o Claude.

Herramientas

HerramientaQué haceSin key
list_gamesLista los juegos y sus identificadores.Sí
get_latest_resultsÚltimos resultados de un juego.Sí
get_next_drawPróximo sorteo, fecha y bote.Sí
check_numbersComprueba tus números o tu décimo y dice qué premio tienen.Sí
get_public_statisticsEstadísticas agregadas de un juego.Sí
search_resultsBusca sorteos por fechas, año o bote mínimo, con páginas.No
get_result_by_dateEl sorteo de un día, con todos sus premios.No
get_statisticsEstadísticas completas de un juego, por año.No
get_number_frequenciesCuántas veces ha salido cada número.No
get_jackpot_historyHistorial de botes.No
get_patternsPatrones: pares e impares, altos y bajos, sumas, consecutivos.No

Sin key, get_latest_results devuelve hasta 3 sorteos y check_numbers solo mira los 3 últimos; las estadísticas se dan agregadas con get_public_statistics.

Preguntas que puedes hacer a tu agente

  • ¿Cuál fue la combinación ganadora del último Euromillones?
  • He jugado 4, 12, 23, 31, 40 y 45 en la Primitiva del sábado, ¿he ganado algo?
  • ¿Cuándo es el próximo sorteo de El Gordo y cuánto es el bote?
  • Dame los botes de Euromillones de más de 100 millones de este año.
  • ¿Qué números han salido más en la Bonoloto en 2025?
  • ¿Ha tocado algo mi décimo 01755 de la Lotería Nacional del jueves?

Preguntas frecuentes

¿Necesito una API key para usar el MCP?

No para probarlo: sin key el MCP da gratis los 3 últimos sorteos de cada juego, el próximo sorteo y estadísticas agregadas. Con una API key tu agente consulta el histórico, busca por fechas o bote y accede a todas las estadísticas, según tu plan.

¿Cuántas peticiones gasta cada pregunta al agente?

Cada llamada a una herramienta gasta 1 petición de tu plan, igual que la API REST. list_games y get_next_draw son gratis, las llamadas que fallan no cuentan y check_numbers con una fecha gasta 2. Una pregunta normal suele necesitar 1 o 2 llamadas.

¿Funciona con claude.ai?

Sí, en modo gratuito: añade un conector personalizado con la URL del MCP. Los conectores de claude.ai todavía no permiten enviar una API key en una cabecera, así que el modo con key se usa desde Claude Code, la API de Claude o cualquier cliente MCP que permita cabeceras.

¿Funciona con ChatGPT?

Sí, en modo gratuito: añade el MCP como conector personalizado con la URL https://api.loteriasapi.com/mcp y sin autenticación. ChatGPT no permite enviar una API key en una cabecera, así que el histórico y las estadísticas completas se usan desde Codex, Claude Code o la API.

¿Cómo lo uso con Codex?

Con codex mcp add loterias --url https://api.loteriasapi.com/mcp. Para el modo con key, guarda tu key en la variable LOTERIAS_API_KEY y añade --bearer-token-env-var LOTERIAS_API_KEY, o ponlo en config.toml con bearer_token_env_var.

¿La IA puede predecir los números que van a salir?

No. Ninguna IA puede predecir un sorteo: cada combinación tiene la misma probabilidad. El MCP sirve para consultar resultados reales, comprobar tus números y ver estadísticas de lo que ya ha salido.

¿Qué límites tiene?

Sin key, 60 llamadas por minuto por IP. Con key, 300 por minuto por key, además del máximo de sorteos por petición y los días de histórico de tu plan. Cada respuesta incluye un objeto plan con el plan y las peticiones que te quedan.

¿El MCP puede modificar algo de mi cuenta?

No. Todas las herramientas son de solo lectura: consultan resultados, sorteos y estadísticas. No crean, cambian ni borran nada.

Dale datos de loterías a tu agente

Crea tu cuenta, genera una API key y conéctala al MCP. El plan Free incluye 50 peticiones para probar.

Crear cuenta gratis

¿Prefieres la API REST? Primeros pasos