{"name":"aly.store Commerce Agent","description":"AI shopping agent for aly.store — browse products, manage carts, and complete purchases across user storefronts.","supportedInterfaces":[{"url":"https://aly.store/api/a2a","protocolBinding":"JSONRPC","protocolVersion":"1.0"},{"url":"https://aly.store/api/a2a","protocolBinding":"HTTP+JSON","protocolVersion":"1.0"}],"provider":{"organization":"aly.store","url":"https://aly.store"},"version":"1.0.0","documentationUrl":"https://aly.store/docs/api","capabilities":{"streaming":true,"pushNotifications":true},"securitySchemes":{"aly_oauth":{"oauth2SecurityScheme":{"description":"OAuth 2.1 authorization for acting on behalf of users","oauth2MetadataUrl":"https://aly.store/.well-known/oauth-authorization-server","flows":{"authorizationCode":{"authorizationUrl":"https://admin.aly.store/oauth/authorize","tokenUrl":"https://admin.aly.store/oauth/token","scopes":{"read:sites":"Browse published storefronts and products","read:orders":"View order history","write:orders":"Place orders and manage cart"},"pkceRequired":true}}}},"aly_api_key":{"httpAuthSecurityScheme":{"description":"Scoped API key authentication using `Authorization: Bearer aly_*`; protected skills require an API key carrying the equivalent Aly scope.","scheme":"Bearer","bearerFormat":"aly-api-key"}}},"defaultInputModes":["text/plain","application/json"],"defaultOutputModes":["application/json"],"skills":[{"id":"product-search","name":"Product Search","description":"Search and browse products across published aly.store storefronts. Filter by site, category, price range.","tags":["shopping","search","products","catalog"],"examples":["Find digital products under $50","Show me all products on this store","Search for T-shirts"],"inputModes":["text/plain","application/json"],"outputModes":["application/json"]},{"id":"cart-management","name":"Cart Management","description":"Create and manage shopping carts — add/remove items, update quantities, and apply coupon, gift-card, or store-credit discounts.","tags":["shopping","cart","commerce"],"examples":["{ \"skill\": \"cart-management\", \"action\": \"create\", \"site_slug\": \"my-shop\" }","{ \"skill\": \"cart-management\", \"action\": \"add\", \"cart_token\": \"...\", \"product_id\": \"...\", \"quantity\": 1 }","{ \"skill\": \"cart-management\", \"action\": \"apply_gift_card\", \"cart_token\": \"...\", \"code\": \"GIFT-ABCDEFGH12345678\" }","{ \"skill\": \"cart-management\", \"action\": \"remove_gift_card\", \"cart_token\": \"...\", \"gift_card_id\": \"giftCards_...\" }","{ \"skill\": \"cart-management\", \"action\": \"apply_store_credit\", \"cart_token\": \"...\", \"account_id\": \"storeCreditAccounts_...\" }","{ \"skill\": \"cart-management\", \"action\": \"remove_store_credit\", \"cart_token\": \"...\", \"account_id\": \"storeCreditAccounts_...\" }","{ \"skill\": \"cart-management\", \"action\": \"view\", \"cart_token\": \"...\" }"],"inputModes":["application/json"],"outputModes":["application/json"],"securityRequirements":[{"aly_oauth":["write:orders"]},{"aly_api_key":[]}]},{"id":"checkout","name":"Checkout","description":"Initiate checkout for a cart. Returns a Stripe payment URL for the buyer to complete payment.","tags":["shopping","checkout","payment"],"examples":["{ \"skill\": \"checkout\", \"cart_token\": \"...\", \"site_slug\": \"my-shop\" }"],"inputModes":["application/json"],"outputModes":["application/json"],"securityRequirements":[{"aly_oauth":["write:orders"]},{"aly_api_key":[]}]},{"id":"x402-purchase","name":"x402 Direct Purchase","description":"Purchase a product directly via the x402 protocol using USDC on Base Sepolia (testnet). Send a GET request to the resource URL — the server responds with HTTP 402 and payment requirements. Pay on-chain, resend with PAYMENT-SIGNATURE, and receive the order confirmation plus PAYMENT-RESPONSE settlement header.","tags":["shopping","payment","x402","crypto","usdc","usdt","bnb","agent"],"examples":["{ \"skill\": \"x402-purchase\", \"site_slug\": \"my-shop\", \"product_id\": \"...\" }","GET /api/x402/product/my-shop/product123 (returns 402 with stablecoin payment requirements)"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"order-status","name":"Order Status","description":"Check the status of an order by confirmation token. View fulfillment and delivery details.","tags":["orders","fulfillment","tracking"],"examples":["{ \"skill\": \"order-status\", \"confirmation_token\": \"...\", \"site_slug\": \"my-shop\" }"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"store-info","name":"Store Information","description":"Get details about a published aly.store storefront — name, description, theme, available products.","tags":["store","info","discovery"],"examples":["Tell me about store my-shop","{ \"skill\": \"store-info\", \"site_slug\": \"my-shop\" }"],"inputModes":["text/plain","application/json"],"outputModes":["application/json"]}]}