Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ship_address | Securely retrieve a physical address using a public key and a timed cryptographic signature. |
| create_cart | 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). |
| get_cart | Retrieve a shopping cart by its Public Key ID. Uses W3SHIP_PUBLIC_KEY if no id is provided. |
| add_item | Add an item to an existing shopping cart. Uses W3SHIP_PUBLIC_KEY as cartId if not provided. |
| delete_cart | Delete a shopping cart. |
| create_order | Convert a Shopping Cart into a confirmed Order (TMF622) and initiate fulfillment. |
| get_order | Retrieve detailed information about a specific Order (TMF622). |
| track_shipment | Track the delivery status of a shipment (TMF621). |
| get_available_slots | 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_slot | Hold/reserve a session time slot for a customer. The slot is held for 10 minutes pending payment. Works for any bookable service. |
| list_bookings | List all confirmed session bookings. Optionally filter by location or date. |
| generate_demo_key | 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. |
| get_identity | 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_swap_quote | 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_token_approval | 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_listing | 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. |
| search_listings | Browse the W3Ship P2P marketplace. Search by category (electronics, gifts, clothing, etc.) or keyword. Returns active listings with prices and seller info. |
| get_listing | Get full details of a specific marketplace listing by ID. |
| remove_listing | Remove a marketplace listing. Only the seller can remove their own listing. |
| confirm_payment | 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". |
| add_tracking | Seller tool: Add real shipping tracking info to an order after shipping the item. Provides the buyer with a tracking number and carrier. |
| claim_promo | 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). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |