{"$schema":"https://modelcontextprotocol.io/schemas/well-known/mcp.json","name":"maestro-commerce","displayName":"Maestro Commerce","description":"The agent-commerce layer for shops. Discover shops, search products, ask questions in the shop's brand voice, create checkout URLs, and track orders — across every shop registered with Maestro.","version":"1.8.0","homepage":"https://maestrocommerce.ai/agent-connector","documentation":"https://maestrocommerce.ai/agent-connector","vendor":{"name":"Maestro Commerce","url":"https://maestrocommerce.ai"},"endpoints":[{"type":"mcp","transport":"streamable-http","url":"https://maestrocommerce.ai/v1/mcp","auth":{"type":"open-or-bearer","description":"8 tools (discover_shops, get_shop_info, find_categories, search_products, ask_shop, get_reviews, create_checkout_url, track_order) are open with per-IP rate limits. Merchant write tools require a Bearer PAT."}},{"type":"a2a","transport":"jsonrpc-http","url":"https://maestrocommerce.ai/v1/a2a","agentCard":"https://maestrocommerce.ai/.well-known/agent.json","perShopAgentCardTemplate":"https://maestrocommerce.ai/agents/{shop_id}/.well-known/agent.json","auth":{"type":"open","description":"A2A (Google Agent-to-Agent) broker + per-shop endpoints. No authentication required for the open tier; per-IP rate-limited at 60/min."}}],"openapi":"https://bgivcrhwvvlnbokhwwwl.supabase.co/functions/v1/public-api/v1/openapi.json","manifest":"https://bgivcrhwvvlnbokhwwwl.supabase.co/functions/v1/public-api/v1/manifest","categories":["commerce","shopping","ecommerce","checkout","discovery"],"tools":[{"name":"ask_shop","description":"Conversational Q&A with a shop's AI agent — brand voice, cartridge rules, recommendation logic.","open":true,"rateLimitPerMin":50},{"name":"create_checkout_url","description":"Create a Shopify checkout URL the user opens to complete payment. Attribution carried in cart.attributes.","open":true,"rateLimitPerMin":30},{"name":"track_order","description":"Read order status by order_id. PII-sanitized.","open":true,"rateLimitPerMin":60},{"name":"get_reviews","description":"Read reviews for a single product. Up to N reviews ordered by helpfulness + date, plus a roll-up (rating histogram, average, occasion histogram, verified-purchase %).","open":true,"rateLimitPerMin":60},{"name":"search_products_blurb","description":"Blurb-only search path — generates AI summaries without fetching full product cards.","open":true,"rateLimitPerMin":60},{"name":"search_products","description":"AI-ranked product search within a shop.","open":true,"rateLimitPerMin":60},{"name":"discover_shops","description":"Find shops in the Maestro registry by topic, locale, ships_to, category, niche, occasion, price tier, or specialty.","open":true,"rateLimitPerMin":60},{"name":"get_shop_info","description":"Read public information about a shop — locale, currency, shipping zones, brand persona, capabilities.","open":true,"rateLimitPerMin":60},{"name":"find_categories","description":"Discover a shop's catalog category structure — sub-verticals with product counts and inferred-occasion counts.","open":true,"rateLimitPerMin":60}],"principles":["Maestro never holds payment — checkout always happens at the shop's own processor.","Open tools mean any agent can browse without an install or token.","Cart attributes carry agent_id + conversation_id + idempotency_key into order.note_attributes for attribution.","Merchant config writes always require a scoped PAT."]}