MCP Perú

MCP (Model Context Protocol) server providing access to Peruvian data from BCRP, INEI, SBS, MINSA, MINAM, INGEMMET, IDEP, MIDAGRI, CKAN, and SENAMHI.

Features

• BCRP: Exchange rates, monetary policy rates, reserve data
• INEI: Population, income, health, employment, GDP, census data
• SBS: Financial indicators, interest rates, AFP pension data
• Geospatial: MINSA (health), MINAM (protected areas), INGEMMET (mining), IDEP (populated centers), MIDAGRI (rural land)
• CKAN: Local indexed catalog of 4,309 datasets from datosabiertos.gob.pe
• SENAMHI: Weather data catalog

Installation

npm install @clawrdo/mcp-peru

Configuration

With Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "peru": {
      "command": "node",
      "args": ["/path/to/mcp-peru/dist/index.js"]
    }
  }
}

Available Tools (24 total)

Economic Tools

| Tool | Description | |------|-------------| | get_economic_indicator | Get current economic indicator (exchange, monetary, reserves) | | get_historical_economic | Get historical economic data for a date range |

Demographic Tools

| Tool | Description | |------|-------------| | get_demographic_data | Get demographic data (population, income, health, employment, inflation, GDP) | | search_data | Search available data sources and datasets |

Financial Tools

| Tool | Description | |------|-------------| | get_financial_data | Get financial data (interest rates, credit, deposits, AFP) |

Geospatial Tools

| Tool | Description | |------|-------------| | geospatial_list_sources | List available geospatial sources | | geospatial_query | Query geospatial source and layer | | geospatial_get_metadata | Get metadata about geospatial source or layer | | get_gis_data | [DEPRECATED] Use geospatial_query instead | | validate_location | Validate Peruvian location code (UBIGEO) |

Comparison Tools

| Tool | Description | |------|-------------| | compare_regions | Compare multiple regions by indicators | | get_source_info | Get information about available data sources |

Metadata Tools

| Tool | Description | |------|-------------| | get_data_freshness | Get information about when data was last updated |

Catalog Tools

| Tool | Description | |------|-------------| | catalog_get_status | Get refresh status for catalog providers | | catalog_get_metadata | Get detailed metadata for catalog providers |

CKAN Tools

| Tool | Description | |------|-------------| | ckan_search_local | Search local indexed catalog (4,309 datasets) | | ckan_list_local_datasets | List datasets from local catalog | | ckan_get_catalog_info | Get catalog info (total, formats, organizations) | | ckan_list_formats | List available data formats | | ckan_list_organizations | List organizations with dataset counts | | ckan_list_datasets | List datasets from portal | | ckan_get_dataset | Get detailed metadata for a dataset | | ckan_list_groups | List groups/categories in portal | | ckan_get_status | Get portal status and endpoint availability |

Provider Classification

| Provider | Type | Status | |----------|------|--------| | BCRP | Economic | ✅ LIVE | | MINSA | Geospatial | ✅ LIVE | | MINAM | Geospatial | ✅ LIVE | | INGEMMET | Geospatial | ✅ LIVE | | IDEP | Geospatial | ✅ LIVE | | MIDAGRI | Geospatial | ✅ LIVE | | CKAN | Open Data | ⚠️ PARTIAL + INDEXED | | INEI | Statistical | 📦 CATALOG | | SBS | Financial | 📦 CATALOG | | SENAMHI | Weather | 📦 CATALOG |

License

MIT