README.md
@peralta/economia-mcp
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
License
MIT - Peralta Digital
Tools 5
get_exchange_ratesRetrieves current exchange rates from all available sources.get_exchange_rate_historyRetrieves historical exchange rate data with statistics.get_inflationRetrieves monthly and yearly inflation data from the BCV.get_basket_pricesRetrieves basic goods basket prices in VES and USD.get_sourcesLists all available data sources.Environment Variables
ECONOMIA_API_KEYAPI key for higher request limitsTry it
→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?