Correios MCP Server - install, status & alternatives [2026]

01 · Install Correios

before you install - you'll need

Set CORREIOS_USER, CORREIOS_TOKEN before connecting.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-ecommerc -- npx -y @codespar/mcp-correios

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codespar-mcp-dev-latam-packages-ecommerc": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-correios"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @codespar/mcp-correios - published under the repo owner's npm scope (@codespar)

registry namespace io.github.codespar is GitHub-verified and matches the repo owner

03 · What Correios can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can calculate shipping rates between two CEPs, get estimated delivery time between two CEPs, list available Correios shipping services, and get delivery modality (forma de entrega) for a CEP and service - whether delivery is domicile, agency picku...

Capability map

Tools grouped from the project's README - what Correios lets an agent do.

read & search

3 tools - e.g. List available Correios shipping services; List pre-posting orders with optional filters (date range, status); Search addresses by street name or location (returns matching CEPs)

list_services · list_preposts · list_postal_codes

Cep

3 tools - e.g. Look up address by CEP via Correios; Batch address lookup for up to 20 CEPs in a single call; List CEP ranges (faixas de CEP) served by a given shipping service

find_cep · find_cep_bulk · list_cep_ranges

Prepost

3 tools - e.g. Create a pre-posting order for shipping; Get a pre-posting order by ID; Cancel a pre-posting order

create_prepost · get_prepost · cancel_prepost

Collection

3 tools - e.g. Schedule a package collection (pickup) from an address; Get collection request details by ID; Cancel a scheduled collection request

create_collection · get_collection · cancel_collection

Track

2 tools - e.g. Track a package by Correios tracking code; Track multiple Correios packages in a single call (up to 50 codes)

track_package · track_bulk

Delivery

2 tools - e.g. Get estimated delivery time between two CEPs; Get delivery modality (forma de entrega) for a CEP and service - whether delivery is domicile, agency picku...

get_delivery_time · get_delivery_modality

Reverse

2 tools - e.g. Create a reverse logistics (return) order; Get reverse logistics order details by ID

create_reverse · get_reverse

Calculate

1 tool - e.g. Calculate shipping rates between two CEPs

calculate_shipping

04 · Who maintains Correios

mcp-correios is maintained by codespar. We track 127 MCP servers from codespar - 127 actively maintained, 269 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from codespar.

05 · Facts

repository: github.com/codespar/mcp-dev-latam
category: other - actively maintained as of 2026-08-25.
registry: io.github.codespar/mcp-correios (active, first published 2026-04-12 · 3 versions)
packages: npm:@codespar/mcp-correios

06 · Correios FAQ

Is Correios still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

What can Correios do?

With this server connected, an agent can calculate shipping rates between two CEPs, get estimated delivery time between two CEPs, list available Correios shipping services, and get delivery modality (forma de entrega) for a CEP and service - whether delivery is domicile, agency picku...

How do I install Correios?

Run `npx -y @codespar/mcp-correios`. The README documents 2 environment variables (CORREIOS_USER, CORREIOS_TOKEN) to set first. Set CORREIOS_USER, CORREIOS_TOKEN before connecting. You can also paste the ready-made client config above.

Does Correios run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Correios

Alternatives to Correios

Maintained other servers if Correios isn't the fit.

More MCP servers to compare · Melhor Envio · Focus Nfe · Nfe Io · Nuvem Fiscal · Clearsale

More JavaScript MCP servers · Shopee · Shopify · Vtex · Bling · see all