# Correios API (REST) MCP for AI Agents AI Agent Connect

> Correios API (REST) lets you track Brazilian packages and get shipping quotes directly through your AI agent. It connects to the official Correios infrastructure to handle real-time tracking and price simulations for services like SEDEX and PAC.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_4iZbXMFuYoAjqYec5stsntBdvl8ODs8dceSPK3aY/ai-agent-connect
- **Tags:** correios, brazil-logistics, tracking-api, shipping-calculator, postal-service

## Description

This Connector connects your AI agent directly to the Correios infrastructure to handle Brazilian logistics without you having to jump between tabs. If you're tired of copy-pasting tracking numbers into a browser just to see where a package is, this tool changes that. You can ask your agent to pull the full history of a shipment or get a price quote for a specific weight and dimension instantly. It's a huge win for anyone managing Brazilian e-commerce because it puts the official data right where you're already working. You'll find it's a lot easier to manage high-volume shipping when the data comes to you. Vinkius makes it simple to plug this into your existing setup so you can stop manual lookups and start automating the boring stuff. It handles the heavy lifting of talking to the REST API, so you just get the answers you need.

## Tools

### calculate_price_deadline
Get estimated shipping costs and delivery dates for SEDEX or PAC based on weight and dimensions.

### track_object
Get the full event history and current status for a specific Brazilian postal tracking code.

## Prompt Examples

**Prompt:** 
```
Where is package AA123456789BR?
```

**Response:** 
```
I've checked the status for **AA123456789BR**. It's currently **In Transit** and was last seen at the distribution center in São Paulo. 

**Recent Activity:**
* Oct 24: Posted
* Oct 25: Arrived at distribution center
```

**Prompt:** 
```
What's the cost for a 1kg box to 01001-000 via SEDEX?
```

**Response:** 
```
For a 1kg package to zip code **01001-000**, the estimated **SEDEX** price is **R$ 24.50** with a **1-business-day** delivery deadline.
```

**Prompt:** 
```
Give me the history for NL123456789BR.
```

**Response:** 
```
Here's the history for **NL123456789BR**: 

* **Posted:** Oct 24th
* **In Transit:** Arrived at the São Paulo hub on Oct 25th
* **Current Status:** Moving toward your local center.
```

## Capabilities

### Pull full shipping histories
Get the complete event log and current status for any valid Brazilian tracking code.

### Get real-time shipping quotes
Fetch current prices for SEDEX and PAC based on package weight and dimensions.

### Check delivery deadlines
See how many business days a shipment will take to reach a specific zip code.

### Automate status updates
Provide instant tracking information to customers without leaving your chat interface.

### Simulate shipping costs
Compare different shipping options for various package sizes and regional destinations.

## Use Cases

### Answering customer status inquiries
A customer asks 'Where is my package?' and the agent uses track_object to show the last 5 stops in the delivery chain.

### Calculating shipping for a new product
An owner needs to know the cost of shipping a 2kg box to São Paulo and asks for a SEDEX quote to set the price.

### Providing proactive updates
A support lead wants to check if a high-priority shipment is still on schedule using the tracking tool.

### Estimating regional delivery times
A manager checks how many days it takes to reach a specific zip code to set realistic delivery promises.

## Benefits

- Stop manual tracking lookups by using track_object to pull history into your chat.
- Get accurate SEDEX and PAC quotes instantly with calculate_price_deadline.
- Reduce customer wait times by providing immediate status updates to your support team.
- Eliminate pricing errors by simulating shipping costs for specific dimensions and weights.
- Automate logistics workflows for Brazilian e-commerce without manual data entry.

## How It Works

The bottom line is you get real-time Brazilian logistics data inside your AI chat without leaving your workspace.

1. Subscribe to the Correios API (REST) MCP on Vinkius.
2. Enter your official Correios API credentials into your AI client.
3. Ask your agent to track a package or calculate a shipping quote.

## Frequently Asked Questions

**Can the Correios API (REST) track international packages?**
No, this Connector is specifically for the Brazilian postal service. It won't work for international carriers like DHL or FedEx.

**How do I get shipping prices for different services?**
You can ask your agent to calculate prices for SEDEX or PAC based on the weight and dimensions of your package.

**Does the Correios API (REST) provide real-time data?**
Yes, it connects to the official REST API to give you the most current tracking status and shipping rates available.

**Can I use the Correios API (REST) for my e-commerce store?**
It's perfect for Brazilian e-commerce owners who need to give customers instant updates and accurate shipping quotes.

**What information do I need for a price quote?**
Your agent will need the weight, dimensions, and the destination zip code to give you an accurate price and deadline.

**What information do I need to calculate a shipping price?**
You need to provide the origin and destination ZIP codes (CEP), the service code (e.g., 04014 for SEDEX), weight, package format, and dimensions (length, height, width) using the `calculate_price_deadline` tool.

**Can I track multiple objects at once?**
The `track_object` tool currently processes one tracking code per request to ensure detailed event history for that specific item.

**What is the 'idLote' field in the shipping calculation?**
The `idLote` (Batch ID) is a required identifier for the Correios API request. It can be any string or number used to identify your specific calculation request in their logs.