Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FEE_RATE | No | Platform fee rate as decimal (e.g., 0.005 = 0.5%) | 0.005 |
| LOG_LEVEL | No | Logging level | info |
| SHOPIFY_API_KEY | Yes | Shopify app API key | |
| GATEWAY_BASE_URL | No | Public gateway URL | http://localhost:3000 |
| FEE_WALLET_ADDRESS | No | Wallet address for fee collection | |
| SHOPIFY_API_SECRET | Yes | Shopify app API secret | |
| SHOPIFY_ACCESS_TOKEN | Yes | Admin API access token | |
| SHOPIFY_STORE_DOMAIN | Yes | Your Shopify store domain (e.g., store.myshopify.com) | |
| AP2_SIGNING_PRIVATE_KEY | Yes | ES256 private key in JWK format for mandate signing | |
| SHOPIFY_STOREFRONT_TOKEN | Yes | Storefront API access token | |
| AP2_VERIFICATION_PUBLIC_KEY | No | ES256 public key in JWK format (defaults to deriving from private key) |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| scout_inventory | Search the Shopify catalog for products matching query, category, and price filters. |
| negotiate_terms | Negotiate capabilities, discounts, and shipping options between an agent and the merchant. |
| execute_checkout | Execute a full checkout with AP2 mandate chain verification (intent, cart, payment mandates). |
| manage_cart | Create, modify, or retrieve a Shopify cart (create, add, remove, get). |
| track_order | Retrieve order status and fulfillment tracking information. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |