BCB Full Mega-Server MCP. Analyze Brazilian macro trends with official data feeds.
Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
BCB Full is the definitive Mega-Server for Brazilian economic intelligence. It gives your AI client instant access to 20,000+ SGS statistical time series from the Central Bank of Brazil (BCB).
You can pull everything: PTAX dollar quotes across currencies, Selic and CDI rates, IPCA/INPC inflation indexes, GDP variations, trade balance figures, and market expectations for all major economic variables.
What your AI agents can do
Get balanca comercial
Retrieves the historical Brazilian trade balance, which tracks exports and imports of commodities.
Get cdi
Pulls the Interbank Deposit Certificate (CDI) rate, a key benchmark for fixed-income investments in Brazil.
Get cotacao dolar
Gets the official PTAX quote for the US dollar, including both buy and sell values on specific dates.
Pull spot rates for any foreign currency at a specific date using PTAX or SGS historical series.
Compare the current Selic target rate against daily effective rates and market predictions (Focus Survey expectations).
Retrieve multiple inflation indices—IPCA, INPC, IGP-M—and their expected future values to model cost pressures.
Query key macro data points like GDP variation (IBC-Br), public debt/GDP ratios, and international reserves for stability checks.
Consult the SGS system to query over 20,000 time series codes across any available economic variable.
Ask AI about this MCP
Supported MCP Clients
Waiting for input…
BCB Full Mega-Server: 22 Tools for Brazilian Economics
These tools give your agent direct access to key economic metrics from the Central Bank of Brazil. Use them to pull historical data on rates, inflation, and macro indicators.
019d7559get balanca comercial
Retrieves the historical Brazilian trade balance, which tracks exports and imports of commodities.
019d7559get cdi
Pulls the Interbank Deposit Certificate (CDI) rate, a key benchmark for fixed-income investments in Brazil.
019d7559get cotacao dolar
Gets the official PTAX quote for the US dollar, including both buy and sell values on specific dates.
019d7559get cotacao moeda
Retrieves the current or historical exchange rate for any major foreign currency (e.g., EUR, GBP).
019d7559get desemprego
Provides the quarterly unemployment rate data for Brazil from the PNAD survey.
019d7559get divida pib
Calculates and retrieves the net public debt as a percentage of the country's Gross Domestic Product (GDP).
019d7559get dolar periodo
Fetches the historical PTAX dollar rate series over a defined time period, including opening/closing values.
019d7559get dolar sgs
Queries the commercial dollar historical series (buy/sell) using flexible SGS codes and date formats.
019d7559get expectativas inflacao
Gathers market forecasts for inflation from the Focus report, filtering by IPCA, IGP-DI, or IGP-M.
019d7559get expectativas selic
Retrieves institutional forecasts for the Selic rate using data published in the Focus Report.
019d7559get igpm
Gets the IGP-M index, commonly used as a benchmark for commercial contracts and rent adjustments.
019d7559get inpc
Retrieves the National Consumer Price Index (INPC), which measures inflation for lower-income families.
019d7559get ipca
Gets the official and widely tracked Índice Nacional de Preços ao Consumidor Amplo (IPCA) rate.
019d7559get ipca15
Pulls the IPCA-15 index, which is often used by the market as a forward indicator for official inflation.
019d7559get pib
Obtains the monthly economic activity index (IBC-Br), serving as a proxy for Brazil's Gross Domestic Product variation.
019d7559get pix estatisticas
Provides volume and transaction count statistics for PIX, Brazil's instant payment system operated by the BCB.
019d7559get reservas
Retrieves the total international reserves of Brazil in US dollars, critical for external debt assessment.
019d7559get selic diaria
Gives the daily effective Selic rate, reflecting the real-time execution of monetary policy.
019d7559get selic meta
Retrieves the official target rate for Selic set by the COPOM (Monetary Policy Committee).
019d7559get serie bcb
Consults any specific time series available in the BCB's vast SGS system using its unique numerical code.
019d7559listar moedas
Lists all 150+ foreign currencies supported by the PTAX system for immediate quote retrieval.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with BCB Full — Inteligência Financeira Completa do Brasil, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
This Mega-Server gives your AI client instant access to over 20,000 statistical time series from Brazil's Central Bank (BCB). You don't gotta hunt down data from multiple sources; you pull everything here.
Currency and Exchange Rates:
For US dollar quotes, you can grab the official PTAX rate using get_cotacao_dolar, or get a historical series of those rates over time with get_dolar_periodo. If you need to query the commercial dollar market, use get_dolar_sgs with flexible SGS codes and date formats. To check any foreign currency quote—like EUR or GBP—you call get_cotacao_moeda, which retrieves either the current rate or a historical one.
You can also list every supported PTAX currency using listar_moedas. When you need to pull an exchange rate for any specific date, you've got get_serie_bcb for consulting the vast BCB SGS system directly.
Monetary Policy and Interest Rates:
To analyze monetary cycles, you start with the official Selic target set by COPOM using get_selic_meta. You can compare that to the daily effective rate via get_selic_diaria, or check out key fixed-income benchmarks like the Interbank Deposit Certificate (CDI) rate using get_cdi. Market expectations for future rates are available through get_expectativas_selic, which pulls institutional forecasts from the Focus Report.
Inflation and Cost Pressures:
Tracking inflation requires multiple indices, so you'll use several tools. Get the official, widely tracked rate with get_ipca. For lower-income households, run get_inpc to retrieve the National Consumer Price Index data. If you need a benchmark for commercial contracts or rent adjustments, call get_igpm for the IGP-M index.
To model future cost pressures, use get_expectativas_inflacao, filtering by IPCA, IGP-DI, or IGP-M forecasts. The market also uses a forward indicator rate; you can pull that specific measure with get_ipca15.
Macroeconomic Health Indicators:
When checking the overall economic picture, you'll use several key indicators. You get a proxy for Brazil’s Gross Domestic Product variation by calling get_pib, which pulls the monthly IBC-Br index data. For stability checks, retrieve international reserves in US dollars using get_reservas. The public debt relative to GDP is calculated and pulled with get_divida_pib.
You track trade performance by retrieving the historical Brazilian trade balance—which covers exports and imports of commodities—using get_balanca_comercial. Unemployment data, based on the PNAD survey, comes through get_desemprego, providing quarterly rates. Finally, for instant payment system activity, you pull volume and transaction count statistics using get_pix_estatisticas.
Deep Dive Data Access:
If none of these specific tools cut it, you can consult any general time series code available in the BCB's massive SGS system by calling get_serie_bcb. It’s your full kit for Brazilian macro analysis.
How BCB Full Mega-Server MCP Works
- 1 Tell your agent exactly what data you need (e.g., 'The historical IPCA rate for the last five years' or 'The current USD/BRL PTAX quote').
- 2 Your AI client calls the appropriate tool (like
get_ipcaorget_cotacao_dolar) and passes necessary parameters (date, currency code, indicator type). - 3 The server executes the query against the BCB data feeds and returns structured time series data points for your agent to analyze.
The bottom line is that you feed it a specific economic question, and it spits out clean, standardized historical or current data directly from the Central Bank's source.
Who Is BCB Full Mega-Server MCP For?
This server is for quant analysts, risk managers, and senior economists. If your job involves modeling market movements based on official government statistics—especially in emerging markets like Brazil—you need this. You are the person staring at dashboards at 2 AM because a key indicator moved unexpectedly.
Uses get_selic_meta and get_expectativas_selic to model interest rate scenarios, comparing central bank targets against market consensus.
Runs get_divida_pib and checks international reserves (get_reservas) to assess the country's fiscal stability under various stress scenarios.
Compares inflation metrics (IPCA vs. INPC) with commodity trade data via get_balanca_comercial to determine real consumer purchasing power trends.
What Changes When You Connect
- Instant Inflation Comparison: Don't just look at IPCA. Use
get_ipca,get_inpc, andget_igpmtogether to see how inflation affects different income groups and sectors, giving a layered view of cost pressures. - Policy vs. Reality Check: You can compare the official Selic target (
get_selic_meta) directly against the daily effective rate usingget_selic_diaria. This shows whether monetary policy is hitting its actual execution goals. - Full Currency Depth: Forget limited quote tools. Use
listar_moedasto see every available foreign currency, then useget_cotacao_moedato pull rates for anything from JPY to MXN in one go. - Economic Stability Snapshot: Get a complete picture of national health by cross-referencing the debt ratio (
get_divida_pib) with international reserves (get_reservas). This is non-negotiable for any large capital decision. - Historical Depth (The SGS Advantage): When PTAX limits you, use
get_serie_bcbto pull data from over 20,000 SGS time series. You're pulling years of granular history, not just the last quarter.
Real-World Use Cases
Assessing Trade Impact on Debt
A credit analyst needs to know if Brazil's ability to service debt has improved. They start by querying get_balanca_comercial to see the trade surplus, then combine that with get_divida_pib and get_reservas. The agent can generate a report showing how commodity exports directly impact fiscal stability.
Modeling Interest Rate Shifts
A bond trader anticipates rate drops. They query the market expectation using get_expectativas_selic and then confirm their model by pulling historical Selic data via get_dolar_sgs to see how rates historically reacted to similar prediction shifts.
Tracking Consumer Cost of Living
A social impact researcher needs to know if the middle class is feeling inflation. They query both the broad consumer index (get_ipca) and the lower-income index (get_inpc), then compare those trends against wage growth projections using get_desemprego data.
Cross-Border Investment Due Diligence
An investment firm needs to price a potential acquisition. They use get_cotacao_moeda for the target currency and run historical comparisons using get_dolar_sgs to understand typical exchange rate volatility over the past few years.
The Tradeoffs
Assuming a single tool provides everything
Running only get_ipca and assuming that is enough for a full cost of living analysis. You miss the unique angles of commodity price changes or lower-income group impacts.
→
Don't stop at inflation. Always cross-reference IPCA with the trade balance using get_balanca_comercial. This connects macro demand (trade) to consumer prices (IPCA).
Mixing PTAX and SGS codes haphazardly
Trying to get a long-term, consistent history of the dollar by jumping between get_cotacao_dolar and other methods, resulting in mismatched data points or format errors.
→
For historical depth, always prioritize using get_serie_bcb. It's built for complex time series queries and handles multiple codes consistently.
Focusing only on the current rate
Just calling get_selic_diaria today without checking what the market expects next. You miss the forward-looking signal.
→
Always pair the current data point with expectations. Use get_selic_meta alongside get_expectativas_selic. This gives you both the reality and the consensus forecast.
When It Fits, When It Doesn't
Use this server if your analysis requires rigorous, verifiable time-series comparison across multiple economic domains (e.g., comparing inflation rates to debt ratios). You must be able to answer 'What happened when X indicator moved?'
Don't use it if you are primarily concerned with qualitative risk assessment or political sentiment—the data is purely quantitative. If your goal is merely a quick, high-level summary of the current dollar rate, get_cotacao_dolar works fine, but for anything deeper, this mega-server is necessary.
Crucially, if you need to compare how an indicator like unemployment (get_desemprego) correlates with interest rates (get_cdi), this toolset provides the historical depth and variety required. If your data needs are limited to just one variable (e.g., only IPCA), then calling that single tool is faster, but you'll miss the context.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Banco Central do Brasil. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 21 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Gathering a full economic picture used to take days of cross-referencing government sites.
Before this server, getting a cohesive view required jumping between multiple BCB and Ministry pages. You'd manually pull the IPCA trend from one tab, then run to another site for the Selic rate, check a third resource for GDP data, and finally grab exchange rates from a fourth source—all while trying to align dates and formats.
Now, you ask your agent for 'Brazil’s economic health snapshot.' It automatically fires off queries using `get_pib`, `get_divida_pib`, and `get_ipca`. You get the full, correlated data set in one response. No copy-pasting, no calendar alignment headaches—just pure, usable intelligence.
The `get_serie_bcb` tool lets you query any economic series code directly.
If a specific indicator isn't listed in the standard 22 tools (say, an obscure sector index), you don't get stuck. You just pull the SGS code from bcb.gov.br and pass it to `get_serie_bcb`. It handles the query structure for any of the 20,000+ available time series.
This capability moves your agent beyond simple macro summaries. It lets you build custom intelligence pipelines that hit niche data points instantly—the kind of granular retrieval previously reserved for dedicated database engineers.
Common Questions About BCB Full Mega-Server MCP
How do I get the historical dollar rate using `get_dolar_periodo`? +
You pass the start and end dates in MM-DD-YYYY format. The tool returns the PTAX rates for that range, including opening, intermediate, and closing values.
What's the difference between `get_ipca` and `get_inpc`? +
IPCA tracks inflation for a broad consumer base (1 to 40 minimum wages), while INPC measures it specifically for lower-income families (1 to 5 minimum wages). They show different cost pressures.
Can I compare Selic expectations with the current rate using `get_selic_meta` and `get_expectativas_selic`? +
Yes. You can run both tools back-to-back. This lets your agent directly contrast the Central Bank's stated goal (get_selic_meta) against what top financial institutions are predicting for future rates.
Which tool should I use for general macro time series data? Is it `get_serie_bcb`? +
get_serie_bcb is your catch-all. If you know the SGS code, this tool accesses the widest array of economic data points available in the BCB's database.
If I need a data series code not covered by the example tools, how do I find it using `get_serie_bcb`? +
The tool accepts any valid SGS code from bcb.gov.br/estabilidadefinanceira/seriestemporais. You must verify the code's active status and data scope before calling it. Don't assume a series is available just because you know the topic.
What happens if I use `get_dolar_periodo` for dates where PTAX quotes were unavailable? Will my agent receive an error? +
If data is missing, the tool returns a null value or specific gap indicator instead of failing. Your AI client needs to check for these gaps and handle them gracefully in your logic.
I need to check 50+ currencies using `get_cotacao_moeda`. Is there a rate limit if I call this tool too many times? +
Yes, high-volume calls can trigger rate limits. For bulk checks, structure your request in batches rather than calling the function individually for every currency code.
How do I compare international reserves from `get_reservas` with historical trade data using `get_balanca_comercial`? +
Run both calls separately to get the specific time series needed. Your agent then needs to align these two datasets by date before performing any comparative analysis.
What is the Focus Survey? +
The Focus Survey (Relatório Focus) is a weekly survey published every Monday by Brazil's Central Bank. It collects expectations from ~140 financial institutions about key economic variables: Selic, IPCA, GDP, exchange rate, and more. The median projections are closely watched by markets.
Does this MCP cover both daily currency exchanges and long-term macroeconomics? +
Yes! BCB Full is an 'all-in-one' Mega-Server that unifies the PTAX currency gateway alongside deep economic surveys (like the 20k+ SGS series and Focus survey). Use it simultaneously without flipping contexts.
What happens if local BCB APIs are temporarily unstable? +
The tool uses streamlined async fetches equipped with silent polling gracefully designed to mitigate brief BCB outages, delivering the latest known cache boundary when direct parsing fails.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Sumo Logic
Connect your AI to Sumo Logic. Orchestrate log searches, monitor active collectors, and analyze system events efficiently.
Aliyun VOD / 阿里云视频点播
Alibaba Cloud's professional video pipeline — manage media, retrieve play URLs, and audit transcode templates via AI.
HubSpot Lead Creator
This MCP does exactly one thing: it extracts customer data from conversations and creates a new Contact in your HubSpot CRM. That's its only function. Incredible for turning your AI into an automated sales assistant.
You might also like
Gameball Alternative
Automate loyalty programs and gamification via Gameball — manage customer profiles, track points, and handle order rewards directly from any AI agent.
Mailshake
Run cold email outreach campaigns with personalization, automated follow-ups, and reply detection that fills your sales pipeline.
JokeAPI
Universal humor engine — get random jokes, filter by category and safety flags via AI.