{"schema_version":"mcp-manifest/1.0","name":"agenticmcpstores","display_name":"AgenticMCPStores","description":"Multi-merchant MCP commerce network. Search products across verified Shopify and WooCommerce stores, manage carts, and initiate checkout flows autonomously.","version":"1.0.0","updated_at":"2026-03-29","servers":[{"transport":"streamable-http","url":"https://agenticmcpstores-production.up.railway.app/mcp","label":"Production MCP Server"}],"auth":{"type":"oauth2","authorization_url":"https://agenticmcpstores-production.up.railway.app/oauth/authorize","token_url":"https://agenticmcpstores-production.up.railway.app/oauth/token","scopes":["agent:read","agent:cart","agent:checkout"],"pkce_required":true},"capabilities":{"tools":true,"resources":true,"prompts":false,"sampling":false,"a2ui":true},"ui_protocols":{"a2ui":{"version":"0.8","status":"coming_soon","spec_url":"https://github.com/google/A2UI","description":"Tools that support A2UI accept an optional 'a2ui: true' parameter and return a declarative JSON UI surface instead of plain JSON. Renderers: Angular, Flutter, Lit (React planned). Fallback to plain JSON when 'a2ui' is omitted or false.","planned_components":["ProductGrid","CheckoutWidget","OrderTracker","ShippingSelector"],"compatible_tools":["search_products","complete_checkout"],"catalog_url":"https://www.agenticmcpstores.com/.well-known/a2ui-catalog.json","renderers_url":"https://github.com/google/A2UI/tree/main/renderers"},"webmcp":{"status":"sandbox","sandbox_url":"https://www.agenticmcpstores.com/en/demo-store/playground","description":"Browser-native MCP via navigator.modelContext. Enables client-side agents to call MCP tools directly from the browser without server-side proxy.","planned_tools":["navigator.modelContext.callTool('search_products', {...})","navigator.modelContext.callTool('get_product_details', {...})","navigator.modelContext.callTool('browse_categories', {...})","navigator.modelContext.callTool('get_merchant_profile', {...})"],"note":"Sandbox available at /en/demo-store#webmcp-playground. Not available in production agents."}},"protocols":{"acp":{"status":"sandbox","provider":"stripe","description":"Stripe-based fiat checkout (test mode)"},"ap2":{"status":"sandbox","provider":"mock","description":"Google Agent Payment Protocol — mandate-based confirmations (mock mode)"},"x402":{"status":"sandbox","provider":"mock","description":"USDC stablecoin payments via HTTP 402 (simulated settlement)"},"ucp":{"status":"active","version":"2026-01-15","discovery_url":"https://www.agenticmcpstores.com/.well-known/ucp","description":"Universal Commerce Protocol — standardized commerce operations. 5 checkout tools active: create, get, update, complete, cancel. Full capability negotiation.","spec_url":"https://github.com/universal-commerce-protocol/ucp","tools":["ucp_create_checkout","ucp_get_checkout","ucp_update_checkout","ucp_complete_checkout","ucp_cancel_checkout"]},"kyapay":{"version":"0.1","settlement":"skyfire","tokenTypes":["pay","kya+pay"],"identity":true,"auth_required":true,"description":"KYApay identity-linked payments via Skyfire (JWT-based, no gas fees)"},"paypal":{"status":"sandbox","version":"1.0","adapter":"paypal-inbound-v1","provider":"paypal","api":"Orders API v2","sandbox_url":"https://api-m.sandbox.paypal.com","supported_currencies":["USD","EUR","GBP","CAD","AUD","JPY"],"auth_required":true,"refunds_require_approval":true,"description":"PayPal Orders API v2 — card and PayPal wallet payments. Buyer approval flow. Refunds require merchant approval."},"mcap":{"status":"sandbox","version":"1.0","adapter":"mcap-inbound-v1","provider":"stripe","auth_required":true,"description":"Mastercard Agent Pay — Ed25519 HTTP Message Signatures (RFC 9421) with Agentic Token pass-through via Stripe. Zero-code for merchants with existing Stripe setup.","tools":["process_agent_payment","check_agent_consent"]}},"rate_limits":{"free":"20 req/min","growth":"500 req/min","pro":"1000 req/min","enterprise":"unlimited"},"trust":{"min_trust_score":0.3,"verification_levels":["UNVERIFIED","BASIC","STANDARD","PREMIUM"],"trust_info_url":"https://www.agenticmcpstores.com/en/trust","ranking_formula":"relevanceScore = (text_relevance × 0.55) + (store_trust_score × 0.25) + (freshness × 0.10) + (in_stock × 0.10)"},"eu_ai_act_transparency":{"regulation":"EU AI Act Art. 50 (Reg. 2024/1689)","headers":{"X-Agent-Commerce":{"value":"1","scope":"all agent API and MCP gateway responses","description":"Identifies that the HTTP request was initiated by an AI agent acting on behalf of a human user."},"X-AI-Act-Transparency":{"value":"agent-initiated-transaction","scope":"transactional routes only — /checkout, /payment, /cart, /order","description":"Signals a financial or cart-mutation action performed by an AI agent. Triggers Art. 50 disclosure obligations for merchants and PSPs."}},"body_field":{"name":"agent_transaction","type":"boolean","value":true,"scope":"POST /api/v1/agent/checkout response body","description":"Indicates that the checkout was initiated by an AI agent. Available for consumers that process the response body but not HTTP headers."}},"legal":{"terms_url":"https://www.agenticmcpstores.com/en/terms","privacy_url":"https://www.agenticmcpstores.com/en/privacy","compliance_url":"https://www.agenticmcpstores.com/en/compliance"},"contact":{"email":"developers@agenticmcpstores.com","docs_url":"https://agenticmcpstores-production.up.railway.app/api/v1/docs/json","developer_portal":"https://www.agenticmcpstores.com/en/developers"},"demo":{"endpoint":"/demo-store/mcp","playground_url":"https://www.agenticmcpstores.com/en/demo-store/playground","auth_required":false,"note":"Read-only tools available without authentication. Rate limit: 20 req/min per IP.","tools":["search_products","get_product_details","browse_categories","get_merchant_profile"],"sandbox_key":"POST /api/v1/sandbox/key"},"i18n":{"default_locale":"en","supported_locales":["en","es"]},"tools_preview":[{"name":"search_products","description":"Search products across all verified merchants. Supports filters by category, price, stock and trust score. Pass 'a2ui: true' to receive a rich declarative UI grid instead of plain JSON. Eligibility requires BASIC+ verification and trustScore ≥ 0.3.","input_schema":{"type":"object","properties":{"query":{"type":"string","description":"Natural language product query"},"category":{"type":"string"},"price_min":{"type":"number"},"price_max":{"type":"number"},"in_stock_only":{"type":"boolean","default":true},"min_trust_score":{"type":"number","default":0.3},"limit":{"type":"integer","default":10,"maximum":100},"page":{"type":"integer","default":1},"a2ui":{"type":"boolean","default":false,"description":"Return an A2UI declarative UI surface (ProductGrid) instead of plain JSON array. Requires A2UI-compatible renderer."}},"required":["query"]},"examples":[{"description":"Search sneakers under $100","input":{"query":"sneakers","max_price":10000,"max_results":3},"output":{"products":[{"id":"prod-001","title":"Nike Air Max 90","price":9900,"currency":"USD","trustScore":0.85,"inStock":true}],"total":1}}],"auth_required":true,"a2ui_support":true,"a2ui_component":"ProductGrid"},{"name":"get_product_details","description":"Get full product info: price, variants, policies, merchant trust score, stock status.","input_schema":{"type":"object","properties":{"product_id":{"type":"string"}},"required":["product_id"]},"examples":[{"description":"Get full details for a product by ID","input":{"product_id":"prod-001"},"output":{"id":"prod-001","title":"Nike Air Max 90","price":9900,"currency":"USD","description":"Classic running shoe with Air cushioning.","variants":[{"size":"42","inStock":true}],"trustScore":0.85,"returnPolicy":"30-day free returns"}}],"auth_required":true},{"name":"compare_products","description":"Side-by-side comparison of up to 10 products with normalized pricing, trust scores and return policies.","input_schema":{"type":"object","properties":{"product_ids":{"type":"array","items":{"type":"string"},"maxItems":10}},"required":["product_ids"]},"auth_required":true},{"name":"check_availability","description":"Real-time stock status with freshness tier: fresh (<1h), stale (>24h). Returns in_stock, low_stock or out_of_stock.","input_schema":{"type":"object","properties":{"product_id":{"type":"string"}},"required":["product_id"]},"auth_required":true},{"name":"get_merchant_profile","description":"Merchant trust score, verification level (BASIC/STANDARD/PREMIUM), return policies and shipping SLA.","input_schema":{"type":"object","properties":{"merchant_slug":{"type":"string"}},"required":["merchant_slug"]},"auth_required":true},{"name":"browse_categories","description":"List available product categories for a merchant. Returns category tree with product counts.","input_schema":{"type":"object","properties":{"merchant_slug":{"type":"string"}},"required":["merchant_slug"]},"auth_required":true},{"name":"create_cart","description":"Create a shopping cart for a merchant. Returns a cart_id UUID. Validates stock and applies fraud detection rules.","input_schema":{"type":"object","properties":{"merchant_id":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"product_id":{"type":"string"},"quantity":{"type":"integer","minimum":1}},"required":["product_id","quantity"]},"minItems":1}},"required":["merchant_id","items"]},"examples":[{"description":"Create a cart with one item","input":{"merchant_id":"demo-store","items":[{"product_id":"prod-001","quantity":1}]},"output":{"cart_id":"cart_abc123","status":"NOT_READY_FOR_PAYMENT","items":[{"product_id":"prod-001","quantity":1,"price":9900}],"subtotal":9900,"currency":"USD"}}],"auth_required":true},{"name":"complete_checkout","description":"Complete checkout via Shopify ACP or platform adapter. Pass 'a2ui: true' to receive a CheckoutWidget surface with cart summary, shipping selector and payment CTA instead of plain JSON. Requires explicit human confirmation before execution. Idempotent — safe to retry.","input_schema":{"type":"object","properties":{"checkout_session_id":{"type":"string","description":"Checkout session ID (UUID) from preview_checkout"},"idempotency_key":{"type":"string","description":"Unique key to prevent duplicate charges on retry. Generate once per purchase attempt."},"a2ui":{"type":"boolean","default":false,"description":"Return an A2UI declarative CheckoutWidget instead of plain JSON. Requires A2UI-compatible renderer."}},"required":["checkout_session_id","idempotency_key"]},"examples":[{"description":"Complete checkout after preview (requires human confirmation for orders > $100)","input":{"checkout_session_id":"session_xyz789","idempotency_key":"idem_unique_key_001"},"output":{"status":"COMPLETED","order_id":"order_123","total":9900,"currency":"USD","confirmation_required":false}}],"auth_required":true,"human_confirmation_required":true,"a2ui_support":true,"a2ui_component":"CheckoutWidget"},{"name":"ucp_create_checkout","description":"Create a UCP checkout session from line items. Returns checkout ID and session URL.","input_schema":{"type":"object","properties":{"store_slug":{"type":"string","description":"Merchant store slug"},"line_items":{"type":"array","items":{"type":"object","properties":{"product_id":{"type":"string"},"quantity":{"type":"integer","minimum":1}},"required":["product_id","quantity"]},"minItems":1},"currency":{"type":"string","default":"USD"}},"required":["store_slug","line_items"]},"auth_required":true,"human_confirmation_required":true},{"name":"ucp_get_checkout","description":"Retrieve a UCP checkout session by ID. Returns status, line items and totals.","input_schema":{"type":"object","properties":{"checkout_id":{"type":"string","description":"UCP checkout session ID"}},"required":["checkout_id"]},"auth_required":true},{"name":"ucp_update_checkout","description":"Replace all line items in a UCP checkout session (full replace). Recalculates totals.","input_schema":{"type":"object","properties":{"checkout_id":{"type":"string"},"line_items":{"type":"array","items":{"type":"object","properties":{"product_id":{"type":"string"},"quantity":{"type":"integer","minimum":1}},"required":["product_id","quantity"]},"minItems":1}},"required":["checkout_id","line_items"]},"auth_required":true,"human_confirmation_required":true},{"name":"ucp_complete_checkout","description":"Complete a UCP checkout session. Idempotent — safe to retry. Requires explicit user confirmation.","input_schema":{"type":"object","properties":{"checkout_id":{"type":"string"},"payment_token":{"type":"string","description":"Payment authorization token"}},"required":["checkout_id"]},"auth_required":true,"human_confirmation_required":true},{"name":"ucp_cancel_checkout","description":"Cancel a UCP checkout session. Releases any held inventory.","input_schema":{"type":"object","properties":{"checkout_id":{"type":"string"},"reason":{"type":"string","description":"Optional cancellation reason"}},"required":["checkout_id"]},"auth_required":true,"human_confirmation_required":true}]}