Black Friday MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Black Friday MCP
An agent-first Black Friday deal feed for Skroutz (Greece), served as a remote MCP server with llms.txt, copy-ready prompts and a fast web UI.
Agents discover and filter deals here, verify prices and build the cart with Skroutz's own Skroutz Shopping MCP connector, and the human does the paying. Nothing in this project can make a purchase.
Independent project, not affiliated with or endorsed by Skroutz. Deal data comes from Skroutz and changes without notice: always confirm the live price on Skroutz before paying.
Sources
Each source is one small file. Today:
Source | How | Notes |
Skroutz | official Skroutz Shopping MCP connector (OAuth, one-time local sign-in) | agents can fill a Skroutz cart |
BestPrice | official open MCP ( | compares Greek shops (Kotsovolos, Public, ...); shown as each deal's |
Adding Amazon or any other marketplace is a new provider file plus one line in a registry. See docs/ADDING_A_SOURCE.md, which also records which Greek and global marketplaces have MCPs today.
Related MCP server: CartScout MCP server
How it works
The app itself fetches fresh prices from every source and caches them. No cron job, no external routine: it is plain Next.js 16 Cache Components with ISR-style revalidation.
lib/providers/* one Provider per source (fetchDeals → Deal[])
lib/deals-source.ts providerSnapshot(id): "use cache" + cacheLife + cacheTag, one cache entry per source
getSnapshot(): merges all enabled sources (+ per-source status)
/ web UI (static shell, rebuilt in the background when a source's cache goes stale)
/api/deals JSON + filters /api/mcp MCP server /llms.txt agent docsCache lifetime (
next.config.ts):deals: { stale: 300, revalidate: 3600, expire: 86400 }. After an hour the next request is served the cached prices instantly while a fresh fetch runs in the background. A source can set its ownrefreshSeconds(BestPrice uses 6h to stay inside its free tier).Independent sources: each source is cached on its own, so a slow, broken or rate-limited source never blocks or hides the others.
Failure handling: a failed refresh serves the last good snapshot (or bundled sample data), labelled cached / sample, and retries in 5 minutes. A
429backs off for theRetry-Afterthe source sent (capped at 6h).The page, the JSON API and the MCP tools read the same cached functions, so they always agree.
MCP tools (read-only)
Tool | Purpose |
| Filter by |
| Look up or compare deals by id ( |
| Facets, source status (live / cached / sample, can it fill a cart) and campaigns |
| When prices were last fetched, per source |
| Best deal per wishlist item within a budget, plus how to verify and buy each |
| Renders a basket / cart UI (images, totals, add-to-Skroutz-cart and go-to-cart buttons). Never buys |
| Recommended system prompt |
Endpoint: /api/mcp (Streamable HTTP, no auth). Also: /llms.txt, /llms-full.txt, /.well-known/mcp.json, /api/deals, /api/status.
claude mcp add --transport http blackfriday https://<your-site>/api/mcp
claude mcp add --transport http skroutz https://api.skroutz.gr/api/agents/mcp/shoppingMCP App UI
search_deals, get_deal, compare_deals, build_shopping_plan and show_basket also return structured data and point at a widget (ui://blackfriday/deals.html, source in lib/ui/widget.ts). Hosts that support MCP Apps render product cards with images, an add-to-basket button, a basket and a cart view. Other clients just get JSON.
The widget never buys and cannot touch the user's real cart (that needs the user's own sign-in). Its Add to Skroutz cart button asks the assistant to run the Skroutz Shopping connector's add_to_cart; the assistant then calls show_basket with the returned cart_url, and the widget shows Go to Skroutz cart & pay. Links and images are host-allowlisted (Skroutz, BestPrice) and everything is rendered with textContent.
Run your own
1. Deploy
Import the repo into Vercel as a Next.js project.
Add a Blob store and connect it to the project (sets
BLOB_READ_WRITE_TOKEN).Add
ADMIN_SECRETas a Sensitive env var:openssl rand -hex 24.
Until step 2 is done the Skroutz source shows bundled sample data; BestPrice needs no setup.
2. Connect Skroutz (one time)
Skroutz's connector uses OAuth for each account, so the server needs a refresh token once. Run this on your own machine:
node scripts/skroutz-auth.mjsIt registers an OAuth client, opens the Skroutz sign-in, and prints three values. Add them to Vercel as Sensitive env vars and redeploy:
SKROUTZ_CLIENT_ID=...
SKROUTZ_CLIENT_SECRET=...
SKROUTZ_REFRESH_TOKEN=...Nothing is written to disk and nothing should ever be committed.
Environment variables
Name | What it is |
| Vercel Blob token (last good snapshot + encrypted tokens) |
| Password for the |
| From |
| Optional comma list to restrict which sources run, e.g. |
| Optional, default |
.env* is git-ignored; only .env.example (empty values) is tracked.
Security notes
Use a dedicated Skroutz account. The Skroutz connector's scope also covers carts, orders and addresses. This app only ever calls
search_deals(seelib/skroutz/deals.ts), but the token itself is powerful, so don't use your personal account.BestPrice rate limits. Its free tier caps unidentified clients per day (HTTP 429). The provider identifies itself, spends about 55 calls per refresh and refreshes every 6h. For hourly data contact feedback@bestprice.gr.
Skroutz rotates refresh tokens; the newest one is stored AES-256-GCM encrypted (key derived from
ADMIN_SECRET) under an unguessable Blob path. RotatingADMIN_SECRETmeans re-running the sign-in script.POST /api/refresh(BearerADMIN_SECRET, or the form on/admin) forces a rebuild on the next request. The hourly refresh is request-driven; to guarantee it without traffic, call that endpoint from any scheduler.
Design notes
The UI follows Emil Kowalski's design-engineering principles: strong ease-out curves, 150–250ms transitions on transform and opacity only, press feedback on buttons, hover effects gated to hover-capable devices, and prefers-reduced-motion support.
Connect your agent
Claude, ChatGPT / GPT, Codex, Grok (xAI), Cursor, VS Code, Windsurf, Gemini CLI, Cline, Zed and any other MCP client: see docs/CONNECT.md (copy-paste commands and JSON/TOML configs) or /agents on a running site.
Contributing
Issues and PRs are very welcome: read CONTRIBUTING.md for setup, ground rules (read-only, no secrets, no scraping, be rate-limit friendly) and a list of the most useful things to build next. New deal sources are one small file: docs/ADDING_A_SOURCE.md.
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only shopping decisions, product search, offers, and price history for Greece.
Free, read-only price comparison for products sold in Australia. Search products, browse categories, open a product with every seller's current price (eBay Australia, Amazon, JB Hi-Fi and more), and compare two products head to head. No login or API key. Answers come from Lianex's cached catalogue, so they are fast and never place an order or change anything. Docs: https://lianex.ai/developers
Read-only product catalog for shopping agents: search, details, compatibility, shop answers.
Read-only product catalog for shopping agents: search, details, compatibility, shop answers.
Related MCP Servers
- AlicenseAqualityBmaintenanceProvides live product search, offer comparison, and price history retrieval from BestPrice.gr through three read-only tools, enabling AI applications to query shopping data without an API key.49Apache 2.0
- AlicenseAqualityBmaintenanceEnables AI agents to retrieve live product prices, stock, variants, and deal ratings from Shopify, WooCommerce, Walmart, eBay, and Amazon by pasting product links and asking about price, availability, or comparisons.427 PyPI1MIT

datawebot MCP serverofficial
AlicenseNot gradedqualityBmaintenanceEnables AI agents to search products across online shops worldwide and retrieve each seller's price, shipping total, delivery note, rating, and direct product link.3MIT- AlicenseNot gradedqualityBmaintenanceEnables product search, full product detail, category browsing, page fetching and price comparison across 26 Australian online retailers plus a price-comparison site and AliExpress, from a single process or a chosen subset of sites. It is read-only, rate-limited and cached, with site-prefixed tools and URL restrictions that keep fetching on-adapter.MIT