dolar-mcp

Name: dolar-mcp
Author: dan1d

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