• VALID
  • FIXED
  • INVALID
  • HUMAN

How to validate Brazilian addresses with your AI

Connect the IBGE Localidades MCP to your agent to fix typos and standardize Brazilian location data.

Ask AI about this page

Short answer

Can my AI check if a Brazilian city name is real?

Yes. Your AI uses official IBGE data to match user input against valid city names and state codes. This ensures your datasets use standardized identifiers instead of typos. You'll see how the AI handles these checks below.

The results.

Where your data lands.

The AI sorts your input into these specific outcomes.

VALID

Standardized records

The AI matches the input to an official IBGE code. You get clean, uniform city and state data.

FIXED

Corrected typos

The AI identifies common misspellings. It replaces them with the official name from the IBGE database.

INVALID

Flagged errors

If a city or state doesn't exist in the official list, the AI marks it as invalid. You'll know exactly which rows need attention.

HUMAN

Manual review

When the AI finds ambiguous names that don't clearly match a single municipality, it flags them for you to decide.

The workflow

What your AI does when the data arrives.

The AI acts as a gatekeeper between messy user input and official Brazilian geographic standards.

  1. Identify the state

    The AI checks the provided state abbreviation against the official list of Brazilian states.

    list_estados

  2. Locate the city

    The AI searches for the specific municipality within the identified state to find its official ID.

    get_municipio

  3. Compare and match

    The AI compares the user's text to the official IBGE name to catch spelling errors.

    get_municipio

  4. Finalize the record

    The AI outputs the standardized name and code for your database or sheet.

    get_municipiolist_estados

Try it

Copy these to start.

Paste these into your chat to begin working.

Starting points

These are just ideas. Swap out the specific cities or files for your own.

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

  • Check this list of cities in my spreadsheet for any typos using IBGE standards.

  • Validate if 'São Paulo, SP' is a correct municipality and state combination.

  • Clean up the city names in this CSV file so they match official IBGE records.

  • Verify if the state abbreviation 'RJ' is valid and find the municipality code for 'Niterói'.

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

Start here

Connect IBGE Localidades once, then ask.

One click connects this MCP to your agent. Your credentials stay encrypted, and you can start validating data immediately.

Connect IBGE Localidades to your AI

FAQ

How this task behaves.

  • 01

    Can the AI fix my database automatically?

    No. The AI identifies the correct names and codes, but you must decide whether to apply those changes to your database.

  • 02

    Does it work for any country?

    No. This specific MCP only uses official IBGE data for Brazil.

  • 03

    What happens if a city name is spelled correctly but doesn't exist?

    The AI will flag it as an invalid municipality because it won't find a match in the official IBGE registry.

  • 04

    Can the AI change the state abbreviation to a full name?

    Yes, the AI can use the state list to convert abbreviations into full names or vice versa.

  • 05

    Will the AI delete any of my existing data?

    No. The AI only reads the data you provide and suggests corrections. It has no permission to delete your files.

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

Connect IBGE to Claude, Cursor, ChatGPT & more