• DATA
  • FORMAT
  • VALIDATION
  • HUMAN

How to list all municipalities in a state with your AI

Connect this MCP to your AI client to access official IBGE geographic data. Once linked, you can pull city lists using state abbreviations.

Ask AI about this page

Short answer

How do I get a list of all cities in a Brazilian state?

Provide your AI with the two-letter state abbreviation. It will fetch the official municipal data from IBGE and present it to you. You'll get a clean list of names for your project.

The results you get

Where the data lands

The AI handles the heavy lifting of querying official records so you can focus on your work.

DATA

Official city lists

The AI pulls every municipality name for a given state. You get accurate names straight from the source.

FORMAT

Ready-to-use lists

Your AI can format these names into a CSV, a JSON array, or a simple text list. It's ready for your next project.

VALIDATION

State code checks

If you aren't sure of a state abbreviation, the AI can check the valid codes first. This prevents errors in your requests.

HUMAN

Manual verification

You should still double-check the list if you are using it for legal or official government filings. The AI provides the data, but you own the final output.

The workflow

What your AI does when the request arrives.

The AI moves from verifying the state to pulling the specific municipal data.

  1. Validate state

    The AI checks the provided abbreviation against the official list of Brazilian states to ensure it's valid.

    list_estados

  2. Fetch cities

    Once the state is confirmed, the AI pulls the full list of cities for that specific region.

    get_municipios_por_uf

  3. Clean data

    The AI processes the raw municipal records to remove unnecessary metadata.

    get_municipios_por_uf

  4. Format output

    The AI organizes the names into the specific structure you requested, like a table or a list.

    get_municipios_por_uf

Try it

Copy these to start.

Use these prompts to trigger the data retrieval immediately.

Starting points

Swap out the state abbreviations like 'SP' or 'RJ' for the ones you actually need.

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 municipalities in the state of SP.

  • Give me a JSON list of all cities in Minas Gerais (MG).

  • What are all the cities in Rio de Janeiro (RJ)?

  • Check if 'BA' is a valid state abbreviation and then list its cities.

  • 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 for data immediately.

Connect IBGE Localidades, Cidades do Brasil to your AI

FAQ

How this task behaves

  • 01

    Can the AI add new cities to the list?

    No. The AI only retrieves official data from IBGE. It cannot create or modify municipal records.

  • 02

    Does it work with full state names?

    Yes, the AI can usually map a full name like 'São Paulo' to the correct abbreviation to run the tool.

  • 03

    Can I get the population of these cities?

    No. This specific MCP only provides lists of municipalities based on state codes.

  • 04

    What happens if I provide an invalid state code?

    The AI will use the state listing tool to check the code and tell you if it doesn't exist.

  • 05

    Can the AI export this directly to my Google Sheets?

    No. The AI provides the text or data in the chat. You will need to copy and paste it into your spreadsheet yourself.

  • 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