{"schemaVersion":"1.0","purpose":"Reproducible buyer-task examples, not independent buyer visits or orders","connection":{"publicOrigin":"https://hadacart.com","publicCatalogMcp":{"url":"https://hadacart.com/api/catalog/mcp","transport":"streamable-http","responseMode":"stateless JSON; GET subscription returns405","supportedProtocolVersions":["2025-11-25","2025-06-18","2025-03-26"],"authenticationRequired":false,"credentials":"omit; Authorization and Cookie are rejected","tools":["find_buying_guides","find_purchase_candidates","search_products","get_product"],"scope":"Same already-public dated catalog and buying-guide data as public HTTP. No connected apps, private reports, source refresh, issuer activation, cart, checkout, payment or order.","arbitraryClientCompatibilityVerified":false,"operatorRegistryPublicationCompleted":true,"automaticDistributionToAllAIUsers":false,"clientExample":{"downloadUrl":"https://hadacart.com/public-catalog-client.mjs","sdk":"@modelcontextprotocol/client@2.3.1","nodeVersion":"v26.5.0","negotiatedProtocol":"2025-11-25","verifiedAt":"2026-10-19T18:42:26.758Z","scope":"Own diagnostic integration with fixed KR/US examples, no merchant calls or buyer evidence","otherClientVersionsVerified":false,"diagnosticHeaderRequiredForExamples":true},"registry":{"name":"com.hadacart/catalog-snapshots","version":"1.0.0","status":"active","publishedAt":"2026-10-21T01:22:49.120624Z","verifiedAt":"2026-10-21T01:23:02.651Z","metadataUrl":"https://registry.modelcontextprotocol.io/v0.1/servers/com.hadacart%2Fcatalog-snapshots/versions/1.0.0","remoteUrl":"https://hadacart.com/api/catalog/mcp","submissionLicenseScope":"Owner-authored registry metadata only, dedicated under CC0; linked catalog/source content is not relicensed","isClientInstallationOrBuyerEvidence":false,"ordersOrCommissionVerified":false},"inputRecovery":{"schemaVersion":"1.0","scope":"Public snapshot tool input recovery only; no automatic retry or buyer selection change","helpUrl":"https://hadacart.com/agents/#public-mcp-input-recovery","automaticRetryRecommended":false,"requiresActualBuyerInputs":true,"relaxBuyerConstraints":false,"requiredArgumentsByTool":{"find_purchase_candidates":["query","currency","destinationCountry"],"get_product":["productId"],"find_buying_guides":[],"search_products":[]},"rules":["Call tools/list for the current input schema. Do not repeat the same failing request unchanged.","find_purchase_candidates requires query, one native currency and destinationCountry. Use the actual buyer destination; US additionally needs the actual region to assess a purchase handoff.","optionQuery and maxOptionPrice require sellerId and one native currency, even when productId is provided. Preserve the exact option, quantity, budget, benefits and product constraints. Never remove them just to obtain a result.","For get_product, copy an exact products[].id from search_products or candidates[].productId from find_purchase_candidates. A title, variant ID, merchant URL or invented prefix is not a product ID. Unknown IDs are not replaced automatically.","If required buyer choices are missing, obtain them from the buyer. The KR and US examples below are diagnostic documentation, never defaults or buyer consent.","After correcting the input, review source dates, exact options and destination conditions. Keep the original issued affiliate URL and reselect actual options/quantity at merchant; delivery, final total, payment approval, qualified order and commission need separate evidence."],"examplesAreDiagnosticOnly":true,"diagnosticHeader":{"X-Hadacart-Traffic-Purpose":"diagnostic"},"examples":[{"label":"KR native-KRW udon example only","tool":"find_purchase_candidates","arguments":{"query":"우동","currency":"KRW","destinationCountry":"KR","sellerId":"pulmuone","quantity":1,"limit":3}},{"label":"US native-USD exact K2 Brown example only; NY and quantity2 are not buyer defaults","tool":"find_purchase_candidates","arguments":{"query":"K2","currency":"USD","destinationCountry":"US","destinationRegion":"NY","sellerId":"keychron","productId":"keychron-4328395079769","optionQuery":"Brown","quantity":2,"budget":{"amount":140,"currency":"USD"},"maxOptionPrice":70,"limit":3}}],"returnedLinkIsClick":false,"orderPlaced":false,"commissionConfirmed":false}},"publicHttp":{"url":"https://hadacart.com/api/buying/candidates","method":"POST","authenticationRequired":false,"credentials":"omit","requestFields":"Documented BUYING_SCHEMA only; no personal data or secrets","browserCrossOriginSupported":true,"diagnosticHeader":"X-Hadacart-Traffic-Purpose: diagnostic","scope":"Public catalog candidate lookup only; no merchant reads, link activation, cart creation or payment"},"openapiUrl":"https://hadacart.com/openapi.json","mcpTransport":"streamable-http","platformMcpUrl":"https://hadacart.tiny-deer-9667.chatgpt.site/mcp","platformMcpOAuthResource":"https://hadacart.tiny-deer-9667.chatgpt.site/mcp","connectionMetadataUrl":"https://hadacart.com/.well-known/agent-connection.json","rawCanonicalMcpAnonymousStatus":404,"connectionScope":"Existing Sites-provisioned personal plugin; client installation/authorization is separate. This does not enroll all ChatGPT users or grant checkout/payment permission."},"instructions":["Replace the example destination and constraints with the actual buyer choices. California is an example, not every US buyer.","Read-only candidate requests do not open affiliate links or create carts. No-match results never relax exact identity, option or budget.","Revalidate current price/stock and verify delivery/final total at the merchant; snapshots are dated.","Keep the original provider-issued link and merchant browser session for a buyer-approved purchase; AI and cart attribution remain unverified.","A copied prompt, connected tool or own QA run is not an independent purchaser, qualified order or earned commission."],"tasks":[{"id":"us-k8-unit-ceiling-with-total-budget","title":"US K8: $80 per keyboard remains fixed with a $200 total budget","englishTitle":"US K8: $80 per keyboard remains fixed with a $200 total budget","buyerQuestion":"For two exact K8 RGB Super Brown keyboards sent to NY, keep the unit ceiling80USD and total budget200USD separately. Revalidate the same variant; a higher total budget does not permit a unit quote above80USD. Preserve PC/card/no selected benefits and the original issuer URL.","advantage":"The unit ceiling survives exact preparation and source-verification requests as unitPriceCeiling, independent of total budget/quantity. Fresh above-ceiling exact prices require new buyer direction; never substitute an option or use the product minimum. Current stock/shipping/tax/payment/commission remain unverified.","guidePath":"/buying/keychron-k8-rgb-super-brown-two-keyboards/","request":{"query":"Keychron K8 Wireless Mechanical Keyboard","productId":"keychron-4669741170777","sellerId":"keychron","optionQuery":"RGB Backlight / Keychron Super Switch (Hot-Swappable) / Brown","optionQueryMode":"exact","currency":"USD","destinationCountry":"US","destinationRegion":"NY","quantity":2,"maxOptionPrice":80,"budget":{"amount":200,"currency":"USD"},"limit":1,"purchasePreferences":{"channel":"PC","paymentMethod":"card","benefits":[]}},"exampleUrls":{"html":"https://hadacart.com/agents/tasks/us-k8-unit-ceiling-with-total-budget/","json":"https://hadacart.com/agents/tasks/us-k8-unit-ceiling-with-total-budget/task.json","markdown":"https://hadacart.com/agents/tasks/us-k8-unit-ceiling-with-total-budget/index.md"},"guideUrl":"https://hadacart.com/buying/keychron-k8-rgb-super-brown-two-keyboards/","requestIsExample":true,"destinationIsExample":true,"api":{"method":"POST","url":"https://hadacart.com/api/buying/candidates"},"mcpTool":"find_purchase_candidates","preview":{"evaluatedAt":"2026-10-21T05:14:03.044Z","matchingSnapshotCount":1,"returnedCount":1,"hasMore":false,"ranking":"catalog-order-no-price-ranking","optionBudgetEvidence":null,"orderPlaced":false,"paymentCaptured":false,"commissionConfirmed":false,"candidates":[{"productId":"keychron-4669741170777","name":"Keychron K8 Wireless Mechanical Keyboard","seller":"Keychron","currency":"USD","advertisedPrice":59.99,"priceScope":"lowest-available-option-price","purchaseConditions":null,"packageQuantity":null,"unitPricing":null,"matchedOptions":[{"id":"32018252955737","name":"RGB Backlight / Keychron Super Switch (Hot-Swappable) / Brown","price":79.99,"currency":"USD","available":true,"sku":"K8-H3","recordedOptionIdentity":{"state":"selected-sku-unique-within-recorded-product","catalogProductId":"keychron-4669741170777","sourceCapturedAt":"2026-10-14T01:15:06.163762+00:00","sourceUrl":"https://www.keychron.com/products.json?limit=250&page=3","selectedVariantId":"32018252955737","selectedOptionName":"RGB Backlight / Keychron Super Switch (Hot-Swappable) / Brown","recordedSku":"K8-H3","recordedSameSkuOptionCount":1,"selectedVariantIdUniqueWithinRecordedProduct":true,"sameSkuOptions":[{"variantId":"32018252955737","name":"RGB Backlight / Keychron Super Switch (Hot-Swappable) / Brown"}],"optionsTruncated":false,"scope":"case-sensitive-SKU-only-within-this-dated-product; not global uniqueness, a merchant selection or stock confirmation","skuAloneSelectsExactCurrentOption":false,"requiresExactRecordedVariantIdAndName":true,"selectionChanged":false,"currentMerchantSelectionVerified":false,"requestedQuantityStockConfirmed":false},"priceScope":"recorded-option-price-not-current-quote","availabilityScope":"recorded-option-availability-not-current-stock","sourceUrl":"https://www.keychron.com/products.json?limit=250&page=3","capturedAt":"2026-10-14T01:15:06.163762+00:00","availabilityCheckedAt":"2026-10-14T01:15:06.163762+00:00","livePriceVerified":false,"liveInventoryVerified":false,"requestedQuantityStockConfirmed":false,"deliveredTotal":null,"orderPlaced":false}],"capturedAt":"2026-10-14T01:15:06.163762+00:00","sourceUrl":"https://www.keychron.com/products.json?limit=250&page=3","sourceAvailable":true,"routeState":"merchant-verification-required","purchasePreferences":{"channel":"PC","paymentMethod":"card","benefits":[]},"buyerPreferencesPreserved":true,"affiliateRouteAssessment":null,"affiliateRouteSelected":true,"quantityAssessment":{"requestedMerchantQuantity":2,"quantityIsExample":false,"scope":"merchant listing units or packages, not individual contents","recordedPackageQuantity":null,"requestedContentsQuantity":null,"maximumQuantityPerBuyerAtCapture":null,"sourceQuantityLimitExceeded":false,"quantityLimitScope":"dated merchant declaration; current limit and stock allocation unverified","currentQuantityStockVerified":false,"quantityAllocated":false,"selectionChanged":false,"orderPlaced":false},"purchasePreparation":{"requestExecuted":false,"cartCreated":false,"paymentAuthorized":false,"orderPlaced":false,"plans":[{"status":"merchant-verification-required","method":"POST","endpoint":"https://hadacart.com/api/purchase/prepare","request":{"items":[{"productId":"keychron-4669741170777","variantId":"32018252955737","quantity":2,"unitPriceCeiling":{"amount":80,"currency":"USD"},"purchasePreferences":{"channel":"PC","paymentMethod":"card","benefits":[]}}],"destinationCountry":"US","destinationRegion":"NY","budget":{"amount":200,"currency":"USD"}},"merchantSelection":{"catalogProductId":"keychron-4669741170777","sourceProductUrl":"https://www.keychron.com/products/keychron-k8-tenkeyless-wireless-mechanical-keyboard","observationSourceUrl":"https://www.keychron.com/products.json?limit=250&page=3","recordedMerchantIdentity":null,"recordedOption":{"variantId":"32018252955737","name":"RGB Backlight / Keychron Super Switch (Hot-Swappable) / Brown","sku":"K8-H3"},"recordedOptionIdentity":{"state":"selected-sku-unique-within-recorded-product","catalogProductId":"keychron-4669741170777","sourceCapturedAt":"2026-10-14T01:15:06.163762+00:00","sourceUrl":"https://www.keychron.com/products.json?limit=250&page=3","selectedVariantId":"32018252955737","selectedOptionName":"RGB Backlight / Keychron Super Switch (Hot-Swappable) / Brown","recordedSku":"K8-H3","recordedSameSkuOptionCount":1,"selectedVariantIdUniqueWithinRecordedProduct":true,"sameSkuOptions":[{"variantId":"32018252955737","name":"RGB Backlight / Keychron Super Switch (Hot-Swappable) / Brown"}],"optionsTruncated":false,"scope":"case-sensitive-SKU-only-within-this-dated-product; not global uniqueness, a merchant selection or stock confirmation","skuAloneSelectsExactCurrentOption":false,"requiresExactRecordedVariantIdAndName":true,"selectionChanged":false,"currentMerchantSelectionVerified":false,"requestedQuantityStockConfirmed":false},"requestedMerchantQuantity":2,"merchantQuantityScope":"number-of-listed-product-configurations-or-packages; not individual contents","recordedPackageQuantity":null,"requestedContentsQuantity":null,"originalIssuedAffiliateUrl":"https://www.keychron.com/products/keychron-k8-tenkeyless-wireless-mechanical-keyboard?ref=pfuqblvp","sourceCapturedAt":"2026-10-14T01:15:06.163762+00:00","selectionChanged":false,"merchantSelectionApplied":false,"currentStockVerified":false,"finalTotal":null,"paymentAuthorized":false,"orderPlaced":false},"unitPriceCeilingAssessment":{"ceiling":{"amount":80,"currency":"USD"},"state":"merchant-current-option-price-required","observedUnitPrice":79.99,"observedCurrency":"USD","priceEvidence":"dated-source","observedAt":"2026-10-14T01:15:06.163762+00:00","currencyComparable":true,"unitPriceExceedsCeiling":false,"ceilingChanged":false,"selectionChanged":false,"currencyConversionPerformed":false,"currentExactOptionPriceVerified":false,"requiresBuyerReview":true,"buyerAcceptedChanges":false,"withinDeliveredBudget":null,"deliveredTotal":null,"paymentAuthorized":false,"scope":"one selected merchant listing/configuration; excludes quantity multiplication, shipping/tax and buyer-specific benefit eligibility"},"purchasePreferences":{"channel":"PC","paymentMethod":"card","benefits":[]},"buyerPreferencesPreserved":true,"affiliateRouteAssessment":null,"preferenceRouteState":"merchant-verification-required","budgetAssessment":{"state":"merchant-final-quote-required","budget":{"amount":200,"currency":"USD"},"currencyComparable":true,"sourceProductSubtotal":159.98,"sourceCurrency":"USD","sourceSubtotalScope":"captured advertised product prices only; not a current buyer-specific quote","containsBuyerConditionalPrices":false,"sourceSubtotalExceedsBudget":false,"remainingForShippingAndTax":40.02,"currencyConversionPerformed":false,"selectionChanged":false,"deliveredTotal":null,"withinDeliveredBudget":null,"requiresMerchantFinalQuote":true,"requiresBuyerDecision":false,"buyerPaymentAuthorized":false,"reason":"Revalidate the exact option/quantity and buyer benefits, then obtain merchant shipping, tax and final total in the budget currency before buyer-authorized payment."},"sourceUnitPrice":79.99,"sourceProductSubtotal":159.98,"currency":"USD","priceScope":"dated-exact-option-price-times-merchant-quantity","perUnitPriceCeilingUnchanged":true,"quantityIsExample":false,"destinationCopiedFromRequest":true,"requestIsExample":true,"requestExecuted":false,"sourceCurrentPriceVerified":false,"requestedQuantityStockVerified":false,"deliveredTotal":null,"buyerPaymentAuthorized":false,"orderPlaced":false}],"status":"read-only-merchant-selection-preparation-plans"},"purchaseVerification":{"requestExecuted":false,"stockReservation":false,"cartCreationAuthorized":false,"paymentAuthorized":false,"plans":[{"method":"POST","endpoint":"https://hadacart.com/api/purchase/revalidate","request":{"items":[{"productId":"keychron-4669741170777","variantId":"32018252955737","quantity":2,"unitPriceCeiling":{"amount":80,"currency":"USD"},"purchasePreferences":{"channel":"PC","paymentMethod":"card","benefits":[]}}],"destinationCountry":"US","destinationRegion":"NY","budget":{"amount":200,"currency":"USD"}},"verificationPageUrl":"https://hadacart.com/global/?product=keychron-4669741170777&quantity=2&destination_country=US&variant=32018252955737&preferences_present=1&channel=PC&payment=card&benefits_state=none&unit_ceiling_amount=80&unit_ceiling_currency=USD&destination_region=NY&budget_amount=200&budget_currency=USD","selectedOptionName":"RGB Backlight / Keychron Super Switch (Hot-Swappable) / Brown","scope":"exact-option-price-and-source-availability","exactOptionPriceSupported":true,"optionInventorySupported":true,"requestIsExample":true,"quantityIsExample":false,"quantityCopiedFromRequest":true,"destinationCopiedFromRequest":true,"requestExecuted":false,"sourceMayReturnDatedCache":true,"cacheTtlSeconds":600,"originalAffiliateUrlModified":false,"stockReservation":false,"cartCreationAuthorized":false,"paymentAuthorized":false,"instructions":"Preserve the supplied merchant listing quantity. Preserve buyer preferences in any later route assessment. Destination is copied from this candidate request; verify the actual buyer destination. Review at the verification page or explicitly request the read-only source check. Advertised product price is not selected-option price or stock. Current stock, requested-quantity allocation, delivery, shipping, tax and final payable total are not guaranteed. Reading this plan executes no request, affiliate visit, cart, order or payment."}],"status":"read-only-source-verification-plans"},"requestIsExample":true,"detailUrl":"https://hadacart.com/products/keychron-4669741170777/","productJsonUrl":"https://hadacart.com/products/keychron-4669741170777/product.json","commissionTrackingUrl":"https://www.keychron.com/products/keychron-k8-tenkeyless-wireless-mechanical-keyboard?ref=pfuqblvp","affiliateFinalApproval":false,"affiliateEligibility":{"status":"issued-product-link-ai-and-qualified-order-eligibility-unverified","merchantApproval":"account-active-in-authenticated-portal","siteRegistrationVerified":true,"aiTrafficApproved":null,"conditions":"키크론 공식 상품 링크 발급 · hadacart.com 프로필 저장 확인. 첫 구매자 적격 구매 5% 안내, 예약판매 제외. 쿠키 7일·다른 경유로 덮어쓰기 가능·30일 검증. PayPal 최소 300 USD, 검증 후 Net15. AI 활동·장바구니/결제 추적·정산 신원·실제 수익 미확인.","eligibleChannels":null,"ineligibleChannels":null,"recognizedCountries":null,"recognizedLanguages":null,"providerConditionsUrl":"https://affiliate.keychron.com/program-details/commissions","programConditionsUrl":null,"providerConditions":{"firstTimeCustomerOnly":true,"preOrdersExcluded":true,"validationDays":30,"cookieDays":7,"shippingTaxExcluded":true,"payoutMethod":"PayPal","payoutWithinDaysAfterValidation":15,"cookieOverwritePossible":true,"minimumPayoutUSD":300},"providerDisplayedRatePercent":5,"conditionsObservedAt":"2026-10-09T02:05:21.990Z","payoutIdentityVerified":false,"payoutSettingsObservedAt":"2026-10-09T02:16:25.088760+00:00","qualifiedOrderVerified":false,"earnedCommission":null},"shippingIncluded":false,"liveInventoryVerified":false,"deliveredTotal":null}]}}]}