Skip to main content
Glama

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.

PyPI Python Tests Descargas Licencia: MIT Glama MCP score


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

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

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

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.

Available Tools

9 tools
export_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

    A3.8/5.0

    Scored across 9 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides 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.
      21
      57 npm
      12
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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.
      16
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      Provides 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.
      4
      10 PyPI
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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 npm
      1
      MIT