EconomíA Venezuela

MCP server for real-time Venezuelan economic data. Built for AI assistants like Claude.

Features

• Exchange Rates: BCV official + parallel market (DolarToday, Monitor Dólar)
• Historical Data: Up to 90 days with statistics
• Inflation: Monthly and yearly from BCV
• Basket Prices: Basic goods in VES and USD

Quick Start

Install globally

npm install -g @peralta/economia-mcp

Or use with npx

npx @peralta/economia-mcp

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "economia-venezuela": {
      "command": "npx",
      "args": ["-y", "@peralta/economia-mcp"]
    }
  }
}

With API key for higher limits:

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

Available Tools

Tool	Description
get_exchange_rates	Current rates from all sources
get_exchange_rate_history	Historical data with statistics
get_inflation	Monthly/yearly inflation data
get_basket_prices	Basic goods basket prices
get_sources	List data sources

Example Usage

Once configured, ask Claude:

"What's the current dollar rate in Venezuela?"

"Show me the USD-VES exchange rate history for the last 30 days"

"What's the inflation rate in Venezuela this month?"

"How much does the basic food basket cost in Venezuela?"

Data Sources

Source	Type	Update
BCV	Official	24h
DolarToday	Parallel	6h
Monitor Dólar	Parallel	6h
Parallel Average	Aggregate	6h

Rate Limits

Tier	Requests/Day	Price
Free	10	$0
Basic	1,000	$9/mo
Pro	10,000	$19/mo

Get your API key at https://economia.arlexperalta.com

Development

# Clone
git clone https://github.com/arlexperalta/economia-mcp
cd economia-mcp

# Install
npm install

# Run in dev mode
npm run dev

# Build
npm run build

Related

• API REST - Direct API access
• API Docs - OpenAPI documentation

License

MIT - Peralta Digital