# Correios do Brazil MCP for AI Agents AI Agent Connect > Correios do Brazil MCP lets you pull real-time shipping rates, delivery estimates, and address data from the official Brazilian postal service. It handles the heavy lifting of calculating costs for SEDEX and PAC services so you don't have to switch tabs to a separate portal. ## Overview - **Category:** ecommerce - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_7RdgeSFMAwQmVAnu6cz3B9qVN1mhg1qOCDL0pHHe/ai-agent-connect - **Tags:** postal-service, shipping-rates, delivery-tracking, logistics-automation, address-verification, package-dimensions ## Description This Connector connects your agent directly to the Correios REST API to handle Brazilian logistics without the manual headache of checking different shipping codes. Instead of jumping between browser tabs to figure out how much a package from São Paulo to Rio will cost, you can just ask your agent to run the numbers. You'll get back precise costs based on weight and dimensions for major services like SEDEX and PAC. It also handles the tedious work of looking up full address details using a ZIP code, which is a lifesaver when you're validating customer data. By adding this to your setup on Vinkius, you turn a multi-step manual process into a single natural language command. It's built for anyone moving goods across Brazil who needs to know exactly how long a package will take to arrive or what the current shipping rates are before they hit confirm on an order. ## Tools ### calculate_prices Get the exact cost for a shipment based on weight, size, and service type. This helps you provide accurate quotes to customers instantly. ### consult_cep Pull the street name, neighborhood, and city from a Brazilian ZIP code. Use this to verify customer data and prevent shipping errors. ### estimate_delivery_time Find out how many working days a package will take to travel between two locations. This helps you set realistic delivery expectations. ## Prompt Examples **Prompt:** ``` How much does it cost to send a 5kg box from São Paulo to Salvador using PAC? ``` **Response:** ``` For a 5kg package from São Paulo to Salvador via PAC, the estimated cost is **R$ 45.90**. This estimate is based on standard dimensions for a box of that weight. ``` **Prompt:** ``` Give me the address for ZIP code 01001000. ``` **Response:** ``` The address for CEP 01001-000 is: **Praça da Sé** Sé, São Paulo - SP ``` **Prompt:** ``` How many days will it take to get a package from Rio to Brasília? ``` **Response:** ``` A shipment from Rio de Janeiro to Brasília typically takes about **4 to 6 working days** depending on the service selected. For a standard PAC delivery, you should expect it in about 6 days. ``` ## Capabilities ### Get shipping costs Retrieve precise pricing for specific package weights and dimensions. ### Estimate delivery windows Find out how many working days a package will take to reach a destination. ### Look up street details Convert a Brazilian ZIP code into a full street and city address. ### Compare postal services Check different shipping codes to find the best balance of speed and price. ### Validate Brazilian addresses Verify that a customer's ZIP code corresponds to a real street and neighborhood. ## Use Cases ### Providing instant quotes for customers A customer asks for a shipping quote for a 2kg box to Curitiba. The agent uses calculate_prices to give a quote in seconds. ### Checking delivery windows for orders You need to know if a package will arrive by Friday. The agent runs estimate_delivery_time between the two ZIP codes. ### Verifying customer addresses A customer provides a ZIP code but no street name. The agent uses consult_cep to fill in the missing address details. ### Comparing shipping speeds for heavy items You're comparing shipping speeds for a heavy item. The agent checks different postal codes to find the best balance of cost and speed. ## Benefits - Stop manual tab-switching by getting shipping quotes for SEDEX and PAC directly in your agent. - Save time on customer service by using consult_cep to verify addresses instantly. - Improve order accuracy by getting estimate_delivery_time data before confirming a sale. - Reduce pricing errors by letting your agent handle weight and dimension calculations via calculate_prices. - Automate logistics workflows for Brazilian e-commerce without needing to write custom API code. ## How It Works The bottom line is you stop manually calculating shipping costs and start getting instant logistics data. 1. Connect your Correios Web Services credentials to the Connector. 2. Describe the package size, weight, and destination to your agent. 3. Get back the total price and estimated delivery days. ## Frequently Asked Questions **Can the Correios do Brazil MCP give me real-time shipping prices?** Yes, it pulls live rates from the official API for services like SEDEX and PAC based on the weight and dimensions you provide. **Does this Connector work for all Brazilian states?** It covers the entire Brazilian postal network for price calculations and address lookups. **Can I use it to verify if a Brazilian ZIP code is valid?** You can use it to pull full address details for any CEP, which confirms the code exists and provides the street and city. **How does the Correios do Brazil MCP handle different package sizes?** You tell your agent the dimensions, and it calculates the price for that specific size. **Does this Connector include international shipping?** No, this is specifically for the domestic Correios network within Brazil. **Is there a limit to how many addresses I can look up?** You can query addresses as needed within your agent's workflow without manual limits. **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.