mcp-sinim

Pull Chilean municipal data from SINIM with a searchable catalog, tidy municipal panels, and the same package from Python or any MCP-compatible client.

An open-source project by Maykol Medrano.

What You Can Do

• Search roughly 480 SINIM variables by natural language instead of memorizing id_dato codes.
• Pull one or many municipal indicators as tidy pandas panels in one call.
• Discover available years and municipality codes directly from the live portal.
• Use the same package in notebooks, scripts, or MCP clients.
• Work with an offline catalog snapshot plus optional metadata caching.

Installation

pip install mcp-sinim

Python Example

from mcp_sinim import SINIMClient

client = SINIMClient(corrmon=True)

# 1) Find the right variable code
hits = client.search("patentes municipales")
print(hits[["code", "name"]].head(3).to_string(index=False))

# 4173 = Ingresos por Patentes Municipales de Beneficio Municipal
# 1311 = Monto Patentes Municipales Pagadas
# 13101 = Santiago, 13114 = Las Condes, 13123 = Providencia

# 2) Pull a tidy panel for several years and municipalities
df = client.get(
    ["4173", "1311"],
    years=[2022, 2023, 2024],
    municipios=["13101", "13114", "13123"],  # Santiago, Las Condes, Providencia
)
print(df.head(12).to_string(index=False))

# 3) Explore metadata when needed
print(client.years()[-5:])
print(client.search_municipios("providencia"))
print(client.municipios(region="13"))  # official region code: Metropolitana

Main things you will use:

• search(...) to find variable codes
• get(...) to pull municipal data
• municipios(...) and search_municipios(...) to work with legal municipality codes
• years() to see what is currently available

MCP Server

Use mcp-sinim when you want an MCP client to search SINIM variables, inspect their metadata, and fetch municipal data without writing a custom wrapper.

Run the server after installation:

mcp-sinim

Typical MCP configuration:

{
  "mcpServers": {
    "sinim": {
      "command": "mcp-sinim"
    }
  }
}

Optional environment variable:

• MCP_SINIM_CACHE_DIR for the metadata disk cache

MCP tools

Important Notes

• cod_municipio matches the official SUBDERE CUT codes for the 345 municipalities present in SINIM.
• Pass those legal CUT codes to municipios=. The client translates them to SINIM's internal identifiers automatically.
• Region filters accept official Chilean region codes ("1" through "16"), as well as SINIM's portal identifiers for compatibility.
• corrmon=True requests SINIM's real-value series, expressed in pesos of the most recent published year.
• This is an independent open-source client for the public SINIM portal. It is not affiliated with SUBDERE or the Gobierno de Chile.

Development

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

License

MIT. See LICENSE.