Servidor MCP · OAuth 2.1 · Streamable HTTP

Preços de metais ao vivo, direto no seu assistente de IA

Conecte Claude, ChatGPT, Cursor ou VS Code à MetalAPI e peça, em linguagem natural, preços de ouro, prata, platina, energia, moedas e cripto — ao vivo, históricos ou convertidos para qualquer unidade.

Conecte seu assistente Obtenha uma chave de API grátis

URL do servidor MCP

https://metalapi.com/mcp

Pergunte em vez de programar

Seu assistente escolhe a ferramenta certa, chama a MetalAPI e responde com números reais.

Qual é o preço do ouro por grama em euros agora?

O ouro está sendo negociado a cerca de €110,40 por grama (USD 3.997,89 por onça troy), segundo a cotação mais recente da MetalAPI.

Como a prata se comportou nas últimas duas semanas?

A prata fechou entre US$ 52,10 e US$ 54,30 e terminou 3,1% acima do valor de duas semanas atrás. Aqui está a série diária…

Converta 2,5 onças troy de platina para liras turcas.

2,5 oz de platina valem cerca de ₺98.600 pelo preço mais recente.

Respostas ilustrativas. As respostas reais usam os preços mais recentes que o seu plano permite.

Conecte em um minuto

Faça login com sua conta MetalAPI nos apps que oferecem suporte a conectores ou cole uma chave de API na configuração MCP do seu editor.

Claude (claude.ai e Claude Desktop)

1Abra Configurações → Conectores e escolha Adicionar conector personalizado.
2Dê o nome MetalAPI e informe https://metalapi.com/mcp.
3Clique em Conectar, faça login na MetalAPI (ou crie uma conta grátis) e clique em Allow.

ChatGPT

1Abra Configurações → Apps e conectores e crie um conector (modo desenvolvedor).
2Informe https://metalapi.com/mcp e escolha a autenticação OAuth.
3Faça login na MetalAPI e aprove a conexão.

Claude Code

Chave de API

Ou adicione sem --header e execute /mcp para fazer login.

claude mcp add --transport http metalapi https://metalapi.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Chave de API

Adicione isto a ~/.cursor/mcp.json (ou a .cursor/mcp.json em um projeto).

{
  "mcpServers": {
    "metalapi": {
      "url": "https://metalapi.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code (GitHub Copilot)

Chave de API

Salve como .vscode/mcp.json; o VS Code pede a chave uma vez e a armazena com segurança.

{
  "inputs": [
    { "type": "promptString", "id": "metalapi-key", "description": "MetalAPI API key", "password": true }
  ],
  "servers": {
    "metalapi": {
      "type": "http",
      "url": "https://metalapi.com/mcp",
      "headers": { "Authorization": "Bearer ${input:metalapi-key}" }
    }
  }
}

Guia passo a passo

13 ferramentas, uma conexão

As ferramentas de dados de mercado contam nas requisições mensais do seu plano exatamente como chamadas REST. As ferramentas de conta são gratuitas.

get_latest_pricesSomente leitura

Preços mais recentes de metais, energia, moedas e cripto, em qualquer moeda base e unidade.

get_historical_pricesSomente leitura

Preços de fechamento de qualquer dia passado: moedas desde 1999, metais e energia desde 2000.

convertSomente leitura

Converte um valor entre dois símbolos quaisquer, agora ou em um dia passado.

get_timeseriesSomente leitura

Preços de fechamento diários entre duas datas.

get_fluctuationSomente leitura

Preço inicial e final, variação absoluta e percentual entre duas datas.

get_ohlcSomente leitura

Abertura, máxima, mínima e fechamento de um dia.

get_carat_pricesSomente leitura

Preço do ouro por grama para cada quilate, de 8K a 24K.

list_symbolsSomente leitura

Todos os símbolos suportados, com nomes, categorias e unidades.

get_accountSomente leitura

Seu plano, franquia mensal e uso.

list_plansSomente leitura

Todos os planos, com limites e preços.

list_api_keysSomente leitura

Suas chaves de API ativas (mascaradas).

create_api_keyPede confirmação

Cria uma chave de API para seus próprios apps (somente em conexões OAuth).

get_upgrade_linkPede confirmação

Prepara um link de checkout do Stripe para um plano maior — você mesmo abre e faz o pagamento.

Seguro por design

Sua conta, seu consentimento

OAuth 2.1 com PKCE: você faz login em metalapi.com e aprova cada app. Desconecte quando quiser em Settings → Connected apps.

Somente leitura por padrão

Onze das treze ferramentas apenas leem dados. As duas que alteram algo — criar uma chave e preparar um link de checkout — pedem sua confirmação antes.

Nenhum pagamento pela IA

O assistente pode preparar um link de checkout, mas só você pode pagá-lo. O servidor MCP nunca faz nenhuma cobrança.

Os mesmos limites da API

As chamadas de dados de mercado ficam registradas no seu painel e contam para a mesma cota mensal e os mesmos limites por minuto das requisições REST.

Desenvolvendo com uma ferramenta de programação com IA?

Indique a ela a nossa documentação legível por máquina, e ela escreverá a integração para você.

Listado no MCP Registry oficial como com.metalapi/metalapi.

metalapi.com/llms.txt

Mapa da documentação para LLMs

metalapi.com/llms-full.txt

Toda a documentação em um único arquivo

metalapi.com/openapi.json

Especificação OpenAPI 3.1

Perguntas

Preciso de um plano pago?+

Não. O plano Free (100 requisições por mês, preços diários) funciona com todas as ferramentas de dados, exceto os preços do ouro por quilate. Os planos pagos oferecem preços mais recentes e limites maiores.

Quais assistentes funcionam com a MetalAPI?+

Qualquer cliente MCP compatível com Streamable HTTP: Claude (web, desktop e Claude Code), conectores do ChatGPT, Cursor, VS Code com GitHub Copilot, Windsurf e outros.

O assistente pode ver meus outros dados?+

Não. A conexão só acessa a MetalAPI: preços, seu plano, uso e chaves de API. Ela nunca vê suas conversas nem outros apps.

E se eu atingir meu limite mensal?+

As ferramentas de dados retornam um erro de cota excedida com um link de upgrade até o dia 1º do mês. As ferramentas de conta continuam funcionando.

Dê ao seu assistente dados reais de mercado

Crie uma conta grátis, conecte seu assistente e faça sua primeira pergunta em menos de dois minutos.

Criar conta grátis Leia o guia de configuração