Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use IBGE with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Give your AI agent a precise map of Brazil: all 5,570 municipalities, 27 states, 5 macro-regions, metropolitan areas, and the complete administrative hierarchy

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 5 capabilities

The complete IBGE capability set.

These are the exact actions your AI can choose when you ask it to work with IBGE.

Capability set01 / 02

01-03

3 capabilities in this set.

Part of 5 available through IBGE.

  1. 01

    Get municipio

    Use the 7-digit IBGE code. Get municipality details by IBGE code

  2. 02

    Get municipios por uf

    Use the 2-letter UF abbreviation (e.g., SP, RJ, MG, BA). List all municipalities in a Brazilian state

  3. 03

    List estados

    List all Brazilian states (UFs)

Capability set02 / 02

04-05

2 capabilities in this set.

Part of 5 available through IBGE.

  1. 04

    List regioes

    List the 5 macro-regions of Brazil

  2. 05

    List regioes metropolitanas

    List metropolitan regions by state

Observed, not estimated

766ms average. Fast in production.

IBGE is checked daily against the live service.

Daily averagePeak 835ms
Sep 1Today
Fastest day
697ms
Slowest day
835ms
14-day trend
Slowing+20%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 5 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of IBGE, so you can see the experience inside your AI.

It does not authenticate your account with IBGE. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

IBGE Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_AM9EVKBJgJsifTbV7JN66DtbSPuPWvGf4JphVnSn/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — IBGE capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "ibge-localidades-cidades-do-brasil-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_AM9EVKBJgJsifTbV7JN66DtbSPuPWvGf4JphVnSn/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions IBGE owners ask.

  • 01

    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.

Explore

More in Data Management

Suggestions