Mcp Correios

io.github.codesparPublished by GitHub account codesparv0.2.0-alpha.3Updated Oct 24, 2026

MCP server for Correios — package tracking, shipping rates, CEP lookup

VerifiedSTDIODesktop onlyLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

MCP server for Brazil's Correios postal service: track packages, calculate shipping rates, look up CEP addresses and manage pre-posting and collection orders.

What you can do
  • Track single or bulk packages by Correios tracking code and read their status.
  • Calculate shipping rates, delivery times, available services, delivery modality and CEP ranges between two CEPs.
  • Look up addresses by CEP, in batches, or search CEPs by street and location.
  • Create, list, fetch and cancel pre-posting orders, and close posted objects into a PLP.
  • Request SIGEP label ranges, schedule or cancel package pickups, and create or read reverse logistics orders.
When to use it
Useful when an assistant needs Brazilian shipping data or Correios operations: checking delivery status, quoting freight between CEPs, resolving addresses, or handling pre-posting, labels, pickups and returns for a Correios contract holder.
Requirements
Runs locally over stdio, typically via npx from the npm package. Needs a Correios API contract and credentials: the CORREIOS_USER and CORREIOS_TOKEN environment variables (the manifest declares only CORREIOS_TOKEN). A homologation environment exists for testing with separate credentials. Desktop client only.
Before you install
The README marks this an alpha release whose endpoint paths have not been fully live-validated, and recommends pinning exact versions. Several tools create, cancel or post real shipping orders, labels and pickups, which can incur costs and change logistics state. Credentials are passed as environment variables and should be kept out of shared config files.

Installation

In SourceWeft

  1. Open Mcp Correios in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-correios

Alpha release — published under the alpha npm dist-tag. Endpoint paths follow public docs and BACEN/provider conventions but have not been fully live-validated. Pin exact versions during 0.x.x-alpha. Install with npm install <pkg>@alpha.

MCP server for Correios — Brazilian postal service tracking, rates, and shipping

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "correios": {      "command": "npx",      "args": ["-y", "@codespar/mcp-correios"],      "env": {        "CORREIOS_USER": "your-user",        "CORREIOS_TOKEN": "your-token"      }    }  }}

Claude Code

bash
claude mcp add correios -- npx @codespar/mcp-correios

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "correios": {      "command": "npx",      "args": ["-y", "@codespar/mcp-correios"],      "env": {        "CORREIOS_USER": "your-user",        "CORREIOS_TOKEN": "your-token"      }    }  }}

Tools (21)

ToolPurpose
track_packageTrack a package by Correios tracking code
track_bulkTrack multiple Correios packages in a single call (up to 50 codes)
calculate_shippingCalculate shipping rates between two CEPs
get_delivery_timeGet estimated delivery time between two CEPs
list_servicesList available Correios shipping services
find_cepLook up address by CEP via Correios
find_cep_bulkBatch address lookup for up to 20 CEPs in a single call
list_cep_rangesList CEP ranges (faixas de CEP) served by a given shipping service
get_delivery_modalityGet delivery modality (forma de entrega) for a CEP and service — whether delivery is domicile, agency picku...
create_prepostCreate a pre-posting order for shipping
get_prepostGet a pre-posting order by ID
list_prepostsList pre-posting orders with optional filters (date range, status)
cancel_prepostCancel a pre-posting order
buy_label_rangeRequest a range of SIGEP tracking labels (etiquetas) for a service
post_objectsClose and post a list of pre-posted objects (fechar postagem SIGEP) — creates a PLP
list_postal_codesSearch addresses by street name or location (returns matching CEPs)
create_collectionSchedule a package collection (pickup) from an address
get_collectionGet collection request details by ID
cancel_collectionCancel a scheduled collection request
create_reverseCreate a reverse logistics (return) order
get_reverseGet reverse logistics order details by ID

Authentication

Correios uses Basic Auth for token generation, then Bearer token for subsequent requests. The server automatically manages authentication.

Sandbox / Testing

Correios provides a homologation environment for testing. Contact Correios for homologation credentials.

Get your credentials

  1. Go to Correios CWS Portal
  2. Register for API access (requires a contract with Correios)
  3. Get your username and token
  4. Set the environment variables

Environment Variables

VariableRequiredDescription
CORREIOS_USERYesCorreios API username
CORREIOS_TOKENYesCorreios API token

Roadmap

v0.2 (planned)

  • list_postal_codes — List postal codes for a region
  • get_postal_code_range — Get postal code range for a city
  • create_collection — Schedule a package collection
  • get_collection — Get collection request details
  • create_reverse — Create a reverse logistics (return) request

v0.3 (planned)

  • batch_tracking — Track multiple packages in a single request
  • international_shipping — Calculate international shipping rates

Want to contribute? Open a PR or request a tool.

Links

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

Source: packages/ecommerce/correios/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.0-alpha.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts