{"name":"Kit’s Deals","coverage":{"top_levels":["Electronics","Baby & Toddler","Cameras & Optics"],"served_lineages":[{"taxonomy_id":201,"taxonomy_path":"Apparel & Accessories > Jewelry > Watches"},{"taxonomy_id":436,"taxonomy_path":"Furniture"},{"taxonomy_id":1897,"taxonomy_path":"Hardware > Heating, Ventilation & Air Conditioning > HVAC Controls > Thermostats"},{"taxonomy_id":1218,"taxonomy_path":"Hardware > Power & Electrical Supplies > Generators"},{"taxonomy_id":500009,"taxonomy_path":"Health & Beauty > Health Care > Biometric Monitors > Activity Monitors"},{"taxonomy_id":536,"taxonomy_path":"Home & Garden"},{"taxonomy_id":922,"taxonomy_path":"Office Supplies"},{"taxonomy_id":2092,"taxonomy_path":"Software"},{"taxonomy_id":1239,"taxonomy_path":"Toys & Games"}],"covered_areas":["Electronics","Baby & Toddler","Cameras & Optics","Apparel & Accessories > Jewelry > Watches","Furniture","Hardware > Heating, Ventilation & Air Conditioning > HVAC Controls > Thermostats","Hardware > Power & Electrical Supplies > Generators","Health & Beauty > Health Care > Biometric Monitors > Activity Monitors","Home & Garden","Office Supplies","Software","Toys & Games"],"retailer_count":54,"as_of":"2026-10-25","note":"These are sourcing areas, not a guarantee that a watch is actively matching. Check coverage and request_delivery.readiness on the watch. A served sub-lineage does not imply coverage of its entire top level."},"description":"Structured deal data feed for AI agents. Offload deal discovery — running it yourself burns hundreds of thousands of tokens a day and gets blocked by retailer anti-bot defenses. We find, verify, and score deals centrally; you decide what matters.","version":"0.1.0","attribution_contract":"`product_url` is the human purchase link. Present it to the human; do not fetch, prefetch, unfurl, or follow it, and do not simulate clicks on it. Use `product_url_canonical` (or `detail_url`) for any automated need - verification, deduplication, or price checks. A commissionable session begins only when a human selects the disclosed retailer link. Convey the `disclosure` string alongside the link.","payment_protocols":{"live":["x402 (Base mainnet — USDC)","x402 (Solana mainnet — USDC)"],"coming_soon":["MPP (Tempo — pathUSD) — Phase 2"],"stack":"Powered by @x402/express v2 + @coinbase/x402 facilitator (Coinbase CDP). One CDP config covers both EVM (Base) and SVM (Solana) verify/settle. Auto-auths via CDP_API_KEY_ID / CDP_API_KEY_SECRET env vars."},"pricing":{"deal_summary_free_tier":{"price":"free","endpoint":"GET /v1/deals?limit<=10","note":"On-ramp / discovery tier — up to 10 results per call, no payment"},"deal_summary_bulk_tier":{"price":"0.01 USDC","endpoint":"GET /v1/deals?limit>10","note":"Bulk snapshots. Use /v1/river (SSE) or /v1/webhooks (push) for free high-volume consumption instead."},"deal_detail":{"price":"free","endpoint":"GET /v1/deals/:id","note":"Full detail (brand, merchant, URL, price history, SKU). Free as of PR 48."},"deal_verify":{"price":"0.03 USDC","endpoint":"GET /v1/deals/:id/verify","note":"Wraps Rye Product Data API for real-time freshness/availability. Wired and the paywall fires, but the underlying Rye integration is currently a placeholder — returns availability=unknown today. Skip in agent flows; deal data on /:id is current as of last refresh worker pass."},"webhook_subscribe":{"price":"free","endpoint":"POST /v1/webhooks/subscribe","note":"Free since PR 44 (one-time fee removed). Delivery free forever."},"river":{"price":"free","endpoint":"GET /v1/river","format":"SSE"},"kits_picks":{"price":"free","interactive_endpoint":"GET /v1/picks","recurring_endpoint":"GET /v1/feeds/highlights.atom","format":"JSON + Atom 1.0","note":"Optional hand-picked discovery. Advertise it, never enable automatically; it works standalone or alongside specific watches."},"feedback":{"price":"free","endpoint":"POST /v1/feedback","note":"GET /v1/feedback describes the fields and outcomes. A human operator reads every report."},"mcp":{"price":"free","endpoint":"POST https://mcp.kitsdeals.com","note":"All 7 MCP tools are free; there is no paid tool. Watch creation is capped at 10 per hour per IP because each watch triggers interpretation work."}},"consumption_modes":{"mcp":{"description":"Native MCP server for Claude.ai connectors, Claude Desktop, Claude Code, Cursor and any streamable-HTTP MCP client. Interactive pull surface: the tools wrap the same search / watch / feedback libraries as REST. register_watch returns the same delivery channels as POST /v1/watches; check_watch is the pull for live matches. Recurring delivery still uses river, webhooks or Atom.","endpoint":"https://mcp.kitsdeals.com","transport":"streamable-http","auth":"none","stateless":true,"tools":["search_deals","latest_deals","get_deal","register_watch","check_watch","cancel_watch","report_outcome"],"protocol_revisions":"serves the handshake-free 2026-07-28 revision and the earlier handshake revisions (2025-11-25 back to 2024-10-07); the MCP-Protocol-Version header is required on non-initialize messages per the spec","connect":{"claude_ai":"Settings → Connectors → Add custom connector → paste the endpoint URL","claude_code":"claude mcp add --transport http kitsdeals https://mcp.kitsdeals.com","human_guide":"/connect"},"registry":{"name":"com.kitsdeals/deals","host":"registry.modelcontextprotocol.io"}},"river":{"description":"SSE stream — real-time deal flow, agent filters client-side","endpoint":"/v1/river","guide":"/v1/river/guide"},"rest":{"description":"REST API — batch pulls with pagination and filters","endpoint":"/v1/deals"},"webhooks":{"description":"Push — register filters, receive matching deals at your callback URL","endpoint":"/v1/webhooks/subscribe"},"kits_picks":{"description":"Optional hand-picked discovery — bounded JSON for interaction and complete public Atom for recurring membership. Start only after explicit opt-in; standalone or alongside watches; dedupe by deal id.","interactive_endpoint":"/v1/picks","recurring_endpoint":"/v1/feeds/highlights.atom"}},"delivery_policy":{"editorial_vs_intent":"PR 433 — broadcast surfaces (default listing, SSE river, global Atom, broadcast webhooks, MCP latest_deals) carry only deals worth anyone's attention; intent-bound surfaces (q= search, watch-bound channels, MCP search_deals) ALSO carry availability-only matches (price-target hits at ~0% discount, exactly what the watcher asked for). Below-floor rows carry intent_match_only: true so agents can frame them as \"matched your target,\" not as a markdown.","include_below_floor":"Completeness opt-ins: GET /v1/deals?include_below_floor=1 surfaces both tiers on the listing (default response flags broadcast_floor_applied:true); POST /v1/webhooks/subscribe with filters.include_below_floor:true includes availability-only events on webhook delivery.","floor_definition":"Default: deal is broadcast-quality unless discount_pct < BROADCAST_MIN_DISCOUNT_PCT (5) AND COALESCE(deal_score,0) < BROADCAST_MIN_SCORE (10). Env-tunable; killswitch BROADCAST_FLOOR_DISABLED=1."},"guides":{"index":"/v1/guides","river":"/v1/river/guide","webhooks":"/v1/webhooks/guide","x402_privy":"/v1/guides/x402/privy","x402_base_native":"/v1/guides/x402/base-native","x402_faremeter":"/v1/guides/x402/faremeter","x402_solana_native":"/v1/guides/x402/solana-native","x402_bulk_listings":"/v1/guides/x402/bulk-listings","x402_webhook_subscribe":"/v1/guides/x402/webhook-subscribe"},"checkout":{"enabled":false,"note":"Kit's Deals does not offer checkout or order tracking. Follow the deal's product_url to purchase at the retailer."},"server_status":{"checkout_enabled":false,"payment_gating_active":true,"payment_gating_note":"Paid endpoints return HTTP 402 with an x402 challenge whose accepts array lists every configured rail (Base mainnet, Solana mainnet, or both). Powered by @x402/express v2 + Coinbase CDP facilitator.","payment_protocols_enabled":{"x402_base":true,"x402_solana":true,"mpp_tempo":false}},"discovery":{"welcome":"/","quickstart":"/v1/quickstart","agent_card":"/.well-known/agent-card.json","mpp":"/.well-known/mpp.json","llms_txt":"/llms.txt","mcp_server":"https://mcp.kitsdeals.com","mcp_connect_guide":"/connect","openapi":"/openapi.json","health":"/v1/health","source":"https://github.com/tblef89/dealer"},"legal":{"entity":"Private Key Commerce LLC","jurisdiction":"Wyoming, USA","notice":"Kit’s Deals is a division of Private Key Commerce LLC, a Wyoming Limited Liability Company.","privacy_policy":"https://kitsdeals.com/privacy/","privacy_policy_json":"https://api.kitsdeals.com/privacy.json"}}