README.md
Real-time Argentine exchange rates for AI agents.
dolar-mcp
Argentine exchange rates for AI agents.
MCP server that gives AI agents real-time access to Argentine exchange rates via DolarAPI. Dollar blue, oficial, MEP, CCL, crypto — plus currency conversion and spread calculator.
No API key required.
Quick Start
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"dolar": {
"command": "npx",
"args": ["-y", "@dan1d/dolar-mcp"]
}
}
}
Claude Code
claude mcp add dolar -- npx -y @dan1d/dolar-mcp
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"dolar": {
"command": "npx",
"args": ["-y", "@dan1d/dolar-mcp"]
}
}
}
Windsurf
{
"mcpServers": {
"dolar": {
"command": "npx",
"args": ["-y", "@dan1d/dolar-mcp"]
}
}
}
Once configured, ask your AI assistant things like: "How much is the dollar blue today?" or "Convert 100 USD blue to ARS" or "What's the spread between blue and oficial?"
Available Tools
| Tool | Description |
|---|---|
get_all_dollars |
Get all dollar exchange rates: blue, oficial, bolsa (MEP), contado con liqui (CCL), cripto, mayorista, and tarjeta. Returns buy/sell prices. |
get_dollar |
Get a specific dollar type rate. Types: blue, oficial, bolsa, contadoconliqui, cripto, mayorista, tarjeta. |
get_all_currencies |
Get all foreign currency exchange rates vs ARS (EUR, BRL, UYU, CLP, etc.). |
get_currency |
Get exchange rate for a specific foreign currency vs ARS. |
convert |
Convert an amount between ARS and any currency or dollar type. At least one side must be ARS. Supports use_buy flag for buy rate. |
get_spread |
Calculate the spread (difference) between two dollar types, e.g. blue vs oficial. Returns absolute and percentage spread. |
Example Prompts
- "Dame todas las cotizaciones del dolar"
- "Cuanto sale el dolar blue hoy?"
- "Converti 500 USD blue a pesos"
- "Cual es la brecha entre el oficial y el blue?"
- "Cuanto esta el euro?"
- "Converti 1000 EUR a ARS"
Programmatic Usage
npm install @dan1d/dolar-mcp
import { createDolarTools } from "@dan1d/dolar-mcp";
const dolar = createDolarTools();
// Get all dollar rates
const rates = await dolar.tools.get_all_dollars();
// Get blue dollar specifically
const blue = await dolar.tools.get_dollar({ type: "blue" });
// Convert 100 USD blue to ARS
const converted = await dolar.tools.convert({
amount: 100,
from: "blue",
});
// Calculate spread between oficial and blue
const spread = await dolar.tools.get_spread({
type_a: "oficial",
type_b: "blue",
});
Data Source
All data comes from DolarAPI, a free public API for Argentine exchange rates. No authentication required. Data is updated in real time.
Part of the LATAM MCP Toolkit
| Server | What it does |
|---|---|
| CobroYa | Mercado Pago payments — create links, search payments, refunds |
| MercadoLibre MCP | MercadoLibre marketplace — search products, categories, trends |
| DolarAPI MCP | Argentine exchange rates — blue, oficial, CCL, crypto, conversion |
License
Tools (6)
get_all_dollarsGet all dollar exchange rates including blue, oficial, bolsa, CCL, cripto, mayorista, and tarjeta.get_dollarGet a specific dollar type rate.get_all_currenciesGet all foreign currency exchange rates vs ARS.get_currencyGet exchange rate for a specific foreign currency vs ARS.convertConvert an amount between ARS and any currency or dollar type.get_spreadCalculate the spread between two dollar types.Configuration
claude_desktop_config.json
{"mcpServers": {"dolar": {"command": "npx", "args": ["-y", "@dan1d/dolar-mcp"]}}}Try it
→How much is the dollar blue today?
→Convert 500 USD blue to pesos
→What is the spread between the official and blue dollar?
→How much is the Euro in ARS?
→Convert 1000 EUR to ARS