{"_id":"@codespar/mcp-superfrete","name":"@codespar/mcp-superfrete","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@codespar/mcp-superfrete","version":"0.1.0","description":"MCP server for SuperFrete shipping API - freight calculation, label creation, tracking, and account management for Brazilian logistics","type":"module","main":"./dist/index.js","bin":{"mcp-superfrete":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"keywords":["mcp","superfrete","shipping","freight","logistics","brazil","e-commerce"],"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"mcpName":"io.github.codespar/mcp-superfrete","_id":"@codespar/mcp-superfrete@0.1.0","gitHead":"0cf000f9cad29acc97dc1e29789d180431c6fe12","types":"./dist/index.d.ts","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-51AwfmKjmuUjJT3ftiPOyePTWgTZ4jswqzfxQ/Yj64qCKzJIj5/62+3/jeBgtC5u99LtVCzEmUkDraPoy5R8PQ==","shasum":"5f6669f56233c6bbcc1718de06e83c6148d9b5b6","tarball":"https://registry.npmjs.org/@codespar/mcp-superfrete/-/mcp-superfrete-0.1.0.tgz","fileCount":6,"unpackedSize":45107,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFToEwmQLdvrmi7snQq0JsPw4tKK2L86wiqXFcq26p59AiBXeQoqUEI5RzcvofFEeB+AcUNlgdT/C2xM5LJMgeJZQw=="}]},"_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-superfrete_0.1.0_1783129615844_0.07163738183279333"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-04T01:46:55.628Z","0.1.0":"2026-07-04T01:46:55.988Z","modified":"2026-07-04T01:46:56.368Z"},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"description":"MCP server for SuperFrete shipping API - freight calculation, label creation, tracking, and account management for Brazilian logistics","keywords":["mcp","superfrete","shipping","freight","logistics","brazil","e-commerce"],"license":"MIT","readme":"# @codespar/mcp-superfrete\n\n> MCP server for **SuperFrete** — Brazilian shipping platform with discounted rates across multiple carriers\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-superfrete)](https://www.npmjs.com/package/@codespar/mcp-superfrete)\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    \"superfrete\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-superfrete\"],\n      \"env\": {\n        \"SUPERFRETE_TOKEN\": \"your-token\",\n        \"SUPERFRETE_SANDBOX\": \"true\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add superfrete -- npx @codespar/mcp-superfrete\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"superfrete\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-superfrete\"],\n      \"env\": {\n        \"SUPERFRETE_TOKEN\": \"your-token\",\n        \"SUPERFRETE_SANDBOX\": \"true\"\n      }\n    }\n  }\n}\n```\n\n## Tools (11)\n\n| Tool | Description |\n|------|-------------|\n| `calculate_freight` | Calculate shipping rates across carriers (PAC, SEDEX, JadLog, Loggi, Mini Envios) |\n| `create_freight` | Create a freight/label order |\n| `get_freight` | Get freight order details, status, and tracking |\n| `checkout_freight` | Purchase freight orders and generate labels |\n| `cancel_freight` | Cancel a freight order |\n| `get_user_info` | Get user info, balance, and shipment limits |\n| `get_user_addresses` | List saved addresses |\n| `get_services` | Get available services with restrictions and limits |\n| `list_webhooks` | List configured webhooks |\n| `create_webhook` | Create a webhook for order event notifications |\n| `delete_webhook` | Delete a webhook |\n\n## Authentication\n\nSuperFrete uses a Bearer token (API key) for authentication.\n\n## Sandbox / Testing\n\nSuperFrete provides a sandbox environment. Set `SUPERFRETE_SANDBOX=true` to use it.\n\n### Get your credentials\n\n1. Go to [SuperFrete](https://superfrete.com) and create an account\n2. Navigate to [Integrations](https://web.superfrete.com/#/integrations/select-integration-platform)\n3. Click **\"Desenvolvedores\"** → **\"Integrar\"** to generate your API token\n4. Set the `SUPERFRETE_TOKEN` environment variable\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `SUPERFRETE_TOKEN` | Yes | API Bearer token from SuperFrete |\n| `SUPERFRETE_SANDBOX` | No | Set to `\"true\"` for sandbox mode |\n\n## Available Services\n\n| ID | Service | Carrier |\n|----|---------|---------|\n| 1 | PAC | Correios |\n| 2 | SEDEX | Correios |\n| 3 | .Package | JadLog |\n| 17 | Mini Envios | Correios |\n| 31 | Loggi | Loggi |\n\n## Typical Workflow\n\n1. **Calculate rates** with `calculate_freight` — get prices and delivery times for all carriers\n2. **Create order** with `create_freight` — select a service and provide addresses\n3. **Checkout** with `checkout_freight` — pay for the order and generate the label\n4. **Track** with `get_freight` — monitor status and get the label print URL\n\n## Links\n\n- [SuperFrete Website](https://superfrete.com)\n- [SuperFrete API Documentation](https://docs.superfrete.com)\n- [MCP Dev LATAM](https://github.com/codespar/mcp-dev-latam)\n- [Catalog](https://codespar.dev/servers)\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","_rev":"1-2c01d6d75a9079f20102366615a22c00"}