Correios API (REST) Connector for AI agents.
2 live capabilities
Get real-time Brazilian shipping rates and package tracking data.
Waiting for input…
Why people use Correios API (REST)
Stop the manual tab-switching with Correios API (REST) Brazilian logistics
This Connector changes that by bringing the data to you. Your AI agent handles the heavy lifting, fetching real-time statuses and price quotes directly into your conversation. You get a clear picture of your logistics without ever opening a new tab.
What Vinkius changes
You get real-time Brazilian logistics data inside your AI chat without leaving your workspace.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Answering customer status inquiries
A customer asks 'Where is my package?
- Real-world use case 02
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.
- Real-world use case 03
Providing proactive updates
A support lead wants to check if a high-priority shipment is still on schedule using the tracking capability.
Complete set · 2capabilities
The complete Correios API (REST) capability set.
These are the exact actions your AI can choose when you ask it to work with Correios API (REST).
01—02
2 capabilities in this set.
Part of 2 available through Correios API (REST).
- 01 Capability
Calculate price deadline
Get estimated shipping costs and delivery dates for SEDEX or PAC based on weight and dimensions.
- 02 Capability
Track object
Get the full event history and current status for a specific Brazilian postal tracking code.
Set up in minutes
One URL. Then ask Correios API (REST) to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Correios API (REST) from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_4iZbXMFuYoAjqYec5stsntBdvl8ODs8dceSPK3aY/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Correios API (REST), and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Correios API (REST) for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_4iZbXMFuYoAjqYec5stsntBdvl8ODs8dceSPK3aY/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Correios API (REST) URL.
- Step 03
Save and start
Save the connection and enable Correios API (REST) in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"correios-api-rest": {
"url": "https://edge.vinkius.com/vk_preview_4iZbXMFuYoAjqYec5stsntBdvl8ODs8dceSPK3aY/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Correios API (REST)
Open Agent mode in chat and ask: "Using Correios API (REST), help me...". 2 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"correios-api-rest": {
"url": "https://edge.vinkius.com/vk_preview_4iZbXMFuYoAjqYec5stsntBdvl8ODs8dceSPK3aY/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Correios API (REST)
Ask Copilot: "Using Correios API (REST), help me...". 2 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"correios-api-rest": {
"url": "https://edge.vinkius.com/vk_preview_4iZbXMFuYoAjqYec5stsntBdvl8ODs8dceSPK3aY/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Correios API (REST)
Open Cascade and ask: "Using Correios API (REST), help me...". 2 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"correios-api-rest": {
"url": "https://edge.vinkius.com/vk_preview_4iZbXMFuYoAjqYec5stsntBdvl8ODs8dceSPK3aY/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Correios API (REST)
Ask Cline: "Using Correios API (REST), help me...". 2 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add correios-api-rest --transport http "https://edge.vinkius.com/vk_preview_4iZbXMFuYoAjqYec5stsntBdvl8ODs8dceSPK3aY/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Correios API (REST)
Ask Claude: "Using Correios API (REST), show me...". 2 tools are ready
Where the request belongs
Work Correios can move forward.
This is for the e-commerce ops manager who's drowning in 'Where's my order?' tickets or the logistics lead trying to price out shipping for a new product launch in Brazil.
E-commerce Store Owner
Handles customer inquiries by pulling live tracking data instantly to provide better service.
Logistics Coordinator
Calculates bulk shipping costs for various regions to set accurate landing prices on products.
Customer Support Rep
Provides proactive shipping updates to frustrated customers without toggling between different windows.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsCorreios do Brazil
Calculate shipping costs, estimate delivery times, and consult address information via the official Correios REST API.
USPS Developer Portal
Manage US mail. audit addresses, tracking, and ZIP codes via AI.
EasyPost
Equip your AI agent to manage shipments, track packages, and monitor carrier accounts via the EasyPost API.
AfterShip
Track packages worldwide. create, manage, and monitor shipments via AI.
Correios (Brazil)
Orchestrate Correios logistics. track objects, calculate shipping prices, and validate Brazilian addresses directly from any AI agent.
AfterShip Tracking
Shipment tracking and logistics. track packages, manage couriers, and monitor deliveries via AI.
Bring your own AI
Change the model, client or framework. Keep Correios connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Correios.
The practical details behind the request, access and result.
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 capability.
Can I track multiple objects at once?
The track_object capability 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.
One connection away
Give your agent a direct line to Correios.
Connect Correios once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available