home / mcp / economia mcp server

Economia MCP Server

Provides real-time Venezuelan economic data via MCP, including exchange rates, inflation, and basket prices from multiple sources.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "arlexperalta-economia-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@peralta/economia-mcp"
      ],
      "env": {
        "ECONOMIA_API_KEY": "ek_your_api_key"
      }
    }
  }
}

You can run a dedicated MCP server that provides real-time Venezuelan economic data, including exchange rates from multiple sources, inflation figures, and basic basket prices. This server helps AI assistants access up-to-date economic metrics in an integrated, consistent way.

How to use

You interact with the MCP server through your MCP client. Install the server package, start it, and then configure your client to point to the local or remote MCP endpoint. Once configured, you can request the current exchange rates, historical exchange rate data, inflation figures, and basket prices for Venezuela. The server aggregates data from official and parallel sources and exposes endpoints that your client can query to retrieve current values and recent trends.

How to install

Prerequisites: you need Node.js and npm installed on your system.

Install the MCP server package globally using npm.

npm install -g @peralta/economia-mcp

Or run the server with npx without a global install.

npx @peralta/economia-mcp

Configuration and usage notes

Configure your MCP client to load the server as an MCP endpoint. You can run the server via npx and provide an API key to unlock higher usage limits if you have one.

Default configuration shown for Claude Desktop integration uses npx to run the server and pass the package name for direct invocation.

If you have an API key for higher limits, you can supply it in the configuration to enable expanded usage.

Data sources and capabilities

The MCP server exposes tools to fetch exchange rates from official and parallel sources, provide historical rate data with statistics, fetch inflation data on monthly and yearly bases, and retrieve prices for a basic goods basket in VES and USD.

Data sources overview

Official: BCV is the primary source for official exchange rates and inflation figures. Parallel sources include DolarToday and Monitor Dólar for market rates. An aggregate Parallel Average is available as a consolidated source.

Rate limits

Tiered usage is available with free and paid options. Free access provides a limited daily quota, while Basic and Pro tiers offer higher request limits at monthly rates.

Troubleshooting

If you encounter connection issues, verify that your MCP client is configured to reach the MCP endpoint and that your API key (if used) is correctly set. Check that the MCP server process is running and listening on the expected port.

Notes

This MCP server is designed to provide real-time economic data for use by AI assistants and automation tools. Ensure you respect rate limits and manage your API keys securely.

Available tools

get_exchange_rates

Fetch current exchange rates from all configured sources.

get_exchange_rate_history

Retrieve historical exchange rate data with statistics.

get_inflation

Obtain monthly and yearly inflation data.

get_basket_prices

Get prices for the basic goods basket in VES and USD.

get_sources

List available data sources.