# 🇦🇷 dolar-argentina MCP

> Real-time Argentine dollar exchange rates for Claude — blue, oficial, MEP, CCL, cripto and more.

[![npm version](https://img.shields.io/npm/v/dolar-argentina-mcp)](https://www.npmjs.com/package/dolar-argentina-mcp)
[![license](https://img.shields.io/npm/l/dolar-argentina-mcp)](LICENSE)

---

## ¿Qué es esto?

Un servidor [MCP (Model Context Protocol)](https://modelcontextprotocol.io) que le da a Claude acceso en tiempo real a los tipos de cambio del dólar en Argentina. Una vez instalado, Claude puede consultar precios actualizados automáticamente cuando trabajás con presupuestos, tablas comparativas, conversiones y cualquier análisis que involucre divisas.

---

## Instalación

### Requisitos

- [Node.js](https://nodejs.org) v18 o superior
- [Claude Desktop](https://claude.ai/download)

### 1. Abrí el config de Claude

**Claude Desktop → Settings → Developer → Edit Config**

### 2. Pegá esto en el archivo

```json
{
  "mcpServers": {
    "dolar-argentina": {
      "command": "npx",
      "args": ["-y", "dolar-argentina-mcp"]
    }
  }
}
```

> Si ya tenés otros MCPs configurados, agregá solo el bloque `"dolar-argentina"` dentro de `"mcpServers"`.

### 3. Reiniciá Claude Desktop

Cerrá completamente (Cmd+Q en Mac / Alt+F4 en Windows) y volvé a abrir. El servidor debería aparecer activo en Settings → Developer.

Eso es todo. No hace falta clonar el repo ni instalar nada manualmente — `npx` se encarga de bajarlo y mantenerlo actualizado.

---

## Tools disponibles

| Tool                | Descripción                                                                     |
| ------------------- | ------------------------------------------------------------------------------- |
| `get_dolar_prices`  | Todos los tipos de cambio (oficial, blue, MEP, CCL, mayorista, cripto, tarjeta) |
| `get_dolar_blue`    | Precio actual del dólar blue (compra / venta)                                   |
| `get_dolar_oficial` | Precio actual del dólar oficial (compra / venta)                                |

**Ejemplo de respuesta:**

```json
[
  { "nombre": "Oficial", "compra": 1335, "venta": 1385 },
  { "nombre": "Blue", "compra": 1390, "venta": 1410 },
  { "nombre": "Bolsa", "compra": 1393.5, "venta": 1399.1 },
  { "nombre": "Contado con liquidación", "compra": 1447.5, "venta": 1449.3 },
  { "nombre": "Mayorista", "compra": 1350, "venta": 1359 },
  { "nombre": "Cripto", "compra": 1457.9, "venta": 1458 },
  { "nombre": "Tarjeta", "compra": 1735.5, "venta": 1800.5 }
]
```

---

## Uso recomendado

Para que Claude consulte los precios automáticamente sin que tengas que pedirlo cada vez, agregá esto en **Claude → Settings → Profile → Personal preferences**:

```
Cuando trabajés con presupuestos, precios o tablas comparativas en pesos y dólares,
consultá siempre el MCP dolar-argentina para usar los valores actualizados del día
(blue, oficial, MEP, etc.) sin que yo tenga que pedirlo explícitamente.
```

---

## Ejemplos de uso

Una vez instalado, podés pedirle a Claude cosas como:

- _"Hacé una tabla comparativa de estos servicios en USD y pasalos a pesos al blue y al oficial"_
- _"¿Cuánto sale este producto en dólares al precio de hoy?"_
- _"Armá un presupuesto en ARS usando el dólar MEP"_
- _"¿Cuánto es $500 USD al blue ahora mismo?"_

---

## Fuente de datos

Los precios se obtienen de [dolarapi.com](https://dolarapi.com), actualizados en tiempo real.

---

## Contribuciones

¡PRs y feedback bienvenidos! Si encontrás algún bug o querés sugerir una nueva feature, abrí un [issue](https://github.com/giannidona/dolar-argentina-mcp/issues).

---

## Licencia

MIT