{"_id":"@codespar/mcp-correios","_rev":"6-289c9f8bce3f330c3ad21bff0ceb1630","name":"@codespar/mcp-correios","dist-tags":{"latest":"0.2.0-alpha.3","alpha":"0.2.0-alpha.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-correios","version":"0.1.0","keywords":["mcp","correios","shipping","tracking","cep","brazil"],"license":"MIT","_id":"@codespar/mcp-correios@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-correios":"dist/index.js"},"dist":{"shasum":"9ab92fc14a51dcf6194dc96096a684dc3b4e5aa9","tarball":"https://registry.npmjs.org/@codespar/mcp-correios/-/mcp-correios-0.1.0.tgz","fileCount":4,"integrity":"sha512-HhkIzIPwOV3pMRHw0DLB9PEslrvxK9QIS9bzbHUuyf3m2OmKClWybTQyKUT1zlwxBjYEDKFwiiN2bmDgltwsQQ==","signatures":[{"sig":"MEUCIQCBdBGWCWlOPqWLg9dSxmE8ckkM+NwDht8KFyMrMcsBjwIgDsQ+rVlp4clDeN4on9jKM3Yq4Lpjn41kYiGxsc1N/Lo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15788},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"ac49d04d5aa50ad5dc16233f0bba88213f917641","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Correios — package tracking, shipping rates, CEP lookup","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-correios_0.1.0_1774923337049_0.641658728427305","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@codespar/mcp-correios","version":"0.1.2","keywords":["mcp","correios","shipping","tracking","cep","brazil"],"license":"MIT","_id":"@codespar/mcp-correios@0.1.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-correios":"dist/index.js"},"dist":{"shasum":"9e32de6b7a60c4ef90285445e5114b4455ad29e5","tarball":"https://registry.npmjs.org/@codespar/mcp-correios/-/mcp-correios-0.1.2.tgz","fileCount":7,"integrity":"sha512-KVnLxLj8EdNlyzmu6WcAFLQ3mla13+RFz3ydI/HzM1FRHWkEgcPMJ03uMvXEFn1grfX1po++xejAJRPFjhFQzg==","signatures":[{"sig":"MEYCIQD3sIRcNI5HRvHF77XhMyZEe1OcjSyY6auefxf3pU8hjQIhAIBA1rNPZNB0iWtduzov+7SsgO5xElfURPHecf8AJao6","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34797},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8fd47fad095cdf96618460a39345eddfe2a4af21","mcpName":"io.github.codespar/mcp-correios","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Correios — package tracking, shipping rates, CEP lookup","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-correios_0.1.2_1775953695394_0.8526650144037433","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.1":{"name":"@codespar/mcp-correios","version":"0.2.0-alpha.1","keywords":["mcp","correios","shipping","tracking","cep","brazil"],"license":"MIT","_id":"@codespar/mcp-correios@0.2.0-alpha.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-correios":"dist/index.js"},"dist":{"shasum":"ef3d456f665cd6f5dd87b99831000fba453b71c2","tarball":"https://registry.npmjs.org/@codespar/mcp-correios/-/mcp-correios-0.2.0-alpha.1.tgz","fileCount":7,"integrity":"sha512-vJkv48TLH2l2B9N8Cvxn5ihuXDueScAihOxAHNLtL5Dc83gezvyxERJS4jhVcNwRoRMoGZyXUgHQkjg9yEBYNA==","signatures":[{"sig":"MEUCIEUoTvvlki4HHC8gpXbDZEiUiK22lVr3soNzb6RqG0QgAiEAqJ+4xwMN0ChblgOssOHnNQiofpxiCT9yUxpbo9m7f8o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":52861},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"aa155cfd90298f7233644389f945286db9d20fe4","mcpName":"io.github.codespar/mcp-correios","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Correios — package tracking, shipping rates, CEP lookup","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-correios_0.2.0-alpha.1_1777065421066_0.4556678445817113","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.2":{"name":"@codespar/mcp-correios","version":"0.2.0-alpha.2","keywords":["mcp","correios","shipping","tracking","cep","brazil"],"license":"MIT","_id":"@codespar/mcp-correios@0.2.0-alpha.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-correios":"dist/index.js"},"dist":{"shasum":"95bb22625953b140b6c6c0df11962899d43711e3","tarball":"https://registry.npmjs.org/@codespar/mcp-correios/-/mcp-correios-0.2.0-alpha.2.tgz","fileCount":7,"integrity":"sha512-LKykxUDl6/cu7DQLeJ7i8o+e6qSx1whPLHAzZEWBGGW6ro3nEz+Vy4zsJI6hDl0ijZVQQa8uFAh/0I4ihjNwuA==","signatures":[{"sig":"MEUCIQD6b4r2yzzQQ26hVCvDAemM1Yx684EzfUxPqGbHNvQADAIgK+/5m/r8a/tSg3OpFWLYJgoX+oBI0XSvIqavtQXELpM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":54317},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-correios","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Correios — package tracking, shipping rates, CEP lookup","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-correios_0.2.0-alpha.2_1777123042342_0.033845668036606824","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.3":{"name":"@codespar/mcp-correios","version":"0.2.0-alpha.3","description":"MCP server for Correios — package tracking, shipping rates, CEP lookup","type":"module","main":"./dist/index.js","bin":{"mcp-correios":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","correios","shipping","tracking","cep","brazil"],"mcpName":"io.github.codespar/mcp-correios","_id":"@codespar/mcp-correios@0.2.0-alpha.3","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-03MC5p/5z9Z4WHZvfUUz/zcgPwh+LeA/0QzTAi1zvzRNkpUcPILo4SMNZbHJ0JIVTeM7b9ZgvM1dVwqz47ZEaQ==","shasum":"2397ad8aa1cd56f5633b4704de22e9352d481288","tarball":"https://registry.npmjs.org/@codespar/mcp-correios/-/mcp-correios-0.2.0-alpha.3.tgz","fileCount":7,"unpackedSize":55621,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICwowN58WNlPp48nJRCRjkgDNHQHApDTCjmpIvTOboYGAiEAq2lzrni04WdI8ccLP0TZHsSz7WUH0zaWjAPDXtfm6xU="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-correios_0.2.0-alpha.3_1782153571217_0.4944650846799672"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-31T02:15:36.977Z","modified":"2026-06-22T18:39:31.498Z","0.1.0":"2026-03-31T02:15:37.205Z","0.1.2":"2026-04-12T00:28:15.559Z","0.2.0-alpha.1":"2026-04-24T21:17:01.232Z","0.2.0-alpha.2":"2026-04-25T13:17:22.475Z","0.2.0-alpha.3":"2026-06-22T18:39:31.347Z"},"license":"MIT","keywords":["mcp","correios","shipping","tracking","cep","brazil"],"description":"MCP server for Correios — package tracking, shipping rates, CEP lookup","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-correios\n\n\n> **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`.\n\n> MCP server for **Correios** — Brazilian postal service tracking, rates, and shipping\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-correios)](https://www.npmjs.com/package/@codespar/mcp-correios)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"correios\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-correios\"],\n      \"env\": {\n        \"CORREIOS_USER\": \"your-user\",\n        \"CORREIOS_TOKEN\": \"your-token\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add correios -- npx @codespar/mcp-correios\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"correios\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-correios\"],\n      \"env\": {\n        \"CORREIOS_USER\": \"your-user\",\n        \"CORREIOS_TOKEN\": \"your-token\"\n      }\n    }\n  }\n}\n```\n\n## Tools (21)\n\n| Tool | Purpose |\n|---|---|\n| `track_package` | Track a package by Correios tracking code |\n| `track_bulk` | Track multiple Correios packages in a single call (up to 50 codes) |\n| `calculate_shipping` | Calculate shipping rates between two CEPs |\n| `get_delivery_time` | Get estimated delivery time between two CEPs |\n| `list_services` | List available Correios shipping services |\n| `find_cep` | Look up address by CEP via Correios |\n| `find_cep_bulk` | Batch address lookup for up to 20 CEPs in a single call |\n| `list_cep_ranges` | List CEP ranges (faixas de CEP) served by a given shipping service |\n| `get_delivery_modality` | Get delivery modality (forma de entrega) for a CEP and service — whether delivery is domicile, agency picku... |\n| `create_prepost` | Create a pre-posting order for shipping |\n| `get_prepost` | Get a pre-posting order by ID |\n| `list_preposts` | List pre-posting orders with optional filters (date range, status) |\n| `cancel_prepost` | Cancel a pre-posting order |\n| `buy_label_range` | Request a range of SIGEP tracking labels (etiquetas) for a service |\n| `post_objects` | Close and post a list of pre-posted objects (fechar postagem SIGEP) — creates a PLP |\n| `list_postal_codes` | Search addresses by street name or location (returns matching CEPs) |\n| `create_collection` | Schedule a package collection (pickup) from an address |\n| `get_collection` | Get collection request details by ID |\n| `cancel_collection` | Cancel a scheduled collection request |\n| `create_reverse` | Create a reverse logistics (return) order |\n| `get_reverse` | Get reverse logistics order details by ID |\n\n## Authentication\n\nCorreios uses Basic Auth for token generation, then Bearer token for subsequent requests. The server automatically manages authentication.\n\n## Sandbox / Testing\n\nCorreios provides a homologation environment for testing. Contact Correios for homologation credentials.\n\n### Get your credentials\n\n1. Go to [Correios CWS Portal](https://cws.correios.com.br)\n2. Register for API access (requires a contract with Correios)\n3. Get your username and token\n4. Set the environment variables\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `CORREIOS_USER` | Yes | Correios API username |\n| `CORREIOS_TOKEN` | Yes | Correios API token |\n\n## Roadmap\n\n### v0.2 (planned)\n- `list_postal_codes` — List postal codes for a region\n- `get_postal_code_range` — Get postal code range for a city\n- `create_collection` — Schedule a package collection\n- `get_collection` — Get collection request details\n- `create_reverse` — Create a reverse logistics (return) request\n\n### v0.3 (planned)\n- `batch_tracking` — Track multiple packages in a single request\n- `international_shipping` — Calculate international shipping rates\n\nWant to contribute? [Open a PR](https://github.com/codespar/mcp-dev-latam) or [request a tool](https://github.com/codespar/mcp-dev-latam/issues).\n\n## Links\n\n- [Correios Website](https://correios.com.br)\n- [Correios API Portal](https://cws.correios.com.br)\n- [MCP Dev LATAM](https://github.com/codespar/mcp-dev-latam)\n- [Landing Page](https://codespar.dev/mcp)\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}