How to Use the Correios do Brazil MCP in Claude Code

Q: How do I configure the Correios do Brazil MCP Server in Claude Code?

Run the claude mcp add command in your terminal. Pass the Vinkius transport type to the MCP connector, then verify with claude mcp list.

Script, automate, and test Correios do Brazil shipping calculations directly from your terminal using Claude Code.

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 Claude Code

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run terminal-based shipping calculations

The `calculate_prices` tool executes shipping cost queries directly from your terminal session. Claude Code uses this tool to quickly check shipping rates or debug pricing logic without leaving your shell. This MCP integration lets you pipe inputs directly into your terminal flow. You can pipe the terminal output of a script directly into Claude Code. The agent calls the Brazilian shipping calculation tool with your input variables and outputs the exact costs in clean JSON format.

Fast CEP lookups via Claude Code MCP Server

The `consult_cep` tool resolves Brazilian ZIP codes to full street addresses from the command line. Claude Code calls this tool to validate customer address databases or run quick lookups during database migrations. If you need to verify a batch of CEPs, you can ask the agent to run them through this tool. It processes the queries sequentially and outputs the verified address structures to your terminal.

Scriptable delivery estimates in the shell

The `estimate_delivery_time` tool estimates transit days between Brazilian postal zones. Claude Code uses this tool to help you build automated delivery reporting scripts or cron jobs. You can instruct the agent to generate a shell script that checks Brazilian delivery times for common routes. It writes the script, tests it using this tool, and verifies the output format.

Setup guide

Set up Correios do Brazil MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see correios-do-brazil-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Correios do Brazil transactions." It will automatically discover and invoke the available Correios do Brazil tools.

Terminal

claude mcp add --transport http correios-do-brazil-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
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

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "correios-do-brazil-mcp": {
      "type": "url",
      "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 Claude Code

Run the `claude mcp add` command in your terminal. Pass the Vinkius transport type to the MCP connector, then verify with `claude mcp list`.

Yes, you can run Claude Code headlessly in your deployment pipelines. The agent will execute shipping calculations or CEP validations as part of your automated test suite.

Yes, every tool call fetches live data directly from the Correios REST API. Claude Code receives the exact, up-to-date pricing and transit times instantly.

Yes, you can feed a list of ZIP codes from a CSV file into Claude Code. The agent parses the input and runs the tools to resolve them.

Your CEP inputs and shipping payloads are transmitted over encrypted HTTPS directly to the Correios API. No address data is cached or written to disk within the Vinkius hosting runtime.

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