buyme-mcp-vercel

buyme-mcp-vercel

Public remote MCP server (Streamable HTTP) for searching Israeli businessesthat accept BuyMe (buyme.co.il) gift cards. Deployed on Vercel.

Live: https://buyme-mcp-vercel.vercel.appMCP endpoint: https://buyme-mcp-vercel.vercel.app/api/mcp

This repo holds two servers that share the same catalog:

• Cloud / remote (this Next.js app, app/api/[transport]/route.ts) — the publicStreamable HTTP endpoint any MCP client (Gemini, Claude, ChatGPT…) can use over theinternet. Search/lookup only; wallet reads are DISABLED_ON_CLOUD by design.
• Local / stdio (local-server/) — the server you run on your own machine, whereyour BuyMe token stays local and the wallet tools actually work. Seelocal-server/README.md andlocal-server/WALLET-SETUP.md.

Tools

Catalog tools (both servers):

• search_businesses — query (HE/EN) + filters: category, region, online_only, min_price, max_price, limit
• get_business — full detail + all products/prices for one id
• list_categories / list_regions — browse with counts

Wallet tools (local server only — the cloud server returns DISABLED_ON_CLOUD):

• list_my_giftcards — your cards: balance, code, expiry, redeem link, total
• wallet_summary — total, counts, value distribution, small cards to clear, expiry buckets
• giftcards_expiring — cards lapsing within N days (default 90), soonest first
• assemble_amount — which cards to combine to cover a target ₪ amount, lowest balance first

Connect

# Gemini CLI
gemini mcp add --transport http buyme https://buyme-mcp-vercel.vercel.app/api/mcp

# Claude Code
claude mcp add --transport http buyme https://buyme-mcp-vercel.vercel.app/api/mcp

Claude.ai / Claude Desktop: Settings → Connectors → Add custom connector →paste the endpoint URL.

Gemini API (google-genai) and other SDKs: point their MCP client transportat the same URL.

Architecture

app/api/[transport]/route.ts        MCP server (mcp-handler, Streamable HTTP) -> /api/mcp
app/page.tsx                         server: gathers endpoint + stats
app/_components/Landing.tsx          bilingual (HE/EN) UI, RTL toggle
lib/catalog.ts                       search / filter / lookup logic (shared)
lib/dataset.ts                       loads bundled data/buyme.json
scripts/scrape.mjs                   scraper -> data/buyme.json
.github/workflows/refresh-catalog.yml  weekly auto-refresh
data/buyme.json                      bundled catalog
local-server/                        local stdio MCP server (wallet tools; not part of the Vercel build)

Stateless Streamable HTTP — no Redis required. Node.js runtime.

Keeping the catalog fresh (automatic)

A GitHub Action (.github/workflows/refresh-catalog.yml) re-scrapes BuyMe everyMonday 04:00 UTC, and commits data/buyme.json only if it changed. The pushtriggers a Vercel production deploy, so the live site + MCP endpoint always servefresh data. No Vercel plan limits apply (the scrape runs on the GitHub runner, notin a serverless function).

• Run it on demand: GitHub → Actions → "Refresh BuyMe catalog" → Run workflow.
• Manual local refresh: node scripts/scrape.mjs && git commit -am "refresh catalog" && git push.

Caveat

Unofficial community index built from publicly available data on buyme.co.il.Not affiliated with BuyMe. Prices/terms/participating businesses may be stale —verify on the official site. Every tool response includes a _source attributionnote. The endpoint has best-effort per-instance rate limiting; for hard limitsadd Upstash/Vercel KV.