Correios MCP. Track packages, calculate shipping, and validate Brazilian addresses.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Correios (Brazil) MCP Server gives you direct access to Brazil's national postal service logistics. Use it to track any package status, calculate accurate shipping prices and deadlines (PAC/SEDEX), and validate complex Brazilian addresses using CEP codes.
It handles everything from tracking objects to checking contract service lists, all through your AI agent.
What your AI agents can do
Calculate price deadline
Calculates the shipping cost and estimated delivery date for a package between two zip codes.
Get contract status
Checks the current operational status of your specific Correios business contract.
Get unit info
Retrieves detailed information about a specific post office unit location.
The agent calculates the cost and expected delivery date for a package moving between two specified Brazilian zip codes, offering multiple service options like SEDEX and PAC.
The agent checks the current location and movement history of a package using its unique Correios tracking code.
The agent takes a Brazilian CEP (zip code) and returns the full, verified address, including the street, neighborhood, and city.
The agent lists all postage services and checks the operational status of the associated Correios contract.
The agent searches for physical post office locations near a given CEP or lists all available unit types used by Correios.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Correios (Brazil) MCP Server: 8 Tools for Logistics
Use these 8 tools to manage everything from tracking objects to calculating shipping rates and validating addresses across Brazil.
019d842acalculate price deadline
Calculates the shipping cost and estimated delivery date for a package between two zip codes.
019d842aget contract status
Checks the current operational status of your specific Correios business contract.
019d842aget unit info
Retrieves detailed information about a specific post office unit location.
019d842alist contract services
Lists all postage services that are active and available under your business contract.
019d842alist unit types
Lists every type of post office unit designation used by Correios.
019d842alookup cep
Gets the full street, neighborhood, and city details associated with any Brazilian zip code.
019d842asearch units by cep
Searches for and lists physical post office units near a specified Brazilian zip code.
019d842atrack object
Checks the current status and full history of a package using its tracking code.
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 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ 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
What you can do with this MCP connector
You're hooking your AI agent up to Correios, Brazil's national postal service. This MCP lets you run real-time logistics stuff—track packages, nail down shipping costs and deadlines, and validate complex Brazilian addresses using CEP codes. You'll use it to handle everything from object tracking to checking your business contract status, all through your agent.
Track Package Status
Use track_object to check a package's current location and its full history using its unique tracking code.
Validate Brazilian Addresses
Give it a Brazilian CEP and lookup_cep returns the full street, neighborhood, and city details. You can also use search_units_by_cep to find physical post office units near a specific CEP, or run list_unit_types to see every designation Correios uses for its units.
Calculate Shipping Prices and Deadlines
Need to ship something? calculate_price_deadline figures out the cost and expected delivery date for a package moving between two specified zip codes, handling services like SEDEX and PAC.
Manage Contract Services
To manage your business relationship, list_contract_services lists every postage service that's active under your business contract, and get_contract_status checks the current operational status of that contract. You can also use get_unit_info to pull detailed information about a specific post office unit location.
How Correios MCP Works
- 1 Subscribe to the Correios MCP Server and obtain your credentials (Username, Password, Contract Number) from the Correios Web Services Portal.
- 2 Configure your agent with the necessary API keys and contract details.
- 3 Run a command like 'Track package X' or 'Calculate shipping from CEP A to CEP B' to let your agent execute the relevant tool calls.
The bottom line is that your AI agent handles all the API calls and data formatting; you just ask it what you need.
Who Is Correios MCP For?
E-commerce operations teams and support staff need this. They're the ones who wake up at 2 AM needing to know where a package is, or the logistics managers who deal with high volumes of shipments and constantly need to cross-reference CEPs for billing. This saves them the day of manual portal clicks and spreadsheet updates.
Automates shipping rate calculations and tracking updates for Brazilian customers directly into the checkout flow.
Monitors large volumes of outbound shipments and verifies regional data without leaving their primary dashboard.
Provides real-time package status checks and verifies customer addresses instantly via natural language chat.
What Changes When You Connect
- Automate Tracking: Instead of logging into the Correios website and manually entering a tracking number, your agent runs the
track_objecttool. You get the object's status and full history in a single chat response. - Instant Shipping Quotes: Calculating shipping used to mean jumping between spreadsheets and the Correios website. Now, running
calculate_price_deadlinegives you instant, multi-service options (PAC, SEDEX) based on two CEPs. - Data Validation: Need to know if a customer's address is legit? Use
lookup_cep. It returns the full street, neighborhood, and city for any CEP, eliminating manual address lookups. - Contract Oversight: Running
list_contract_serviceslets you see exactly what services your company paid for. It keeps your operations running smoothly by confirming service availability. - Geo-Specific Search: If you need to know where the nearest post office is, run
search_units_by_cep. It finds nearby physical locations, linking location data to your CEP workflow. - Comprehensive Unit Data: Use
get_unit_infoto get deep details on a specific post office unit. This is useful when your system needs to confirm the operational parameters of a specific location.
Real-World Use Cases
Handling a Delayed Shipment Inquiry
A customer complains about a late package. Instead of forcing the agent to open a tracking page, you simply tell it: 'Check tracking code XYZ.' The agent runs track_object and immediately reports the status, including the last known location and any delay notes, solving the problem in one step.
Calculating Shipping for a New Product Line
You need to price a new product going from São Paulo to Rio de Janeiro. You prompt the agent: 'Calculate shipping for 2kg from 01310-100 to 20040-002.' The agent runs calculate_price_deadline and returns a clear breakdown of costs and deadlines for both SEDEX and PAC.
Verifying an Address for Billing
Before generating a shipping label, you must validate the customer's location. You tell the agent: 'What is the full address for CEP 01310-914?' The agent runs lookup_cep and provides the full, confirmed street address, ensuring your billing records are accurate.
Auditing Service Scope
Your manager asks, 'Are we authorized to sell SEDEX?' Instead of digging through contract documents, you ask the agent to run list_contract_services. It immediately checks your account and confirms if SEDEX is an authorized service.
The Tradeoffs
Sequential lookups
Trying to find a service by first calling lookup_cep for a city, then calling search_units_by_cep for that city, and then calling get_unit_info for the result. This is slow and requires manual data passing between steps.
→
Let your agent orchestrate these calls. You just ask: 'Find details for the post office near CEP 01310-914.' The agent handles the sequence: lookup_cep -> search_units_by_cep -> get_unit_info.
Guessing service availability
Assuming a certain service (like PAC) is available because it's common knowledge, but not checking if your contract supports it. This leads to failed shipments and incorrect pricing.
→
Always run list_contract_services first. This confirms what services your account actually supports before you calculate anything with calculate_price_deadline.
Treating tools as single actions
Thinking that track_object is enough. You need to know why the object is delayed. The tool only gives status, not the root cause.
→
Use the tool, then follow up with contextual analysis. For example, after track_object reports a delay, ask the agent: 'What are the typical causes for delays in this region?'
When It Fits, When It Doesn't
Use this MCP Server if your workflow requires reliable, real-time logistics data specific to Brazil. You need to know if a package is where it should be, or if a shipment can legally be sent from Point A to Point B based on current contracts.
Don't use this if you only need general global shipping data (use a general shipping API) or if you are building a system that only handles local, non-postal logistics (use a specialized local mapping service).
Crucially, if your process involves finding a physical address, checking its postal code, and then calculating the cost to send something there, this is the right tool. It connects the location (via lookup_cep), the capability (list_contract_services), and the outcome (calculate_price_deadline).
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 server provides 8 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
The biggest friction point is manually verifying addresses and calculating costs.
Today, if you need to ship a package, you're bouncing between the Correios website, a separate address validator, and a rate sheet. You copy the CEP, paste it into one tool. Then you copy the result, paste it into a second tool to find the nearest post office. Then you start a third tab to calculate the price based on the origin and destination CEPs. It's a painful, multi-step, copy-paste process.
With this MCP Server, your agent handles the whole sequence. You just tell it: 'Calculate the shipping cost for a 2kg box from 01310-100 to 20040-002.' The agent runs `calculate_price_deadline` and gives you the final, actionable list of services, saving you all the back-and-forth.
Correios (Brazil) MCP Server: Track packages and calculate rates.
You no longer have to manually cross-reference contract limitations with service availability. You ask the agent to run `list_contract_services` and immediately know if a service is authorized. If it is, you can then use `calculate_price_deadline` to get the exact rate, all in one chat thread.
The difference is that you move from being a data assembler—constantly copying and pasting from one portal to another—to a pure decision-maker. Your AI client does the dirty work.
Common Questions About Correios MCP
How do I use the `track_object` tool? +
You provide the unique Correios tracking code (e.g., 'QI123456789BR'). The tool returns the package's current status, including the last known location and movement history.
Can I use `lookup_cep` to find a full address? +
Yes. Giving it a Brazilian CEP is enough. The tool returns the complete street, neighborhood, and city details associated with that specific zip code.
What is the best way to calculate shipping using `calculate_price_deadline`? +
You must provide three pieces of information: the origin CEP, the destination CEP, and the package weight. The tool then returns all available service options (PAC, SEDEX) with costs and deadlines.
Does `search_units_by_cep` find the best post office? +
No. It searches for all physical post office units near the CEP you provide. You then use get_unit_info on a specific unit ID if you need its detailed operational parameters.
Can I check my contract status with `get_contract_status`? +
Yes. Simply asking the agent to run get_contract_status checks the live status of your business contract, confirming if it's active or if there are any issues.
How do I list all available services using `list_contract_services`? +
You call list_contract_services and provide your credentials. The tool returns a complete list of all postage services available under your active contract.
What happens if I use `lookup_cep` with an invalid Brazilian CEP? +
The tool validates the CEP format and, if invalid, returns a specific error message detailing the required format. It won't attempt to query the service with bad data.
Can I check for nearby units using `search_units_by_cep` and filter by type? +
Yes, you can search for nearby post office units and specify a type filter. This helps you narrow down results to specific operational 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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
ScreenshotAPI
Capture full-page website screenshots programmatically with custom viewport sizes, delays, and rendering options via a simple API.
Elastic Enterprise Search
Manage enterprise search via Elastic — search engines and documents, handle indexing, and monitor search analytics directly from any AI agent.
Range
Keep distributed teams in sync with async check-ins, team updates, and meeting tools that reduce unnecessary status meetings.
You might also like
GoTo Connect
Manage your cloud phone system — view call records, send SMS, and manage voicemails via AI.
PBGC Pension Data
Access official US Pension Benefit Guaranty Corporation data — query single and multiemployer plans, ERISA 4044 rates, and financial assistance records.
Typefully
Write, schedule, and grow your audience on Twitter and LinkedIn with an editor that helps you craft threads that go viral.