# @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
```bash
npm install -g @peralta/economia-mcp
```
### Or use with npx
```bash
npx @peralta/economia-mcp
```
## Claude Desktop Configuration
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"economia-venezuela": {
"command": "npx",
"args": ["-y", "@peralta/economia-mcp"]
}
}
}
```
With API key for higher limits:
```json
{
"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
```bash
# 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](https://economia.arlexperalta.com) - Direct API access
- [API Docs](https://economia.arlexperalta.com/docs) - OpenAPI documentation
## License
MIT - Peralta Digital
