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.

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