Skip to main content
CO

Correios

v0.2.0-alpha.1API Keyalpha

Official Brazilian postal service. Package tracking, shipping rate calculation, CEP lookup, SEDEX, and PAC.

21 tools1 env vars๐Ÿ‡ง๐Ÿ‡ท Brazilalpha โ€” pending validation

Install

terminal
$ npm install @codespar/mcp-correios@alpha

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json
{
  "mcpServers": {
    "correios": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-correios@alpha"
      ],
      "env": {
        "CORREIOS_TOKEN": "<your_correios_token>"
      }
    }
  }
}

After restart, your agent can call any of the 21 tools below โ€” try track_package first.

Environment variables ยท 1

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

CORREIOS_TOKEN
requiredsecret

API key for correios

Available tools ยท 21

Each tool is independent โ€” your agent loads only what it needs to reduce context and response time.

WRITEtrack_package
Track a package by Correios tracking code
WRITEtrack_bulk
Track multiple Correios packages in a single call (up to 50 codes)
READcalculate_shipping
Calculate shipping rates between two CEPs
READget_delivery_time
Get estimated delivery time between two CEPs
READlist_services
List available Correios shipping services
READfind_cep
Look up address by CEP via Correios
READfind_cep_bulk
Batch address lookup for up to 20 CEPs in a single call
READlist_cep_ranges
List CEP ranges (faixas de CEP) served by a given shipping service

Compatible frameworks

MCP is a protocol โ€” any framework that speaks it can mount this server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets โ€” it receives scoped, short-lived session tokens.
Servers โ€” Every LatAm commerce API your agent needs | CodeSpar