mcp-sinim
This server provides a standardized interface to search, explore, and retrieve Chilean municipal data from the public SINIM portal.
search_variables: Fuzzy-search ~480 SINIM variables by keyword (e.g. "patentes municipales", "ingresos propios"), with optional filtering by subject area. Matching is accent- and case-insensitive.get_variable_info: Retrieve full metadata for a specific SINIM variable by its code (e.g."4173").get_data: Fetch tidy municipal records for one or more variables, with optional filters for years, municipalities (by CUT codes), region, and monetary correction (real vs. nominal pesos).list_areas: List all SINIM catalog subject areas (e.g. finance, education, health).list_municipios: Browse ~345 municipalities, optionally filtered by official Chilean region codes.list_years: Discover which years have data published in SINIM, dynamically fetched so newly published years appear automatically.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-sinim search variables about education spending"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-sinim
Busca, descarga y analiza datos municipales de Chile desde el Sistema Nacional de Información Municipal (SINIM), usando Python o cualquier cliente MCP.
¿Qué es mcp-sinim?
mcp-sinim ofrece dos interfaces para consultar el Sistema Nacional de
Información Municipal (SINIM) de Chile:
un cliente síncrono de Python para análisis en notebooks y scripts;
un servidor MCP para agentes de IA y otras aplicaciones compatibles.
Ambas interfaces utilizan el mismo catálogo de variables y entregan datos
municipales ordenados, listos para trabajar con pandas.
Funciones principales:
Buscar cerca de 480 variables por texto, sin memorizar códigos
id_dato.Descargar uno o varios indicadores como paneles municipales ordenados.
Consultar los años y códigos de municipios disponibles en el portal.
Usar el paquete desde Python, notebooks o clientes MCP.
Buscar en una copia local del catálogo y almacenar metadatos en caché.
Related MCP server: Kolada MCP Server
Instalación y primer uso
pip install mcp-sinimRequiere Python 3.10 o una versión posterior.
Uso con Python
from mcp_sinim import SINIMClient
client = SINIMClient(corrmon=True)
# 1) Buscar el código de una variable
resultados = client.search("patentes municipales")
print(resultados[["code", "name"]].head(3).to_string(index=False))
# 2) Descargar un panel para varios años y municipios
datos = client.get(
["4173", "1311"],
years=[2022, 2023, 2024],
municipios=["13101", "13114", "13123"], # Santiago, Las Condes, Providencia
)
print(datos.head().to_string(index=False))
# 3) Explorar años y municipios
print(client.years()[-5:])
print(client.search_municipios("providencia"))
print(client.municipios(region="13")) # código oficial de la Región Metropolitana
client.close()Las columnas principales del resultado son:
Columna | Contenido |
| Código CUT oficial del municipio. |
| Nombre del municipio. |
| Año de la observación. |
| Código de la variable SINIM. |
| Nombre de la variable. |
| Valor publicado por SINIM. |
| Unidad de medida. |
Métodos principales:
search(...): busca códigos de variables;get(...): descarga datos municipales;municipios(...)ysearch_municipios(...): consulta códigos CUT;years(): muestra los años disponibles.
Consulta también el notebook de inicio rápido con mapa interactivo en Kepler.gl (Python 3.10–3.12), el ejemplo básico en Python y la guía de usuario en Jupyter.
Conectar a un cliente MCP
Instalación automática con IA
Si utilizas un asistente con acceso autorizado a la terminal, como Codex, Claude Code, Cursor o Windsurf, puedes pedirle que instale el paquete y registre el servidor en tu cliente MCP. Copia y pega este prompt:
Instala
mcp-sinimdesde PyPI conpython -m pip install --upgrade mcp-sinimy regístralo en mi cliente MCP usando transportestdio, con el comandomcp-sinimy el nombre de servidorsinim. Verifica que el ejecutable exista, que el servidor inicie correctamente y que exponga sus herramientas antes de darlo por terminado. Si el comando no está disponible enPATH, configura su ruta absoluta. No modifiques otras entradas MCP.
El asistente deberá adaptar la ubicación del archivo de configuración al cliente y al sistema operativo que estés utilizando.
Revisa los comandos ejecutados y los cambios realizados en tus archivos de configuración antes de aprobarlos. No compartas credenciales ni concedas permisos adicionales que no sean necesarios.
Reinicia el cliente MCP después de guardar la configuración. Para comprobar la conexión, prueba una solicitud como:
Usa el servidor MCP
sinimpara buscar indicadores relacionados con ejecución presupuestaria municipal.
Configuración manual
Después de instalar el paquete, inicia el servidor con:
mcp-sinimConfiguración MCP habitual:
{
"mcpServers": {
"sinim": {
"command": "mcp-sinim"
}
}
}Si el cliente MCP no encuentra el comando, usa la ruta completa del ejecutable
mcp-sinim correspondiente a tu entorno de Python.
Variable de entorno opcional:
MCP_SINIM_CACHE_DIR: directorio para la caché de metadatos.
Herramientas MCP
Herramienta | Descripción |
| Busca variables SINIM por palabras clave. |
| Entrega los metadatos de una variable. |
| Descarga registros para una o varias variables. |
| Previsualiza hasta 100 registros antes de exportar. |
| Exporta un panel completo a Parquet o CSV. |
| Lista las nueve áreas temáticas del catálogo. |
| Lista municipios y permite filtrar por región. |
| Busca municipios por nombre y región. |
| Lista los años disponibles actualmente. |
Ejemplos de solicitudes para un agente conectado al servidor:
Busca variables relacionadas con ingresos propios municipales.
Descarga la variable 4173 para Santiago, Las Condes y Providencia entre 2020 y 2024.
Exporta a Parquet los ingresos por patentes de todos los municipios de la Región Metropolitana.
Casos de uso
mcp-sinim permite construir flujos reproducibles para:
analizar ingresos propios, Fondo Común Municipal y ejecución presupuestaria;
comparar gasto, inversión y disponibilidad presupuestaria entre municipios;
estudiar indicadores de educación, salud y gestión municipal;
construir paneles históricos para investigación y políticas públicas;
exportar resultados a CSV o Parquet para Stata, R, Python o Power BI;
crear mapas municipales y conectar agentes de IA con una fuente oficial.
El servidor trabaja con indicadores publicados por SINIM; no entrega registros transaccionales como facturas, proveedores u órdenes de compra.
Datos, unidades y limitaciones
Los datos provienen del portal oficial SINIM Datos Municipales, administrado por la Subsecretaría de Desarrollo Regional y Administrativo (SUBDERE) del Ministerio del Interior de Chile.
Al utilizar la información, cita como fuente: Sistema Nacional de Información Municipal (SINIM), SUBDERE, Ministerio del Interior.
Consideraciones
cod_municipiocorresponde a los códigos CUT oficiales de SUBDERE para los 345 municipios presentes en SINIM.El argumento
municipios=recibe esos códigos CUT y los traduce internamente a los identificadores utilizados por el portal.Los filtros regionales aceptan los códigos oficiales de Chile (
"1"a"16") y, por compatibilidad, los identificadores internos de SINIM.corrmon=Truesolicita la serie en valores reales, expresada en pesos del último año publicado.La unidad depende de cada variable. Por ejemplo,
M$significa miles de pesos.La disponibilidad y cobertura histórica varían entre indicadores.
Desarrollo
mcp_sinim/
├── mcp_sinim/ Cliente, catálogo, parsers y servidor MCP
│ └── data/ Copia local del catálogo de variables
├── examples/ Ejemplos, mapa Kepler.gl y guía en Jupyter
├── tests/ Pruebas automatizadas y datos de prueba
├── scripts/ Utilidades de catálogo, publicación y verificación
├── pyproject.toml Configuración del paquete
└── README.md Documentación principalConfigurar el entorno
git clone https://github.com/MaykolMedrano/mcp_sinim
cd mcp_sinim
python -m venv .venv
.venv/Scripts/activate
pip install -e ".[dev]"
python -m ruff check .
python -m ruff format --check .
python -m pytestEn macOS o Linux, activa el entorno con source .venv/bin/activate.
Autor y licencia
Maykol Medrano Pontificia Universidad Católica de Chile Correo: mmedrano2@uc.cl GitHub: MaykolMedrano
Licencia y descargo de responsabilidad
Este proyecto se distribuye bajo la licencia MIT. Es un cliente independiente de código abierto y no está afiliado a SUBDERE ni al Gobierno de Chile. La disponibilidad y exactitud de los datos dependen del servicio público de SINIM.
Available Tools
9 toolsexport_dataA
Write a full SINIM panel to disk instead of the model's context.
Call preview_data first to sanity-check the query shape and coverage.
The export has a generous safety ceiling for pathological or extremely
long-running queries, independent of the in-context response limit.
Inputs: codes (required), years (required), format, region, +2 more. Returns: object
get_dataC
Fetch municipal data for one or more SINIM variables.
Inputs: codes (required), years (required), region, corrmon, +1 more. Returns: result
get_variable_infoA
Get full metadata for a single SINIM variable code.
Inputs: code (required). Returns: object
list_areasA
List all SINIM subject areas (e.g. finance, education, health).
Returns: The distinct area names present in the catalog, sorted.
Inputs: no named parameters. Returns: result
list_municipiosB
List municipalities, optionally filtered by region.
Inputs: region. Returns: result
list_yearsA
List the years with data available in SINIM.
Discovered dynamically from the SINIM form, so newly published years appear automatically.
Returns: Available years, ascending (e.g. 2001..2025).
Inputs: no named parameters. Returns: result
preview_dataA
Inspect a query's shape and coverage before exporting its full result.
Use this bounded preview to check columns, coverage, and sample values,
then call export_data to write the complete panel to disk.
Inputs: codes (required), years (required), limit, region, +2 more. Returns: result
search_municipalitiesA
Fuzzy-search Chilean municipalities by name, optionally filtered by region.
Matching is accent- and case-insensitive ("nunoa" also finds "ÑUÑOA").
Inputs: query (required), limit, region. Returns: result
search_variablesA
Fuzzy-search SINIM variables by name, optionally filtered by area.
Matching is accent- and case-insensitive ("educacion" also finds "Educación").
Inputs: query (required), area, limit. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Most tools have clearly distinct purposes (listing vs searching vs fetching), but list_municipios and search_municipalities overlap significantly as both return municipalities, differing only in fuzzy matching. The data-related tools (get_data, preview_data, export_data) are distinct but could confuse at a glance.
The verb_noun pattern is mostly followed (list_*, search_*, get_*, preview_data, export_data), but there is an inconsistency with list_municipios using Spanish while search_municipalities uses English, and get_variable_info breaks the simple verb_noun form.
9 tools is well-scoped for a data catalog focused on discovery, search, and retrieval. Each tool serves a distinct step in the workflow without redundancy.
The tool set covers the full lifecycle of exploring and exporting SINIM data: discovering areas, municipalities, years, and variables, then fetching, previewing, and exporting. No critical gaps for the stated domain.
Maintenance
Related MCP Connectors
Official public data for Central America and the Dominican Republic, down to the municipality.
Official public data for Central America and the Dominican Republic, down to the municipality.
Financial data, fiscal health scores, and economic indicators for 20,000+ U.S. municipalities.
Argentina's official public data (INDEC, BCRA, 38 portals): search, read tables, cited answers.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides access to 5,000+ Key Performance Indicators across 264 operating areas for all Swedish municipalities and regions, enabling statistical analysis, comparisons, and trend tracking of Swedish public sector data.2157 npm12MIT
- AlicenseNot gradedqualityDmaintenanceProvides access to Sweden's comprehensive municipal and regional statistics database with semantic search capabilities. Enables natural language queries against thousands of Key Performance Indicators covering various aspects of Swedish public sector data.16Apache 2.0
- AlicenseAqualityDmaintenanceProvides access to over 5,000 macroeconomic indicators from the Banco Central de Reserva del Perú (BCRP) statistical database. It enables AI agents to search for indicators, fetch time-series data, and generate professional economic charts.410 PyPI1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search, read, and explore thousands of public datasets from Chile's open government data portal (datos.gob.cl) without requiring an API key.33 npm1MIT