Repository avatar
AI Tools
v0.1.0
active

deals

com.blackfridaymcp/deals

Live Amazon.com (US) deals in your AI chat: search deals, check a price, trending, gift ideas.

Documentation

Black Friday MCP

A free remote MCP server. Your AI assistant searches live Amazon.com (US) prices and deals and checks whether a discount is real.

  • Server URL: https://blackfridaymcp.com/mcp
  • Website and setup guides: https://blackfridaymcp.com
  • No account, no API key. Connect once with one-click OAuth.

Tools

All four are read-only.

ToolWhat it does
search_dealsLive prices and discounts for a shopping question, in-stock items only
check_dealOne product: current price, Amazon's reference price and its type, and a plain verdict on how strong the discount evidence is
get_trending_dealsDiscounted in-stock items in a category, ranked by how trustworthy the discount evidence is
gift_ideasTurns 1–3 gift ideas into in-stock picks under a per-gift budget

Full input schemas: https://blackfridaymcp.com/developers

How it works

  • Cloudflare Workers, TypeScript, agents (createMcpHandler), Streamable HTTP, stateless.
  • OAuth 2.1 via @cloudflare/workers-oauth-provider: dynamic client registration, client ID metadata documents, PKCE. Consent mints an anonymous install ID.
  • One Durable Object (Gate) is the only caller of the Amazon Creators API: pacing, daily budget, per-install caps, request coalescing.
  • KV cache: results up to 24 hours, offers 1 hour. No price history, no image bytes, Amazon URLs passed through untouched.

Data and money

Amazon.com (US) only, prices in USD, from the Amazon Creators API. Free to use. As an Amazon Associate, Black Friday MCP earns from qualifying purchases. Not affiliated with Amazon.

Privacy: https://blackfridaymcp.com/privacy

Develop

cp .dev.vars.example .dev.vars   # Amazon Creators API credentials (never commit)
npm install
npm test
npm run typecheck
npm run dev                                  # local HTTPS on 127.0.0.1:8787 (self-signed)
npm run test:e2e -- https://127.0.0.1:8787   # DCR → consent → PKCE token → initialize → tools/list
npm run smoke                                # live Amazon token + a few lookups

Runtime config (no redeploy): KV key config in CACHE_KV; keys and defaults in src/config.ts.

License

MIT. See LICENSE.

No installation packages available.

Remote