{"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-k10-exact-brown-budget","title":"US Keychron K10: check exact RGB aluminum hot-swap Brown against $80","englishTitle":"US Keychron K10: check exact RGB aluminum hot-swap Brown against $80","buyerQuestion":"For US delivery, find the Keychron K10 RGB aluminum-frame hot-swappable Brown configuration with an option unit price no higher than 80 USD. Keep that exact configuration; do not use the product minimum or silently substitute a non-hot-swap option.","advantage":"The complete recorded option name and exact catalog product ID stay fixed while the USD option ceiling is checked. A cheap product minimum cannot stand in for this configuration. No-match evidence explains the dated price without raising the ceiling; no delivery, current-stock or payment promise.","guidePath":"/buying/keychron/","request":{"query":"","productId":"keychron-6576777199705","sellerId":"keychron","optionQuery":"RGB Backlight Aluminum Frame / Keychron Super Switch (Hot-Swappable) / Brown","optionQueryMode":"exact","currency":"USD","destinationCountry":"US","destinationRegion":"CA","maxOptionPrice":80,"limit":1},"exampleUrls":{"html":"https://hadacart.com/agents/tasks/us-k10-exact-brown-budget/","json":"https://hadacart.com/agents/tasks/us-k10-exact-brown-budget/task.json","markdown":"https://hadacart.com/agents/tasks/us-k10-exact-brown-budget/index.md"},"guideUrl":"https://hadacart.com/buying/keychron/","requestIsExample":true,"destinationIsExample":true,"api":{"method":"POST","url":"https://hadacart.com/api/buying/candidates"},"mcpTool":"find_purchase_candidates","preview":{"evaluatedAt":"2026-10-21T05:14:17.479Z","matchingSnapshotCount":0,"returnedCount":0,"hasMore":false,"ranking":"catalog-order-no-price-ranking","optionBudgetEvidence":{"reason":"recorded-exact-option-prices-exceed-ceiling","scope":"bounded-dated-same-option-evidence-not-purchase-alternatives","onlyRemovedFilter":"maxOptionPrice","preservedFilters":{"query":"","productId":"keychron-6576777199705","sellerId":"keychron","optionQuery":"RGB Backlight Aluminum Frame / Keychron Super Switch (Hot-Swappable) / Brown","optionQueryMode":"exact","currency":"USD","destinationCountry":"US","destinationRegion":"CA","limit":1,"affiliateLinkedOnly":true,"availableOnly":false,"sort":"default"},"requestedCeiling":80,"currency":"USD","matchingProductCount":1,"examinedProductCount":1,"hasMoreUnexaminedProducts":false,"examinedOptionCount":1,"unknownPriceOptionCount":0,"lowestExaminedExactOptionPrice":82.99,"amountAboveCeiling":2.99,"lowestPricedOptions":[{"productId":"keychron-6576777199705","productName":"Keychron K10 Wireless Mechanical Keyboard","variantId":"39426678325337","optionName":"RGB Backlight Aluminum Frame / Keychron Super Switch (Hot-Swappable) / Brown","price":82.99,"currency":"USD","sourceAvailable":false,"capturedAt":"2026-10-12T12:52:43.914619+00:00","availabilityCheckedAt":"2026-10-12T12:52:43.914619+00:00","sourceUrl":"https://www.keychron.com/products.json?limit=250&page=3","priceScope":"recorded-option-price-not-current-quote","shippingAssessment":{"destination":{"country":"US","region":"CA"},"scope":"merchant-published-policy-not-product-quote","policyStatus":"country-section-observed","blockedByPublishedPolicy":false,"reason":null,"countrySectionObserved":true,"remoteAreaChargeDeclaration":{"sourceUrl":"https://www.keychron.com/pages/shipping-policy","capturedAt":"2026-10-16T14:01:23.139778+00:00","sourceHash":"352508e0c89009be3af9c0f90b58ea2f734e70b136d257928e90c21cdde0ae30","sourceSection":"Remote Area Shipping Cost","namedUSRegionCodes":["PR","GU","VI"],"equivalentISOCountryCodes":["PR","GU","VI"],"sourceAmount":35,"sourceCurrencySymbol":"$","currency":null,"currencyScope":"Source paragraph uses $ without an explicit ISO currency code; never assumed or added to USD subtotal.","sourceText":"Puerto Rico, Guam, US Virgin Islands are required to pay $35 additional cost as per the quote from DHL. Shipping cost does NOT include extra costs defined as remote area shipping fees on DHL’s website.","otherRemotePostcodesMayBeCharged":true,"postcodeVerified":false,"buyerChargeConfirmed":false,"payableShippingAmount":null,"finalDeliveredTotal":null,"application":"postcode-dependent-not-verified","destination":{"country":"US","region":"CA"}},"sourceUrl":"https://www.keychron.com/pages/shipping-policy","capturedAt":"2026-10-16T14:01:23.139778+00:00","addressRestrictions":["APO, DPO and PO boxes excluded","Forwarding addresses excluded","Some Spanish provinces and European island addresses excluded; verify the exact address at merchant","Delivery address must be accepted by the merchant's carrier"],"productDeliveryAvailable":null,"postcodeVerified":false,"shippingAmount":null,"taxAmount":null,"deliveredTotal":null,"requiresMerchantQuote":true}}],"lowestPricedOptionsTruncated":false,"automaticFilterChange":false,"currentPriceVerified":false,"currentInventoryVerified":false,"deliveredTotal":null,"buyerSpendingAuthorization":false,"orderPlaced":false},"orderPlaced":false,"paymentCaptured":false,"commissionConfirmed":false,"candidates":[]}}]}