How to Use the Correios do Brazil MCP in Windsurf

Q: How does Windsurf use Correios do Brazil to automate checkout testing?

Cascade calls consultcep to fetch real Brazilian addresses during test execution. It writes these details directly into your integration tests without manual input.

Get real-time Brazilian shipping rates and address validation directly inside Windsurf Cascade.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Correios do Brazil MCP to Windsurf

Create your Vinkius account to connect Correios do Brazil to Windsurf 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 do Brazil with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Calculate shipping costs directly in Windsurf

The `calculate_prices` tool fetches shipping costs for Brazilian postal services directly inside your editor. Cascade chains this MCP tool with your workspace code to update checkout components dynamically when shipping rates change. You don't have to copy-paste package dimensions or postal codes. Cascade reads your cart logic, runs the calculation, and rewrites your pricing functions with real Correios data in one shot.

Resolve Brazilian addresses via Windsurf MCP Server

The `consult_cep` tool pulls complete Brazilian address details using only a ZIP code. Cascade uses this tool to instantly generate mock Brazilian data or pre-fill address forms while you build your checkout UI. Instead of hardcoding dummy Brazilian addresses, you tell Cascade to fetch a real one. It calls the server, gets the street, neighborhood, and city, and writes them straight into your test suites.

Estimate delivery times with Cascade automation

The `estimate_delivery_time` tool calculates the transit days between two Brazilian ZIP codes. Cascade calls this Brazilian shipping endpoint autonomously when you ask it to fix delivery estimation bugs in your codebase. The agent reads your shipping controller, gets the origin and destination CEPs, and checks the delivery window. It then updates your frontend components to display accurate delivery dates to your users.

Setup guide

Set up Correios do Brazil MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Correios do Brazil MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Correios do Brazil payment history." If connected, Cascade will call the Correios do Brazil tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "correios-do-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 do 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 do Brazil MCP in Windsurf

Cascade calls `consult_cep` to fetch real Brazilian addresses during test execution. It writes these details directly into your integration tests without manual input.

Yes, Cascade chains them. You can ask Cascade to find an address with `consult_cep` and then immediately calculate shipping costs using `calculate_prices` in a single prompt.

No, you can add it via the Windsurf MCP panel or edit your local configuration file. Once added, Cascade automatically discovers the shipping tools.

Cascade reads the error message returned by the tool. It then adjusts its plan or asks you to verify the input ZIP codes before trying again.

Your ZIP codes and package dimensions go straight to the Correios API via Vinkius's secure sandboxed environment. No personal buyer data or street addresses are logged or stored on our servers.

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