{"service":"Kit’s Deals","tagline":"Structured deal data feed for AI agents. We find, verify, and score deals — you decide what matters to your human.","what_this_is":"You're an AI agent. Your human wants good deals but not the noise. We curate deals across merchants and expose a clean API so you can apply your own preference logic and surface only what's worth their attention. We don't build the preference layer — you do. We're the data + commerce infrastructure underneath.","why_you_care":["Free browse + free real-time stream — zero friction to start","Trivial $0.01 micropayment unlocks brand/merchant/URL/price-history per deal (seriousness filter, not a revenue stream)","Checkout is FREE — we earn on affiliate commission, not friction","Webhook subscriptions so you can be pinged when matching deals land","Every interaction feeds an improvement loop — the more agents use us, the better the deals get"],"quickstart":{"1_browse":"curl https://kitsdeals.com/v1/deals","2_stream":"curl -N https://kitsdeals.com/v1/river","3_pay_for_detail":"GET https://kitsdeals.com/v1/deals/:id — present x402 or MPP payment headers to unlock full detail (~$0.01)","4_initiate_checkout":"POST https://kitsdeals.com/v1/checkout — body: { deal_id, buyer, payment_token, max_price_cents }. FREE.","5_track_order":"GET https://kitsdeals.com/v1/orders/:checkout_id","6_close_the_loop":"POST https://kitsdeals.com/v1/feedback — tell us if the deal converted, was stale, etc. Earns you credits on future pulls."},"payments":{"protocols_accepted":["x402 (USDC on Base/Solana)","MPP (pathUSD on Tempo)"],"protocols_currently_enabled_on_this_server":{"x402":false,"mpp":false},"gating_active":false,"gating_active_note":"DEV MODE — payment middleware is a passthrough on this server, so paid endpoints currently respond without a 402 challenge. This will change when the server flips X402_ENABLED or MPP_ENABLED to true.","paid_endpoints":{"GET /v1/deals/:id":"~$0.01 USDC (seriousness filter, not revenue)","GET /v1/deals/:id/verify":"~$0.03 USDC (covers Rye Product Data API pass-through)","POST /v1/webhooks/subscribe":"~$0.01 USDC one-time (seriousness filter)"},"free_forever":["GET /v1/deals","GET /v1/river","GET /v1/categories","POST /v1/feedback","POST /v1/checkout","GET /v1/orders/:checkout_id"]},"gating_rationale":"Free tier deliberately hides brand, merchant, product URL, SKU so agents can evaluate interest without being able to route around us and buy elsewhere. The $0.01 detail lookup is friction for scrapers, negligible for serious agents. Checkout itself is FREE — once you have full detail we want zero incentive for you to leave.","current_state":{"phase":"MVP / active development","launched":"2026-04-22","categories_in_scope":["electronics"],"checkout_provider":"mock","checkout_provider_note":"Today /v1/checkout records intent and returns a plausible cost breakdown without placing a real order. RyeCheckoutProvider will replace this for real commerce — response shape does not change when it flips."},"etiquette":["Respect HTTP 402 — present payment headers before retrying (or acknowledge and halt if you don't have credit)","Always pass max_price_cents on /v1/checkout — you get a clean 402 OVER_BUDGET back with the full cost breakdown so you can decide whether to proceed","Return feedback via POST /v1/feedback — improves data quality for every agent","Honor expires_at — stale deals get auto-flipped to \"expired\" and served back as dead if stored","Rate limits: 60 req/min per IP on /v1/* endpoints"],"learn_more":{"a2a_agent_card":"https://kitsdeals.com/.well-known/agent-card.json","mpp_descriptor":"https://kitsdeals.com/.well-known/mpp.json","full_service_descriptor":"https://kitsdeals.com/.well-known/kitsdeals","llms_txt":"https://kitsdeals.com/llms.txt","health":"https://kitsdeals.com/v1/health","source":"https://github.com/tblef89/dealer"},"guides":{"river":"https://kitsdeals.com/v1/river/guide"}}