bcrp-mcp

rodcar/bcrp-mcp

3.3

If you are the rightful owner of bcrp-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

BCRP-MCP is a Model Context Protocol server designed to provide access to economic and financial time series data from the Banco Central de Reserva del Perรบ (BCRP).

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

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


๐Ÿ”ง Tools

NameInputDescription
search_time_series_groupskeywordsSearch for time series groups using one or multiple keywords
search_time_series_by_grouptime_series_groupFind all time series within a specific group, returns code and name pairs
get_time_series_datatime_series_code
start
end
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

NameInputDescription
search_datakeywordGuided workflow to find relevant time series using keyword search
askquestionFinancial 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

PromptLanguageQuestionConversation
askSpanish"ยฟ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.

graph LR
    CLIENT[MCP Client<br/>Claude Desktop, IDE, etc.] --> MCP_SERVER[BCRP-MCP Server]
    
    subgraph TOOLS ["๐Ÿ”ง Tools"]
        SEARCH_GROUP[search_time_serie_group]
        SEARCH_SERIES[search_time_series_by_group]
        GET_DATA[get_time_series_data]
    end
    
    subgraph "๐Ÿ’ฌ Prompts"
        SEARCH_PROMPT[search_data]
        ASK_PROMPT[ask]
    end
    
    MCP_SERVER --> SEARCH_GROUP
    MCP_SERVER --> SEARCH_SERIES
    MCP_SERVER --> GET_DATA
    MCP_SERVER --> SEARCH_PROMPT
    MCP_SERVER --> ASK_PROMPT
    
    TOOLS --> BCRP_API[BCRP API<br/>estadisticas.bcrp.gob.pe]
    
    style CLIENT fill:#e3f2fd
    style MCP_SERVER fill:#f3e5f5
    style BCRP_API fill:#fff3e0

๐Ÿ“ License

This project is licensed under the .


๐Ÿ™ Acknowledgments

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