BCRP-MCP

Model Context Protocol (MCP) Server for BCRP Economic and Financial Time Series Data

👨‍💻 Author

Ivan Yang Rodriguez Carranza

📋 Table of Contents

🎯 Overview

BCRP-MCP is a Model Context Protocol (MCP) server that provides seamless access to economic and financial time series data from the BCRP (Banco Central de Reserva del Perú) - Central Reserve Bank of Peru. This server enables AI agents and applications to search, explore, and analyze Peru's economic indicators, financial statistics, and monetary data through a standardized MCP interface.

🎬 Demo

https://github.com/user-attachments/assets/c42eb8c3-4a1c-442d-bd12-cc1fd4ff18ae

Demo (Spanish): https://youtube.com/shorts/gsjC07WR0n0

🔧 Tools

Name	Input	Description
`search_time_series_groups`	`keywords`	Search for time series groups using one or multiple keywords
`search_time_series_by_group`	`time_series_group`	Find all time series within a specific group, returns code and name pairs
`get_time_series_data`	`time_series_codestartend`	Retrieve time series data for a specific code within a date range

Note: When using the remote server, the MCP client may require increased connection timeout settings.

💬 Prompts

Name	Input	Description
`search_data`	`keyword`	Guided workflow to find relevant time series using keyword search
`ask`	`question`	Financial analysis workflow that extracts keywords, searches data, and answers questions

🚀 How to Use

Claude Desktop (Remote Server)

Note: Requires npx which comes bundled with npm. If you don't have npm installed, install Node.js which includes npm.

Add to Claude Desktop config (Claude > Settings > Developer > Edit Config):

{
  "mcpServers": {
    "bcrp_mcp_remote": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://bcrp-mcp.onrender.com/mcp"
      ]
    }
  }
}

Local Server

Note: Make sure you have uv installed. If not, install it from uv.tool.

Clone and install:

git clone https://github.com/rodcar/bcrp-mcp.git
cd bcrp-mcp
uv sync

Add to Claude Desktop config (Claude > Settings > Developer > Edit Config):

Note: Replace /path/to/bcrp-mcp with the actual path where you cloned the repository.

{
  "mcpServers": {
    "simple_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/bcrp-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

MCP Inspector (Alternative)

Note: Requires npx which comes bundled with npm. If you don't have npm installed, install Node.js which includes npm.

Note: Replace /path/to/bcrp-mcp with the actual path where you cloned the repository.

Run

npx @modelcontextprotocol/inspector \
  uv \
  --directory /path/to/bcrp-mcp \                     
  run \
  main.py

Open MCP Inspector (URL displayed in the console) and configure the MCP client with the following settings:

Transport Type: Streamable HTTP
URL: http://bcrp-mcp.onrender.com/mcp
Request Timeout: Increase from default values
Maximum Total Timeout: Increase from default values
Proxy Session Token: Use the token generated in the console

💡 Examples

Prompt	Language	Question	Conversation
`ask`	Spanish	"¿Cómo ha evolucionado la tasa de interés de referencia en el último año?"	https://claude.ai/share/34df5f90-7a35-474d-b4cf-e8f48c3f9772

🏛️ Architecture Diagram

BCRP-MCP follows the Model Context Protocol specification and provides a clean abstraction layer over the BCRP API.

📝 License

This project is licensed under the Apache License 2.0.

🙏 Acknowledgments

BCRP for providing open access to Peru's economic data
bcrpy library for the Python interface to BCRP data (https://github.com/andrewrgarcia/bcrpy)

Note: bcrpy was used in early development, is no longer a dependency. Unfortunately the performance for the remote MCP server led to response timeouts.

Report Bug · Request Feature · Documentation

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

Model Context Protocol server that provides access to economic and financial time series data from Peru's Central Reserve Bank, enabling AI agents to search, explore, and analyze Peru's economic indicators through a standardized interface.

Related MCP Servers

FRED MCP Server
kablewy
A
security
F
license
A
quality
A Model Context Protocol server that provides tools to search and retrieve economic data series from the Federal Reserve Economic Data (FRED) API.
Last updated -
2
3
TypeScript
Juhe Exchange Rates MCP Server
juhemcp
-
security
F
license
-
quality
A Model Context Protocol server that provides real-time global currency exchange rate queries, enabling large language models to access up-to-date currency exchange information.
Last updated -
Python
Brasil API MCP
guilhermelirio
-
security
-
license
-
quality
A Model Context Protocol server that connects AI assistants to Brazilian public data services, providing access to postal codes, company registrations, bank information, area codes, IBGE data, currency exchange rates, and domain registration status.
Last updated -
3
TypeScript
MIT License
Financial Modeling Prep MCP Server
shadi-fsai
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to programmatically access financial data from Financial Modeling Prep API, including company profiles, financial statements, metrics, SEC filings, and market data.
Last updated -
5
Python
MIT License

View all related MCP servers

BCRP-MCP

BCRP-MCP

Model Context Protocol (MCP) Server for BCRP Economic and Financial Time Series Data

👨‍💻 Author

📋 Table of Contents

🎯 Overview

🎬 Demo

🔧 Tools

💬 Prompts

🚀 How to Use

Claude Desktop (Remote Server)

Local Server

💡 Examples

🏛️ Architecture Diagram

📝 License

🙏 Acknowledgments

Related MCP Servers

FRED MCP Server

Juhe Exchange Rates MCP Server

Brasil API MCP

Financial Modeling Prep MCP Server

New MCP Servers

MCP directory API