• CLEAN DATA
  • LOGISTICS
  • DATABASES
  • HUMAN

How to validate Brazilian addresses with your AI

Connect BrasilAPI to your agent to instantly resolve postal codes into complete address data.

Ask AI about this page

Short answer

How can I use my AI to validate Brazilian addresses?

Your agent uses the get_cep_details tool to look up any CEP code and return the exact street, neighborhood, and city. This ensures your logistics data stays accurate. You'll get the following results.

Where the data lands.

The outcomes of address validation.

Once your agent resolves a CEP, the information flows into these specific areas.

CLEAN DATA

Corrected address lists

The AI pulls the official street name and neighborhood. You get a clean list of addresses for your shipping logs.

LOGISTICS

Delivery routing

The agent uses the city and state details to organize delivery zones. This prevents packages from heading to the wrong district.

DATABASES

Updated customer records

Your AI can format the retrieved data for your CRM. It fills in missing location details in your user profiles.

HUMAN

Manual review needed

If a CEP doesn't exist, the AI flags it for you. You'll need to contact the customer to get the right code.

The workflow

What your AI does when a CEP arrives.

The agent handles the heavy lifting of searching postal databases.

  1. Identify the CEP

    The agent scans your input to find 8-digit Brazilian postal codes.

    get_cep_details

  2. Fetch street info

    The agent calls the API to get the specific street and neighborhood for that code.

    get_cep_details

  3. Verify location

    It checks the city and state to ensure the address is geographically correct.

    get_cep_details

  4. Format the result

    The AI organizes the street, neighborhood, and city into a single, usable string.

    get_cep_details

Try it

Copy these to start.

Use these prompts to trigger the address lookup immediately.

Starting points

Replace the bracketed text with your actual data, like a specific spreadsheet or a list of codes.

BrasilAPI Connector

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

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

  • Validate this list of CEP codes from my Google Sheet: [paste list].

  • Check the address for this customer in my CRM: [paste customer info].

  • Convert these postal codes into full street addresses: [paste CEPs].

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

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

Start here

Connect BrasilAPI once, then ask.

One click connects the MCP to your client. Your credentials stay encrypted, and you can start using the tools immediately.

Connect BrasilAPI to your AI

FAQ

How this task behaves.

  • 01

    Can the AI fix a misspelled street name?

    No. The AI uses the CEP to find the official name from the API. It replaces the incorrect input with the correct data from the source.

  • 02

    What happens if the CEP is invalid?

    The tool returns an error if the code doesn't exist. Your AI will tell you that the CEP could not be found.

  • 03

    Can the AI update my database automatically?

    No. The AI can prepare the formatted address for you, but you must be the one to trigger the final update to your external database.

  • 04

    Does it work for addresses outside of Brazil?

    No. This connector is built specifically for Brazilian postal codes.

  • 05

    Can the AI find GPS coordinates?

    No. The get_cep_details tool only provides street, neighborhood, city, and state information.

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

Connect BrasilAPI to Claude, Cursor, ChatGPT & more