W3Ship MCP Server

Securely retrieve a physical address using a public key and a timed cryptographic signature.

Create a new TMF663 shopping cart. If W3SHIP_PUBLIC_KEY is configured, it is used automatically — no id required. Otherwise provide an SLH-DSA or ECDSA public key (hex).

Retrieve a shopping cart by its Public Key ID. Uses W3SHIP_PUBLIC_KEY if no id is provided.

Add an item to an existing shopping cart. Uses W3SHIP_PUBLIC_KEY as cartId if not provided.

Delete a shopping cart.

Convert a Shopping Cart into a confirmed Order (TMF622) and initiate fulfillment.

Retrieve detailed information about a specific Order (TMF622).

Track the delivery status of a shipment (TMF621).

Get available session time slots for a location on a given date. Returns times, capacity, pricing, and activity type. Works for any bookable service (VR, fitness, dining, salon, etc.).

Hold/reserve a session time slot for a customer. The slot is held for 10 minutes pending payment. Works for any bookable service.

List all confirmed session bookings. Optionally filter by location or date.

Generate a demo ECDSA key pair for testing. Returns a public key hex that can be used with create_cart and other tools. Useful for trying out the commerce flow without a real wallet.

Show the currently configured identity (W3SHIP_PUBLIC_KEY). Returns the public key and its type if set, or instructions on how to configure one.

Get a swap quote from Uniswap. Returns estimated output, routing path, gas fees, and price impact. Supports V2, V3, V4, and UniswapX protocols. Requires UNISWAP_API_KEY env var.

Check if a token is approved for swapping on Uniswap. Returns whether approval is needed and the approval transaction if so. Requires UNISWAP_API_KEY env var.

Create a P2P marketplace listing. Anyone can sell items — no merchant onboarding needed. Specify title, price, currency (USDC/ETH/etc), and your wallet address for payment.

Browse the W3Ship P2P marketplace. Search by category (electronics, gifts, clothing, etc.) or keyword. Returns active listings with prices and seller info.

Get full details of a specific marketplace listing by ID.

Remove a marketplace listing. Only the seller can remove their own listing.

Submit an on-chain payment transaction for verification. After paying the seller (send crypto to their wallet address), provide the transaction hash here to verify payment and update the order status to "paid".

Seller tool: Add real shipping tracking info to an order after shipping the item. Provides the buyer with a tracking number and carrier.

Claim a FREE promotional listing. Items are $0. For shipping promos you pay shipping only; for pickup promos it is completely free. One claim per wallet. Must have a registered W3Ship/Dah.mx identity (address required for shipping, wallet-only for pickup).