How to Use the Correios (Brazil) MCP in Cline

Q: Can Cline build a full tracking dashboard using Correios (Brazil)?

Yes, Cline writes the code, imports the trackobject tool, and creates a visual timeline in your application. It executes the entire task from UI layout to live API integration.

Q: What tool should I use to find local Brazilian post offices?

Use searchunitsbycep to locate nearby branches. It returns names, types, and coordinates for offices close to your target postal code.

Build Brazilian logistics features in VS Code using Cline to write code and call Correios APIs.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Correios (Brazil) MCP to Cline

Create your Vinkius account to connect Correios (Brazil) 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 (Brazil) with Cline

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build checkout forms with Cline using this MCP Server

The `lookup_cep` tool retrieves complete Brazilian address details using a CEP code. Cline writes the frontend form, hooks up the API call, and validates the output structure automatically. You don't have to write boilerplate fetch requests. Cline handles the integration end-to-end, placing the address data exactly where your React or Vue component expects it.

Fetch contract details and postage lists

The `list_contract_services` tool outputs all active postage services linked to your corporate account. Cline runs this to populate dropdown menus in your administrative dashboards. It matches these services against your active UI state. If you need to check contract health, Cline runs `get_contract_status` to ensure your account is in good standing.

Calculate live shipping rates on the fly

The `calculate_price_deadline` tool returns shipping prices and transit times for any package dimensions. Cline writes the backend controller to call this tool whenever a user updates their cart. No more hardcoded shipping tables. Cline tests the logic with real Brazilian zip codes to ensure your checkout calculates costs correctly before you commit.

Setup guide

Set up Correios (Brazil) 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-brazil-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 (Brazil) 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-brazil-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 (Brazil) 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 (Brazil) MCP in Cline

Open the Cline sidebar and click the MCP Servers icon. Paste your Vinkius URL in the Remote Servers tab to connect via SSE transport, or edit your `cline_mcp_settings.json` file.

Yes, Cline writes the code, imports the `track_object` tool, and creates a visual timeline in your application. It executes the entire task from UI layout to live API integration.

Cline reads the error codes returned by the server, such as invalid CEPs or expired tracking numbers. It then modifies your frontend validation code to handle these edge cases gracefully.

Use `search_units_by_cep` to locate nearby branches. It returns names, types, and coordinates for offices close to your target postal code.

Yes, Vinkius runs this MCP Server in zero-trust, isolated V8 sandboxes to execute each request. Your contract keys and package tracking IDs pass through secure HTTPS tunnels and are destroyed immediately after execution.

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