• DATA
  • LOGS
  • DOCS
  • HUMAN

How to validate Brazilian zip codes with your AI

Connect to Correios once. After that, your AI handles the heavy lifting of turning raw zip codes into usable address data.

Ask AI about this page

Short answer

How can I turn a CEP into a full address using AI?

Your AI uses the lookup_cep tool to query the Correios database for specific zip codes. It returns the street name, neighborhood, city, and state for every valid CEP you provide. You'll see the full breakdown of the data below.

The results.

Where the data lands.

The AI processes the CEP and routes the results based on what you need.

DATA

Clean address lists

The AI pulls the street, city, and state from the database. You get a structured list ready for shipping or billing.

LOGS

Error reports

If a CEP is fake or mistyped, the AI flags it. You'll know exactly which entries are invalid.

DOCS

Updated spreadsheets

The AI can take a list of codes and fill in the missing city and street columns. This keeps your records accurate.

HUMAN

Manual fixes

When the database doesn't recognize a code, the AI hands the task back to you. You decide how to handle the edge cases.

The workflow

What your AI does when a CEP arrives.

The AI acts as the bridge between your chat and the official Brazilian postal service.

  1. Identify the code

    Your AI scans your text or spreadsheet to find any 8-digit Brazilian zip codes.

    lookup_cep

  2. Query the database

    The agent sends the code to the Correios system to fetch the official location details.

    lookup_cep

  3. Format the result

    The AI takes the raw response and turns it into a readable address or a clean JSON object.

    lookup_cep

  4. Flag invalid entries

    If the lookup fails, the AI notifies you that the code is incorrect or doesn't exist.

    lookup_cep

Try it

Copy these to start.

Use these prompts to trigger the validation process immediately.

Starting points

Swap out the bracketed text with your actual data, like a specific list of codes or a file name.

Correios Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_OakBxCUWmn2rDS2C8hs3jEbHTn1ff0NO8IgnpAxZ/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 — Correios capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "correios-brazil-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_OakBxCUWmn2rDS2C8hs3jEbHTn1ff0NO8IgnpAxZ/mcp"
    }
  }
}
Copy into chat04

  • Validate this list of CEPs from my spreadsheet: [paste list or file name]

  • Check if the CEP [insert code] is a valid address in Brazil.

  • Take these zip codes from my contact list and add the city and street names for each.

  • Look up the neighborhood and state for the CEP [insert code].

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

Start here

Connect Correios once, then ask.

Just click to connect. Your credentials stay encrypted, and you can start using the tools in any compatible client right away.

Connect Correios to your AI

FAQ

How this task behaves.

  • 01

    Can the AI fix a typo in a CEP automatically?

    No. If the CEP is invalid, the AI will tell you it couldn't find a match. You have to provide the correct code.

  • 02

    Does the AI update my database directly?

    No. The AI provides the data to you. You remain in control of when and how that data is saved to your files or systems.

  • 03

    Can I use this for international zip codes?

    No. This specific tool is built for the Correios database and only works with Brazilian CEP codes.

  • 04

    Will the AI delete any of my existing address data?

    No. The AI only reads from the Correios database and provides information to you. It has no permission to delete your files.

  • 05

    What happens if a CEP is valid but the street name is old?

    The AI returns exactly what is in the Correios database. It doesn't know if a street has been renamed recently unless the database is updated.

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

Connect Correios to Claude, Cursor, ChatGPT & more