# Correios (Brazil) MCP for AI Agents AI Agent Connect > Correios (Brazil) MCP gives your AI agent the ability to manage Brazilian postal logistics. It handles real-time package tracking, shipping price quotes for PAC and SEDEX, and Brazilian zip code (CEP) address validation. It also lets you pull contract details and authorized service codes directly into your workflow. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_OakBxCUWmn2rDS2C8hs3jEbHTn1ff0NO8IgnpAxZ/ai-agent-connect - **Tags:** correios, brazilian-post, object-tracking, shipping-calculation, cep-search, sedex-pac, logistics-api ## Description This Connector connects your AI agent to the official Brazilian postal service to handle the heavy lifting of logistics. Instead of jumping between tabs to check package statuses or hunting for shipping rates, you can just ask your agent to do it. It handles the specific nuances of the Brazilian market, like calculating costs for PAC and SEDEX services based on weight and zip codes. You can also use it to verify addresses using Brazilian CEP codes, which helps prevent delivery errors before they happen. It even lets you manage the business side of things by checking contract statuses and listing authorized services. Because it's part of the Vinkius catalog, you can get this running in minutes without worrying about the underlying API complexity. It turns a multi-step manual process into a simple conversation about where a package is or how much it'll cost to get it to a customer. By integrating this into your workflow, you stop worrying about the technical details of the Correios API and start focusing on moving your products faster. It gives you a direct line to the national postal infrastructure, making it a core tool for anyone moving goods within Brazil. ## Tools ### calculate_price_deadline Get the exact cost and delivery timeframe for a shipment. It is useful for providing customers with instant quotes. ### get_contract_status Check if your business contract is active and healthy. Use this to ensure your account is ready for shipping. ### get_unit_info Pull specific details about a single post office branch. This helps you provide precise location info to customers. ### list_contract_services See all the postage services your account is cleared to use. It helps you understand your contract limitations. ### list_unit_types Get a list of all different types of postal units available. Use this to understand the variety of Correios locations. ### lookup_cep Turn a Brazilian zip code into a full street address. It is the best way to validate customer delivery locations. ### search_units_by_cep Find the nearest post office locations for a specific area. This is helpful for customers looking for local pickup points. ### track_object Pull the latest status and history for a specific tracking code. Use this to give customers real-time updates on their orders. ## Prompt Examples **Prompt:** ``` Track the package with code BR123456789BR. ``` **Response:** ``` Checking Correios status... The package is currently in transit. It was last scanned in Curitiba, PR, about 4 hours ago. Would you like to see the full movement history? ``` **Prompt:** ``` What's the price for a 3kg box from São Paulo to Salvador? ``` **Response:** ``` Here are the options for a 3kg package from SP to Salvador: - **SEDEX**: R$ 42.00 (Est. 2 business days) - **PAC**: R$ 28.50 (Est. 7 business days) Which one would you like to use? ``` **Prompt:** ``` Find the address for CEP 04578-000. ``` **Response:** ``` That zip code belongs to: - **Street**: Avenida Paulista - **Neighborhood**: Bela Vista - **City**: São Paulo - SP It's a major commercial area. ``` ## Capabilities ### Track package history Get a full timeline of where a shipment is currently located. ### Quote shipping costs Get instant pricing for PAC and SEDEX services between two regions. ### Validate Brazilian addresses Confirm street and city details using a Brazilian CEP zip code. ### Check contract status See the current state of your official Correios business account. ### List available services See which postage options your specific contract allows. ### Find nearby post offices Locate the closest physical units based on a specific zip code. ### Get unit details Pull specific information about a single post office location. ## Use Cases ### Failed delivery prevention An e-commerce bot uses lookup_cep to verify a customer's address in São Paulo before confirming a large order. ### Instant shipping quotes A user asks their agent to compare PAC and SEDEX prices for a 5kg box to Rio de Janeiro using calculate_price_deadline. ### Bulk shipment monitoring A manager asks for a summary of all 'Delayed' statuses from a list of tracking codes using track_object. ### Contract auditing An admin checks list_contract_services to see if their current agreement includes specific regional services. ## Benefits - Stop manual copy-pasting by using track_object to get real-time shipment updates in one go. - Reduce delivery failures by using lookup_cep to validate every Brazilian address before shipping. - Save time on quotes with calculate_price_deadline to give customers instant PAC and SEDEX pricing. - Simplify contract management by using list_contract_services to see exactly what your account offers. - Improve customer trust by using get_unit_info to provide precise location details for local pickups. - Keep your business account compliant and active by regularly checking it with get_contract_status. ## How It Works The bottom line is you get a direct line to Brazilian postal data without ever leaving your chat window. 1. Create your account on the Correios Web Services Portal. 2. Grab your username, password, and contract number from the API Management section. 3. Plug those credentials into the Connector to let your agent start pulling data. ## Frequently Asked Questions **How can I use the Correios (Brazil) MCP for my online store?** You can connect it to your AI agent to automate shipping quotes and tracking. It allows your agent to pull real-time prices for PAC and SEDEX so you can show customers accurate costs at checkout. **Does the Correios (Brazil) MCP handle Brazilian zip codes?** Yes, it uses the official CEP system to look up street, neighborhood, and city details. This helps you verify that customer addresses are valid before you ship their orders. **Can I use the Correios (Brazil) MCP to check my business contract?** Yes, the Connector can retrieve your contract status and list the specific postage services authorized for your account. This is great for staying organized and ensuring your shipping methods are always active. **Can the Correios (Brazil) MCP track packages for me?** It can pull the latest status and historical events for any package using its tracking code. Your agent can summarize these updates so you don't have to check the website manually. **Is the Correios (Brazil) MCP good for calculating shipping costs?** It is specifically designed for that. It takes the weight and the starting and ending zip codes to give you the exact price and estimated delivery time for different services. **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.