IBGE Localidades Connector for AI agents.
5 live capabilities
Map Brazilian cities and states with official government geographic data.
Waiting for input…
Why people use IBGE Localidades
IBGE Localidades. Cidades do Brasil: Official Data for Brazilian Logistics
This Connector changes that by connecting your agent directly to the official IBGE geographic database. Instead of guessing, your agent pulls the exact 7-digit codes and administrative hierarchies used by the government. You get reliable, structured data in one step.
What Vinkius changes
You get instant, official Brazilian geographic data without the headache of managing API keys.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Listing all cities in a specific state
A user wants to know every city in Minas Gerais.
- Real-world use case 02
Verifying a city's regional hierarchy
A developer needs to verify a city's region.
- Real-world use case 03
Identifying major urban hubs
A logistics planner wants to see metro areas.
Complete set · 5capabilities
The complete IBGE Localidades capability set.
These are the exact actions your AI can choose when you ask it to work with IBGE Localidades.
01—03
3 capabilities in this set.
Part of 5 available through IBGE Localidades.
- 01 Capability
Get municipio
Returns specific details for a city using its unique 7-digit IBGE code. It includes the mesoregion and macro-region info.
- 02 Capability
List estados
Lists all 27 Brazilian states (UFs) for your agent to reference. It provides the official abbreviations used by the government.
- 03 Capability
Get municipios por uf
Pulls a full list of cities in a state when you provide a 2-letter abbreviation. This is useful for populating dropdowns or regional lists.
04—05
2 capabilities in this set.
Part of 5 available through IBGE Localidades.
- 04 Capability
List regioes
Shows the 5 macro-regions of Brazil including their nested structures. Use this to group data by large geographic areas.
- 05 Capability
List regioes metropolitanas
Identifies metropolitan areas across different Brazilian states. It helps map out major urban hubs and their surrounding areas.
Set up in minutes
One URL. Then ask IBGE Localidades to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use IBGE Localidades from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_AM9EVKBJgJsifTbV7JN66DtbSPuPWvGf4JphVnSn/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it IBGE Localidades, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable IBGE Localidades for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_AM9EVKBJgJsifTbV7JN66DtbSPuPWvGf4JphVnSn/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the IBGE Localidades URL.
- Step 03
Save and start
Save the connection and enable IBGE Localidades in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"ibge-localidades-cidades-do-brasil": {
"url": "https://edge.vinkius.com/vk_preview_AM9EVKBJgJsifTbV7JN66DtbSPuPWvGf4JphVnSn/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using IBGE Localidades
Open Agent mode in chat and ask: "Using IBGE Localidades, help me...". 5 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"ibge-localidades-cidades-do-brasil": {
"url": "https://edge.vinkius.com/vk_preview_AM9EVKBJgJsifTbV7JN66DtbSPuPWvGf4JphVnSn/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using IBGE Localidades
Ask Copilot: "Using IBGE Localidades, help me...". 5 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"ibge-localidades-cidades-do-brasil": {
"url": "https://edge.vinkius.com/vk_preview_AM9EVKBJgJsifTbV7JN66DtbSPuPWvGf4JphVnSn/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using IBGE Localidades
Open Cascade and ask: "Using IBGE Localidades, help me...". 5 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"ibge-localidades-cidades-do-brasil": {
"url": "https://edge.vinkius.com/vk_preview_AM9EVKBJgJsifTbV7JN66DtbSPuPWvGf4JphVnSn/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using IBGE Localidades
Ask Cline: "Using IBGE Localidades, help me...". 5 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add ibge-localidades-cidades-do-brasil --transport http "https://edge.vinkius.com/vk_preview_AM9EVKBJgJsifTbV7JN66DtbSPuPWvGf4JphVnSn/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using IBGE Localidades
Ask Claude: "Using IBGE Localidades, show me...". 5 tools are ready
Where the request belongs
Work IBGE can move forward.
This is for developers and data analysts who need to ground their AI agents in real-world Brazilian geography. It's for the person tired of their agent making up fake city names or getting state codes wrong.
Logistics Developer
Mapping out delivery zones and checking municipality codes for shipping routes on a Tuesday afternoon.
Fintech Product Manager
Building address validation capabilities that need to match official government standards for KYC or payments.
Market Researcher
Pulling lists of cities in specific states to analyze regional trends and demographic reach.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsIBGE Pesquisas — Brasil Cidades
Query the engine behind Brasil Cidades: health, education, economy, and quality-of-life indicators for every Brazilian municipality. rank cities, compare regions, and build data-driven policy analysis.
IBGE Serviços de Dados
Access official Brazilian statistics, geographic data, economic classifications (CNAE), and demographic insights directly from IBGE.
IBGE Full Access — Dados Brasileiros
The ultimate Brazil data Mega-Server: 15 capabilities spanning census, cities, CNAE economy, name trends, survey indicators, IBGE news, and country comparisons. all of Brazil's official statistics in one zero-auth integration.
Campinas Open Data
Access public data from Campinas, Brazil. search datasets, resources, and city organizations directly from your AI agent.
IBGE Agregados (SIDRA)
Access official Brazilian statistical data from IBGE SIDRA. query surveys, metadata, variables, and geographic levels directly.
Minas Gerais (Estado)
Access the official Open Data Portal of the State of Minas Gerais, Brazil. Query datasets, organizations, and public resources directly.
Bring your own AI
Change the model, client or framework. Keep IBGE connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about IBGE.
The practical details behind the request, access and result.
Does the IBGE Localidades. Cidades do Brasil MCP require an API key?
No, it uses open government data from the IBGE, so you can connect it to your AI client instantly without managing keys.
Can I use IBGE Localidades. Cidades do Brasil MCP for logistics?
Yes, it provides the official IBGE codes used by shipping and logistics companies to ensure accurate regional mapping.
Does IBGE Localidades. Cidades do Brasil MCP include all Brazilian states?
Yes, it covers all 27 states, their municipalities, and the 5 major macro-regions of Brazil.
How does IBGE Localidades. Cidades do Brasil MCP handle metropolitan areas?
It lists metropolitan regions by state, allowing your agent to identify major urban hubs like Rio de Janeiro and Belo Horizonte.
Is the data in IBGE Localidades. Cidades do Brasil MCP up to date?
It pulls from the official IBGE geographic database, which is the standard authoritative source for all Brazilian geography.
Can my AI agent use IBGE Localidades. Cidades do Brasil MCP for address validation?
Yes, it provides the administrative hierarchy needed to verify city, state, and region data against official records.
Do I need an API key?
No! IBGE data is 100% open government data. This server works instantly with zero configuration. just subscribe and start querying Brazilian geography.
One connection away
Give your agent a direct line to IBGE.
Connect IBGE once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available