# Loterías API

> Loterías API is a freemium MCP server for gaming information. MCP server giving AI assistants access to Spanish lottery results, draws and number checks. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://loteriasapi.com/para-ia
- **MCP Registry name:** com.loteriasapi/loterias
- **Categories:** [gaming information](https://ai-powered.com/categories/gaming-information)
- **Listing updated:** 2026-11-19

## About

The README and page describe a remote MCP endpoint that lets Claude, ChatGPT, Codex and other MCP clients query official Spanish lottery results. Covered games include Euromillones, La Primitiva, Bonoloto, El Gordo, Lotería Nacional, EuroDreams, La Quiniela, Quinigol, Lototurf and Quíntuple Plus.

Without an API key the server returns the three most recent draws per game, the next draw with its jackpot, number checks against those recent draws, and aggregated statistics. Adding a key from the account panel unlocks historical search by date, year or minimum jackpot, full prize breakdowns for specific draws, and frequency and pattern statistics, within the limits of the user's plan.

It suits developers wiring lottery data into agents and people who want to ask an assistant about past results or check a ticket. All tools are read-only, and the site states the assistant cannot predict draws.

## Features

- **Official draw results:** Returns recent results for the major Spanish lottery games, with the latest draws available without a key.
- **Ticket number checking:** Compares played numbers against draws and reports which prize, if any, they match.
- **Next draw and jackpot:** Shows the date and current prize pool of the upcoming draw for each game.
- **Historical search:** With an API key, searches past draws by date range, year or minimum jackpot, with paging.
- **Statistics and patterns:** Provides number frequencies, jackpot history and pattern breakdowns such as odd/even and sums.
- **Read-only tools:** All exposed tools only read data and do not create, change or delete anything in the user's account.

## Good for

- Asking an AI assistant what the latest Euromillones or Primitiva combination was
- Checking whether a played set of numbers or a Lotería Nacional décimo won a prize
- Finding the next El Gordo draw date and current jackpot
- Analysing historical jackpots or number frequencies for a given year
- Adding Spanish lottery data to an agent or application through MCP

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.loteriasapi.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "loterias": {
      "url": "https://api.loteriasapi.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "loterias": {
      "type": "http",
      "url": "https://api.loteriasapi.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "loterias": {
      "serverUrl": "https://api.loteriasapi.com/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://api.loteriasapi.com/mcp
```

Enter a Name (for example "Loterías API"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "loterias": {
      "type": "http",
      "url": "https://api.loteriasapi.com/mcp"
    }
  }
}
```

## Tools

All 5 tools say they're read-only. From the server's own tool annotations; not verified by us.

- `list_games` (says read-only): List the Spanish state lottery games covered (slug and name). Use the slug as the "game" argument of the other tools.
- `get_latest_results` (says read-only): Get the most recent official results (draw date, winning combination, complementary numbers and jackpot when applicable) of one game, newest first. Use it for questions like "what were the last Euromillones numbers?". Returns up to the 3 most recent draws.
- `get_next_draw` (says read-only): Get the next scheduled draw of one game: date, status and announced jackpot when available. Use it for "when is the next Primitiva draw and how much is the jackpot?".
- `check_numbers` (says read-only): Check whether a set of numbers won in one of the 3 most recent draws of a game (default: the latest). For "nacional" the numbers are décimo numbers (up to 5 digits, at most 5, pass them as strings to keep leading zeros, e.g. "01755"). For the other games pass the main numbers and, when the game has them, the extra numbers (stars, reintegro, clave...). Returns matches, whether it is a winner and th
- `get_public_statistics` (says read-only): Aggregated statistics of a game over its last 2000 draws: most and least frequent numbers, longest absences, even/odd split, sum range and top pairs. Available for: primitiva, bonoloto, euromillones, gordo, eurodreams, lototurf. Covers the last 2000 draws only; no per-number tables or custom periods.

## FAQ

### Do I need an API key to use the MCP?

No. Without a key the server provides the last three draws per game, the next draw, number checks against those draws and aggregated statistics. A key unlocks historical and full statistics according to the plan.

### How many requests does each question use?

Each tool call uses one request from the plan. list_games and get_next_draw are free, failed calls are not counted, and check_numbers with a date uses two.

### Can the MCP predict lottery numbers?

No. The site states that no AI can predict a draw, since every combination has the same probability. The server only returns real results and statistics.

### What are the rate limits?

Without a key the limit is 60 calls per minute per IP. With a key it is 300 per minute per key, plus per-request draw and history limits set by the plan.

### Is Loterías API free?

Loterías API has a free plan, with paid plans for more usage or features.

### How do I add Loterías API to Claude Code?

Run this command in your terminal: claude mcp add --transport http loterias https://api.loteriasapi.com/mcp

### What are the best alternatives to Loterías API?

The closest alternatives to Loterías API are 符文戰場新手指南, 遊戲發售日與預告片資料庫, MCP, Roblox Popular Games Search and Open Hangar.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [符文戰場新手指南](https://ai-powered.com/mcp/listing-39): 符文戰場新手指南 is an MCP server for gaming information.
- [遊戲發售日與預告片資料庫](https://ai-powered.com/mcp/listing-44): 遊戲發售日與預告片資料庫 is an MCP server for gaming information.
- [MCP](https://ai-powered.com/mcp/mcp-mwmse76g): MCP is an open-source MCP server for crypto and web3.
- [Roblox Popular Games Search](https://ai-powered.com/mcp/roblox-popular-games-search): Roblox Popular Games Search is a paid MCP server for gaming information.
- [Open Hangar](https://ai-powered.com/mcp/open-hangar): Open Hangar is a free MCP server for gaming information.
- [RipSeek](https://ai-powered.com/mcp/ripseek): RipSeek is a free MCP server for gaming information.
- [Insights Royale](https://ai-powered.com/mcp/insights-royale): Insights Royale is an MCP server for gaming information.
- [AniList](https://ai-powered.com/mcp/anilist-2): AniList is an open-source MCP server for gaming information.

---
Source: https://ai-powered.com/mcp/loterias-api
