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-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:

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

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

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

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