Correios do Brazil MCP for AI. Get accurate shipping rates and address data instantly.
Works with every AI agent you already use
…and any MCP-compatible client








Connect to your AI in seconds.
Correios do Brazil connects your agent to the official Brazilian postal service data. It lets you calculate precise shipping costs for services like SEDEX and PAC, verify full addresses from any CEP (ZIP code), and estimate delivery times between two points across Brazil.
What your AI can do
Calculate prices
Calculates the exact shipping cost for packages by accepting dimensions, weight, and service type.
Consult cep
Looks up a full address (street, neighborhood, city) given any Brazilian ZIP code.
Estimate delivery time
Provides an estimate of working days needed for delivery between two specified locations.
Determines precise shipping costs based on package dimensions, weight, and chosen postal service (e.g., SEDEX or PAC).
Takes a Brazilian ZIP code and returns the full, structured address, including street, neighborhood, city, and state.
Predicts the estimated number of working days required for delivery between two specific locations in Brazil.
Ask an AI about this
Waiting for input…
Correios do Brazil: 3 Tools for Logistics
Use these tools to calculate precise shipping rates, validate address information, or predict transit time directly through your agent's natural language interface.
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 do Brazil on VinkiusCalculate Prices
Calculates the exact shipping cost for packages by accepting dimensions, weight, and service type.
Consult Cep
Looks up a full address (street, neighborhood, city) given any Brazilian ZIP code.
Estimate Delivery Time
Provides an estimate of working days needed for delivery between two specified...
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.
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
Make Your AI Do More
Start with Correios do Brazil, 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
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
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 3 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Getting shipping rates used to be a mess of spreadsheets and redirects.
Today, figuring out how much it costs to ship an item feels like running around five different websites. You copy the origin ZIP code into one site, paste dimensions into another, then switch over to a third site just to check if that service even supports your destination state. It's tedious, and if you miss one field or use outdated data, the quote is useless.
With this MCP, you tell your agent what you need—the origin, destination, weight, and dimensions. The system handles all those fragmented steps behind the scenes, using `calculate_prices` to give you a single, reliable cost estimate right where you are working.
Getting verified addresses with Correios do Brazil MCP
Before, if your system just took a ZIP code and used it for display, you were often left guessing the correct street name or neighborhood. You'd have to manually cross-reference that data against local records, wasting time and creating potential billing errors.
Now, when you need to confirm an address, you simply call `consult_cep`. The agent returns a clean, structured object containing all official details—the full street, the correct neighborhood name. That's it. You get guaranteed accurate data every single time.
What your AI can actually do with this
Need reliable logistics data for an e-commerce platform? This MCP gives your agent access to the official Correios API. You can get accurate pricing by specifying origin, destination, weight, and package dimensions for various services. Beyond just costs, you'll instantly retrieve full street names and city details using only a Brazilian ZIP code lookup.
It also estimates how many working days it will take for a package to move between any two locations. Just connect your credentials through Vinkius, and your agent handles the complex calculations right where you are working—in the chat or in your IDE.
019e387e-3e31-732e-a8b9-f8b48a11379e Here's how it actually works
The bottom line is you talk to your agent like talking to a person; this MCP handles all the complex API calls in the background.
Subscribe to this MCP and enter your Correios Web Services (CWS) credentials within Vinkius.
Your AI client sends a request detailing the required action, such as dimensions for shipping or two ZIP codes for time estimation.
The MCP runs the query against the official API and returns structured data—be it a cost quote, an address object, or a day count.
Who is this actually for?
E-commerce owners who lose sleep over inaccurate shipping quotes, and developers building logistics into their applications. You're tired of hardcoding rules or making your customers wait for manual rate checks.
Needs to quote accurate shipping prices instantly during checkout without redirecting the customer to a separate carrier page.
Must integrate complex, country-specific logic (like Brazilian ZIP codes) into an application's backend using simple natural language calls.
Needs to quickly verify if a shipment route is feasible and predict delivery windows across multiple states in Brazil.
What Changes When You Connect
Accuracy: Stop guessing on costs. Using calculate_prices provides precise, real-time quotes for services like SEDEX based on exact dimensions and weight.
Data Integrity: Need to confirm an address? consult_cep pulls verified street details from the official source, eliminating manual data entry errors.
Customer Experience: Give your customers instant cost estimates right in the chat. They never have to leave your site just to check shipping rates.
Planning Time: Don't guess delivery windows. Use estimate_delivery_time to give clients reliable transit time predictions for routes across Brazil.
Integration Speed: Your agent handles all the complex API calls, allowing you to integrate core logistics logic into your workflow without writing boilerplate code.
See it in action
Checking Shipping Feasibility
A store owner needs to know if shipping a fragile item from São Paulo to Porto Alegre is possible and how long it will take. They ask the agent, which uses estimate_delivery_time and calculate_prices to give them a cost quote and an 8-day delivery window.
Verifying Partner Addresses
A developer receives a new client ZIP code (CEP). Instead of manually checking it, they ask the agent. The MCP uses consult_cep to immediately return the full street address for database entry.
Pre-Calculating Quote on Demand
A sales team member needs a quote for a bulk order. They feed the agent package dimensions and list multiple services (PAC, SEDEX). The MCP uses calculate_prices to return three distinct rate options immediately.
Optimizing Shipping Routes
A logistics manager is comparing two potential destinations. By running estimate_delivery_time with the destination ZIP codes, they can quickly compare which route offers the fastest working day count.
The honest tradeoffs
Assuming a general lookup works
A developer tries to find shipping cost using only consult_cep, thinking any address info will give them a rate.
You need more than just an address. Use calculate_prices and provide the package dimensions, weight, and service type so the MCP can generate a proper quote.
Forgetting required parameters
Asking for delivery time between two ZIP codes but omitting the service type (like PAC or SEDEX). The agent will fail because it needs context.
Always specify the intent. Use estimate_delivery_time and ensure your query includes both start/end CEPs and the desired postal service.
Copy-pasting address data
A user manually types in a street name and ZIP code, hoping their agent can use it for shipping.
Let the MCP do the work. Use consult_cep first to validate the raw ZIP code against the official record before trying any calculations.
When It Fits, When It Doesn't
Use this MCP if your core problem involves calculating, verifying, or estimating anything related to shipping within Brazil using official postal data. If you need to process inventory lists across multiple unrelated carriers (like FedEx and Correios), you'll need a broader multi-carrier logistics tool. However, if your goal is merely tracking an already shipped package after the rate was set, this MCP doesn't track; it only calculates or estimates. It works best when combined with other tools that handle order creation or payment processing. Don't use consult_cep alone if you need a price—you must follow up by using calculate_prices. This combination of verification and pricing is its strength.
Questions you might have
How can I calculate the shipping price for a specific package? +
Use the calculate_prices tool. You will need to provide the origin and destination ZIP codes, weight, dimensions, and the service code (e.g., 04014 for SEDEX).
Can I check the delivery deadline between two Brazilian cities? +
Yes! The estimate_delivery_time tool allows you to input the service code and both ZIP codes to receive the estimated delivery time in working days.
Is it possible to find an address using only the ZIP code (CEP)? +
Absolutely. Use the consult_cep tool with the 8-digit ZIP code to retrieve the street name, neighborhood, city, and state automatically.
How do I get started with using the MCP credentials for `calculate_prices`? +
You first subscribe to the MCP and enter your Correios Web Services (CWS) credentials. Once connected, your AI client can start querying logistics data immediately without needing manual API calls.
What specific details must I provide when running `calculate_prices`? +
You need to specify the package weight, dimensions (length, width, height), and both the origin and destination ZIP codes. You also have to name the specific postal service you want to use, like SEDEX or PAC.
Is this MCP limited only to Brazilian postal codes? +
Yes, this MCP is built around the official Correios REST API and functions exclusively with Brazilian ZIP codes (CEP). It cannot process international shipping data.
What happens if I run `consult_cep` using an invalid or non-existent CEP? +
If you enter a bad ZIP code, the tool will return an error message and won't proceed. This prevents incorrect address data from entering your workflow.
Can I use `estimate_delivery_time` to compare different shipping services? +
While it estimates time for a specific service, you can run the tool multiple times with varying services (like SEDEX vs. PAC) to manually compare delivery windows and costs.
We've already built the connector for Correios do Brazil. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 3 tools are live and waiting.
You're up and running in seconds.
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.
Built, hosted, and secured by Vinkius. You just connect and go.