{"_id":"@codespar/mcp-melhor-envio","_rev":"5-7abf8e9bf3da0fec2cc3e33d47f1287a","name":"@codespar/mcp-melhor-envio","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.0":{"name":"@codespar/mcp-melhor-envio","version":"0.1.0","keywords":["mcp","melhor-envio","shipping","tracking","brazil"],"license":"MIT","_id":"@codespar/mcp-melhor-envio@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-melhor-envio":"dist/index.js"},"dist":{"shasum":"8667537cd46d5388d0f9f8de949e078094b185fc","tarball":"https://registry.npmjs.org/@codespar/mcp-melhor-envio/-/mcp-melhor-envio-0.1.0.tgz","fileCount":4,"integrity":"sha512-vrMDlSG6mcCRpKh+KYVl7/MLd81ZNr510c1jjNBgM6ewadpdNjVlzDEONyiC7SR5Io6+/vknmbaXTywRq2v4JQ==","signatures":[{"sig":"MEYCIQD1vuJa3+67rsWnni6j1mS5jI44z6rFSYg8LMunt82QNwIhALV6FRHQoUZl2MQl+udAP/zJwOQKRR8/zLE4pcUDPgcd","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19170},"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 Melhor Envio — shipping rates, labels, tracking, agencies","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-melhor-envio_0.1.0_1774923339768_0.7234901238819702","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@codespar/mcp-melhor-envio","version":"0.1.2","keywords":["mcp","melhor-envio","shipping","tracking","brazil"],"license":"MIT","_id":"@codespar/mcp-melhor-envio@0.1.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-melhor-envio":"dist/index.js"},"dist":{"shasum":"61b20b272a1e5428d03c81e0c8ff3225573a127f","tarball":"https://registry.npmjs.org/@codespar/mcp-melhor-envio/-/mcp-melhor-envio-0.1.2.tgz","fileCount":7,"integrity":"sha512-7UPduSXmxrx5et4H4PZqaO3ILhznbTxMosawwOPaNHQWxbODYoyNHyOeXyBTZd17aEjx7mizaUXLNvFGdp+aEQ==","signatures":[{"sig":"MEUCIQCpYN6oogpli+qxDmQqiywnWk2LBkLzEs36ckbXp2IwPwIgZsMkb2rn7F6zfzCxmittxGVLVEMGuqiViEolgXMLurU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":56491},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8fd47fad095cdf96618460a39345eddfe2a4af21","mcpName":"io.github.codespar/mcp-melhor-envio","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Melhor Envio — shipping rates, labels, tracking, agencies","directories":{},"_nodeVersion":"25.5.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-melhor-envio_0.1.2_1775953699129_0.44635709774864996","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@codespar/mcp-melhor-envio","version":"0.1.3","keywords":["mcp","melhor-envio","shipping","tracking","brazil"],"license":"MIT","_id":"@codespar/mcp-melhor-envio@0.1.3","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-melhor-envio":"dist/index.js"},"dist":{"shasum":"7d4072a477297465489e1f2f8600b1258ff76374","tarball":"https://registry.npmjs.org/@codespar/mcp-melhor-envio/-/mcp-melhor-envio-0.1.3.tgz","fileCount":7,"integrity":"sha512-BsqOM+8RZ+s57cwUpFoaRqInQM2xvg0CjhpFYk4A7xJqVfPTpmp9DhK1B4+bwpeidKVyPutmLTq+7KqN4/AlBw==","signatures":[{"sig":"MEUCIEvuT5muKzZSg5K5/Xkd6hlS1imnNB1IJiVffSeYJ6HhAiEA0ZBczfLm0nw4LpbQlijWYncEqYKVLmNSmyQWfaIe5Bo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":60055},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-melhor-envio","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Melhor Envio — shipping rates, labels, tracking, agencies","directories":{},"_nodeVersion":"25.5.0","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-melhor-envio_0.1.3_1777123046146_0.07580418373549191","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@codespar/mcp-melhor-envio","version":"0.1.4","description":"MCP server for Melhor Envio — shipping rates, labels, tracking, agencies","type":"module","main":"./dist/index.js","bin":{"mcp-melhor-envio":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.23.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","melhor-envio","shipping","tracking","brazil"],"mcpName":"io.github.codespar/mcp-melhor-envio","_id":"@codespar/mcp-melhor-envio@0.1.4","gitHead":"776ee260ec81f40a78c5f23f4ae78d64b475c0fa","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-dsDjspEUxV4v55TMM+qm9tmr4YlDTqsTh++fk8QR0vJ1QYIxQnnQWBCM6jd9gUGvzxbrQR+D3yykgX67azQ9YQ==","shasum":"8c32cc58f7bb471fa9b3677f01d114de51aa00fb","tarball":"https://registry.npmjs.org/@codespar/mcp-melhor-envio/-/mcp-melhor-envio-0.1.4.tgz","fileCount":7,"unpackedSize":61395,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCUsfesqbQvqt3e7y1+4ysuVHTdOgT4/fnFlKeiCwPZLwIgFZ61EkO0VDg2zShB9z17vQJVIuNMQFPJit1fJs4a1iY="}]},"_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-melhor-envio_0.1.4_1782149651043_0.16309615876714978"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-31T02:15:39.663Z","modified":"2026-06-22T17:34:11.376Z","0.1.0":"2026-03-31T02:15:39.936Z","0.1.2":"2026-04-12T00:28:19.293Z","0.1.3":"2026-04-25T13:17:26.354Z","0.1.4":"2026-06-22T17:34:11.227Z"},"license":"MIT","keywords":["mcp","melhor-envio","shipping","tracking","brazil"],"description":"MCP server for Melhor Envio — shipping rates, labels, tracking, agencies","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-melhor-envio\n\n> MCP server for **Melhor Envio** — shipping aggregator with multi-carrier rate comparison\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-melhor-envio)](https://www.npmjs.com/package/@codespar/mcp-melhor-envio)\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    \"melhor-envio\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-melhor-envio\"],\n      \"env\": {\n        \"MELHOR_ENVIO_TOKEN\": \"your-token\",\n        \"MELHOR_ENVIO_SANDBOX\": \"true\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add melhor-envio -- npx @codespar/mcp-melhor-envio\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"melhor-envio\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-melhor-envio\"],\n      \"env\": {\n        \"MELHOR_ENVIO_TOKEN\": \"your-token\",\n        \"MELHOR_ENVIO_SANDBOX\": \"true\"\n      }\n    }\n  }\n}\n```\n\n## Tools (18)\n\n| Tool | Purpose |\n|---|---|\n| `calculate_shipping` | Calculate shipping rates from multiple carriers |\n| `create_shipment` | Create a shipment order |\n| `track_shipment` | Track a shipment by order ID |\n| `generate_label` | Generate shipping label for an order |\n| `list_agencies` | List carrier pickup agencies near a location |\n| `cancel_shipment` | Cancel a shipment order |\n| `get_balance` | Get current account balance |\n| `add_cart` | Add shipment orders to cart for batch checkout |\n| `checkout_cart` | Checkout all items in the cart and pay |\n| `preview_label` | Preview a shipping label before generating |\n| `print_label` | Print/download label PDF |\n| `get_shipment` | Get shipment order details by ID |\n| `list_shipments` | List all shipment orders with filters |\n| `get_store` | Get store/company information |\n| `search_agencies` | Search pickup agencies by service and location |\n| `create_address` | Create a stored address for sender/recipient |\n| `list_services_available` | List available shipping services for a route |\n| `get_tracking_history` | Get complete tracking history with events |\n\n## Authentication\n\nMelhor Envio uses a Bearer token for authentication.\n\n## Sandbox / Testing\n\nMelhor Envio provides a sandbox at `sandbox.melhorenvio.com.br`. Set `MELHOR_ENVIO_SANDBOX=true` to use it.\n\n### Get your credentials\n\n1. Go to [Melhor Envio](https://melhorenvio.com.br)\n2. Create an account\n3. Navigate to API settings and generate a token\n4. Set the `MELHOR_ENVIO_TOKEN` environment variable\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `MELHOR_ENVIO_TOKEN` | Yes | Bearer token from Melhor Envio |\n| `MELHOR_ENVIO_SANDBOX` | No | Set to `\"true\"` for sandbox mode |\n\n## Roadmap\n\n### v0.2 (planned)\n- `create_store` — Create a store in Melhor Envio\n- `update_store` — Update store details\n- `get_receipt` — Get shipping receipt/label\n- `list_companies` — List available shipping companies\n- `get_invoice` — Get invoice for a shipment\n\n### v0.3 (planned)\n- `batch_shipments` — Create multiple shipments in a single request\n- `detailed_reports` — Generate detailed shipping reports\n- `webhook_management` — Register, list, and delete webhooks\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- [Melhor Envio Website](https://melhorenvio.com.br)\n- [Melhor Envio API Documentation](https://docs.melhorenvio.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"}