BCRP MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | DEBUG · INFO · WARNING · ERROR | INFO |
| BCRP_TIMEOUT | No | HTTP timeout in seconds | 30 |
| BCRP_LANGUAGE | No | Default language: esp (Spanish) or ing (English) | esp |
| BCRP_CACHE_TTL | No | Response cache in seconds (0 = disabled) | 300 |
| BCRP_MAX_RETRIES | No | Retries on transient errors | 3 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
You have access to the BCRPData API — the official open-access statistics database of the Banco Central de Reserva del Perú (BCRP), Peru's central bank.
No authentication is required. The API is fully public and updated in real time.
Tools (7)
bcrp_get_series — Fetch time series data for 1–10 BCRP series with optional date range
bcrp_get_series_long — Fetch up to 50 series (mixed frequencies) as one tidy long-format table
bcrp_get_latest — Get the most recent N data points for 1–10 series
bcrp_describe_series — Get series metadata (name, frequency, date range) without all data
bcrp_search_catalog — Search the built-in catalog of important series by keyword
bcrp_list_catalog_categories — List all catalog categories with series counts
bcrp_get_macro_snapshot — Real-time snapshot of key Peruvian economic indicators
Prompts (3)
inflation_and_monetary_analysis — Monetary policy and inflation analysis workflow
exchange_rate_analysis — Exchange rate dynamics and dollarization analysis
economic_growth_analysis — GDP growth, credit, and liquidity cycle analysis
Resources (3)
bcrp://api-guide — Complete API reference: URL structure, formats, response schema
bcrp://period-formats — Period format reference table (daily/monthly/quarterly/annual)
bcrp://series-catalog — Curated catalog of important series with codes, names, and units
Typical Workflow
Use a prompt for a structured research workflow.
Use
bcrp_search_catalogorbcrp://series-catalogto find series codes.Use
bcrp_describe_seriesto verify a code exists and see its date range.Use
bcrp_get_seriesfor historical data orbcrp_get_latestfor current values. For many series at once — or mixed frequencies — usebcrp_get_series_long.Use
bcrp_get_macro_snapshotfor a quick overview of all key indicators.
Period Format Quick Reference
Daily: DD-MM-YYYY (e.g. '01-01-2025')
Monthly: YYYY-M (e.g. '2024-1' = January 2024)
Quarterly: YYYY-Q (e.g. '2024-1' = Q1 2024)
All series in a single bcrp_get_series call must be the same frequency.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| bcrp_get_seriesA | Fetch time series data from the BCRP (Banco Central de Reserva del Perú) API. Accepts 1–10 series codes of the SAME frequency. Series codes can be found using
Period format by frequency:
Important: All series in one call must have the same frequency (all daily, all monthly, etc.).
Need MORE than 10 series, or a mix of frequencies? Use Responses are cached on disk between calls, so repeating a query is free.
An empty Example codes: PD04637PD (exchange rate), PD12301MD (policy rate), PN00196MM (total liquidity), PN03503MQ (GDP var%) |
| bcrp_get_latestA | Get the most recent data points for 1–10 BCRP series (same frequency). Convenience wrapper around Prefer this over Results are cached on disk; Example codes:
|
| bcrp_describe_seriesA | Get metadata about 1–10 BCRP series without fetching all data points. Returns series names, frequency, decimal precision, and available date range.
Use this to verify series codes exist and understand what they measure before
fetching large date ranges with |
| bcrp_get_series_longA | Fetch MANY BCRP series at once as one tidy long-format table. Unlike Returns Set |
| bcrp_search_catalogA | Search the built-in catalog of important BCRP series by keyword. Returns matching series codes, names, descriptions, frequency, units, and
the period format needed to query them with Example queries:
Use |
| bcrp_list_catalog_categoriesA | List all available categories in the BCRP series catalog. Returns category IDs (usable as the Categories include: exchange rates, interest rates, international reserves, liquidity (M1/M2), credit, financial markets, commodities, and GDP. |
| bcrp_get_macro_snapshotA | Fetch a real-time snapshot of Peru's key macroeconomic indicators in one call. Returns the latest values for: Daily indicators:
Monthly indicators (last 3 months):
Use |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| inflation_and_monetary_analysis | Generate a structured analysis workflow for Peru's monetary policy and inflation using BCRP data. Returns ready-to-run tool calls for policy rate tracking, liquidity monitoring, credit growth, and currency in circulation trends. |
| exchange_rate_analysis | Generate a structured workflow to analyze Peru's exchange rate dynamics and dollarization using BCRP daily and monthly data. Covers USD/PEN rate trends, international reserves, and external shocks. |
| economic_growth_analysis | Generate a structured economic growth analysis workflow for Peru using BCRP quarterly and monthly data. Covers GDP growth, monetary multiplier, credit expansion, and liquidity trends. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| BCRP API Developer Guide | Complete guide for the BCRPData public API: URL structure, period formats, response schema, error handling, and URL examples for all frequencies. |
| BCRP Period Format Reference | Quick reference for BCRP period formats by frequency: daily (DD-MM-YYYY), monthly (YYYY-M), quarterly (YYYY-Q), annual (YYYY). Includes month/quarter number tables and common gotchas. |
| BCRP Series Catalog | Curated catalog of important BCRP series organized by category: exchange rates, interest rates, international reserves, liquidity, credit, financial markets, commodities, and GDP. Each entry includes the series code, name, description, unit, and period format. |
TDQS
Scored across 7 tools
Each tool has a distinct role, and the descriptions explicitly cross-reference when to use which sibling (e.g. get_series vs get_series_long vs get_latest vs get_macro_snapshot). The only real overlap is that get_latest, get_series_long, and get_macro_snapshot are all convenience wrappers over get_series, but the descriptions define clear boundaries between them.
All seven tools follow the same `bcrp_<verb>_<noun>` pattern with a uniform prefix and snake_case throughout (get_series, get_series_long, describe_series, search_catalog, list_catalog_categories, get_macro_snapshot). No mixed conventions or vague verbs.
Seven tools is well-scoped for a central-bank data API: catalog discovery, series metadata, three query shapes (windowed, latest, bulk long), and one curated snapshot. Each tool earns its place without redundant surface.
The lifecycle is well covered — discover series (search_catalog, list_catalog_categories), validate them (describe_series), and fetch them at multiple granularities. Minor gaps: no direct 'list all series in a category' browse tool (only keyword search with a category filter) and no export/serialization option beyond the returned tables.