# mcp-correios

Connects your coding agent to the Correios postal API in Brazil. Tracks packages, calculates shipping rates, and searches addresses by CEP postal code.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/ecommerce/correios
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-correios

## What it does

This server exposes 21 tools designed for Brazilian postal logistics. Agents can check package tracking status individually or in batches of up to 50 codes. It also quotes shipping prices between two postal codes, calculates transit times, and resolves street addresses for up to 20 CEPs in one request.

Beyond basic lookups, the package handles core shipping operations. It can create pre-posting entries, request SIGEP label intervals, generate dispatch PLPs, schedule courier pickups, and trigger return orders. Authentication runs under the hood: the server exchanges basic credentials for session tokens without manual intervention.

Calls will fail immediately without an active Correios corporate agreement. You must obtain API credentials from the CWS portal and pass them through `CORREIOS_USER` and `CORREIOS_TOKEN`. Because the package is currently an alpha release, locking exact package versions prevents unexpected breaking changes.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `CORREIOS_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-correios -e CORREIOS_TOKEN=<CORREIOS_TOKEN> -- npx -y @codespar/mcp-correios
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add correios --env CORREIOS_TOKEN=<CORREIOS_TOKEN> -- npx -y @codespar/mcp-correios
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "correios": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-correios"
            ],
            "env": {
                "CORREIOS_TOKEN": "<CORREIOS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "correios": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-correios"
            ],
            "env": {
                "CORREIOS_TOKEN": "<CORREIOS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e CORREIOS_TOKEN=<CORREIOS_TOKEN> correios npx -y @codespar/mcp-correios
```
Replace <…> with your own values

## When to use it
- track packages across Brazil using official Correios codes
- calculate shipping costs and transit times between two CEP codes
- resolve street names and municipal data from Brazilian postal codes
- generate SIGEP pre-posting slips and finalize dispatch batches
- schedule warehouse pickups and reverse logistics return requests

## Example prompts
- Track package `AA123456789BR` through Correios and report its latest status
- Calculate delivery rates and estimated transit days from CEP `01001-000` to `20040-002`
- Look up the address details for CEP `70040-010`

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md