MCP da Mesa do Dólar
Leve os dados do portal para dentro do seu assistente de IA. O servidor é público, gratuito e só de leitura.
Conectar em 1 minuto
Copie o endereço do servidor e cole no seu assistente. Não precisa de chave nem de cadastro.
https://mesadodolar.com.br/mcp
Transporte Streamable HTTP, sem sessão e sem login. Limite de 60 requisições por minuto por endereço.
- Em claude.ai, abra "Customize > Connectors" (claude.ai/customize/connectors).
- Clique em "+ Add" e depois em "Add custom connector".
- Dê um nome (por exemplo, Mesa do Dólar), cole o endereço e clique em "Continue".
- Em "Authentication", escolha "No sign in" e clique em "Add".
- Na conversa, abra o "+", vá em "Connectors" e ligue o conector.
O conector fica na sua conta e vale também no Claude Desktop. No plano Free cabe um conector personalizado. Em Team e Enterprise, quem adiciona é um Owner, em "Organization settings > Connectors". Os nomes dos menus estão em inglês, como na documentação da Anthropic.
No terminal:
claude mcp add --transport http mesa-do-dolar https://mesadodolar.com.br/mcp
Para conferir: "claude mcp list" no terminal ou "/mcp" dentro do Claude Code.
- No ChatGPT pela web, abra chatgpt.com/plugins.
- Clique no botão de mais e em "Add custom MCP server".
- Dê um nome e, em "Connection", cole o endereço em "Server URL".
- Na autenticação, escolha "No authentication".
- Leia o aviso de risco, marque "I understand and want to continue" e clique em "Create as a plugin".
- Instale o plugin e, na conversa, digite @ para escolher a Mesa do Dólar.
A OpenAI não informa em quais planos a opção aparece: depende do seu plano e das regras do seu workspace. Os nomes dos menus estão em inglês, como na documentação da OpenAI.
Cole em ~/.cursor/mcp.json (vale para todos os projetos) ou em .cursor/mcp.json na raiz do projeto:
{
"mcpServers": {
"mesa-do-dolar": {
"url": "https://mesadodolar.com.br/mcp"
}
}
}Na paleta de comandos, rode "MCP: Add Server", escolha HTTP e cole o endereço. Ou cole em ~/.copilot/mcp-config.json:
{
"mcpServers": {
"mesa-do-dolar": {
"type": "http",
"url": "https://mesadodolar.com.br/mcp",
"tools": [
"*"
]
}
}
}Teste com uma pergunta
Depois de conectar, pergunte normalmente. Três exemplos:
Quanto está o dólar agora?
Qual foi a PTAX de 30 de outubro de 2026?
O Banco Central atuou no câmbio nos últimos 30 dias?
A resposta deve citar a data do dado. Se o assistente não usar o conector, peça: "consulte a Mesa do Dólar".
O que dá para consultar (28 ferramentas)
Ver as 28 ferramentas e os parâmetros
| Ferramenta | O que responde e parâmetros |
|---|---|
| cotacao_agora Dólar à vista agora | O dólar à vista do topo do portal (R$ por US$). Com o pregão da B3 aberto (dia útil, das 9h às 18h30 de Brasília) é uma estimativa em tempo real: o à vista da B3 (dólar futuro menos o casado, que chega com 15 minutos de atraso) corrigido pelo movimento do dólar digital nesses 15 minutos. Com o pregão fechado (noite, fim de semana, feriado) é o fechamento do último pregão, parado, com a data em fechamento_data; o dólar digital, que negocia 24 horas, vem à parte como referência. Traz a variação e diz contra o que ela foi medida. Não é a PTAX. Pergunta sobre USDT, USDC ou a distância entre o dólar digital e o à vista é com dolar_digital, não com esta. Sem parâmetros. |
| ptax PTAX de uma data | Taxa PTAX de compra e de venda do dólar (R$ por US$) divulgada pelo Banco Central. Sem data, devolve a mais recente. Em fim de semana ou feriado devolve a do dia útil anterior e avisa. data: data AAAA-MM-DD. Data AAAA-MM-DD. Omitir para a mais recente. |
| ptax_periodo PTAX num período | Série diária da PTAX de compra e venda entre duas datas. Máximo de 400 dias úteis por chamada (cerca de 19 meses); para períodos maiores, faça mais de uma chamada. de (obrigatório): data AAAA-MM-DD. Data inicial AAAA-MM-DD ate (obrigatório): data AAAA-MM-DD. Data final AAAA-MM-DD |
| ptax_mes PTAX de um mês | Resumo da PTAX de venda de um mês: média mensal, taxa do último dia útil, máxima e mínima. É a consulta usada em fechamento contábil e em contratos. ano (obrigatório): inteiro de 1985 a 2100 mes (obrigatório): inteiro de 1 a 12 |
| panorama_dolar Panorama do dólar | Retrato atual do dólar no Brasil pelos dados oficiais: última PTAX, variações, volatilidade, máxima e mínima de 12 meses, reservas, estoques de swap e de linhas, Selic, Focus e a leitura automática da Mesa do Dólar (viés, fatores de alta e de baixa, níveis e chance de atuação do BC). Sem parâmetros. |
| atuacoes_bc Atuações do Banco Central no câmbio | O que o Banco Central fez no câmbio: leilões de câmbio lidos dos comunicados do dia (data, teto, valor aceito, taxa de corte) e mudanças nos estoques de linhas e de swap cambial, na data de liquidação ou vencimento. Volume em US$ milhões; negativo é vencimento. limite: inteiro de 1 a 100. Quantas atuações, da mais recente para trás. Padrão 20. |
| serie Série do Banco Central | Últimos valores de uma série: "reservas" (reservas internacionais), "swaps" (estoque de swap cambial), "linhas" (estoque de linhas com recompra), todas em US$ milhões, "selic" (meta, % ao ano) e o fluxo cambial diário em US$ milhões ("fluxo_total", "fluxo_comercial", "fluxo_financeiro"; positivo é entrada líquida). Sem código, lista as séries disponíveis. codigo: um de: reservas, swaps, linhas, selic, fluxo_total, fluxo_comercial, fluxo_financeiro pontos: inteiro de 1 a 400. Quantos valores, do mais recente para trás. Padrão 30. |
| fluxo_cambial Fluxo cambial | Saldo do câmbio contratado no Brasil (entrada menos saída de dólares), separado em comercial e financeiro, somado por semana, mês ou ano, e o acumulado do ano até o último dia publicado contra o ano anterior até a mesma data. US$ milhões; positivo é entrada líquida. O Banco Central publica os dias em lote, com cerca de uma semana de atraso. periodo: um de: semana, mes, ano. Agrupamento. Padrão: semana. quantos: inteiro de 1 a 120. Quantos períodos, do mais recente para trás. Padrão 12. |
| balanca_comercial Balança comercial e fluxo comercial | Balança comercial do Brasil por mês (exportação, importação e saldo, em US$ milhões FOB, do MDIC) ao lado do fluxo cambial comercial contratado no mesmo mês (Banco Central) e a diferença entre os dois. A balança conta a mercadoria quando passa pela alfândega; o câmbio pode ser fechado antes (adiantamento) ou meses depois, então a diferença é de registro e de prazo, não prova de dólar retido. O mês mais recente da balança sai nos primeiros dias úteis do mês seguinte. meses: inteiro de 1 a 48. Quantos meses, do mais recente para trás. Padrão 12. |
| fundos_cambiais Fundos cambiais contra o dólar (PTAX) | Quanto rendeu a cota dos fundos cambiais de dólar abertos à pessoa física (dados da CVM) em 1, 3, 6 e 12 meses, a mediana simples entre eles e a variação da PTAX de venda nas mesmas datas. A diferença é o que o fundo rendeu acima ou abaixo do próprio dólar: entra o cupom cambial (o juro em dólar das aplicações do fundo) e sai a taxa de administração. Em janela curta a diferença também mistura horário: a cota usa o dólar do fim do dia e a PTAX é calculada até as 13h. Lista os fundos por patrimônio, não por retorno. Ficam de fora fundos exclusivos ou de investidor profissional, de euro, com patrimônio abaixo de R$ 10 milhões, com menos de 20 cotistas (em geral fundo master) e os que andam ao contrário do dólar. Não é recomendação de investimento. limite: inteiro de 1 a 100. Quantos fundos listar, do maior patrimônio para o menor. Padrão 20. |
| dolar_futuro Dólar futuro na B3 | Cotação do dólar futuro na B3: o vencimento mais negociado (preço, variação sobre o ajuste anterior), o volume do pregão somando contrato cheio (DOL) e mini (WDO) e a lista de vencimentos com contratos negociados e em aberto. Preços em reais por dólar. A cotação pública da B3 chega com 15 minutos de atraso. contrato: um de: DOL, WDO. Lista de vencimentos de qual contrato. Padrão: DOL (cheio, US$ 50 mil). |
| dolar_digital Dólar digital (USDT e USDC em reais) | Preço em reais das stablecoins de dólar (USDT e USDC) em corretoras, com variação e volume das últimas 24 horas e a distância para o dólar à vista da B3. Mercado aberto 24 horas, inclusive fim de semana; o preço é atualizado a cada 2 segundos. Sem parâmetros. |
| exterior O dólar lá fora | O que acontece fora do Brasil e mexe com o dólar aqui: força do dólar no mundo (índice amplo do Fed e uma cesta de 6 moedas na fórmula do DXY, calculada com taxas do BCE; não é o DXY oficial), juros dos EUA (Treasuries de 2 e 10 anos, Fed Funds e SOFR), diferencial de juros Brasil × EUA, posição dos especuladores no futuro de real da CME (relatório COT da CFTC, semanal) e commodities (Brent diário; minério e soja mensais). Cada número vem com data e fonte. semanas_cftc: inteiro de 1 a 52. Quantas semanas da posição na CME, da mais recente para trás. Padrão 4. |
| noticias_cambio Manchetes de câmbio | Manchetes recentes sobre câmbio e economia (até 3 dias), dos feeds públicos de g1, Agência Brasil, Banco Central e Federal Reserve: título, veículo, link e data e hora de publicação (Brasília). O portal guarda só o título, não o texto da notícia. Serve para contar o que a imprensa associa ao movimento do dólar, sempre atribuindo ao veículo. limite: inteiro de 1 a 20. Quantas manchetes, da mais recente para trás. Padrão 10. |
| focus Focus: projeção do dólar | Mediana da projeção do dólar para o fim de cada ano no boletim Focus do Banco Central (pesquisa semanal com bancos, gestoras e consultorias), com a mínima, a máxima e o número de respostas. R$ por US$. Sem parâmetros. |
| converter Converter dólar e real pela PTAX | Converte um valor entre dólar e real pela PTAX de venda de uma data (ou a mais recente). Não inclui spread, tarifa nem IOF: o valor cobrado por bancos e casas de câmbio é maior. De dólar para real, sem data, traz também referencia_viagem: quanto o valor sai em espécie e no cartão pré-pago pela mediana do VET do Banco Central (já com spread, tarifas e IOF), quando o mês tem 5 instituições ou mais. valor (obrigatório): número (ponto decimal), maior que 0 de (obrigatório): um de: USD, BRL. Moeda do valor informado data: data AAAA-MM-DD |
| agenda Agenda do dólar | Próximos eventos que podem mexer com o dólar: decisões do Copom e do Fed, payroll e CPI dos EUA, IPCA, Focus, fluxo cambial, PTAX de fim de mês, vencimento do dólar futuro na B3, recompras de linha e leilões já anunciados pelo BC. Datas de calendários oficiais, hora de Brasília, cada evento com a fonte. Filtra por tipo e por data final. ate: data AAAA-MM-DD. Última data AAAA-MM-DD. Omitir para os próximos seis meses. tipo: um de: copom, fomc, payroll, cpi, ipca, focus, fluxo, ptax-mes, vencimento-dol, vencimento-linha, vencimento-swap, leilao. Só um tipo de evento. limite: inteiro de 1 a 100. Máximo de eventos (padrão 30). |
| dolar_a_termo Dólar a termo e custo de travar o dólar (hedge) | Preço teórico do dólar a termo para uma data, interpolado entre os vencimentos do dólar futuro (DOL) da B3, sobre o dólar à vista de referência de agora. Devolve o custo de travar hoje contra o à vista, a conferência pelo diferencial de juros (DI futuro × SOFR) com o cupom cambial implícito e cenários de +10%, +5%, 0, −5% e −10% com e sem a trava. Preço de mercado, sem spread de banco. Não recomenda nada. data: data AAAA-MM-DD. Data do pagamento ou recebimento em dólar (AAAA-MM-DD). Padrão: daqui a 90 dias. valor_usd: número (ponto decimal), maior que 0. Valor em dólares. Padrão: 10.000. lado: um de: pagar, receber. Se a pessoa vai pagar ou receber dólares na data. Padrão: pagar. |
| remessas_vet Ranking do VET: onde o dólar sai mais barato | Ranking mensal do Banco Central do valor efetivo total (VET, reais por dólar, já com taxa, tarifas e IOF) por instituição: dinheiro em espécie, cartão pré-pago ou transferência pessoal para os EUA, na compra ou na venda, do melhor para o pior para o cliente, com a distância para a PTAX média do mesmo mês. Publicado com cerca de 2 meses de atraso. opcao: um de: especie, cartao, remessa. especie, cartao (pré-pago) ou remessa (transferência para os EUA). Padrão: especie. operacao: um de: compra, venda. compra (ou envio) de dólar pelo cliente, ou venda (ou recebimento). Padrão: compra. valor_usd: um de: 100, 1000, 5000. Faixa de valor da operação em US$: 100, 1000 ou 5000. Padrão: 1000. mes: data AAAA-MM-DD. Mês de referência, no formato AAAA-MM-01. Padrão: o mais recente publicado. |
| remessas_hoje Remessas hoje: quanto chega por provedor | Preço de agora de uma remessa internacional, por provedor, no comparador público da Wise (coletado a cada 30 minutos): câmbio, tarifa, quanto chega e a diferença para o câmbio médio (o câmbio comercial, sem margem, que a Wise informa). Dois sentidos: usd_brl (US$ 1.000 dos EUA para o Brasil, vários provedores) e brl_usd (R$ 5.000 do Brasil para os EUA, onde o comparador só traz a própria Wise). É diferente do ranking do VET do Banco Central (remessas_vet), que é a média do que cada instituição cobrou cerca de 2 meses atrás. Lista por quanto chega, sem indicar provedor. Não é recomendação. sentido: um de: usd_brl, brl_usd. usd_brl: enviar US$ 1.000 dos EUA para o Brasil. brl_usd: enviar R$ 5.000 do Brasil para os EUA. Padrão: usd_brl. |
| glossario Glossário de câmbio | Explicação em linguagem simples de termos de câmbio (PTAX, swap cambial, leilão de linha, cupom cambial, VET e outros). Sem termo, lista os disponíveis. termo: texto (até 60 caracteres). Identificador do termo, por exemplo "swap-cambial". |
| real_e_emergentes O real contra outros emergentes | O movimento do dólar foi do Brasil ou do mundo? Variação do dólar contra o real e contra moedas emergentes (peso mexicano, chileno e colombiano, sol peruano, rand sul-africano, lira turca, rupias indiana e indonésia, won, yuan, zloty e florim) no dia, em 5 e em 20 dias úteis, todas no fechamento do Banco Central do mesmo dia. Positivo = o dólar subiu e a moeda perdeu valor. Traz a leitura por regras, que compara o tamanho do movimento do real com a mediana e a dispersão dos emergentes: do mundo, mais do Brasil ou um pouco dos dois. Use o campo alcance como conclusão; não conclua pela contagem de moedas. Sem parâmetros. |
| diferencial_juros Diferencial de juros Brasil × EUA | Meta Selic menos a taxa efetiva dos Fed Funds, em pontos percentuais: o valor atual e o histórico semanal desde dezembro de 2016. Quanto maior a diferença, mais o investidor ganha para trazer dólares ao Brasil, o que tende a apoiar o real; quando ela encolhe, esse apoio enfraquece. semanas: inteiro de 1 a 600. Quantas semanas do histórico, da mais recente para trás. Padrão 52. |
| cotacao_moeda Cotação de outras moedas em reais | Cotação de fechamento do Banco Central em reais (R$ por unidade, compra e venda) do euro, libra, iene, franco suíço, dólares canadense e australiano, coroas dinamarquesa, norueguesa e sueca (essas nove com PTAX própria), peso argentino, mexicano, chileno e colombiano, sol peruano, yuan, rupias indiana e indonésia, won, rand, lira turca, zloty e florim (taxa de fechamento: PTAX do dólar cruzada com a paridade). Sem moeda, lista todas no último fechamento com a variação no dia e em 20 dias úteis. Com moeda, traz a cotação mais recente (ou a de uma data; sem cotação na data, vale a do dia útil anterior), a variação em 1, 5 e 20 dias úteis, a paridade contra o dólar e o horário do boletim. Com valor, converte pela taxa de venda nos dois sentidos, sem spread, tarifa nem IOF. Histórico desde 2000. moeda: um de: EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK, ARS, MXN, CLP, COP, PEN, CNY, INR, IDR, KRW, ZAR, TRY, PLN, HUF. Sigla ISO da moeda (EUR, GBP, ARS...). Omitir para listar todas. data: data AAAA-MM-DD. Data AAAA-MM-DD (precisa da moeda). Omitir para a mais recente. valor: número (ponto decimal), maior que 0. Valor a converter (precisa da moeda). de: um de: moeda, BRL. Moeda do valor informado: "moeda" (a sigla pedida) ou "BRL". Padrão "moeda". |
| moeda_periodo Cotação de uma moeda num período | Série diária da cotação de fechamento do Banco Central de uma moeda em reais (compra, venda e unidades por US$ 1) entre duas datas, desde 2000. Máximo de 400 dias úteis por chamada; para períodos maiores, faça mais de uma chamada. moeda (obrigatório): um de: EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK, ARS, MXN, CLP, COP, PEN, CNY, INR, IDR, KRW, ZAR, TRY, PLN, HUF. Sigla ISO da moeda (EUR, GBP, ARS...). de (obrigatório): data AAAA-MM-DD. Data inicial AAAA-MM-DD ate (obrigatório): data AAAA-MM-DD. Data final AAAA-MM-DD |
| custo_compra_dolar Custo real de comprar dólar hoje, por canal | Quanto sai em reais comprar um valor em dólar hoje em cada canal: dinheiro em espécie, cartão pré-pago, cartão de crédito ou débito no exterior e transferência para conta própria nos EUA. Conta: PTAX de venda mais recente × (VET ÷ PTAX média do mês do VET), pela mediana das instituições (só com 5 instituições ou mais na faixa; com menos, vem amostra_pequena no lugar) e pelas 3 de menor VET do ranking do Banco Central, separando o IOF de cada canal e o spread com tarifas, e a diferença para a PTAX "seca". O VET sai com cerca de 2 meses de atraso: é referência, não a cotação da instituição agora. Cartão de crédito não está no ranking do VET: vem só o piso (PTAX + IOF). Não é recomendação de investimento. valor_usd: número (ponto decimal), maior que 0. Valor em dólares. Padrão: 1.000. |
| custo_viagem Calculadora de viagem: quanto custa em reais | Total em reais de uma viagem a partir de dias, gasto por dia em dólar e a parte em dinheiro em espécie (o resto no cartão): espécie e cartão pré-pago pela mediana do VET do Banco Central aplicada à PTAX de venda mais recente, cartão de crédito pelo piso PTAX + IOF, com o IOF separado. Traz a mesma conta com o dólar 5% abaixo e 5% acima no dia da compra (sensibilidade, não previsão). Não é recomendação de investimento. dias: inteiro de 1 a 365. Dias de viagem. Padrão: 7. gasto_dia_usd: número (ponto decimal), maior que 0. Gasto por dia no destino, em US$. Padrão: 200. especie_pct: inteiro de 0 a 100. Parte do gasto levada em dinheiro em espécie, em % (o resto vai no cartão). Padrão: 30. |
| dolar_corrigido Dólar corrigido pela inflação (quanto valia em tal data) | PTAX de venda de uma data desde 01/07/1994 (em fim de semana ou feriado, a do dia útil anterior, e avisa) e quanto um valor em dólares daquela data vale hoje em reais corrigidos pelo IPCA (série SGS 433 do BC, variação mensal do IBGE), até o último mês publicado. Traz o "dólar real": US$ 1 da data em reais de hoje, e a comparação com a PTAX mais recente. No mês da data entra só a parte dos dias restantes; os meses seguintes, inteiros. Sem spread, tarifa nem IOF. Não diz se o dólar está caro ou barato. Não é recomendação de investimento. data (obrigatório): data AAAA-MM-DD. Data AAAA-MM-DD, de 1994-07-01 até hoje. valor_usd: número (ponto decimal), maior que 0. Valor em dólares. Padrão: 1. |
A lista sai do próprio catálogo do servidor: ferramenta nova aparece aqui sozinha. Dados do Banco Central do Brasil, da B3 e de corretoras de dólar digital, todos públicos. Nada aqui é recomendação de investimento.
Sem assistente de IA?
Os mesmos dados estão na API pública em JSON e no widget de cotação para o seu site.