Skip to main content
Glama
Cascabel Ship-it

Cascabel Ship-it

by Derwinruiz

Cascabel Ship-it: MCP shipping connector for Claude and ChatGPT

⚠️ DEMO ONLY, NOT A REAL SHIPPING SERVICE. Every price, carrier, duty figure, QR code and tracking event is simulated. No labels are bought, nothing is shipped and no money moves. Do not enter real personal data (names, addresses, phone numbers) in the public demo. Partner names show who would handle each leg; they are examples, not endorsements or partnerships.

Ship something by talking to your AI assistant: "Ship these sneakers to Ana in Aruba." The connector works out the item, route and landed cost (shipping + duty + tax), asks only for what's missing, and hands the user a one-tap checkout. Then it tracks the parcel and owns any problem.

Status

  • v0.9.0-mock, phase 1 of the build plan. Customer pages in English, Papiamento (draft), Dutch and Spanish. Adds an admin panel, problem scenarios, a landing page, tracking from a link, any-item estimates, size bands, a real QR code and Caribbean duty. Status per item: docs/DEMO-PHASE1-PLAN.md.

  • What to perfect in the demo next (UX audit, admin panel, problem scenarios): docs/DEMO-PHASE1-PLAN.md.

  • Known bugs and their fix plan: docs/BUGFIX-PLAN.md.

  • Plan to ship between any two countries: docs/GLOBAL-SHIPPING-PLAN.md. The demo quotes between any two countries (ISO codes), in the sender's local currency. Detailed simulated partners (postal, air, drop-off points) exist for NL, DE, FR, ES, BE, IT, GB, US, CA and AW; every other lane gets a simulated worldwide express quote. Sanctioned destinations are refused. Country data lives in src/data/countries.ts; demo exchange rates are illustrative, not live.

Related MCP server: Easyship MCP

How it works

  • MCP endpoint (demo): https://cascabel-ship-mcp.cascabel-loi.workers.dev/mcp (Streamable HTTP, no auth)

  • Tools: create_shipment_draft, get_quotes, update_shipment, create_booking, pay_in_chat, get_shipment_status, track_shipment, report_problem

  • Landing page: / · Admin panel: /admin (password in the Worker secret ADMIN_PASSWORD; shows every order, a funnel, an event log and demo controls such as problem scenarios)

  • Web pages: /c/<draft_id>?k=<key> checkout → confirmation with drop-off QR or pickup window · /t/<draft_id>?k=<key> tracking. Each shipment has secret link keys; a shipment is only visible to the chat session that created it.

  • Asks only (in the chat): sender name, email or phone, and address; recipient name + delivery address (when missing); a map pin works where addresses have no house number. Recipient email or phone is optional. No sign-in.

  • Rule: nothing is paid or booked until a person confirms, in the chat's own Yes/No prompt or with one tap on the checkout page.

Try it in Claude

Settings → Connectors → Add custom connector → paste the MCP URL.

Develop

Runs on Cloudflare Workers + Durable Objects (Agents SDK McpAgent).

npm install
npm run dev        # local server via wrangler
npm run typecheck
npm run deploy     # deploys to your own Cloudflare account
npx wrangler secret put ADMIN_PASSWORD   # enables /admin
bash scripts/smoke.sh <url>              # end-to-end check (default http://localhost:8799)

Contributing

Issues and pull requests are welcome, especially for anything in docs/BUGFIX-PLAN.md or country coverage in docs/GLOBAL-SHIPPING-PLAN.md. Please report security problems privately via GitHub's "Report a vulnerability" rather than in a public issue.

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides supply chain and shipping tools including shipment tracking, route optimization, warehouse inventory management, delivery ETA estimation, and customs documentation. Enables logistics operations through natural language interactions with Claude.
      8 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to manage global shipping operations, including rate comparison, shipment creation, label purchasing, tracking, pickup scheduling, address validation, billing, and analytics, via natural language.
      25 npm
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Integrates the Machship freight management platform with MCP-compatible LLMs, enabling shipment creation, quotes, labels, and carrier management via natural language.
      125
      139 npm
      1
      ISC