• REAL-TIME
  • HISTORY
  • ALERTS
  • HUMAN

How to track Brazilian postal shipments with your AI

Connect the Correios API once. After that, your AI handles all the tracking lookups and status checks for you.

Ask AI about this page

Short answer

How can I track Correios packages with my AI?

Give your AI a Correios tracking code, and it will pull the current location and full history of the shipment. You'll get instant updates on where your package is and what its next move will be.

The results

What your AI delivers

The AI turns raw tracking data into clear information.

REAL-TIME

Live status updates

The AI uses the tracking tool to fetch the most recent location data from Correios. You get the exact current status of your package immediately.

HISTORY

Full movement logs

Your agent retrieves the entire journey of the shipment. It maps out every checkpoint the package has hit since it was sent.

ALERTS

Delivery summaries

The AI summarizes complex tracking logs into plain English. It tells you if a package is delayed or if it's out for delivery.

HUMAN

Manual intervention

If a package is stuck or lost, the AI identifies the issue. You'll need to contact Correios directly to resolve delivery disputes or missing items.

The workflow

What your AI does when a tracking code arrives.

The AI acts as the bridge between your chat and the Correios database.

  1. Fetch data

    The AI takes your tracking code and hits the Correios API to pull the raw shipment data.

    track_object

  2. Parse logs

    It reads through the movement history and identifies the current location of the object.

    track_object

  3. Interpret status

    The agent translates technical postal codes into human-readable updates about the package's progress.

    track_object

  4. Report findings

    Your AI presents the final summary, highlighting any delays or successful deliveries.

    track_object

Try it

Copy these to start.

Use these prompts to get moving.

Starting points

Replace the tracking code in these prompts with your actual Correios code.

Correios Connector

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

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

  • Track this Correios package for me: [CODE]

  • Where is my shipment [CODE] right now?

  • Give me a summary of the movement history for [CODE].

  • Check if package [CODE] has any recent updates or delays.

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

Start here

Connect Correios API once, then ask.

Click the link to connect. Your credentials stay encrypted, and you can start asking your AI about shipments immediately.

Connect Correios API to your AI

FAQ

Common questions

  • 01

    Can the AI change the delivery address?

    No. The AI can only read tracking data. You must use the official Correios website to change any delivery details.

  • 02

    Can my AI fix a lost package?

    No. The AI can identify if a package is stuck, but it cannot contact Correios to file a claim or request a redelivery.

  • 03

    Does it work for all Brazilian shipments?

    Yes, as long as the tracking code is a valid Correios code.

  • 04

    Can the AI send me a text when the package arrives?

    No. The AI only provides information when you ask it. It does not have the capability to send proactive SMS or email alerts.

  • 05

    How often does the data refresh?

    The AI pulls live data from the Correios API every time you ask, so you always get the most recent update available in their system.

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

Connect Correios to Claude, Cursor, ChatGPT & more