dan1d/dolar-mcp

Argentine exchange rates for AI agents.

npm version tests npm downloads license

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.

npm | GitHub

---

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

MIT -- by dan1d