• LIVE DATA
  • ALERTS
  • LOGS
  • HUMAN

How to track Correios packages with your AI

Connect Correios to your AI client once. From then on, your agent handles the tracking lookups and status monitoring for you.

Ask AI about this page

Short answer

How can I track Correios packages with my AI?

Your agent uses the track_object tool to pull live data from the Correios system. You provide the tracking code, and your AI gives you the current location and status. You'll see exactly where your package is in the following breakdown.

Tracking outcomes

What you get from your agent

The AI turns raw postal data into clear updates.

LIVE DATA

Instant status checks

The AI uses track_object to pull the latest movement data from Correios. You get the exact current stage of your shipment immediately.

ALERTS

Automatic updates

Your agent monitors changes in the package status. It tells you when a shipment moves from transit to delivery.

LOGS

Full history access

The AI reads through the entire movement history of an object. You can ask for a summary of everywhere the package has been.

HUMAN

Manual intervention

If a package is stuck or lost, your AI identifies the issue. You then decide if you need to contact Correios support yourself.

The workflow

What your AI does when a tracking code arrives.

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

  1. Fetch status

    Your agent takes the tracking number and queries the Correios database for the most recent event.

    track_object

  2. Interpret data

    The AI translates technical postal codes and status logs into plain language.

    track_object

  3. Summarize movement

    Your agent compiles the list of locations and timestamps into a readable timeline.

    track_object

  4. Flag delays

    The AI looks for anomalies like long periods without movement and alerts you to potential delays.

    track_object

Try it

Copy these to start.

Use these prompts to begin tracking with your agent.

Starting points

Replace the tracking numbers in these examples with your actual Correios codes.

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

  • Track this Correios package for me: [insert code]

  • Where is my package [insert code] right now?

  • Summarize the delivery history for object [insert code]

  • Check if there are any new updates for tracking number [insert code]

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

Start here

Connect Correios once, then ask.

Just click the link to connect the MCP to your client. Your credentials stay encrypted, and you can start tracking immediately.

Connect Correios to your AI

FAQ

How the task behaves

  • 01

    Can my AI change the delivery address?

    No. The AI can only read tracking data. You must contact Correios directly to change any shipment details.

  • 02

    Does the AI update the tracking status automatically?

    The AI can check for updates whenever you ask it to, but it does not push notifications to you unless you have set up a specific monitoring workflow in your client.

  • 03

    Can the AI fix a lost package?

    No. The AI can identify that a package is stuck, but it cannot file claims or contact postal workers.

  • 04

    Do I need to provide the tracking code every time?

    Once you provide a code in a conversation, your agent remembers it, so you can ask follow-up questions about that specific object.

  • 05

    Can the AI track international packages via Correios?

    Yes, as long as the tracking number is valid within the Correios system.

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

Connect Correios to Claude, Cursor, ChatGPT & more