• CLEAN DATA
  • DATA ENTRY
  • LOGISTICS
  • HUMAN REVIEW

How to verify Brazilian addresses with your AI

Connect to Correios do Brazil once. From then on, your agent handles the address lookups for you.

Ask AI about this page

Short answer

How can I get full address details from a Brazilian ZIP code?

Your agent uses the consult_cep tool to fetch the street name, neighborhood, city, and state from a single CEP. You'll get clean, structured data for your records. Here is how it works.

Where the data lands.

The results of your lookup.

The AI processes the ZIP code and delivers the following outcomes.

CLEAN DATA

Formatted address strings

The AI extracts the street, neighborhood, and city. You get a single, usable line of text.

DATA ENTRY

Updated spreadsheets

The AI takes the retrieved details and fills in missing columns in your sheets or databases.

LOGISTICS

Shipping labels

The AI provides the precise location data needed to generate valid Brazilian shipping documents.

HUMAN REVIEW

Flagged errors

If a ZIP code doesn't exist in the Correios database, the AI tells you so you can check it manually.

The workflow

What your AI does when a ZIP code arrives.

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

  1. Identify the CEP

    The AI scans your text or spreadsheet to find the 8-digit Brazilian postal code.

    consult_cep

  2. Query the database

    The AI sends the code to the official Correios system to fetch the registered location.

    consult_cep

  3. Parse the response

    The AI breaks down the raw postal data into street, neighborhood, city, and state.

    consult_cep

  4. Format for use

    The AI organizes the information into the specific structure you requested for your task.

    consult_cep

Try it

Copy these to start.

Use these prompts to trigger the address lookup immediately.

Starting points

Swap the bracketed text for your actual data, like a specific sheet or a list of codes.

Correios Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_7RdgeSFMAwQmVAnu6cz3B9qVN1mhg1qOCDL0pHHe/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-do-brazil-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_7RdgeSFMAwQmVAnu6cz3B9qVN1mhg1qOCDL0pHHe/mcp"
    }
  }
}
Copy into chat04

  • Use the Correios do Brazil connector to find the address for CEP 01310-200.

  • Check this Google Sheet and fill in the missing street and city details using the CEP column.

  • I have a list of Brazilian addresses in this text file. Use the CEP tool to verify if they are all valid.

  • Look up the neighborhood and state for the following ZIP codes: [insert list].

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

Start here

Connect Correios do Brazil once, then ask.

You only need to link the MCP one time. Your credentials stay encrypted, and you can start asking questions in any compatible client right away.

Connect Correios do Brazil to your AI

FAQ

How this task behaves

  • 01

    Can the AI fix a typo in a ZIP code?

    No. The AI can only look up valid CEPs. If the code is incorrect, the tool will return no results.

  • 02

    Does the AI update my database automatically?

    No. The AI provides the data to you in the chat. You must tell it to write that data to a specific sheet or tool.

  • 03

    Can it find the house number?

    No. The tool provides the street and neighborhood, but the specific house or apartment number must be provided by you.

  • 04

    What happens if the CEP is invalid?

    The AI will tell you that the CEP was not found in the Correios database.

  • 05

    Can the AI change the official postal records?

    No. This tool is read-only. It only pulls information from the official database; it cannot modify it.

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

Connect Correios to Claude, Cursor, ChatGPT & more