{"_id":"@envia/envia-mcp","name":"@envia/envia-mcp","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@envia/envia-mcp","version":"0.1.0","description":"MCP server for Envia shipping APIs — quote rates, create labels, track packages, and more from your AI assistant.","keywords":["mcp","model-context-protocol","envia","shipping","logistics","labels","tracking","carriers","mexico","latam"],"license":"MIT","author":{"name":"Envia","email":"dev@envia.com","url":"https://envia.com"},"repository":{"type":"git","url":"git+https://github.com/envia-ep/envia-mcp-server.git"},"homepage":"https://docs.envia.com/docs/mcp-overview","bugs":{"url":"https://github.com/envia-ep/envia-mcp-server/issues"},"type":"module","main":"dist/index.js","bin":{"envia-mcp":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","lint":"eslint src/","test":"vitest run","test:watch":"vitest","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","zod":"^3.24.0"},"devDependencies":{"@types/node":"^22.0.0","eslint":"^9.0.0","typescript":"^5.7.0","vitest":"^3.0.0"},"engines":{"node":">=18.0.0"},"_id":"@envia/envia-mcp@0.1.0","gitHead":"685a7b86744ed97a6dedca9c06d7ec7ef2681b8d","types":"./dist/index.d.ts","_nodeVersion":"18.20.8","_npmVersion":"10.8.2","dist":{"integrity":"sha512-9H8jhZNbMUFlWes+KSMVNPbFcNgZRe/th6wzznNIn2EOIViYjUzq+U/sWqMCGu/Wq++ZSVa8CoDC701A2KfhZQ==","shasum":"cc32c7a48204c8b5c8dc5c65056c8550f7c3920e","tarball":"https://registry.npmjs.org/@envia/envia-mcp/-/envia-mcp-0.1.0.tgz","fileCount":66,"unpackedSize":127568,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHtQzjYEjkEwu2194AdQ/NzJTKy3sTFB4uOmmcGrfjT9AiEA8vZoxjeKn0l9qnuIeejc45jHioqd5mSbAUQGB/ZX2eQ="}]},"_npmUser":{"name":"jose.vidrio","email":"jose.vidrio@envia.com"},"directories":{},"maintainers":[{"name":"jose.vidrio","email":"jose.vidrio@envia.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/envia-mcp_0.1.0_1772662064083_0.2088641565044953"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-04T22:07:43.995Z","0.1.0":"2026-03-04T22:07:44.278Z","modified":"2026-03-04T22:07:44.482Z"},"maintainers":[{"name":"jose.vidrio","email":"jose.vidrio@envia.com"}],"description":"MCP server for Envia shipping APIs — quote rates, create labels, track packages, and more from your AI assistant.","homepage":"https://docs.envia.com/docs/mcp-overview","keywords":["mcp","model-context-protocol","envia","shipping","logistics","labels","tracking","carriers","mexico","latam"],"repository":{"type":"git","url":"git+https://github.com/envia-ep/envia-mcp-server.git"},"author":{"name":"Envia","email":"dev@envia.com","url":"https://envia.com"},"bugs":{"url":"https://github.com/envia-ep/envia-mcp-server/issues"},"license":"MIT","readme":"# @envia/envia-mcp\n\nMCP server for [Envia](https://envia.com) shipping APIs. Quote rates, create labels, track packages, schedule pickups, and more — directly from your AI assistant.\n\n## Quick start\n\n```bash\n# Run with npx (no install needed)\nnpx @envia/envia-mcp\n```\n\nSet your API key as an environment variable:\n\n```bash\nexport ENVIA_API_KEY=\"your_jwt_token_here\"\n\n# Optional: use production (default is sandbox)\n# export ENVIA_ENVIRONMENT=\"production\"\n```\n\nGet your API key:\n- **Sandbox:** https://app.envia.com → Settings → API Keys\n- **Production:** https://app-production.envia.com → Settings → API Keys\n\n## IDE setup\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"envia\": {\n      \"command\": \"npx\",\n      \"args\": [\"@envia/envia-mcp\"],\n      \"env\": {\n        \"ENVIA_API_KEY\": \"your_jwt_token_here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"envia\": {\n      \"command\": \"npx\",\n      \"args\": [\"@envia/envia-mcp\"],\n      \"env\": {\n        \"ENVIA_API_KEY\": \"your_jwt_token_here\"\n      }\n    }\n  }\n}\n```\n\n### VS Code\n\nAdd to `.vscode/mcp.json` in your project root:\n\n```json\n{\n  \"servers\": {\n    \"envia\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"@envia/envia-mcp\"],\n      \"env\": {\n        \"ENVIA_API_KEY\": \"your_jwt_token_here\"\n      }\n    }\n  }\n}\n```\n\n## Available tools\n\n| Tool | Description |\n|------|-------------|\n| `envia_validate_address` | Validate postal codes and look up cities |\n| `envia_list_carriers` | List available carriers and services for a country |\n| `envia_get_shipping_rates` | Compare rates across carriers for a route |\n| `envia_create_label` | Purchase a shipping label (charges balance) |\n| `envia_track_package` | Track one or more shipments |\n| `envia_cancel_shipment` | Void a label and reclaim balance |\n| `envia_schedule_pickup` | Schedule carrier pickup |\n| `envia_get_shipment_history` | List shipments by month |\n| `envia_classify_hscode` | Classify product HS code for customs |\n| `envia_create_commercial_invoice` | Generate customs invoice PDF |\n\n## Example conversations\n\n### Domestic shipment (Mexico)\n\n```\nYou: Ship a 2kg box (30x20x15cm) from postal code 64000 in Monterrey\n     to 03100 in Mexico City. Compare DHL and Estafeta rates.\n\nAI:  [validates both postal codes with envia_validate_address]\n     [fetches rates with envia_get_shipping_rates for dhl,estafeta]\n\n     Here are your options:\n       DHL Economy:    $185.20 MXN — 3-5 business days\n       Estafeta Express: $210.00 MXN — 1-2 business days\n\n     Would you like me to create a label with one of these?\n\nYou: Yes, go with DHL Economy.\n\nAI:  [creates label with envia_create_label]\n\n     Label created!\n       Tracking: 7520610403\n       Label PDF: https://...\n       Price: $185.20 MXN\n```\n\n### International shipment\n\n```\nYou: I need to ship handmade ceramic mugs from Mexico to the US.\n     What HS code should I use?\n\nAI:  [classifies with envia_classify_hscode]\n\n     Recommended HS code: 6912.00 — Ceramic tableware\n     This code is required for customs when creating the label.\n```\n\n## Environment variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `ENVIA_API_KEY` | Yes | — | Your Envia JWT token |\n| `ENVIA_ENVIRONMENT` | No | `sandbox` | `sandbox` or `production` |\n\n## Development\n\n```bash\ngit clone https://github.com/envia-ep/envia-mcp-server.git\ncd envia-mcp-server\nnpm install\nnpm run build\nnpm test\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-4e421cfcdf896f642f54f0d84b2cffb9"}