Agentes de IA

Un agente de IA con acceso a HTTP puede consultar MonedAPI como cualquier otro cliente: ChatGPT, Claude, Gemini, Cursor o un agente propio. Las lecturas son públicas, sin registro, y la API responde con CORS abierto (Access-Control-Allow-Origin: *), así que también funciona desde un agente que corre en el navegador.

Recursos para agentes

Recurso	Para qué sirve
https://monedapi.ar/llms.txt	Índice corto de la API: qué es, ejemplos, orígenes válidos de cada moneda y enlaces a cada página de la documentación.
https://monedapi.ar/llms-full.txt	Toda la documentación en un solo archivo de texto.
https://monedapi.ar/openapi.json	Esquema OpenAPI 3.1 con todas las rutas públicas, sus parámetros y sus respuestas.
https://monedapi.ar/api/mcp	Servidor MCP por HTTP, con las cotizaciones actuales y el valor a una fecha.

Para un agente que lee la web, /llms.txt es el punto de partida. Para uno que llama herramientas, /openapi.json describe cada operación. Para un cliente MCP, el servidor de abajo.

Servidor MCP

MonedAPI expone un servidor MCP (Model Context Protocol) por HTTP, sin registro:

https://monedapi.ar/api/mcp

Los clientes compatibles (Claude, Cursor, VS Code y otros) pueden usar estas herramientas:

Herramienta	Qué hace
get_dolar	Cotización del dólar. Sin argumentos devuelve todos los tipos; con tipo (blue, oficial, bna, bolsa, mep, ccl, cripto, tarjeta, mayorista, futuro), uno.
get_cotizacion	Cotización de una moneda (usd, eur, brl, clp, uyu) o de un índice (arg: riesgo, cer, uva), con origin opcional.
list_cotizaciones	Todas las cotizaciones e índices con su valor actual.
get_cotizacion_historica	El valor de un par en una fecha (YYYY-MM-DD) y, si se quiere, una hora (HH:MM). Trae quotedAt y daysStale, que dicen de cuándo es realmente el valor.

Cada herramienta devuelve el mismo objeto que la ruta equivalente de la API, como texto JSON y en structuredContent.data.

Claude Code

claude mcp add --transport http monedapi https://monedapi.ar/api/mcp

Claude Desktop

En Configuración → Conectores → Agregar conector personalizado, pegá la URL:

https://monedapi.ar/api/mcp

Cursor

En ~/.cursor/mcp.json (o en Settings → MCP):

{
  "mcpServers": {
    "monedapi": {
      "url": "https://monedapi.ar/api/mcp"
    }
  }
}

Clientes solo stdio

Para un cliente que solo habla MCP por stdio, usá mcp-remote como puente:

{
  "mcpServers": {
    "monedapi": {
      "command": "npx",
      "args": ["mcp-remote", "https://monedapi.ar/api/mcp"]
    }
  }
}

Prueba rápida

# Dólar blue ahora
curl https://monedapi.ar/api/v2/usd/blue

# Todos los tipos de dólar
curl https://monedapi.ar/api/v2/usd

# El blue del 29 de septiembre de 2026
curl https://monedapi.ar/api/v2/date/2026-09-29/usd/blue

{
  "currency": "USD",
  "name": "Dólar Blue",
  "origin": "BLUE",
  "buy": 1540,
  "sell": 1560,
  "updatedAt": "2026-09-29T18:54:13.917-03:00",
  "lastScrapedAt": "2026-09-30T18:33:24.838-03:00",
  "valueType": "money",
  "change": { "amount": 0, "percent": 0, "referenceValue": 1560 }
}

buy es la compra y sell la venta, en pesos argentinos.

ChatGPT: GPT personalizado con acciones

1. En ChatGPT, creá un GPT y, en Configure, elegí Create new action.
2. En Import from URL, pegá https://monedapi.ar/openapi.json.
3. En Authentication, elegí None.

Con eso el GPT puede responder preguntas como “¿a cuánto está el dólar blue?” o “¿a cuánto estaba el euro oficial el 29 de septiembre?” llamando a MonedAPI.

Gemini, LangChain y otros frameworks

Gemini, LangChain, LlamaIndex y otros frameworks aceptan un esquema OpenAPI como definición de herramientas. Usá https://monedapi.ar/openapi.json, o declará a mano una herramienta HTTP que llame a las rutas.

Un ejemplo mínimo de herramienta, en Python:

import requests

def cotizacion(moneda: str, origen: str) -> dict:
    """Cotización actual de un par de MonedAPI, como usd/blue o arg/riesgo."""
    res = requests.get(f"https://monedapi.ar/api/v2/{moneda}/{origen}", timeout=10)
    res.raise_for_status()
    return res.json()

Instrucciones para el agente

Si armás el prompt de un agente, estas reglas evitan los errores más comunes:

- Para el dólar, pedí https://monedapi.ar/api/v2/usd: trae todos los tipos en un pedido.
- Para todo junto, pedí https://monedapi.ar/api/v2/quotes.
- "buy" es compra y "sell" es venta. En Riesgo País, CER y UVA son iguales.
- Riesgo País está en puntos, CER es un coeficiente y el resto está en pesos.
- Para un valor en una fecha pasada, usá /api/v2/date/{YYYY-MM-DD}/{moneda}/{origen}
  y mirá "quotedAt": dice cuándo se observó el valor.
- Los valores se actualizan cada 5 minutos. No repitas el pedido más de una vez por minuto.
- Si la API responde 429, esperá los segundos de Retry-After antes de reintentar.

Límites

• Las cotizaciones actuales se sirven desde caché y no tienen el límite por IP del histórico.
• El histórico, la consulta por fecha y el servidor MCP aceptan, entre todos, 20 pedidos cada 10 segundos por IP. Por encima, la API responde 429 en texto plano con Retry-After: 10. Una conexión MCP con una llamada son unos 4 pedidos.
• Un par que no existe, en las cotizaciones actuales, responde 403 con una página HTML. Un agente que interpreta el cuerpo como JSON tiene que revisar antes el código de estado.