Vinkius
Correios API

Correios API MCP for AI. Track Brazilian shipments & quote costs instantly.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Correios API (REST) MCP on Cursor AI Code EditorCorreios API (REST) MCP on Claude Desktop AppCorreios API (REST) MCP on OpenAI Agents SDKCorreios API (REST) MCP on Visual Studio CodeCorreios API (REST) MCP on GitHub Copilot AI AgentCorreios API (REST) MCP on Google Gemini AICorreios API (REST) MCP on Lovable AI DevelopmentCorreios API (REST) MCP on Mistral AI AgentsCorreios API (REST) MCP on Amazon AWS Bedrock

Connect to your AI in seconds.

Correios API provides direct access to Brazilian postal services data. You can track any object using its tracking code or calculate accurate shipping costs and estimated delivery deadlines for various services like SEDEX and PAC.

What your AI can do

Calculate price deadline

Estimates both the cost and delivery timeline for a package between two Brazilian zip codes, given weight and dimensions.

Track object

Fetches the complete status history and current location details for any specific postal tracking code.

Determine object status

Retrieves the full history of events and current location for any valid postal tracking code.

Estimate shipping costs

Calculates the precise monetary price for various services based on package dimensions, weight, and destination codes.

Calculate delivery deadlines

Provides an estimated number of business days until the package is expected to arrive at its destination.

Automate logistics quoting

Runs simulated shipping price and deadline calculations for e-commerce checkout processes or support chats.

Included with Plan

Waiting for input…

AI Agent

Correios API (REST) with 2 Tools

These tools allow you to get real-time logistics data for Brazil: run a package tracking query or calculate shipping price and deadlines.

Make your AI actually useful.

Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.

Start using Correios API (REST) on Vinkius

Calculate Price Deadline

Estimates both the cost and delivery timeline for a package between two Brazilian zip codes, given weight and dimensions.

Track Object

Fetches the complete status history and current location details for any specific...

Security and governance baked right in.

Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.

Claude AI

Claude AI

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

3

Start a conversation

Open a new chat. The Correios API integration is available immediately — no restart needed.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

  • Import from OpenAPI, Swagger, or YAML specs
  • Create Agent Skills with progressive disclosure
  • Deploy to edge with MCPFusion framework
  • Built in DLP, auth, and compliance on every call
  • Real time usage dashboard and cost metering
  • Publish to catalog or keep private
Start building

Make Your AI Do More

Start with Correios API (REST), then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.

  • Use this MCP plus 5,100+ others, all in one place
  • Add new capabilities to your AI anytime you want
  • Every connection is secured and compliant automatically
  • Track usage and costs across all your servers
  • Works with Claude, ChatGPT, Cursor, and more
  • New servers added to the catalog every week
Correios API MCP server cover

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Correios. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

Your data is protected. See how we built it.

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This connection provides 2 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.

Dealing with shipment data usually means copy/pasting between three or four tabs.

Today, when a customer asks about an order, you grab the tracking number and switch to the postal carrier's website. Next, if they ask how much another item will cost to ship, you open a separate calculator page, manually enter the dimensions, and wait for the quote. This process takes time and requires juggling multiple browser tabs just to answer one simple question.

With this MCP, your agent handles it all automatically. You tell the system what data point is needed—be it status or price—and it performs the lookup internally. The result appears in the conversation instantly, letting you keep the user engaged without the manual effort.

Getting accurate pricing and tracking using `calculate_price_deadline`

The system eliminates the need to manually check compatibility between services. Instead of looking up if a service like SEDEX requires specific dimensions, you pass all the parameters to the tool. It handles the complex logic behind the pricing structure.

Now, calculating accurate shipping rates is just a function call. You get the price and deadline back in one go. That's how much faster your support team can answer questions.

What your AI can actually do with this

Need to handle logistics queries in Brazil? This MCP connects your agent directly to the official Correios REST infrastructure, letting you automate tasks that used to require multiple website visits. Instead of switching between tabs to check status or calculate quotes, your AI client handles it all within the chat interface.

For instance, if a customer asks for a tracking update, your agent can fetch the history instantly. If they ask how much an item will cost to ship, the system simulates the price and deadline using weight and zip code details. This keeps conversations flowing and provides instant answers without manual lookups.

By connecting this service via Vinkius, you get reliable access to Brazilian logistics data right where your workflow is happening.

Built · Hosted · Managed by Vinkius Correios API - Track Shipments & Calculate Costs
Server ID 019e387d-ef8d-738f-b61a-a87e43dc5c24
Vinkius Inspector
Compliance Grade A+
Score 100/100
Vinkius Inspector Badge — Score 100/100

Questions you might have

Can I track an object using the `track_object` tool? +

Yes, you can use track_object to fetch the full history and current status of any package. Just provide a valid Brazilian tracking code.

How do I calculate shipping costs with `calculate_price_deadline`? +

You must pass three things: the origin zip, the destination zip, and the full dimensions/weight of the package. This ensures an accurate quote for any service.

Does this MCP handle international tracking? +

No, this MCP is designed specifically for Brazilian postal services (Correios). For international shipments, you'll need a different API tool.

What if I change the dimensions? Do I run `calculate_price_deadline` again? +

Yep. Because shipping rates are highly sensitive to package size, always re-run calculate_price_deadline whenever you adjust any dimension or weight.

What credentials are required before running `track_object`? +

You must provide your registered Correios User and Password to connect. You'll enter these details during the initial setup phase on Vinkius. This ensures your AI client can authenticate with the official API endpoints.

If I run `track_object` with an invalid or non-existent postal code, what response should I expect? +

The tool will return a structured error message indicating that the tracking number is invalid. This prevents guesswork and gives your agent a clear status to report back to the user.

Are there any limits on how often I can run the `calculate_price_deadline` tool in a single day? +

Yes, like all official APIs, there are rate limits. If you send too many requests quickly, you'll receive an API throttle error. It’s best practice to batch similar calculations or implement a short delay between calls.

When using `calculate_price_deadline`, must I specify the shipping service (like SEDEX or PAC)? +

Absolutely, you must name the specific service type. The price and deadline change drastically depending on whether it's a standard PAC shipment or an express SEDEX package.

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.

Built & Managed by Vinkius 30s setup 2 tools

We've already built the connector for Correios API. Just plug in your AI agents and start using Vinkius.

No hosting. No infrastructure. No complex setup.
All 2 tools are live and waiting. You're up and running in seconds.

Vinkius runs on Claude Claude
Vinkius runs on ChatGPT ChatGPT
Vinkius runs on Cursor Cursor
Vinkius runs on Gemini Gemini
Vinkius runs on Windsurf Windsurf
Vinkius runs on VS Code VS Code
Vinkius runs on JetBrains JetBrains
Vinkius runs on Vercel Vercel
+ other MCP clients

Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.