Skip to main content
Glama

mcp-uruguay

tests PyPI Licencia: MIT

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

Herramienta

Qué responde

Fuente

cotizacion

Dólar, UI, peso argentino o real de un día; si es fin de semana, dice qué día hábil usó

BCU

cotizacion_mensual

Promedio mensual, con los días publicados y el mes en curso marcado como parcial

BCU

pesos_constantes

Lleva montos de distintos meses a pesos de un mes base, con la Unidad Indexada

BCU

variacion_real

Cuánto cambió un monto entre dos meses descontando la inflación (UI, IPC argentino o IPCA)

BCU, INDEC, IBGE

ipc_argentina

IPC nacional, base dic-2016 = 100

INDEC

ipca_brasil

IPCA número-índice, base dic-1993 = 100

IBGE

combustible_ancap

Precio máximo al público de cada combustible, por mes

ANCAP

paridad_combustibles

¿ANCAP vende por encima o por debajo de lo que costaría importar? Ex planta contra el precio de paridad de importación, sin impuestos, mes a mes, con el desglose desde el FOB

URSEA, ANCAP

ventas_combustible

Cuánto vendió ANCAP de cada combustible por mes y mercado, con los meses que la fuente no publicó

ANCAP

clima

Lluvia y temperaturas diarias en Salto desde 1970 con su anomalía, o la tendencia por década

INIA

observaciones_inumet

Temperatura, lluvia, humedad, viento o presión de siete estaciones del país, agregada al día local (UTC-3); un día incompleto devuelve null

INUMET

nivel_rio

Altura del río en una estación de la cuenca del río Uruguay, por día, y cuánto subió o bajó

CTM Salto Grande

nivel_rio_comparado

¿El río está alto o bajo para la época? Contra los mismos días de cada año desde 2017

CTM Salto Grande

estaciones_cercanas

Estaciones hidrometeorológicas de la cuenca del río Uruguay cerca de un punto

CTM Salto Grande

geocodificar_direccion

Coordenadas de una dirección o esquina, con su calidad; descarta otra calle o el centro de la localidad

IDE.uy

ubicar_punto

En qué departamento y localidad cae un punto, con la población 2023 de la localidad

INE, IDE.uy

localidad

Población y viviendas 2023 de una localidad, o las de un departamento ordenadas

INE

resultados_electorales

Nacionales 2024, balotaje 2024 y departamentales 2025: participación y votos por partido o candidato, del país o un departamento

Corte Electoral

compras_estado

Cuánto adjudicó el Estado en un año, en pesos, por organismo o por texto, con los mayores ítems y un aviso si uno domina el total

ARCE (OCDS)

asistencia_parlamentaria

Asistencia a sesiones del Senado o Diputados por legislatura, con un mínimo de citaciones y aviso de homónimos

Parlamento

pedidos_de_informes

Pedidos de informes de Diputados a ministerios: cuántos se contestaron por organismo, semestre y partido, con el enlace al oficio y la respuesta

Parlamento

leyes

Leyes promulgadas desde 1985 por texto, fecha o número, con el enlace a IMPO

Parlamento

proyectos_parlamento

Proyectos entrados desde 1985 por texto, legislatura o tipo

Parlamento

validar_documento

Dígito verificador de RUT o cédula

sin red

semana

Semana ISO (W41) de una fecha, con su lunes y su domingo

sin red

buscar_indicador_social

Busca entre los ~1.260 indicadores sociales del MIDES por palabras

MIDES (Observatorio Social)

indicador_social

Un indicador social (pobreza, empleo, educación, vivienda...) con su unidad, cálculo y fuente, por dimensión y año, hasta 2024

MIDES (Observatorio Social)

recursos_catalogo

Archivos vigentes de un dataset de catalogodatos.gub.uy

Catálogo de datos abiertos

diagnostico

De cuándo es cada copia en caché y si está vencida

sin red

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"
}

Related MCP server: mcp-impo

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).

Prompt

Qué arma

combustible_en_pesos_constantes

un combustible en pesos de un mismo mes, contra la paridad de importación y el volumen vendido

clima_de_salto

lluvia y temperatura de Salto desde las dos estaciones públicas, sin promediarlas

el_rio_en_salto

el río contra la misma época de otros años, con las advertencias de la unidad y de la cota

compras_del_estado

lo que el Estado adjudicó de un producto, sin dejar que un solo ítem engañe

real_o_nominal

si un monto subió o bajó descontando la inflación

Recurso

Qué trae

uru://trampas

la trampa que declara cada herramienta

uru://fuentes

quién publica cada dato, como lo cita el campo fuente

uru://inumet/estaciones

las siete estaciones de observaciones_inumet

uru://bcu/monedas

qué es cada moneda que acepta cotizacion

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.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    Not graded
    maintenance
    An MCP server deployed on Cloudflare Workers that provides access to Uruguayan legislation from the official IMPO database. It enables users to search for legal norms, retrieve full texts, and query specific articles from laws, decrees, and the constitution.
    -
  • A
    license
    A
    quality
    D
    maintenance
    MCP server for accessing Uruguay's IMPO open data API with SQLite caching. Provides tools to retrieve legal norms, search regulations, and access schema documentation from Uruguay's official legal database.
    4
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    MCP server for Peruvian public-data lookups including SUNAT RUC registrations, BCRP exchange rates, and SEACE tenders. Provides official open-data access through tools for Claude, Cursor, and other MCP clients.
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    MCP server for querying real-time Argentine economic data, including dollar exchange rates, inflation, country risk, foreign currencies, and more.
    MIT