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

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

License

MIT -- by dan1d