mcp-uruguay

In English: an MCP server that gives AI agents Uruguayan and regional public data straight from the primary sources: Central Bank of Uruguay exchange rates and inflation-adjusted pesos, Argentina's CPI, Brazil's IPCA, ANCAP fuel prices, INIA weather in Salto, Uruguay River stations, IDE.uy geocoding and RUT/ID validation. Read-only, and every answer carries its source and retrieval time.

Servidor MCP con datos públicos de Uruguay y la región, leídos de la fuente primaria. Le da a cualquier agente de IA (Claude, o cualquier cliente MCP) cotizaciones del BCU, pesos constantes, IPC de Argentina y Brasil, combustibles de ANCAP, clima de Salto, estaciones del río Uruguay y validación de RUT y cédula.

Está construido sobre uydatos, así que hereda su regla: rechazar en vez de arreglar. Un agente que recibe un error con motivo puede decirlo; uno que recibe un número plausible pero falso lo repite.

Herramientas

Todas son de solo lectura, y así lo declaran al cliente.

Cada respuesta trae dos campos para citar el dato:

• fuente: quién lo publica.
• bajado: cuándo se obtuvo la copia que se usó.

{
  "moneda": "USD",
  "fecha_pedida": "2026-10-04",
  "fecha_cotizacion": "2026-10-02",
  "valor_en_pesos": 40.342,
  "nota": "Se usó la cotización del 2026-10-02, último día publicado antes del 2026-10-04. ...",
  "fuente": "Banco Central del Uruguay, web service de cotizaciones (cotizaciones.bcu.gub.uy)",
  "bajado": "2026-10-09T20:45"
}

Flujos y referencias

Además de las herramientas, el servidor publica cinco prompts (recetas que el usuario elige, con el orden de las herramientas y lo que hay que desconfiar de cada paso) y cuatro recursos (páginas de referencia que el cliente lee cuando las necesita).

Un test falla si un prompt nombra una herramienta que ya no existe, o si una herramienta queda sin su trampa.

Instalación

Requiere uv. No hace falta clonar nada.

Claude Code

claude mcp add uruguay -- uvx mcp-uruguay

Claude Desktop y otros clientes (claude_desktop_config.json o el equivalente de tu cliente)

{
  "mcpServers": {
    "uruguay": {
      "command": "uvx",
      "args": ["mcp-uruguay"]
    }
  }
}

Después, preguntale al agente cosas como:

• "¿Cuánto valía el dólar el 4 de octubre de 2026?"
• "Vendí 1.200.000 pesos en septiembre de 2025 y 1.450.000 en septiembre de 2026. ¿Cuánto crecí en términos reales?"
• "¿Hizo más calor de lo normal en Salto en enero de 2026?"
• "¿El río Uruguay en Salto está alto para esta época del año?"
• "¿En qué departamento cae el punto -31.10, -57.30, y cuál es el pueblo más cercano?"
• "¿Cómo votó Salto en el balotaje de 2024?"
• "¿Cuánto gastó el Estado en ambulancias en 2025?"
• "¿Qué leyes sobre riego se aprobaron desde 2020?"
• "¿Cuál es la estación meteorológica más cercana a 18 de Julio y Ejido, en Montevideo?"

Caché

Lo que se baja queda en ~/.cache/mcp-uruguay, o en la carpeta que indique la variable MCP_URUGUAY_CACHE.

• Lo cerrado no se vuelve a pedir: un mes ya terminado del BCU no cambia.
• Lo vivo vence: el mes en curso a las 3 horas; el IPC, el IPCA, ANCAP y las estaciones al día; el clima a la semana.
• Una descarga ilegible nunca reemplaza a una copia buena.

La primera consulta de clima baja la serie completa de INIA (unos 57 archivos) y tarda alrededor de un minuto. Las siguientes son instantáneas.

Desarrollo

git clone https://github.com/manusabbath-arch/mcp-uruguay && cd mcp-uruguay
uv run --with pytest --with-editable . pytest            # sin red
uv run --with pytest --with-editable . pytest -m red     # contra las fuentes reales

Los tests del servidor conectan un cliente MCP real en el mismo proceso. Verifican que las herramientas existan, que todas sean de solo lectura, que un error vuelva con su motivo y que los prompts y recursos se puedan pedir y leer. La cobertura se mide con pytest-cov y el CI falla si baja del 88%.

Licencia

MIT. Usalo, adaptalo y compartilo; solo mantené el aviso de autoría.