{"$schema":"https://google.github.io/A2A/schemas/agent-card.json","name":"Maestro Commerce","description":"The agent commerce layer for shops. Discover Shopify storefronts by topic, locale, occasion, or specialty; ask any registered shop's AI sales assistant for product recommendations in its brand voice; run sophisticated AI-ranked product search; and create Shopify checkout URLs that carry agent attribution attributes for stitched analytics.","url":"https://maestrocommerce.ai/v1/a2a","version":"1.0.0","documentationUrl":"https://maestrocommerce.ai/docs/agent-commerce","provider":{"organization":"Maestro Commerce","url":"https://maestrocommerce.ai"},"capabilities":{"streaming":true,"pushNotifications":false,"stateTransitionHistory":true},"authentication":{"schemes":["none"]},"defaultInputModes":["text"],"defaultOutputModes":["text","data"],"skills":[{"id":"discover_shops","name":"Discover shops","description":"Find shops in the Maestro registry by topic, locale, ships_to country, category, niche, occasion, price tier, or specialty. Returns a ranked list with capabilities and sample products. USE FIRST when the shopper has not yet picked a shop.","tags":["shopping","discovery","registry"],"examples":["Find me a Catalan florist that ships same-day to Barcelona","Vegan chocolate shops in the EU","Premium gift baskets that ship to the US"]},{"id":"get_shop_info","name":"Read shop info","description":"Read public information about a specific shop — locale, currency, shipping zones, return policy, brand persona, and supported tools.","tags":["shop","info"],"examples":["What does Telenoflora ship and where?"]},{"id":"find_categories","name":"Find a shop's categories","description":"Get the catalog category structure for one shop — detected sub-verticals (flowers/bouquets, gifts/wine_spirits, etc.) with product counts + sample products, plus aggregated inferred-occasion counts. Lets the calling agent see what the shop sells before asking the shopper questions.","tags":["shop","catalog","categories"],"examples":["What does Telenoflora actually sell?"]},{"id":"search_products","name":"Search a shop's products","description":"Sophisticated AI-ranked product search. USE when the shopper has concrete signals (occasion + recipient + budget + style). Pipeline does intent classification, vector + keyword retrieval, market-aware reranking. Returns ranked products in ~2s. Faster + cheaper than ask_shop. PREFER over ask_shop when the shopper has stated their need clearly.","tags":["shopping","search","products"],"examples":["gift for mom birthday $50-80","premium red roses for our anniversary","gift for my gamer friend under €100"],"outputModes":["data"]},{"id":"ask_shop","name":"Talk to a shop's sales agent","description":"Multi-turn conversation with a shop's AI sales assistant (Don). USE when the shopper hasn't formed a clear preference and needs guided discovery. Extracts occasion + recipient + budget + style progressively across turns, asks ONE clarifying question at a time. Slower (~8-12s/turn) than search_products. PREFER search_products when the shopper has concrete signals.","tags":["shopping","chat","discovery"],"examples":["Help me find a gift for my sister, she likes art","I need a thoughtful condolence arrangement","What would you recommend for someone who has everything?"]},{"id":"get_reviews","name":"Get reviews for a product","description":"Fetch reviews for a single product. Returns up to N reviews ordered by helpful_count + date, plus a roll-up summary (rating histogram, average, verified-purchase %, occasion histogram). Useful for social proof when recommending, breaking ties between equally-fitting picks, or answering \"what do others say?\".","tags":["shopping","reviews","social-proof"],"examples":["What do reviewers say about Premium Red Roses?","Get reviews for product abc-123 on Telenoflora"]},{"id":"create_checkout_url","name":"Create a checkout URL","description":"Create a Shopify checkout URL the shopper opens to complete payment. Idempotent on (shop_id, idempotency_key). agent_id and conversation_id are carried into cart attributes for attribution.","tags":["shopping","checkout","purchase"],"examples":["Build a checkout URL for variant 50731814519112 on Telenoflora"]},{"id":"track_order","name":"Track an order","description":"Read the status of an order placed at a shop. Lookup by order_id. Returns status + tracking_url + line items — no customer PII.","tags":["shopping","order","fulfillment"],"examples":["Track order 12345 on Telenoflora"]}]}