• QUOTES
  • TIMELINES
  • OPTIONS
  • DECISIONS

How to calculate shipping costs and deadlines with your AI

Connect the Correios API to your AI client to pull real-time logistics data. Once connected, your agent handles the math and the lookups for you.

Ask AI about this page

Short answer

How can I get shipping quotes using my AI?

Give your AI the package weight and the destination zip code. It uses the Correios API to return a list of available service levels, their specific costs, and estimated delivery times. You'll get a clear breakdown of options for every shipment.

The outcomes

What you get from your AI

The AI turns raw logistics data into actionable shipping choices.

QUOTES

Instant price lists

The AI pulls current rates from Correios based on your package details. You get a list of costs for different shipping speeds.

TIMELINES

Delivery estimates

Your agent calculates how long each service takes to reach the destination zip code. This helps you set customer expectations.

OPTIONS

Service level comparisons

The AI compares express versus standard services. You can see which option fits your budget or urgency best.

DECISIONS

Human review needed

The AI presents the data, but you decide which service to book. It won't finalize a shipment or charge a card without your command.

The workflow

What your AI does when the data arrives.

The AI acts as the bridge between your chat interface and the Correios logistics engine.

  1. Parse shipment details

    Your agent extracts the necessary weight and zip code from your message. It ensures the data is ready for the API call.

    calculate_price_deadline
  2. Fetch live rates

    The AI sends the package specs to Correios. It retrieves a list of all valid shipping methods for that specific route.

    calculate_price_deadline
  3. Calculate deadlines

    The agent looks at the delivery windows for each service level. It identifies which options are fastest and which are cheapest.

    calculate_price_deadline
  4. Present options

    The AI formats the results into a readable list. You see the price and the estimated arrival date for every available service.

    calculate_price_deadline

Try it

Copy these to start.

Use these prompts to trigger the shipping calculations.

Starting points

Swap the bracketed info with your actual package weight and zip codes.

Correios Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_4iZbXMFuYoAjqYec5stsntBdvl8ODs8dceSPK3aY/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Correios capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "correios-api-rest-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_4iZbXMFuYoAjqYec5stsntBdvl8ODs8dceSPK3aY/mcp"
    }
  }
}
Copy into chat04
  • Calculate shipping for a 2kg package to zip code 01001-000.

  • What are the shipping options and costs for a 500g parcel going to 20040-002?

  • Check the delivery deadlines for a 10kg shipment to zip code 30140-060.

  • Compare the cheapest and fastest shipping methods for a 1.5kg box to 70040-010.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Correios API once, then ask.

One click connects this MCP to your client. Your credentials stay encrypted and your connection remains secure.

Connect Correios API to your AI

FAQ

How this task behaves

  • 01

    Can the AI book the shipment for me?

    No. The AI only retrieves quotes and deadlines. You must handle the actual booking through the official Correios platform.

  • 02

    Does the AI charge my credit card?

    No. This MCP only reads data from the API. It has no access to your payment methods or financial accounts.

  • 03

    Do I need to provide the weight every time?

    Yes. The API requires the weight and the destination zip code to generate an accurate quote.

  • 04

    Can the AI change the shipping service after I pick one?

    The AI can provide new quotes if you change the details, but it cannot modify a shipment that has already been processed elsewhere.

  • 05

    Will the AI remember my previous shipments?

    The AI only knows what is in your current chat history. It does not store a permanent database of your past shipping logs.

  • More questions about Correios API? The Connector page answers them. See everything the Correios API Connector can do

Connect Correios to Claude, Cursor, ChatGPT & more