• MACRO
  • MESO
  • METRO
  • HUMAN

How to map Brazilian regions and metropolitan areas with your AI

Connect your AI to IBGE data to navigate Brazil's administrative hierarchy. Once connected, your agent handles the heavy lifting of locating specific regions and metropolitan clusters.

Ask AI about this page

Short answer

How can I map Brazilian regions and metropolitan areas with my AI?

Your AI uses the IBGE Localidades, Cidades do Brasil connector to pull official administrative data. It identifies macro-regions, mesoregions, and metropolitan groupings. You get a clear view of the geographic hierarchy.

Where your data lands.

The geographic outcomes.

The AI organizes the IBGE hierarchy into these specific outputs.

MACRO

Macro-region identification

The AI identifies the five primary Brazilian regions. You get a high-level view of the country's largest divisions.

MESO

Mesoregion mapping

Your agent drills down into mesoregions. This provides the middle layer of the administrative structure.

METRO

Metropolitan groupings

The AI pulls specific metropolitan areas. This helps you group cities based on their urban clusters.

HUMAN

Manual verification

You review the final geographic lists. The AI provides the data, but you decide how to apply it to your project.

The workflow

What your AI does when the request arrives.

The AI acts as a bridge between your prompt and the IBGE database.

  1. Identify broad regions

    The AI scans the primary administrative divisions of Brazil to establish a starting point.

    list_regioes

  2. Locate metropolitan clusters

    The agent identifies specific metropolitan groupings to help you understand urban density.

    list_regioes_metropolitanas

  3. Parse hierarchy

    The AI organizes the relationship between different levels of the administrative structure.

    list_regioeslist_regioes_metropolitanas

  4. Format geographic data

    The agent converts raw IBGE data into a clean format for your specific use case.

    list_regioes

Try it

Copy these to start.

Use these prompts to trigger the connector immediately.

Starting points

These are opening lines. Swap out the specific region or city name to get different results.

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"
    }
  }
}
Copy into chat04

  • List all the macro-regions in Brazil using the IBGE connector.

  • Find all the metropolitan areas within the state of São Paulo.

  • Show me the mesoregions that belong to the North region.

  • Map out the metropolitan groupings for the Rio de Janeiro area.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect IBGE Localidades, Cidades do Brasil once, then ask.

Click the link to connect the MCP to your client. Your credentials stay encrypted, and you can start asking questions immediately.

Connect IBGE Localidades, Cidades do Brasil to your AI

FAQ

How this task behaves.

  • 01

    Can the AI change the official IBGE boundaries?

    No. The AI only reads and reports the official data provided by the IBGE.

  • 02

    Can I use this to find specific street addresses?

    No. This connector is limited to regions, mesoregions, and metropolitan areas.

  • 03

    Does the AI store my geographic queries?

    No. The AI processes the request and provides the data, but it doesn't save your search history to the IBGE database.

  • 04

    Can the AI create new metropolitan areas?

    No. The AI can only list existing metropolitan groupings defined by the IBGE.

  • 05

    How does the AI know which region a city belongs to?

    It uses the list_regioes and list_regioes_metropolitanas tools to look up the official administrative hierarchy.

  • More questions about IBGE Localidades, Cidades do Brasil? The Connector page answers them. See everything the IBGE Localidades, Cidades do Brasil Connector can do

Connect IBGE to Claude, Cursor, ChatGPT & more