IBGE Pesquisas — Brasil Cidades MCP for AI. Compare indicators across any Brazilian city.
Works with every AI agent you already use
…and any MCP-compatible client








Connect to your AI in seconds.
IBGE Pesquisas — Brasil Cidades allows you to query Brazil's official municipal data engine. Access indicators on health, education, economy, and sanitation for any Brazilian municipality.
You can rank cities by specific metrics or compare data across multiple research surveys and time periods.
What your AI can do
List pesquisas
Lists every available IBGE research program and census report ID so you know what data is in the system.
Get indicadores
Pulls specific quality-of-life metrics for a given Brazilian survey ID, allowing you to see health or education scores.
Get resultados
Retrieves raw survey data for specific geographic locations, using a country code or state code as input.
Get detailed indicator scores for any specific city or state based on the chosen survey.
Query the same metric (like education level) using different research databases, such as Census data or Agricultural reports.
Automatically rank multiple Brazilian municipalities based on a single indicator, like highest GDP per capita.
List every research program and survey type the IBGE has published for municipal use.
Ask an AI about this
Waiting for input…
IBGE Pesquisas — Brasil Cidades: 4 Tools
These tools let you list available surveys, pull raw results for specific cities, get key quality-of-life metrics, or rank municipalities by any indicator.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using IBGE Pesquisas — Brasil Cidades on VinkiusList Pesquisas
Lists every available IBGE research program and census report ID so you know what data is in the system.
Get Indicadores
Pulls specific quality-of-life metrics for a given Brazilian survey ID, allowing you...
Get Resultados
Retrieves raw survey data for specific geographic locations, using a country code or...
Get Ranking Indicador
Calculates and lists the top municipalities based on any chosen economic or social...
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
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 IBGE Pesquisas — Brasil Cidades, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ 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
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by IBGE. 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 connection provides 4 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Gathering municipal data used to take days of clicking and downloading files.
Today, generating a single comparison report requires jumping between dozens of government web pages. You fill out forms, download zip files, unzip them, then copy-paste the numbers into Excel sheets just so you can start analyzing. The data is there, but it's buried under layers of manual labor.
With this MCP, that process vanishes. You tell your agent what comparison you need—say, 'Compare education and income in these three cities.' Your client runs the query and gets a clean, structured result set instantly. It's like having a direct line to the core database.
The `get_ranking_indicador` tool gives you clear answers without manual sorting.
Without this MCP, if you wanted to know which city had the best quality of life based on multiple metrics, you'd have to manually rank them across sanitation scores, then education scores, and then average those rankings yourself. It’s tedious, error-prone work.
Now, simply using `get_ranking_indicador` lets your agent do that heavy lifting for you. You define the indicator, and it delivers a definitive, ranked list. That's the difference between data points and actionable intelligence.
What your AI can actually do with this
You need deep demographic insight into Brazilian municipalities. This MCP connects directly to the core database that powers the official IBGE Brasil Cidades portal. It lets you pull complex, granular data sets—covering everything from literacy rates and sanitation access to GDP per capita—for thousands of cities. Instead of downloading massive, unwieldy CSVs and manually cross-referencing years or topics, your agent handles the heavy lifting.
You specify the region, the metric, and the time frame; it returns structured results ready for analysis. With Vinkius in place, this MCP gives your AI client access to a national catalog of indicators, letting you build data-driven reports without ever leaving your chat window.
019d75b6-f59e-73be-8d28-8acdab6eaac5 Here's how it actually works
The bottom line is: You point to the data set, and the system handles locating the specific city and metric within that massive repository.
First, let your agent run list_pesquisas to find the exact name or ID of the data set you need (e.g., 'Censo Demográfico').
Next, tell it the specific location (state code, municipality code) and what indicator you want to measure.
The MCP then runs the query, fetching the raw results or calculating a ranking based on your request.
Who is this actually for?
This is for public policy researchers, urban planners, journalists, and ESG analysts who routinely need hard numbers on quality of life. You're tired of spending days navigating government websites to download data for a simple comparison.
Needs to compare sanitation coverage rates between two rival cities to advise on infrastructure investment.
Compares education indicators across an entire state's municipalities over a 10-year period for a report.
Quickly pulls economic data (like income or industry stats) to find the fastest-growing city in a specific region.
What Changes When You Connect
Stop manual data scraping. Instead of visiting multiple IBGE pages and downloading different files for each metric, your agent queries the central database directly using get_indicadores.
Quickly identify regional leaders. Need to know which cities have the highest GDP per capita? Use get_ranking_indicador. It generates a ranked list instantly, saving hours of spreadsheet sorting.
Compare disparate data sets easily. You can check health metrics from one survey and compare them against income stats from another, all in one workflow.
Know your sources upfront. Before you start, run list_pesquisas to get the full catalog of available research programs, ensuring you don't miss crucial historical data.
Analyze multiple locations at once. You can input a state code and pull comparative results for all major municipalities in that region.
See it in action
Comparing Health Outcomes
A public health researcher needs to compare life expectancy between São Paulo (SP) and Salvador (BA). They run the query using get_indicadores for both locations, pulling data from the same core survey ID. The agent outputs a clean table showing all comparable metrics at once.
Finding Economic Hotspots
A journalist wants to prove which Brazilian state has the most rapid economic growth in its smaller towns. They use get_ranking_indicador targeting 'GDP per capita' across all available data, immediately identifying the top 5 municipalities.
Building a Historical Report
An ESG analyst needs to track changes in sanitation access over time. They first run list_pesquisas to confirm historical surveys are available, then use get_indicadores multiple times for the same metric across different years.
Targeted Municipal Research
A local government official only cares about one city. They input the specific IBGE code and run get_resultados, pulling all available data points immediately, without needing to browse a massive web portal.
The honest tradeoffs
Searching for single metrics
Manually visiting the IBGE site, searching for 'education rates,' downloading one CSV, then repeating this process for 'income' and 'sanitation.'
You don't need to download files. Use get_indicadores with a single call. It pulls all requested metrics—health, education, income—for the chosen location in one go.
Guessing which survey to use
Trying to analyze economic data but using the wrong survey ID (e.g., mixing Census data with Agricultural reports). The results are useless.
Always start by calling list_pesquisas. This confirms what kind of research programs exist and gives you the correct IDs for your analysis.
Comparing without a rank
Getting raw numbers (e.g., City A has 70% sanitation, City B has 65%) but having no idea which city is truly better or how far apart they are.
Use get_ranking_indicador. It automatically puts the cities in order based on your chosen metric, giving you immediate context and a clear winner.
When It Fits, When It Doesn't
Use this MCP if your goal is comparative analysis of complex, multi-faceted data across Brazilian municipalities. You need to compare metrics like education and health, or rank cities by GDP per capita versus income level. If you only need one single piece of information (e.g., 'What was the census year for Curitiba?'), a simple search engine is fine. However, if you need structured data that ties together multiple indicators and historical periods, this MCP is necessary. Never use it if you don't know which indicator ID or survey to query; always start with list_pesquisas first.
Questions you might have
How do I find out what surveys are available using get_indicadores? +
You shouldn't start with get_indicadores. First, run list_pesquisas to get the full catalog of research programs. This confirms you have the correct survey ID needed for your analysis.
What do I use if I only want results for a single specific city? +
Use get_resultados. You input the location code (either a state or municipality IBGE code), and it retrieves all available raw data points for that exact spot.
Can I compare multiple indicators in one call using get_indicadores? +
Yes. get_indicadores is designed to handle multiple metrics at once, letting you pull health, education, and income data from the same survey ID without separate calls.
If I want a list of top-performing cities, which tool should I use? Use get_ranking_indicador. +
You must use get_ranking_indicador. This tool is specifically built to calculate and present a clear, ordered ranking based on your chosen metric.
When I use get_resultados, what are the accepted formats for specifying a municipality or state? +
The tool accepts three primary identifiers: full country codes (BR), two-digit State Codes (UF like 33 for Rio de Janeiro), and specific IBGE municipal codes. You must provide one of these valid formats to successfully retrieve results.
Can I use get_indicadores to compare indicator data from different years or time periods? +
Yes, the tool supports temporal queries by allowing you to specify a range of survey years. This lets you track changes in indicators over time, which is essential for longitudinal policy analysis.
If I run get_indicadores and encounter missing data points, how do I troubleshoot them? +
Missing data usually means the indicator wasn't collected for that specific municipality or year. Double-check your survey ID using list_pesquisas to confirm if the indicator was part of the original research scope.
When using get_ranking_indicador, how can I limit the rankings to a specific region or state (UF)? +
You must specify the geographical scope—the State Code (UF)—as an optional parameter when calling get_ranking_indicador. This ensures your ranking only includes data points from that selected region.
Is this the same data as the Brasil Cidades portal? +
Yes! This server accesses the exact same API that powers the official Brasil Cidades portal — the IBGE's premier municipal indicator platform.
We've already built the connector for IBGE Pesquisas — Brasil Cidades. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 4 tools are live and waiting.
You're up and running in seconds.
Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.