{"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-k3-pro-exact-hot-swap-brown","title":"US K3 Pro Brown Hot-Swappable: exact H3, recorded unavailable","englishTitle":"US K3 Pro Brown Hot-Swappable: exact H3, recorded unavailable","buyerQuestion":"For US NY delivery, look up one Black / RGB Backlight / Brown (Hot-Swappable) K3 Pro, with an84USD unit ceiling and150USD total budget. Keep the exact H3 variant even if its dated source flag is unavailable; do not substitute cheaper White Backlight or plain RGB Brown.","advantage":"Keeps variant40283619098713/SKUK3P-H3 and the83.99USD Oct14observation. Its recordedfalse availability suppresses preparation; the generic product minimum67.99USD and another available Brown variant do not satisfy this exact hot-swap request. Current stock, shipping/tax, delivered total, payment and affiliate attribution remain unverified.","guidePath":"/buying/keychron-k3-pro-brown/","request":{"query":"","productId":"keychron-7169941405785","sellerId":"keychron","optionQuery":"Black / RGB Backlight / Brown (Hot-Swappable)","optionQueryMode":"exact","currency":"USD","destinationCountry":"US","destinationRegion":"NY","quantity":1,"maxOptionPrice":84,"budget":{"amount":150,"currency":"USD"},"purchasePreferences":{"channel":"PC","paymentMethod":"card","benefits":[]},"limit":1},"exampleUrls":{"html":"https://hadacart.com/agents/tasks/us-k3-pro-exact-hot-swap-brown/","json":"https://hadacart.com/agents/tasks/us-k3-pro-exact-hot-swap-brown/task.json","markdown":"https://hadacart.com/agents/tasks/us-k3-pro-exact-hot-swap-brown/index.md"},"guideUrl":"https://hadacart.com/buying/keychron-k3-pro-brown/","requestIsExample":true,"destinationIsExample":true,"api":{"method":"POST","url":"https://hadacart.com/api/buying/candidates"},"mcpTool":"find_purchase_candidates","preview":{"evaluatedAt":"2026-10-21T05:15:35.241Z","matchingSnapshotCount":1,"returnedCount":1,"hasMore":false,"ranking":"catalog-order-no-price-ranking","optionBudgetEvidence":null,"orderPlaced":false,"paymentCaptured":false,"commissionConfirmed":false,"candidates":[{"productId":"keychron-7169941405785","name":"Keychron K3 Pro QMK/VIA Wireless Custom Mechanical Keyboard","seller":"Keychron","currency":"USD","advertisedPrice":67.99,"priceScope":"lowest-available-option-price","purchaseConditions":null,"packageQuantity":null,"unitPricing":null,"matchedOptions":[{"id":"40283619098713","name":"Black / RGB Backlight / Brown (Hot-Swappable)","price":83.99,"currency":"USD","available":false,"sku":"K3P-H3","recordedOptionIdentity":{"state":"selected-sku-unique-within-recorded-product","catalogProductId":"keychron-7169941405785","sourceCapturedAt":"2026-10-14T01:15:06.163762+00:00","sourceUrl":"https://www.keychron.com/products.json?limit=250&page=3","selectedVariantId":"40283619098713","selectedOptionName":"Black / RGB Backlight / Brown (Hot-Swappable)","recordedSku":"K3P-H3","recordedSameSkuOptionCount":1,"selectedVariantIdUniqueWithinRecordedProduct":true,"sameSkuOptions":[{"variantId":"40283619098713","name":"Black / RGB Backlight / Brown (Hot-Swappable)"}],"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":"source-reported-unavailable","purchasePreferences":{"channel":"PC","paymentMethod":"card","benefits":[]},"buyerPreferencesPreserved":true,"affiliateRouteAssessment":null,"affiliateRouteSelected":false,"quantityAssessment":{"requestedMerchantQuantity":1,"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":"source-reported-unavailable"},"purchaseVerification":{"requestExecuted":false,"stockReservation":false,"cartCreationAuthorized":false,"paymentAuthorized":false,"plans":[{"method":"POST","endpoint":"https://hadacart.com/api/purchase/revalidate","request":{"items":[{"productId":"keychron-7169941405785","variantId":"40283619098713","quantity":1,"unitPriceCeiling":{"amount":84,"currency":"USD"},"purchasePreferences":{"channel":"PC","paymentMethod":"card","benefits":[]}}],"destinationCountry":"US","destinationRegion":"NY","budget":{"amount":150,"currency":"USD"}},"verificationPageUrl":"https://hadacart.com/global/?product=keychron-7169941405785&quantity=1&destination_country=US&variant=40283619098713&preferences_present=1&channel=PC&payment=card&benefits_state=none&unit_ceiling_amount=84&unit_ceiling_currency=USD&destination_region=NY&budget_amount=150&budget_currency=USD","selectedOptionName":"Black / RGB Backlight / Brown (Hot-Swappable)","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-7169941405785/","productJsonUrl":"https://hadacart.com/products/keychron-7169941405785/product.json","commissionTrackingUrl":"https://www.keychron.com/products/keychron-k3-pro-qmk-via-wireless-custom-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}]}}]}