Mcp Sinim

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.

[](https://pypi.org/project/mcp-sinim/) [](https://www.python.org/downloads/) [](https://github.com/MaykolMedrano/mcpsinim/actions/workflows/ci.yml) [](https://pypi.org/project/mcp-sinim/) [](https://opensource.org/licenses/MIT) [](https://glama.ai/mcp/servers/MaykolMedrano/mcpsinim)

---

¿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é.

Instalación y primer uso

pip install mcp-sinim

Requiere 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 | | :--- | :--- | | cod_municipio | Código CUT oficial del municipio. | | nombre_municipio | Nombre del municipio. | | anio | Año de la observación. | | code | Código de la variable SINIM. | | name | Nombre de la variable. | | value | Valor publicado por SINIM. | | unit | Unidad de medida. |

Métodos principales:

• search(...): busca códigos de variables;
• get(...): descarga datos municipales;
• municipios(...) y search_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](examples/basicusage.ipynb) (Python 3.10–3.12), el [ejemplo básico en Python](examples/basicusage.py) y la [guía de usuario en Jupyter](examples/GuiaUsuarioSINIM.ipynb).

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-sinim desde PyPI con python -m pip install --upgrade > mcp-sinim y regístralo en mi cliente MCP usando transporte stdio, con el > comando mcp-sinim y el nombre de servidor sinim. 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 > en PATH, 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.

> [!IMPORTANT] > 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 sinim para buscar indicadores relacionados con > ejecución presupuestaria municipal.

Configuración manual

Después de instalar el paquete, inicia el servidor con:

mcp-sinim

Configuració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 | | :--- | :--- | | search_variables | Busca variables SINIM por palabras clave. | | get_variable_info | Entrega los metadatos de una variable. | | get_data | Descarga registros para una o varias variables. | | preview_data | Previsualiza hasta 100 registros antes de exportar. | | export_data | Exporta un panel completo a Parquet o CSV. | | list_areas | Lista las nueve áreas temáticas del catálogo. | | list_municipios | Lista municipios y permite filtrar por región. | | search_municipalities | Busca municipios por nombre y región. | | list_years | 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_municipio corresponde 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=True solicita 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

Ver estructura del repositorio

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 principal

Configurar 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 pytest

En 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](mailto:mmedrano2@uc.cl) GitHub: MaykolMedrano

Licencia y descargo de responsabilidad

Este proyecto se distribuye bajo la [licencia MIT](LICENSE). 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.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: MaykolMedrano
• Source: MaykolMedrano/mcp_sinim
• License: MIT
• Homepage: https://pypi.org/project/mcp-sinim/

Install and usage instructions live in the source repository linked above.