{"schema_version":"1.0","platform":{"name":"AgentHub Commerce","version":"0.22.0","description":"AI-native commerce platform for autonomous agent shopping","homepage":"/","documentation":"/docs"},"protocols":[{"name":"UCP","version":"2026-04-08","endpoint":"/.well-known/ucp","description":"Universal Commerce Protocol — product discovery, checkout, and order management","capabilities":["dev.ucp.shopping.checkout","dev.ucp.shopping.catalog","dev.ucp.shopping.cart","dev.ucp.shopping.orders","dev.ucp.shopping.fulfillment","dev.ucp.shopping.discount","dev.ucp.shopping.service_catalog","dev.ucp.shopping.service_booking","dev.ucp.common.identity_linking"],"accepted_mandate_shapes":null,"vp_formats_supported":null},{"name":"A2A","version":"1.0.0","endpoint":"/.well-known/agent.json","description":"Agent-to-Agent protocol — task delegation, SSE streaming, push notifications","capabilities":["message/send","tasks/get","tasks/cancel","tasks/list"],"accepted_mandate_shapes":null,"vp_formats_supported":null},{"name":"MCP","version":"2025-11-25","endpoint":"/mcp","description":"Model Context Protocol — 22 tools for product and service commerce via JSON-RPC 2.0","capabilities":["initialize","tools/list","tools/call"],"accepted_mandate_shapes":null,"vp_formats_supported":null},{"name":"AP2","version":"0.1.0+0.2-verified-closed","endpoint":"/api/v1/ap2","description":"Agent Payments Protocol. v0.1 mandates (IntentMandate, CartMandate, PaymentMandate) signed with ES256 JWS Detached remain the legacy path. v0.2 (Apr 2026, FIDO Alliance governance): the UCP AP2 Mandates Extension (`dev.ucp.shopping.ap2_mandate`) is the verified path — negotiate it on a UCP checkout session to engage the Security-Lock; `complete_checkout` then requires a verified closed checkout mandate (SD-JWT+KB, vct=mandate.checkout.1, direct mode). Open mandate + autonomous mode are deferred.","capabilities":["cart_mandate","intent_mandate","payment_mandate","settlement","v0.2.checkout_mandate.open","v0.2.checkout_mandate.closed","v0.2.payment_mandate.open","v0.2.payment_mandate.closed","ucp_ap2_mandate_extension"],"accepted_mandate_shapes":["ucp_embedded"],"vp_formats_supported":{"dc+sd-jwt":{}}}],"authentication":{"methods":[{"method":"api_key","description":"Simple API key authentication","header":"X-API-Key","endpoint":null},{"method":"oauth2_bearer","description":"OAuth2 bearer token via client credentials flow","header":"Authorization","endpoint":"/api/v1/oauth2/token"},{"method":"oauth2_device_flow","description":"Delegated user authorization via RFC 8628 device flow","header":null,"endpoint":"/api/v1/agent/device/authorize"}],"registration_endpoint":"/api/v1/agent/register","token_endpoint":"/api/v1/agent/device/token","device_authorization_endpoint":"/api/v1/agent/device/authorize"},"mcp_tools":[{"name":"search_products","description":"Search product catalog by text, category, brand, price range"},{"name":"get_product_details","description":"Get full product information by ID"},{"name":"add_to_cart","description":"Add items to shopping cart"},{"name":"get_cart","description":"Retrieve current cart contents"},{"name":"update_cart","description":"Modify item quantities"},{"name":"clear_cart","description":"Empty the cart"},{"name":"create_checkout","description":"Initialize a checkout session"},{"name":"complete_checkout","description":"Place order and complete purchase"},{"name":"get_order","description":"Retrieve order by ID"},{"name":"search_services","description":"Search services by text, category, type"},{"name":"check_availability","description":"Get available time slots for a service"},{"name":"book_service","description":"Create a service booking"},{"name":"cancel_booking","description":"Cancel an existing booking"},{"name":"get_providers","description":"List service providers and schedules"},{"name":"set_buyer_location","description":"Set buyer location for nearby search, pickup, and delivery radius checks"},{"name":"get_fulfillment_options","description":"Preview shipping, pickup, and delivery options with costs before checkout"}],"catalog":{"merchant_count":2,"product_count":426,"service_count":230,"categories":["Accessories","Accessory","Aftercare","Apparel","Art & Prints","Backpacks","Bagels","Bags","Baked Goods","Baking","Barware","BBQ Rubs","Beds","Bee Products","Beer","Beeswax Products","Belts","Blends","Books","Boots","Bracelets","Cacti","Camp Furniture","Care","Cat Toys","Children's","Chocolate Pecans","Clothing","Coffee — beans","Coffee Beans","Coffee — ground","Coffee — ready-to-drink","Cold Brew","Collars & Leashes","Collectibles","Collectible Vinyl","Concentrates","Cooking","Custom Hats","Decaf","Decor","Desert Plants","Diffusers","Dog Food","Dog Treats","Earrings","Edibles","Equipment","Experiences","Extracts","Fiction","Floral","Flower","French","Furniture","Gift Cards","Gift Sets","Gourmand","Graphic Novels","Grooming","Harnesses","Hats","Hat Services","Home & Office","Honey Sticks","Hot Sauce","Hydration","Infused Honey","Ingredients","Inks","Jeans","Jewelry","Kits","Large Candles","Lighting","Local Interest","Low Light","Machines","Merch","Merchandise","Necklaces","Needles","New Vinyl","Olive Oil","Pastry","Pecan Butter","Performance","Pet","Poetry","Pots","Pots & Planters","Pralines","Pre-Rolls","Pre-Workout","Protein","Protein Bars","Raw Honey","Raw Pecans","Ready to Drink","Recovery","Reed Diffusers","Rings","Roasted Pecans","Room Sprays","Safety","Salts","Shirts","Signature Candles","Single Origin","Single Spices","Sleeping Gear","Snacks","Sneakers","Sourdough","Specialty Salt","Spice Blends","Spices","Stationery","Stencil Supplies","Subscriptions","Succulents","Supplements","Supplies","Taproom","Tea","Tents","Tinctures","Tools","Topicals","Toys","Trailing","Training","Treats","Trees","Tropical","Used Vinyl","Vapes","Vinegar","Vitamins","Wallets","Wax Melts","Whole Grain","Woodsy"]},"rate_limits":{"requests_per_second":100,"burst":200,"note":"Rate limits apply per API key"},"quick_start":[{"step":1,"title":"Discover Capabilities","description":"Fetch the manifest to understand protocols, tools, and auth methods.","example":"GET /.well-known/agent-commerce.json"},{"step":2,"title":"Set Buyer Location","description":"Provide the buyer's zip code or city for nearby search, pickup badges, and delivery estimates.","example":"MCP tools/call set_buyer_location {\"zip\": \"78704\"}"},{"step":3,"title":"Search Products & Services","description":"Find products and services. Results include merchant location, pickup availability, shipping estimates, and next available slots.","example":"MCP tools/call search_products {\"merchant_id\": \"...\", \"query\": \"coffee\"}"},{"step":4,"title":"Preview Fulfillment Options","description":"See shipping costs, pickup locations, and delivery options before committing to checkout.","example":"MCP tools/call get_fulfillment_options {\"merchant_id\": \"...\"}"},{"step":5,"title":"Create Checkout & Purchase","description":"Create checkout session, select fulfillment, and complete the order.","example":"MCP tools/call create_checkout {\"merchant_id\": \"...\", \"items\": [...]}"}],"discovery_endpoints":{"ucp_profile":"/.well-known/ucp","agent_card":"/.well-known/agent-card.json","agent_commerce_manifest":"/.well-known/agent-commerce.json","jwks":"/.well-known/jwks.json","mcp":"/mcp","a2a":"/a2a","llms_txt":"/llms.txt","openapi":"/docs"}}