{"name":"fast-marketplace","description":"AI-agent marketplace. Discover shops, compare products, prepare quotes, and start explicit checkout handoff or confirmation flows; final order status comes from the chosen shop's adapter.","canonicalUrl":"https://shop.fast.xyz","transport":"stdio","install":{"npm":"npx -y @fastxyz/mcp@latest","bundle":"https://shop.fast.xyz/fast-mcp.mcpb"},"capabilities":["search","list-merchants"],"agentGuidance":{"shoppingFlow":"Use fast_shop_list_merchants, fast_shop_search, and fast_shop_quote to search shops, compare products, and prepare quotes. Checkout and order tools are guarded boundaries, not autonomous business logic.","checkoutConfirmation":"Checkout handoff, order creation, link/card checkout, and cancellation require explicit user action/confirmation. Report authoritative status honestly; only placed, shipped, or delivered means confirmed order progress.","confirmationRequiredTools":["fast_shop_handoff_checkout","fast_shop_create_order","fast_shop_create_link_order","fast_shop_cancel_order"],"recoveryCodes":{"fast_shop_handoff_checkout":"shopping_tool_handoff_confirmation_required","fast_shop_create_order":"shopping_tool_create_order_confirmation_required","fast_shop_create_link_order":"shopping_tool_create_link_order_confirmation_required","fast_shop_cancel_order":"shopping_tool_cancel_order_confirmation_required"},"publicDecisionMetadata":{"schemaVersion":1,"allowedFields":["action","briefSummary","policyDecision","merchantHealth","nextActions","blockedReason","resultTokens","resultCards","quoteEligibility"],"forbiddenFields":["rawPrompt","systemPrompt","chainOfThought","rawModelReasoning","rawScores","rawPii","secrets","providerErrors","toolInternals"],"resultSafety":{"safeResultTokens":["resultSetId","selectionToken","choiceId","quoteRequestId"],"safeResultCards":["publicProductCard","publicQuoteCard","publicPaymentOption"],"quoteEligibility":"Expose quote eligibility as eligible, ineligible, unknown, or confirmation_required; do not infer buyability from unavailable or degraded merchant health.","merchantHealth":"Expose merchant health only as available, degraded, unavailable, or unknown guidance with optional public retry guidance; do not include raw provider errors or internal canary metadata."}}},"toolPolicies":[{"name":"fast_shop_list_merchants","exposedToHostedChatModel":true,"boundary":"safe_read","policyDecision":"allowed_without_confirmation","mutationSensitive":false,"checkoutSensitive":false,"requiresExplicitUserConfirmation":false,"recoveryCode":"shopping_tool_list_merchants_safe","resultMetadata":{"merchantHealth":"List merchant checkout modes and public health guidance only; omit adapter URLs, operational canary data, and raw provider diagnostics."}},{"name":"fast_shop_search","exposedToHostedChatModel":true,"boundary":"safe_read","policyDecision":"allowed_without_confirmation","mutationSensitive":false,"checkoutSensitive":false,"requiresExplicitUserConfirmation":false,"recoveryCode":"shopping_tool_search_safe","resultMetadata":{"safeResultTokens":["resultSetId","selectionToken"],"safeResultCards":["publicProductCard"],"productCardCuration":{"initialVisibleProductCardCap":6,"perShopSafetyCap":3,"unavailableMerchantHandling":"Suppress unavailable merchant cards when safe alternatives exist; otherwise return compact recovery guidance.","degradedMerchantHandling":"Surface degraded merchants as health guidance, not as a promise that cards are permanently unbuyable."},"merchantHealth":"Merchant health is public guidance for current routing and quote confidence; it is not a raw provider diagnostic or permanent buyability claim."}},{"name":"fast_shop_get_product","exposedToHostedChatModel":false,"boundary":"safe_read","policyDecision":"allowed_without_confirmation","mutationSensitive":false,"checkoutSensitive":false,"requiresExplicitUserConfirmation":false,"recoveryCode":"shopping_tool_get_product_safe","resultMetadata":{"safeResultTokens":["selectionToken"],"safeResultCards":["publicProductCard"],"merchantHealth":"Return public product-card context only; do not expose signed hint headers, adapter URLs, or raw variant internals."}},{"name":"fast_shop_quote","exposedToHostedChatModel":true,"boundary":"quote_precheckout","policyDecision":"allowed_without_confirmation","mutationSensitive":false,"checkoutSensitive":false,"requiresExplicitUserConfirmation":false,"recoveryCode":"shopping_tool_quote_safe","quoteEligibility":["eligible","ineligible","unknown"],"resultMetadata":{"safeResultTokens":["quoteRequestId"],"safeResultCards":["publicQuoteCard","publicPaymentOption"],"merchantHealth":"A quote response may report eligibility or temporary unavailability, but it must not include raw payment, provider, shipping, or adapter errors."}},{"name":"fast_shop_handoff_checkout","exposedToHostedChatModel":false,"boundary":"guarded_mutation","policyDecision":"explicit_confirmation_required","mutationSensitive":true,"checkoutSensitive":true,"requiresExplicitUserConfirmation":true,"checkoutAction":"checkout_start","recoveryCode":"shopping_tool_handoff_confirmation_required"},{"name":"fast_shop_create_order","exposedToHostedChatModel":false,"boundary":"guarded_mutation","policyDecision":"explicit_confirmation_required","mutationSensitive":true,"checkoutSensitive":true,"requiresExplicitUserConfirmation":true,"checkoutAction":"order_place","recoveryCode":"shopping_tool_create_order_confirmation_required"},{"name":"fast_shop_create_link_order","exposedToHostedChatModel":false,"boundary":"guarded_mutation","policyDecision":"explicit_confirmation_required","mutationSensitive":true,"checkoutSensitive":true,"requiresExplicitUserConfirmation":true,"checkoutAction":"order_place","recoveryCode":"shopping_tool_create_link_order_confirmation_required"},{"name":"fast_shop_list_orders","exposedToHostedChatModel":false,"boundary":"status_read","policyDecision":"status_read_only","mutationSensitive":false,"checkoutSensitive":true,"requiresExplicitUserConfirmation":false,"recoveryCode":"shopping_tool_list_orders_status_read","resultMetadata":{"safeResultCards":["publicOrderStatusCard"],"merchantHealth":"Expose normalized order status and public recovery guidance only; omit raw payment, shipping, and provider errors."}},{"name":"fast_shop_get_order","exposedToHostedChatModel":false,"boundary":"status_read","policyDecision":"status_read_only","mutationSensitive":false,"checkoutSensitive":true,"requiresExplicitUserConfirmation":false,"recoveryCode":"shopping_tool_get_order_status_read","resultMetadata":{"safeResultCards":["publicOrderStatusCard"],"merchantHealth":"Expose normalized order status and public recovery guidance only; omit raw payment, shipping, and provider errors."}},{"name":"fast_shop_cancel_order","exposedToHostedChatModel":false,"boundary":"guarded_mutation","policyDecision":"explicit_confirmation_required","mutationSensitive":true,"checkoutSensitive":true,"requiresExplicitUserConfirmation":true,"checkoutAction":"order_cancel","recoveryCode":"shopping_tool_cancel_order_confirmation_required"}],"checkoutStates":{"all":["pending","submitted","processing","submission_unknown","paid_unconfirmed","self_checkout_opened","support_needed","placed","shipped","delivered","refunded","failed","cancelled"],"nonTerminal":["pending","submitted","processing","submission_unknown","paid_unconfirmed","self_checkout_opened","support_needed","placed","shipped"],"terminal":["delivered","refunded","failed","cancelled"],"sticky":["placed","shipped","delivered","refunded","failed","cancelled","support_needed","paid_unconfirmed","self_checkout_opened"],"success":"placed","successfulProgress":["placed","shipped","delivered"],"normalization":{"canceled":"cancelled","in_progress":"processing","unknown":"submission_unknown"},"buyerCopy":{"pending":"This order is pending. We are waiting for the merchant to update the status.","submitted":"This order was submitted. Fast will show the merchant result when it is confirmed.","processing":"This order is processing with the merchant.","submission_unknown":"We could not confirm the final merchant status yet.","paid_unconfirmed":"Payment was submitted. Refresh in a few minutes to check the merchant status.","self_checkout_opened":"Fast sent you to the merchant checkout. We cannot confirm whether the merchant completed the order yet.","support_needed":"This order needs support review. We could not confirm the final merchant status yet.","placed":"This order was placed.","shipped":"This order has shipped.","delivered":"This order was delivered.","refunded":"This order was refunded.","failed":"This order failed. The merchant could not complete this order.","cancelled":"This order was cancelled."},"guidance":"These states apply to Fast Shop chat, history, resume, and order-card rendering. Only `placed`, `shipped`, or `delivered` mean an authoritative merchant or adapter source confirmed order progress. `failed`, `cancelled`, `refunded`, and `delivered` are terminal and must not regress to pending or unknown. `placed` may progress to `shipped` or `delivered`; `shipped` may progress to `delivered`. `placed`, `shipped`, `support_needed`, `paid_unconfirmed`, and `self_checkout_opened` are sticky states and must not regress to pending or unknown. Report `refund_status` separately when present, and do not expose raw provider, payment, shipping, or adapter errors to buyers.","selfCheckout":"For Self Checkout handoff, Fast can report that the merchant checkout page was opened, but cannot confirm final merchant completion unless an authoritative status later returns `placed`, `shipped`, `delivered`, `refunded`, `failed`, or `cancelled`."}}