Exchangerate.dev

@nusantara-ventures/exchangerate-mcp

Renombrado. Este paquete se publicó anteriormente como exchangerate-dev-mcp. Ese nombre está obsoleto y no recibirá actualizaciones: instala @nusantara-ventures/exchangerate-mcp en su lugar. No hubo cambios de API con el cambio.

Puente Stdio para exchangerate.dev: tasas de referencia FX de nivel desarrollador, indicativas y conscientes de sesión para agentes de IA. Tipos de cambio en vivo, conversión de divisas y datos históricos de FX para Claude, Cursor y cualquier cliente MCP (Model Context Protocol). Tasas indicativas (datos de mercado agregados + tasas de referencia públicas), no para liquidación ni trading.

Proxy ligero: el puente no contiene definiciones de herramientas ni esquemas. Cada herramienta se sirve en vivo desde el endpoint MCP HTTP api.exchangerate.dev, por lo que las descripciones y esquemas siempre están actualizados.

¿Prefieres una conexión remota? El servidor también se ejecuta directamente en https://api.exchangerate.dev/v1/mcp/ (HTTP transmitible) y está listado en el registro oficial de MCP como dev.exchangerate/mcp: no requiere instalación:

claude mcp add --transport http exchangerate-dev https://api.exchangerate.dev/v1/mcp/

Inicio rápido

{
  "mcpServers": {
    "exchangerate-dev": {
      "command": "npx",
      "args": ["-y", "@nusantara-ventures/exchangerate-mcp"]
    }
  }
}

Se requiere una clave API. Obtén una en https://exchangerate.dev/pricing: el plan gratuito incluye acceso MCP. Para ejecutar sin clave en el grupo anónimo compartido de nivel gratuito, también establece ALLOW_ANONYMOUS=true:

{
  "mcpServers": {
    "exchangerate-dev": {
      "command": "npx",
      "args": ["-y", "@nusantara-ventures/exchangerate-mcp"],
      "env": { "EXCHANGERATE_API_KEY": "your-key-here" }
    }
  }
}

Herramientas

Herramienta	Qué hace
list_currencies	divisas admitidas + metadatos de tipo/decimals
get_rate	par único, en vivo o histórico
convert	conversión de montos con redondeo correcto de unidades menores
get_range	series temporales para gráficos/análisis
search_docs	permite que el agente consulte el comportamiento de la API por sí mismo

Cada respuesta está etiquetada con frescura: un campo source indica si el número proviene del flujo intradía en vivo (actualizaciones de ~60s en días hábiles para divisas negociadas activamente) o de la referencia diaria del BCE, y market_session indica si el mercado FX está actualmente abierto.

Env

Variable	Requerida	Predeterminado	Descripción
EXCHANGERATE_API_KEY	Sí*	—	Token Bearer para acceso a la API. Requerido por defecto.
ALLOW_ANONYMOUS	No	—	Establecer a "true" para permitir acceso anónimo de nivel gratuito sin clave API. Comparte el grupo de límite de tarifa de nivel gratuito; sin rastro de auditoría.
EXCHANGERATE_BASE_URL	No	https://api.exchangerate.dev	Sobrescribir origen de la API (pruebas/staging).
EXCHANGERATE_TIMEOUT	No	10000	Tiempo de espera de solicitud en milisegundos.

* Establece ALLOW_ANONYMOUS=true para optar por acceso anónimo de nivel gratuito en su lugar.

Desarrollo

npm install
npm run build   # tsc -> dist/

Documentación

Referencia completa de API y precios: exchangerate.dev/docs — la API REST es compatible con Frankfurter (parámetros base + symbols) si prefieres omitir MCP y curl.

MIT © Nusantara Ventures LLC