Mesa do Dólar MCP
Bring the site’s data into your AI assistant. The server is public, free and read-only.
Connect in 1 minute
Copy the server address and paste it into your assistant. No key or sign-up needed.
https://mesadodolar.com.br/mcp
Streamable HTTP transport, stateless, no login. Limit of 60 requests per minute per address.
- On claude.ai, open "Customize > Connectors" (claude.ai/customize/connectors).
- Click "+ Add", then "Add custom connector".
- Enter a name (for example, Mesa do Dólar), paste the address and click "Continue".
- Under "Authentication", pick "No sign in" and click "Add".
- In the chat, open the "+", go to "Connectors" and turn the connector on.
The connector lives in your account and also works in Claude Desktop. The Free plan allows one custom connector. On Team and Enterprise, an Owner adds it under "Organization settings > Connectors".
In the terminal:
claude mcp add --transport http mesa-do-dolar https://mesadodolar.com.br/mcp
To check: "claude mcp list" in the terminal or "/mcp" inside Claude Code.
- In ChatGPT on the web, open chatgpt.com/plugins.
- Select the plus button, then "Add custom MCP server".
- Enter a name and, under "Connection", paste the address in "Server URL".
- For authentication, pick "No authentication".
- Read the risk warning, select "I understand and want to continue" and then "Create as a plugin".
- Install the plugin and, in the chat, type @ to pick Mesa do Dólar.
OpenAI does not say which plans get this option: it depends on your plan and on your workspace rules.
Paste into ~/.cursor/mcp.json (all projects) or .cursor/mcp.json in the project root:
{
"mcpServers": {
"mesa-do-dolar": {
"url": "https://mesadodolar.com.br/mcp"
}
}
}In the Command Palette, run "MCP: Add Server", choose HTTP and paste the address. Or paste into ~/.copilot/mcp-config.json:
{
"mcpServers": {
"mesa-do-dolar": {
"type": "http",
"url": "https://mesadodolar.com.br/mcp",
"tools": [
"*"
]
}
}
}Test it with a question
Once connected, just ask. Three examples:
What is the US dollar at in Brazil right now?
What was the PTAX on October 30, 2026?
Did the Central Bank of Brazil intervene in the FX market in the last 30 days?
The answer should state the date of the data. If the assistant does not use the connector, ask: "check Mesa do Dólar".
What you can look up (28 tools)
See the 28 tools and their parameters
| Tool | What it returns and parameters |
|---|---|
| cotacao_agora USD/BRL spot rate now | The USD/BRL spot rate shown at the top of the site (R$ per US$). While the B3 session is open (business days, 9:00 to 18:30 Brasília time) it is a real-time estimate: the B3 spot rate (dollar futures minus the spot-futures spread, which arrives 15 minutes late) adjusted by the move in the digital dollar over those 15 minutes. With the session closed (evening, weekend, holiday) it is the close of the last session, frozen, with its date in fechamento_data; the digital dollar, which trades 24 hours a day, comes separately as a reference. Includes the change and what it was measured against. It is not the PTAX. Questions about USDT, USDC or the gap between the digital dollar and the spot rate go to dolar_digital, not this one. No parameters. |
| ptax PTAX for a date | PTAX buying and selling rates for the dollar (R$ per US$) published by the Central Bank of Brazil. Without a date, returns the latest. On weekends or holidays returns the previous business day’s rate and says so. data: date YYYY-MM-DD. Date YYYY-MM-DD. Leave out for the latest. |
| ptax_periodo PTAX over a period | Daily PTAX buying and selling series between two dates. Up to 400 business days per call (about 19 months); for longer periods, make more than one call. de (required): date YYYY-MM-DD. Start date YYYY-MM-DD ate (required): date YYYY-MM-DD. End date YYYY-MM-DD |
| ptax_mes PTAX for a month | Summary of the PTAX selling rate for a month: monthly average, last business day rate, high and low. This is the query used in accounting closes and contracts. ano (required): integer from 1985 to 2100 mes (required): integer from 1 to 12 |
| panorama_dolar US dollar overview | Current snapshot of the dollar in Brazil from official data: latest PTAX, changes, volatility, 12-month high and low, reserves, swap and credit line stocks, Selic, Focus and Mesa do Dólar’s automatic reading (bias, upward and downward factors, levels and the chance of Central Bank intervention). No parameters. |
| atuacoes_bc Central Bank FX interventions | What the Central Bank of Brazil did in the FX market: FX auctions read from the day’s announcements (date, cap, amount accepted, cut-off rate) and changes in the stocks of credit lines and FX swaps, on the settlement or maturity date. Volume in US$ millions; negative is a maturity. limite: integer from 1 to 100. How many interventions, from the latest backwards. Default 20. |
| serie Central Bank series | Latest values of a series: "reservas" (international reserves), "swaps" (FX swap stock), "linhas" (stock of credit lines with repurchase), all in US$ millions, "selic" (target, % a year) and the daily FX flow in US$ millions ("fluxo_total", "fluxo_comercial", "fluxo_financeiro"; positive is a net inflow). Without a code, lists the available series. codigo: one of: reservas, swaps, linhas, selic, fluxo_total, fluxo_comercial, fluxo_financeiro pontos: integer from 1 to 400. How many values, from the latest backwards. Default 30. |
| fluxo_cambial FX flows | Balance of FX contracted in Brazil (dollars in minus dollars out), split into trade and financial, summed by week, month or year, plus the year to date through the latest day published against the previous year through the same date. US$ millions; positive is a net inflow. The Central Bank publishes the days in batches, about a week late. periodo: one of: semana, mes, ano. Grouping. Default: week. quantos: integer from 1 to 120. How many periods, from the latest backwards. Default 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: integer from 1 to 48. Quantos meses, do mais recente para trás. Padrão 12. |
| fundos_cambiais FX funds against the dollar (PTAX) | How much the units of Brazilian dollar FX funds open to individuals returned (CVM data) over 1, 3, 6 and 12 months, the simple median across them and the change in the PTAX selling rate on the same dates. The difference is what the fund returned above or below the dollar itself: it adds the FX coupon (the dollar interest on the fund’s holdings) and subtracts the management fee. Over short windows the difference also mixes timing: the unit price uses the end-of-day dollar and the PTAX is set by 1 p.m. Funds are listed by net assets, not by return. Left out: exclusive or professional-investor funds, euro funds, funds under R$ 10 million in net assets, with fewer than 20 unitholders (usually a master fund) and funds that move against the dollar. Not investment advice. limite: integer from 1 to 100. How many funds to list, from the largest to the smallest by net assets. Default: 20. |
| dolar_futuro Dollar futures on B3 | B3 dollar futures quote: the most traded expiry (price, change over the previous settlement), the session volume adding the full contract (DOL) and the mini (WDO), and the list of expiries with contracts traded and open. Prices in reais per dollar. The public B3 quote arrives 15 minutes late. contrato: one of: DOL, WDO. Which contract’s expiries to list. Default: DOL (full size, US$ 50,000). |
| dolar_digital Digital dollar (USDT and USDC in reais) | Price in reais of the dollar stablecoins (USDT and USDC) on exchanges, with the last 24 hours’ change and volume and the gap to the B3 spot dollar. The market is open 24 hours, weekends included; the price updates every 2 seconds. No parameters. |
| exterior The dollar abroad | What happens outside Brazil and moves the dollar here: the dollar’s strength worldwide (the Fed’s broad index and a 6-currency basket using the DXY formula, calculated with ECB rates; not the official DXY), US interest rates (2- and 10-year Treasuries, Fed Funds and SOFR), the Brazil × US interest rate differential, speculators’ positions in CME Brazilian real futures (weekly CFTC COT report) and commodities (daily Brent; monthly iron ore and soybeans). Every number comes with a date and source. semanas_cftc: integer from 1 to 52. How many weeks of CME positions, from the latest backwards. Default 4. |
| noticias_cambio FX headlines | Recent headlines on the dollar and the economy (up to 3 days) from the public feeds of g1, Agência Brasil, the Central Bank of Brazil and the Federal Reserve: title, outlet, link and publication date and time (Brasília time). The site keeps only the title, not the article. Useful to tell what the press links to the dollar’s move, always credited to the outlet. limite: integer from 1 to 20. How many headlines, newest first. Default 10. |
| focus Focus: dollar forecast | Median forecast for the dollar at the end of each year in the Central Bank of Brazil’s Focus survey (a weekly survey of banks, asset managers and consultancies), with the low, the high and the number of responses. R$ per US$. No parameters. |
| converter Convert dollars and reais at the PTAX | Converts an amount between dollars and reais at the PTAX selling rate for a date (or the latest). Does not include spread, fees or IOF tax: what banks and exchange houses charge is higher. valor (required): number (decimal point), greater than 0 de (required): one of: USD, BRL. Currency of the amount given data: date YYYY-MM-DD |
| agenda US dollar calendar | Upcoming events that may move the dollar: Copom and Fed decisions, US payroll and CPI, IPCA, Focus, FX flows, the month-end PTAX, B3 dollar futures expiry, credit line repurchases and auctions already announced by the Central Bank. Dates from official calendars, Brasília time, each event with its source. Filters by type and end date. ate: date YYYY-MM-DD. Last date YYYY-MM-DD. Leave out for the next six months. tipo: one of: copom, fomc, payroll, cpi, ipca, focus, fluxo, ptax-mes, vencimento-dol, vencimento-linha, vencimento-swap, leilao. Only one type of event. limite: integer from 1 to 100. Maximum number of events (default 30). |
| dolar_a_termo Forward rate and cost of locking in the dollar (hedge) | Theoretical forward price of the dollar for a date, interpolated between the B3 dollar futures (DOL) expiries, applied to the current reference spot rate. Returns the cost of locking in today against spot, the check by interest rate differential (DI futures × SOFR) with the implied FX coupon, and scenarios of +10%, +5%, 0, −5% and −10% with and without locking in. Market price, without bank spread. Makes no recommendation. data: date YYYY-MM-DD. Date of the dollar payment or receipt (YYYY-MM-DD). Default: 90 days from now. valor_usd: number (decimal point), greater than 0. Amount in dollars. Default: 10,000. lado: one of: pagar, receber. Whether the person will pay or receive dollars on the date. Default: pagar (pay). |
| remessas_vet VET ranking: where the dollar is cheapest | The Central Bank of Brazil’s monthly ranking of the effective total cost (VET, reais per dollar, including rate, fees and IOF tax) by provider: cash, prepaid card or personal transfer to the US, buying or selling, from best to worst for the customer, with the gap to the same month’s average PTAX. Published about 2 months late. opcao: one of: especie, cartao, remessa. especie (cash), cartao (prepaid card) or remessa (transfer to the US). Default: especie. operacao: one of: compra, venda. compra (customer buys or sends dollars) or venda (sells or receives). Default: compra. valor_usd: one of: 100, 1000, 5000. Operation amount range in US$: 100, 1000 or 5000. Default: 1000. mes: date YYYY-MM-DD. Reference month, as YYYY-MM-01. Default: the latest published. |
| remessas_hoje Remittances today: how much arrives, by provider | Today’s price of an international transfer, by provider, from Wise’s public comparison tool (collected every 30 minutes): exchange rate, fee, amount received and the gap to the mid-market rate (the rate without a margin, as reported by Wise). Two directions: usd_brl (US$ 1,000 from the US to Brazil, several providers) and brl_usd (R$ 5,000 from Brazil to the US, where the tool only lists Wise itself). It is not the Central Bank of Brazil’s VET ranking (remessas_vet), which is the average each provider charged about 2 months ago. Listed by amount received, with no provider singled out. Not a recommendation. sentido: one of: usd_brl, brl_usd. usd_brl: send US$ 1,000 from the US to Brazil. brl_usd: send R$ 5,000 from Brazil to the US. Default: usd_brl. |
| glossario FX glossary | Plain-language explanation of FX terms (PTAX, FX swap, credit line auction, FX coupon, VET and others). Without a term, lists the available ones. termo: text (up to 60 characters). Term identifier, for example "swap-cambial". |
| real_e_emergentes The real against other emerging currencies | Was the dollar move about Brazil or the world? Change of the dollar against the real and against emerging currencies (Mexican, Chilean and Colombian pesos, Peruvian sol, South African rand, Turkish lira, Indian and Indonesian rupees, won, yuan, zloty and forint) on the day, over 5 and over 20 business days, all at the Central Bank of Brazil closing on the same day. Positive = the dollar rose and the currency lost value. Includes the rule-based read, which compares the size of the move in the real with the median and the dispersion of the emerging currencies: global, mostly Brazilian or a bit of both. Use the alcance field as the conclusion; do not conclude from the count of currencies. No parameters. |
| diferencial_juros Brazil × US interest rate gap | Selic target minus the effective Fed Funds rate, in percentage points: the current value and the weekly history since December 2016. The wider the gap, the more an investor earns by bringing dollars to Brazil, which tends to support the real; when it narrows, that support weakens. semanas: integer from 1 to 600. How many weeks of history, from the latest back. Default 52. |
| cotacao_moeda Other currencies in Brazilian reais | Central Bank of Brazil closing rate in reais (R$ per unit, buying and selling) for the euro, pound, yen, Swiss franc, Canadian and Australian dollars, Danish, Norwegian and Swedish kroner (these nine have their own PTAX), Argentine, Mexican, Chilean and Colombian pesos, Peruvian sol, yuan, Indian rupee and Indonesian rupiah, won, rand, Turkish lira, zloty and forint (closing rate: the dollar PTAX crossed with the parity). Without a currency, lists all of them at the latest close with the daily and 20 business day change. With a currency, returns the latest rate (or the rate on a date; with no rate that day, the previous business day applies), the 1, 5 and 20 business day change, the parity against the dollar and the bulletin time. With an amount, converts at the selling rate both ways, with no spread, fee or IOF tax. History since 2000. moeda: one of: EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK, ARS, MXN, CLP, COP, PEN, CNY, INR, IDR, KRW, ZAR, TRY, PLN, HUF. ISO currency code (EUR, GBP, ARS...). Leave out to list all. data: date YYYY-MM-DD. Date YYYY-MM-DD (needs the currency). Leave out for the latest. valor: number (decimal point), greater than 0. Amount to convert (needs the currency). de: one of: moeda, BRL. Currency of the amount: "moeda" (the requested code) or "BRL". Default "moeda". |
| moeda_periodo A currency over a period | Daily Central Bank of Brazil closing rate of one currency in reais (buying, selling and units per US$ 1) between two dates, since 2000. Up to 400 business days per call; for longer periods, make more than one call. moeda (required): one of: EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK, ARS, MXN, CLP, COP, PEN, CNY, INR, IDR, KRW, ZAR, TRY, PLN, HUF. ISO currency code (EUR, GBP, ARS...). de (required): date YYYY-MM-DD. Start date YYYY-MM-DD ate (required): date YYYY-MM-DD. End date YYYY-MM-DD |
| custo_compra_dolar Real cost of buying dollars today, by channel | How much buying a dollar amount costs in reais today through each channel: cash, prepaid card, credit or debit card abroad and transfer to your own account in the US. Calculation: latest PTAX selling rate × (VET ÷ that month’s average PTAX), using the median provider and the 3 lowest VETs in the Central Bank of Brazil ranking, splitting out each channel’s IOF tax and the spread with fees, and the gap to the bare PTAX. The VET comes out about 2 months late: it is a reference, not the provider’s rate right now. Credit cards are not in the VET ranking: only the floor (PTAX + IOF) is given. Not investment advice. valor_usd: number (decimal point), greater than 0. Amount in dollars. Default: 1,000. |
| custo_viagem Travel calculator: what it costs in reais | Total cost in reais of a trip from days, daily spending in dollars and the share taken in cash (the rest on card): cash and prepaid card at the median Central Bank VET applied to the latest PTAX selling rate, credit card at the PTAX + IOF floor, with IOF shown separately. Includes the same calculation with the dollar 5% lower and 5% higher on the purchase day (sensitivity, not a forecast). Not investment advice. dias: integer from 1 to 365. Days of travel. Default: 7. gasto_dia_usd: number (decimal point), greater than 0. Daily spending at the destination, in US$. Default: 200. especie_pct: integer from 0 to 100. Share of spending taken in cash, in % (the rest on card). Default: 30. |
| dolar_corrigido Inflation-adjusted dollar (what it was worth on a date) | PTAX selling rate for a date since 1994-07-01 (on weekends or holidays, the previous business day’s rate, flagged) and what a dollar amount on that date is worth today in reais adjusted by IPCA (Central Bank SGS series 433, IBGE monthly change), up to the latest month published. Includes the “real dollar”: US$ 1 of that date in today’s reais, compared with the latest PTAX. In the month of the date only the remaining days count; the following months count in full. No spread, fees or IOF. It does not say whether the dollar is expensive or cheap. Not investment advice. data (required): date YYYY-MM-DD. Date YYYY-MM-DD, from 1994-07-01 to today. valor_usd: number (decimal point), greater than 0. Amount in dollars. Default: 1. |
The list comes from the server’s own catalog: new tools show up here on their own. Data from the Central Bank of Brazil, B3 and digital dollar exchanges, all public. Nothing here is investment advice.
No AI assistant?
The same data are available in the public JSON API and in the exchange rate widget for your website.