Correios MCP for AI. Get instant Brazilian shipping rates & address validation.
Works with every AI agent you already use
…and any MCP-compatible client








Connect to your AI in seconds.
Correios (Brazil) MCP gives your AI agent full control over Brazilian logistics. You can instantly track packages, get precise shipping costs and delivery deadlines for services like PAC or SEDEX, and validate addresses using any Brazilian CEP code.
Stop guessing rates; automate everything from tracking updates to calculating postage fees directly through natural conversation.
What your AI can do
Calculate price deadline
Calculates the total cost and expected delivery window for shipping between two points.
Get contract status
Checks if your business contract with Correios is active or requires attention.
Get unit info
Retrieves specific details about a local post office unit by its identifier.
Enter a tracking code and receive real-time, granular updates on a package's journey.
Provide two zip codes and the package weight to get multiple service options (like PAC or SEDEX) with associated prices and expected delivery dates.
Input a CEP code, and the MCP returns the complete official street name, neighborhood, and city details.
Search for nearby post office branches or operational units using only a given CEP code.
Check the status of your account, list available services, and retrieve specific unit information required for billing.
Ask an AI about this
Waiting for input…
Correios (Brazil) with 8 Tools
Use these tools to perform every logistical action required in Brazil: from validating addresses using a CEP to calculating complex cross-state shipping costs.
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 (Brazil) on VinkiusCalculate Price Deadline
Calculates the total cost and expected delivery window for shipping between two points.
Get Contract Status
Checks if your business contract with Correios is active or requires attention.
Get Unit Info
Retrieves specific details about a local post office unit by its identifier.
List Contract Services
Shows all the specific postage services your account is authorized to use.
List Unit Types
Lists every type of postal unit available within the Correios network.
Lookup Cep
Uses a Brazilian zip code (CEP) to retrieve the full official address details, including street and neighborhood.
Search Units By Cep
Searches for nearby post office locations based on a provided CEP area.
Track Object
Inputs a tracking code and returns the current location and status history of that...
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 (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 8 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Getting shipping rates and verifying addresses in Brazil used to feel like a guessing game.
Right now, if you need to send something, you're stuck jumping between websites. First, you look up the CEP on one site, then you take that address data and copy-paste it into another calculator just to get a cost estimate. Then, if you change the weight or service type, you repeat the whole tedious process—it’s slow, and chances are, you miss something critical.
With this MCP, all of that manual jumping stops. Your agent handles the entire chain: give it two zip codes, tell it the weight, and ask for rates. It pulls together multiple official service options (like PAC or SEDEX) with their prices and deadlines in a single response. You just get the answer.
You finally have direct access to Correios data through the `track_object` tool.
Before, if a customer called about a package delay, you'd spend five minutes manually logging into the tracking portal, finding the object number, and trying to interpret the cryptic status codes. You were always reacting to the system; you weren't in control.
Now, your agent runs `track_object` on demand. It delivers the package status—the last known location, the delivery date, and the full movement history—in a conversational format. It makes customer service instant.
What your AI can actually do with this
Running e-commerce in Brazil means dealing with complex postal rules. This MCP connects your AI agent straight into Correios, the national carrier. You can use it to track packages and find out exactly where an item is at any point in time. It calculates shipping prices and estimates delivery times for specific routes, whether you're sending a small box or a large shipment.
Plus, if you have a Brazilian zip code (CEP), this MCP validates the whole address—street, neighborhood, city—so your shipments never get returned due to bad data. Vinkius makes connecting this critical infrastructure simple; your agent just asks for the info it needs.
019d842a-4456-7108-b337-2ecdf8e963e8 Here's how it actually works
The bottom line is you talk to your agent like talking to a human logistics expert; it handles all the complex Brazilian postal rules for you.
First, you connect your AI agent to this MCP by providing your necessary contract credentials (Username, Password, Contract Number) through the Vinkius catalog.
Next, you simply ask your agent a question—for example, 'What's the cost of shipping from São Paulo to Rio de Janeiro?'
The MCP runs the query, interacts with Correios systems, and returns a formatted answer containing multiple service options, prices, and deadlines.
Who is this actually for?
Anyone who ships goods in Brazil runs into this pain: figuring out accurate rates and verifying addresses manually is slow, error-prone work. This MCP gives your team instant access to official national logistics data without needing a dedicated developer.
You need to quickly calculate shipping costs for new product listings or run bulk quotes before closing out the day's sales manifests.
You have a customer asking 'Where is my package?' and need instant, accurate tracking status without navigating multiple carrier websites.
You're writing code that needs to programmatically validate addresses or list service codes associated with an account contract for a new feature launch.
What Changes When You Connect
Stop manually checking tracking sites. Use track_object to get the full movement history of any package using just its code.
Save money and time on quotes. The calculate_price_deadline tool gives you multiple service options (like PAC vs SEDEX) with clear costs and estimated delivery dates in one query.
Never accept a bad address again. Running lookup_cep validates the full street, neighborhood, and city details from just the CEP code.
Speed up your setup process. You can use list_contract_services to see exactly which postage services are available under your account without calling multiple internal systems.
Improve local mapping accuracy. If you need to find a post office near an address, run search_units_by_cep instead of guessing the closest branch.
See it in action
Handling a Shipment Quote for a New Client
A client needs shipping rates from São Paulo (CEP 01310-100) to Salvador (CEP 40010-000). Instead of calling the sales team, your agent uses calculate_price_deadline and instantly returns a table showing both SEDEX and PAC options with clear price points.
Fixing an Incorrectly Entered Shipping Address
The warehouse worker only has 'CEP 01310-914'. They use lookup_cep to verify the full address (Avenida Paulista, 1159) before printing the label, avoiding a costly return trip.
Checking Contractual Service Availability
The operations lead needs to confirm if their current contract supports express international services. They run list_contract_services and immediately see if 'SEDEX' is listed, preventing a service failure later.
Investigating a Delayed Package
A customer calls about package 'QI123456789BR'. The agent uses track_object and immediately pulls up the full history showing exactly where it was last scanned, giving the client an immediate answer.
The honest tradeoffs
Using general mapping APIs for postal data
Just relying on Google Maps or other generic services to confirm a street address when shipping. These often miss specific neighborhood rules or official Correios designations.
Use lookup_cep. This MCP calls the official national system, so you get guaranteed accurate city and neighborhood data for any CEP.
Manually checking multiple service rates
To compare SEDEX vs. PAC costs, an employee has to open two different rate calculators online with slightly varying inputs, wasting 10 minutes of work.
Use calculate_price_deadline. It compares all available services in one go using your agent, giving you a comparative quote instantly.
Assuming the contract is active
Attempting to send bulk shipments without verifying account status first. This leads to payment failures and operational delays.
Always check get_contract_status before running any major shipment operation to ensure your credentials are good to go.
When It Fits, When It Doesn't
Use this MCP if your primary need is official, actionable Brazilian postal data. This means you must calculate rates (use calculate_price_deadline), validate addresses using the CEP system (lookup_cep), or track a physical item (track_object). Don't use it if you just need general geographic coordinates for an area—a standard mapping service works better there. Also, don't use this MCP to manage internal inventory; it only handles external logistics and postal details. If your goal is purely reporting on past shipments without needing live status checks, you might find other historical data tools more direct.
Questions you might have
How do I use the calculate_price_deadline tool? +
You provide two zip codes (CEP) and the package weight. The MCP returns multiple options, detailing costs and estimated delivery days for services like PAC or SEDEX.
Does lookup_cep verify a street address? +
Yes. It doesn't just give you the neighborhood; it retrieves the complete official street name, number, city, and state associated with that CEP code.
What is the difference between search_units_by_cep and get_unit_info? +
search_units_by_cep finds nearby post office locations based on an area. get_unit_info requires a specific unit ID to pull detailed information about that single branch.
Can I check my account status with get_contract_status? +
Yes, this tool checks the current operational standing of your Correios contract. This is essential before running any large-scale shipment operation to prevent failures.
Before running `track_object`, what credentials must I provide for authentication? +
You need to pass your Username, Password, and Contract Number obtained from the official Correios Web Services Portal. The MCP uses these keys to authenticate your request before tracking any package status.
What kind of services does `list_contract_services` return? +
The tool returns a list of all postage service codes and their names that are currently active under your specific contract. This helps you know exactly which shipping options, like PAC or SEDEX, you can calculate rates for.
If I use `lookup_cep` with an invalid Brazilian ZIP code (CEP), what error do I receive? +
The MCP returns a specific error message that tells you the CEP is malformed or does not correspond to any registered address in the system. This lets your agent know immediately that the input data needs correction.
What information can `list_unit_types` provide about post office locations? +
list_unit_types gives you a reference list of all official Correios unit categories. It’s useful for understanding the type of facility—like a main branch or a small pickup point—before searching for nearby units.
Can my AI automatically track a package just by providing the tracking code? +
Yes! Use the track_object tool with the tracking code (e.g., 'QI123456789BR'). Your agent will retrieve the current status, location, and the full history of logistics events.
How do I calculate shipping prices for PAC or SEDEX? +
Use the calculate_shipping tool with the origin and destination CEPs, along with the weight and dimensions of the package. The agent will return the estimated price and delivery deadline.
Can I retrieve the full address details from a zip code (CEP)? +
Yes! The search_cep tool allows your agent to fetch the street name, neighborhood, city, and state associated with any valid Brazilian zip code.
We've already built the connector for Correios. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 8 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.