Exchangerate.dev

Taxas de câmbio sem chave para agentes de IA — 465 pares de moedas em 31 moedas, rótulos de origem e frescor de market_session em cada resposta, histórico diário desde 1999.

GitHubExperimente este MCPPatrocinado

Documentação

@nusantara-ventures/exchangerate-mcp

Renomeado. Este pacote foi publicado anteriormente como exchangerate-dev-mcp. Esse nome está obsoleto e não receberá atualizações — instale @nusantara-ventures/exchangerate-mcp em vez disso. Nenhuma mudança na API acompanhou a mudança.

Ponte Stdio para exchangerate.dev — taxas de câmbio de referência de nível desenvolvedor, indicativas e cientes de sessão, para agentes de IA. Taxas de câmbio ao vivo, conversão de moedas e dados históricos de câmbio para Claude, Cursor e qualquer cliente MCP (Model Context Protocol). Taxas indicativas (dados de mercado agregados + taxas de referência públicas), não para liquidação ou negociação.

Proxy leve: a ponte não contém definições de ferramentas ou esquemas. Cada ferramenta é servida ao vivo a partir do endpoint MCP HTTP api.exchangerate.dev, então descrições e esquemas estão sempre atualizados.

Prefere uma conexão remota? O servidor também roda diretamente em https://api.exchangerate.dev/v1/mcp/ (HTTP transmissível) e está listado no registro oficial MCP como dev.exchangerate/mcp — sem necessidade de instalação:

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

Início rápido

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

Uma chave de API é necessária. Obtenha uma em https://exchangerate.dev/pricing — o nível gratuito inclui acesso MCP. Para rodar sem chave no pool anônimo compartilhado do nível gratuito, defina também ALLOW_ANONYMOUS=true:

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

Ferramentas

Ferramenta	O que faz
`list_currencies`	moedas suportadas + metadados de tipo/decimais
`get_rate`	par único, ao vivo ou histórico
`convert`	conversão de valores com arredondamento correto de unidades menores
`get_range`	série temporal para gráficos/análise
`search_docs`	permite que o agente consulte o comportamento da API por conta própria

Cada resposta é rotulada com frescor: um campo source indica se o número veio do stream intradiário ao vivo (atualizações ~60s em dias de negociação para moedas ativamente negociadas) ou da referência diária do BCE, e market_session indica se o mercado de câmbio está atualmente aberto.

Variáveis de ambiente

Variável	Obrigatória	Padrão	Descrição
`EXCHANGERATE_API_KEY`	Sim*	—	Token Bearer para acesso à API. Obrigatório por padrão.
`ALLOW_ANONYMOUS`	Não	—	Defina como `"true"` para permitir acesso anônimo ao nível gratuito sem chave de API. Compartilha o pool de limite de taxa do nível gratuito; sem trilha de auditoria.
`EXCHANGERATE_BASE_URL`	Não	`https://api.exchangerate.dev`	Substitui a origem da API (testes / staging).
`EXCHANGERATE_TIMEOUT`	Não	`10000`	Tempo limite de solicitação em milissegundos.

* Defina ALLOW_ANONYMOUS=true para optar pelo acesso anônimo ao nível gratuito em vez disso.

Desenvolvimento

npm install
npm run build   # tsc -> dist/

Documentação

Referência completa da API e preços: exchangerate.dev/docs — a API REST é compatível com Frankfurter (parâmetros base + symbols) se você preferir pular o MCP e curl.