How to Use the Correios do Brazil MCP in LangChain

Q: How does the LangChain agent handle invalid ZIP codes from Correios do Brazil?

The agent uses consultcep to verify the address first. If the API returns an error, the LangChain agent catches it and can ask the user to correct the postal code.

Get real-time Brazilian shipping rates and address lookups directly inside your LangChain reasoning loops.

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 LangChain

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain shipping calculations with LangChain agents

Your agent can now take a customer's cart, look up their postal code using `consult_cep`, and immediately feed that address data into `calculate_prices` to find the cheapest shipping option. This isn't just a static lookup. It runs as a dynamic step in your LangChain graph, allowing the agent to decide which postal service fits the order weight and destination. You get to watch this entire decision path live in LangSmith. If a ZIP code lookup fails or returns unexpected data, your agent catches the error, adjusts its query, and tries again without crashing your pipeline. It makes Brazilian logistics feel like a local, predictable database call.

Trace Correios do Brazil MCP Server calls in LangSmith

When your agent calls `estimate_delivery_time` through this MCP Server, LangSmith captures the exact input payload, latency, and API response. Stop guessing why a shipping estimate failed or why a customer was quoted the wrong rate. You can pinpoint whether a delay happened at the Correios API level or within your agent's reasoning chain. Having this level of observability means you can confidently deploy autonomous checkout assistants. You see the exact tokens used, the execution time of each tool, and the raw JSON returned from the Brazilian postal service, making debugging painless.

Build multi-step Brazilian logistics pipelines

Use `calculate_prices` alongside over 500 LangChain integrations to automate your entire e-commerce backend. An agent can pull order details from your database, run the calculation to get real-time rates, and then write those quotes directly back to your ERP. Because these tools integrate into LangChain's unified interface, you don't have to write custom glue code for the Correios API. Your agent handles the logic of choosing between fast or cheap delivery options by evaluating the output of `estimate_delivery_time` on the fly.

Setup guide

Set up Correios do Brazil MCP in LangChain

Prerequisites

Python 3.10+ installed
langchain-mcp-adapters + langgraph packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install langchain-mcp-adapters langgraph langchain-openai. The MCP adapters package converts MCP tools into native LangChain BaseTool objects.
2

Connect via HTTP transport
Use MultiServerMCPClient with "transport": "http" pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create a ReAct agent
Pass the discovered tools to create_react_agent() from LangGraph. The agent automatically routes Correios do Brazil tool calls through the MCP protocol.
4

Run with any LLM
Swap ChatOpenAI for ChatAnthropic, ChatGoogleGenerativeAI, or any LangChain-compatible model. The MCP tools work identically across all providers.

agent.py

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI

async with MultiServerMCPClient({
    "correios-do-brazil-mcp": {
        "transport": "http",
        "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    }
}) as client:
    tools = client.get_tools()

    agent = create_react_agent(
        ChatOpenAI(model="gpt-4o"),
        tools,
    )
    result = await agent.ainvoke({
        "messages": "List recent Correios do Brazil transactions"
    })
    print(result["messages"][-1].content)

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 LangChain

Yes. You can loop through a list of orders in a LangChain runnable map, calling `calculate_prices` for each destination ZIP code in parallel.

The agent uses `consult_cep` to verify the address first. If the API returns an error, the LangChain agent catches it and can ask the user to correct the postal code.

No, the MCP Server handles the schema translation automatically. LangChain reads the tool outputs directly as structured JSON, making it easy to pass to the next step.

Definitely. You can build a graph where one node calls this server to get delivery times via `estimate_delivery_time` and another node queries a currency converter API.

The server only processes the raw ZIP codes and package dimensions required by the Correios API. Vinkius runs this in a sandboxed environment, meaning your customers' physical address data is never stored or logged on our end.

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