How to Use the Correios API (REST) MCP in Cline

Q: Can Cline use the Correios API (REST) to write test suites?

Yes. Cline can run the calculatepricedeadline tool to gather real payloads, then write mock test suites based on that actual Brazilian postal data.

Q: What tools does the Correios API (REST) server provide to Cline?

This server provides the calculatepricedeadline tool for shipping quotes and the trackobject tool for checking Brazilian package delivery statuses.

Build complete Brazilian ecommerce features in Cline using live Correios API data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Correios API (REST) MCP to Cline

Create your Vinkius account to connect Correios API (REST) to Cline and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Correios API (REST) with Cline

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Fetch shipping quotes directly inside Cline

The `calculate_price_deadline` tool retrieves real-time pricing and delivery windows directly from the official Brazilian postal service. Cline uses this tool to fetch exact shipping rates based on sender and receiver zip codes. If you are building a shopping cart, tell Cline to add a shipping calculator. Your agent calls this MCP Server, retrieves the pricing data, and writes the frontend component to display it.

Build live tracking panels with Cline

The `track_object` tool fetches the current delivery status and history of any Brazilian package. Cline reads this tracking information to help you build customer support dashboards or automated shipment updates. You do not have to write boilerplate API client code. Just ask Cline to create a tracking widget, and it will use this tool to verify the integration works before committing the code.

Write tested ecommerce code using this MCP Server

The `calculate_price_deadline` and `track_object` tools give Cline access to live Correios data through this MCP Server so it can write and test code end-to-end. Your agent can write a shipping service, call the pricing tool to verify the logic, and debug any errors in real time. You watch the agent create the files, import the API responses, and run local tests. Cline handles the entire pipeline within your VS Code workspace.

Setup guide

Set up Correios API (REST) MCP in Cline

Prerequisites

VS Code with Cline extension installed
Active Vinkius subscription with a valid endpoint token

1

Open Cline MCP settings

Click the Cline icon in the VS Code sidebar to open the Cline panel. Then click the MCP Servers icon (server stack) at the top-right corner of the panel.
2

Add a remote server

Click "Remote Servers" at the top, then click "Add Remote MCP". In the Name field, type correios-api-rest-mcp. In the URL field, paste your Vinkius endpoint: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp. Get your token from cloud.vinkius.com.
3

Enable the server

After saving, the server appears in the Cline MCP panel. Toggle the switch to enable it. The status indicator turns green when the connection is live.
4

Start using tools

Return to the Cline chat and ask: "Check my latest Correios API (REST) refund status." Cline will discover the available tools and request your approval before invoking each one — giving you full control over every action.

Cline MCP Settings

{
  "mcpServers": {
    "correios-api-rest-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Correios API (REST) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Correios API (REST) MCP in Cline

Click the MCP Servers icon in the Cline sidebar and navigate to the Remote Servers tab. Paste your Vinkius URL there, or manually add it to your `cline_mcp_settings.json` file.

Yes. Cline can run the `calculate_price_deadline` tool to gather real payloads, then write mock test suites based on that actual Brazilian postal data.

No, Vinkius manages the connection to the official Correios REST API. You only provide your Vinkius endpoint URL in your Cline settings, keeping your environment variables clean.

This server provides the `calculate_price_deadline` tool for shipping quotes and the `track_object` tool for checking Brazilian package delivery statuses.

This MCP Server only processes zip codes, package dimensions, and tracking codes. Vinkius runs the server in an ephemeral, zero-trust container, meaning no postal data is cached or exposed to external parties.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript