# @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