Uruguay: datos públicos

io.github.manusabbath-archv0.5.0Updated Oct 10, 2026

Uruguayan public data from primary sources: BCU rates, CPI, fuel, weather, IDE.uy geocoding, RUT.

VerifiedSTDIODesktop onlyData & AnalyticsLocation & LifestyleFinance

Overview

AI-generated overview

Read-only MCP server giving assistants Uruguayan and regional public data: BCU exchange rates, inflation, fuel, weather, rivers, geocoding and RUT validation.

What it does
Exposes read-only tools that fetch public data from primary sources: BCU exchange rates and monthly averages, constant-peso and real-variation calculations, Argentina's CPI and Brazil's IPCA, ANCAP fuel prices, INIA weather in Salto, Uruguay River levels and nearby stations, IDE.uy geocoding and point lookup, INE locality population, 2024-2025 electoral results, RUT/ID check-digit validation, ISO week, open-data catalog files and cache diagnostics. Every answer includes a source field and a retrieval timestamp. It rejects rather than repairs bad data, so errors come back with a reason instead of a plausible wrong number.
When to use it
Useful when an assistant needs cited Uruguayan or regional public statistics: historical dollar or UI rates, inflation-adjusted amounts, fuel prices, Salto weather trends, river levels, address geocoding, locality population or recent election results.
Requirements
Runs locally over stdio as the PyPI package mcp-uruguay, launched with uvx; uv is required and no cloning is needed. No accounts, API keys or headers are declared. Network access is needed for most tools; document validation, ISO week and diagnostics work offline. Cache lives in ~/.cache/mcp-uruguay or the path in MCP_URUGUAY_CACHE. First weather query downloads about 57 files and takes roughly a minute.
Before you install
All tools are declared read-only and no credentials are requested. Data is downloaded from third-party public sources (BCU, INDEC, IBGE, ANCAP, INIA, CTM Salto Grande, IDE.uy, INE, Corte Electoral, catalogodatos.gub.uy), so queries and cached copies leave the machine. Cached live data expires (current month after 3 hours; IPC, IPCA, ANCAP and stations daily; weather weekly), so results may lag the source.

Installation

In SourceWeft

  1. Open Uruguay: datos públicos in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

HerramientaQué respondeFuente
cotizacionDólar, UI, peso argentino o real de un día; si es fin de semana, dice qué día hábil usóBCU
cotizacion_mensualPromedio mensual, con los días publicados y el mes en curso marcado como parcialBCU
pesos_constantesLleva montos de distintos meses a pesos de un mes base, con la Unidad IndexadaBCU
variacion_realCuánto cambió un monto entre dos meses descontando la inflación (UI, IPC argentino o IPCA)BCU, INDEC, IBGE
ipc_argentinaIPC nacional, base dic-2016 = 100INDEC
ipca_brasilIPCA número-índice, base dic-1993 = 100IBGE
combustible_ancapPrecio máximo al público de cada combustible, por mesANCAP
climaLluvia y temperaturas diarias en Salto desde 1970 con su anomalía, o la tendencia por décadaINIA
nivel_rioAltura 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 2017CTM Salto Grande
estaciones_cercanasEstaciones hidrometeorológicas de la cuenca del río Uruguay cerca de un puntoCTM Salto Grande
geocodificar_direccionCoordenadas de una dirección o esquina, con su calidad; descarta otra calle o el centro de la localidadIDE.uy
ubicar_puntoEn qué departamento y localidad cae un punto, con la población 2023 de la localidadINE, IDE.uy
localidadPoblación y viviendas 2023 de una localidad, o las de un departamento ordenadasINE
resultados_electoralesNacionales 2024, balotaje 2024 y departamentales 2025: participación y votos por partido o candidato, del país o un departamentoCorte Electoral
validar_documentoDígito verificador de RUT o cédulasin red
semanaSemana ISO (W41) de una fecha, con su lunes y su domingosin red
recursos_catalogoArchivos vigentes de un dataset de catalogodatos.gub.uyCatálogo de datos abiertos
diagnosticoDe cuándo es cada copia en caché y si está vencidasin 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ó.
json
{  "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"}

Instalación

Requiere uv. No hace falta clonar nada.

Claude Code

sh
claude mcp add uruguay -- uvx mcp-uruguay

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

json
{  "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á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

sh
git clone https://github.com/manusabbath-arch/mcp-uruguay && cd mcp-uruguayuv run --with pytest --with-editable . pytest            # sin reduv 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 13 herramientas existan, que todas sean de solo lectura y que un error vuelva con su motivo.

Licencia

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

Source: README.md at commit 5372874

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v0.5.0LatestOct 10, 2026