Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LOG_LEVELNoDEBUG · INFO · WARNING · ERRORINFO
BCRP_TIMEOUTNoHTTP timeout in seconds30
BCRP_LANGUAGENoDefault language: esp (Spanish) or ing (English)esp
BCRP_CACHE_TTLNoResponse cache in seconds (0 = disabled)300
BCRP_MAX_RETRIESNoRetries on transient errors3

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

  1. Use a prompt for a structured research workflow.

  2. Use bcrp_search_catalog or bcrp://series-catalog to find series codes.

  3. Use bcrp_describe_series to verify a code exists and see its date range.

  4. Use bcrp_get_series for historical data or bcrp_get_latest for current values. For many series at once — or mixed frequencies — use bcrp_get_series_long.

  5. Use bcrp_get_macro_snapshot for 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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 bcrp_search_catalog or the bcrp://series-catalog resource.

Period format by frequency:

  • Monthly: YYYY-M (e.g. 2024-1 = January 2024, 2024-12 = December 2024)

  • Quarterly: YYYY-Q (e.g. 2024-1 = Q1 2024, 2024-4 = Q4 2024)

  • Daily: DD-MM-YYYY (e.g. 01-01-2025)

  • Annual: YYYY (e.g. 2024)

  • Leave both periods empty to get the most recent available data.

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 bcrp_get_series_long instead — up to 50 codes of any frequencies, returned as one tidy long table.

Responses are cached on disk between calls, so repeating a query is free. An empty series list means the code is valid but has no data in that range, not that the code is wrong — check it with bcrp_describe_series.

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 bcrp_get_series that fetches latest data without specifying a date range, then returns only the last n_periods values.

Prefer this over bcrp_get_series when the question is "what is it now?" — today's exchange rate, the current policy rate. Use bcrp_get_series for a specific historical window, and bcrp_get_series_long for many series at once or mixed frequencies.

Results are cached on disk; n_periods accepts 1–50 and defaults to 5.

Example codes:

  • Daily rates/prices: PD04637PD, PD12301MD, PD04650MD, PD04701XD

  • Monthly monetary: PN00196MM, PN00496MM, PN00178MM

  • Quarterly growth: PN03503MQ, PN03501MQ

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.

bcrp_get_series_longA

Fetch MANY BCRP series at once as one tidy long-format table.

Unlike bcrp_get_series, the codes do NOT have to share a frequency and the limit is 50 rather than 10 — each series is fetched separately, so the code→value mapping is always correct.

Returns rows of {series_code, period, date, value}. date is an ISO-sortable rendering of BCRP's human period label. Missing observations are omitted rather than emitted as nulls.

Set all_history=true to pull each series' entire published history (bounded by max_rows).

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

Example queries:

  • 'tipo de cambio' → exchange rate series

  • 'tasa referencia' → BCRP policy rate

  • 'reservas internacionales' → international reserves

  • 'cobre' → copper price

  • 'liquidez' → monetary liquidity (M1/M2)

  • 'credito' → private sector credit

  • 'BVL' → Lima stock exchange index

  • 'PBI' → GDP quarterly series

Use bcrp_list_catalog_categories to see all available categories.

bcrp_list_catalog_categoriesA

List all available categories in the BCRP series catalog.

Returns category IDs (usable as the category filter in bcrp_search_catalog), the number of series per category, and their frequency.

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:

  • Exchange rate (TC Interbancario S/ por US$)

  • BCRP policy rate (%)

  • International reserves (millions US$)

  • Copper price (cUS$ per pound)

  • Lima stock market index (BVL)

Monthly indicators (last 3 months):

  • Total liquidity M2 (millions S/)

  • Private sector credit (millions S/)

  • Currency in circulation (millions S/)

  • Credit growth 12-month (%)

Use bcrp_get_series for custom date ranges or additional series.

Prompts

Interactive templates invoked by user choice

NameDescription
inflation_and_monetary_analysisGenerate 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_analysisGenerate 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_analysisGenerate 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

NameDescription
BCRP API Developer GuideComplete guide for the BCRPData public API: URL structure, period formats, response schema, error handling, and URL examples for all frequencies.
BCRP Period Format ReferenceQuick 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 CatalogCurated 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

A4.4/5.0

Scored across 7 tools

Disambiguation4/5

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.

Naming Consistency5/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessOutdated data