How to Use the Correios do Brazil MCP in Mastra AI

Q: How do I register Correios do Brazil tools in Mastra AI?

Install @mastra/mcp@latest, initialize your MCP client with the Vinkius URL, and spread mcpClient.listTools() directly into your agent's tool array.

Q: Can I require human approval for Correios do Brazil actions in Mastra AI?

You can use Mastra's requireToolApproval flag to pause workflows whenever the agent attempts to run estimatedeliverytime for high-value orders.

Automate Brazilian shipping workflows and address routing using Mastra AI and live Correios 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 do Brazil MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build resilient shipping workflows with Mastra AI

The `calculate_prices` tool runs inside your Mastra workflows to automate shipping decisions. If a price calculation fails due to a temporary network issue, Mastra's built-in retry engine automatically backs off and tries again without crashing your checkout pipeline. You can write conditional logic that redirects orders to alternative services if the Correios quote exceeds a certain threshold. This MCP Server lets your agents make these decisions autonomously based on real-time data.

Verify Brazilian ZIP codes before processing payments

Use the `consult_cep` tool to validate customer addresses inside your multi-step agent workflows. The agent checks the ZIP code, pulls the official street names, and flags any mismatches before your application triggers a payment gateway. Should a ZIP code turn up invalid, Mastra's routing logic can trigger a customer notification. This MCP Server helps keep your shipping database clean and reduces failed deliveries across Brazil.

Monitor delivery SLAs automatically

The `estimate_delivery_time` tool allows your Mastra agents to track estimated arrival dates against your actual fulfillment times. Your workflow can calculate transit windows between any two Brazilian postal codes and log them to your database. When a shipment is projected to arrive late, the agent can trigger an automated email alert to the customer. You don't need to write manual cron jobs; Mastra coordinates the entire process using the MCP Server.

Setup guide

Set up Correios do Brazil MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Correios do Brazil tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "correios-do-brazil-mcp-client",
  servers: {
    "correios-do-brazil-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Correios do Brazil Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Correios do Brazil tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Correios do Brazil transactions"
);
console.log(result.text);

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 Mastra AI

Install `@mastra/mcp@latest`, initialize your MCP client with the Vinkius URL, and spread `mcpClient.listTools()` directly into your agent's tool array.

Yes. If the Correios API experiences downtime, Mastra AI handles automatic retries with exponential backoff for the `calculate_prices` tool.

You can use Mastra's `requireToolApproval` flag to pause workflows whenever the agent attempts to run `estimate_delivery_time` for high-value orders.

It uses standard SSE or Streamable HTTP transports. Mastra automatically detects the transport type from your Vinkius endpoint URL.

All CEP lookups and package details are processed through isolated, ephemeral sandboxes. Your sensitive shipping data is never cached or stored on Vinkius 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