Dúvidas ou problemas? Poste no GitHub Discussions.

Converta moedas e consulte cotações atuais ou históricas direto do seu assistente de IA, pelo servidor oficial de Model Context Protocol. Os dados diários remontam a 1948.

Adicione https://mcp.frankfurter.dev/ como servidor HTTP remoto. Não precisa de chave de API nem cadastro.

ChatGPT

  1. Abra Configurações e depois Apps (ou Conectores).
  2. No canto superior direito, clique em Configurações avançadas e ative o Modo de desenvolvedor para liberar a criação de apps personalizados.
  3. Volte ao submenu Apps e clique em Criar app (ou Criar conector).
  4. Informe a URL do endpoint: https://mcp.frankfurter.dev/.
  5. Em autenticação, escolha Nenhuma.

Claude

No Claude Code:

claude mcp add frankfurter https://mcp.frankfurter.dev/

No Claude Desktop ou Claude.ai:

  1. Abra Configurações e depois Conectores.
  2. Clique em Adicionar conector personalizado.
  3. Informe a URL do endpoint: https://mcp.frankfurter.dev/.
  4. Clique em Adicionar para concluir. Depois de conectado, ative o conector na interface do chat.

Outros clientes

Adicione à sua configuração do MCP (Cursor, Windsurf, VS Code, etc.):

{
  "mcpServers": {
    "frankfurter": {
      "url": "https://mcp.frankfurter.dev/"
    }
  }
}

Ferramentas

Depois de conectar, estas ferramentas ficam disponíveis para o seu assistente de IA:

convert
Converte um valor entre duas moedas. Retorna o valor convertido e a cotação.
Parâmetros:
  • amount (number, obrigatório): o valor a converter.
  • from (string, obrigatório): código da moeda ou ativo de origem (ex.: USD, XAU ou BTC).
  • to (string, obrigatório): código da moeda ou ativo de destino (ex.: EUR).
  • date (string, opcional): data específica YYYY-MM-DD para conversão histórica.
  • provider (string, opcional): chave de uma fonte (ex.: ECB ou UST), para usar a taxa publicada por uma instituição em vez da combinação. Em fontes semanais, mensais ou trimestrais, uma data dentro do período retorna a taxa em vigor.
get_rates
Consulta taxas de câmbio de referência.
Parâmetros:
  • date (string, opcional): data da cotação YYYY-MM-DD (padrão: a mais recente).
  • base (string, opcional): código da moeda ou ativo base (padrão: EUR).
  • quotes (string ou array, opcional): filtra os resultados por códigos de moeda ou ativo.
  • provider / providers (string ou array, opcional): uma ou mais chaves de fontes. Na moeda base da própria fonte, os dígitos vêm exatamente como publicados, com a data em que entraram em vigor.
list_currencies
Lista todos os códigos suportados de moedas, metais preciosos e criptoativos, com seus nomes.
list_providers
Lista as instituições incluídas, com chave, tipo de cotação, frequência e período de cobertura, para você escolher um provider. Instituições que publicam mais de um conjunto de dados também os listam. Uma chave de conjunto de dados como NBP.B em provider seleciona só ele.

Se você precisa de uma série temporal, um intervalo histórico ou dados em lote, use a API REST.