get_resultados
Retrieve lottery results for a specific date in YYYY-MM-DD format, or leave date empty to get the most recent results. Returns data from multiple lotteries.
Instructions
Obtiene los resultados de loterías para una fecha específica.
Consulta el endpoint `/results/{date}` de la API cuando se proporciona
una fecha, o `/results` para obtener los resultados más recientes.
Args:
date (str): Fecha en formato `YYYY-MM-DD` para filtrar los resultados.
Si se pasa una cadena vacía, retorna los resultados más recientes.
Returns:
dict[str, Any] | None: Diccionario con los resultados de loterías
para la fecha indicada, o None si ocurre un error de red o la API
no responde.
Example:
>>> await get_resultados("2026-04-24")
{"data": [{"lottery": "Lotería Nacional", "result": "1234", ...}]}Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- loteria.py:41-67 (handler)Handler for the 'get_resultados' tool. Accepts a date string (YYYY-MM-DD), calls the external lottery results API at /results/{date} or /results if empty, and returns the JSON response or None on error.
async def get_resultados(date: str) -> dict[str, Any] | None: """Obtiene los resultados de loterías para una fecha específica. Consulta el endpoint `/results/{date}` de la API cuando se proporciona una fecha, o `/results` para obtener los resultados más recientes. Args: date (str): Fecha en formato `YYYY-MM-DD` para filtrar los resultados. Si se pasa una cadena vacía, retorna los resultados más recientes. Returns: dict[str, Any] | None: Diccionario con los resultados de loterías para la fecha indicada, o None si ocurre un error de red o la API no responde. Example: >>> await get_resultados("2026-04-24") {"data": [{"lottery": "Lotería Nacional", "result": "1234", ...}]} """ if date: url = f"{API_BASE}results/{date}" else: url = f"{API_BASE}results" data = await call(url) return data - loteria.py:40-41 (registration)The @mcp.tool() decorator registers get_resultados as an MCP tool on the FastMCP server instance.
@mcp.tool() async def get_resultados(date: str) -> dict[str, Any] | None: - loteria.py:10-18 (helper)Helper function 'call' used by get_resultados to perform HTTP GET requests with a user-agent header and timeout, returning JSON or None on failure.
async def call(url: str) -> dict[str, Any] | None: headers = {"User-Agent": USER_AGENT, "Accept": "application/json"} async with httpx.AsyncClient() as client: try: response = await client.get(url, headers=headers, timeout=30.0) response.raise_for_status() return response.json() except Exception: return None - loteria.py:5-8 (helper)FastMCP server instance and API constants (API_BASE, USER_AGENT) used by get_resultados.
mcp = FastMCP("loteria") API_BASE = "https://api-resultadosloterias.com/api/" USER_AGENT = "loteria-app/1.0"