groupon-mcp
An MCP server that lets Claude search and browse Groupon deals, and (with your signed-in session) view or modify your Groupon cart — though it never completes payment for you.
Search/browse deals (
groupon_search_deals): free-text query or city browse, by division slug, with limit/offset pagination and compact or full views — no sign-in.Get a deal (
groupon_get_deal): one deal's details by slug or URL, including every option's id and price (needed for purchase) — no sign-in.List categories (
groupon_list_categories): Groupon's category taxonomy tree — no sign-in.Healthcheck (
groupon_healthcheck): one live request reporting the credential source, whether Groupon accepted it, latency, and a plain-English hint on what broke.View cart (
groupon_view_cart): the items in your signed-in Groupon cart — requires sign-in.Add to cart (
groupon_purchase): adds a chosen deal option/quantity (optionally as a gift), verifies the line, and returns the checkout URL; it cannot place the order — requires sign-in and confirmation.Clear cart (
groupon_clear_cart): removes all line items, with an optionalexpectedOptionIdsguard so it refuses if the cart changed — requires sign-in and confirmation.Confirmations: writes show a prompt where supported, otherwise a two-step preview +
confirmTokenflow (configurable viaMCP_CONFIRM_*); sessions come fromGROUPON_SESSION_COOKIEor the browser bridge.
Provides tools for searching and browsing local, goods, and travel deals on Groupon.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@groupon-mcp What are the best local deals in Austin?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
groupon-mcp
MCP server for Groupon — search and browse local, goods, and travel deals from Claude via natural language, and add deals to your signed-in Groupon cart once you confirm.
This project was developed and is maintained by AI. Use at your own discretion.
Tools
Tool | What it does | Needs sign-in |
| Search or browse a city's deals | no |
| One deal's detail, including each option's id and price | no |
| Groupon's category taxonomy | no |
| One live request to Groupon, reporting what failed if anything did | no |
| The items in your Groupon cart | yes |
| Add a deal option to your cart (after you confirm) and return the checkout URL | yes |
| Remove every item from your cart (after you confirm) | yes |
The deal reads use Groupon's public consumer endpoint with no API key or account. The cart tools act on your signed-in Groupon account through its session cookie (see below). groupon_purchase cannot place an order: Groupon's checkout is native Apple/Google Pay, card or PayPal, so you complete payment yourself at the checkout URL.
Related MCP server: Groupon MCP Server
Setup
Add the server to your .mcp.json:
{
"mcpServers": {
"groupon": {
"command": "npx",
"args": ["-y", "groupon-mcp"]
}
}
}Cart sign-in (optional)
Reading deals needs no account. The cart tools (groupon_view_cart, groupon_purchase, groupon_clear_cart) use your signed-in groupon.com session, which the server picks up from your browser through the ContextMint Bridge extension:
Install ContextMint Bridge from its releases page. Chrome: download the Chrome zip, unzip it, and load it unpacked at
chrome://extensions(Developer mode). Safari isn't available yet (it will ship inside the ContextMint app, which has no public download), so use Chrome for now.ContextMint Bridge is the fetchproxy browser extension under its new name, from the same maintainer; fetchproxy's own README (https://github.com/chrischall/fetchproxy#extension) points to it. Its source is public at https://github.com/nullnet-app/contextmint-bridge: build it yourself, or check a release zip against the
.sha256file published beside it (shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256).Sign in at groupon.com in that browser. The first cart call lifts the session cookie; approve the request in the extension when asked.
For local dev without the extension, set GROUPON_SESSION_COOKIE (see .env.example); set GROUPON_DISABLE_FETCHPROXY=1 to turn the browser path off. The cookie authorizes changes to your cart, so treat it like a password. The cart tools only send it to an https://*.groupon.com endpoint, and refuse a GROUPON_GRAPHQL_URL override pointing anywhere else.
Environment
All optional; they mirror the .mcpb manifest's settings (the MCP_CONFIRM_* family is under Confirmations).
variable | default | |
| unset | Full |
| unset |
|
|
| GraphQL endpoint override. The cart tools refuse any override that is not an |
|
| Response-cache TTL for reads, in seconds ( |
|
| Concentrator port the ContextMint Bridge connects to. Every MCP on one machine shares it, so move it for all of them or none. |
|
| Bridge bind interface, a literal IP only. Keep on loopback; it exists for hosted deployments in their own network namespace. |
|
| Absolute path for the bridge's long-term identity keypair. |
Confirmations
The cart writes (groupon_purchase, groupon_clear_cart) ask you to confirm before they change anything. A client that can show a confirmation prompt (Claude Code) shows one, unless the server sets MCP_CONFIRM_ELICITATION=off. Elsewhere, the first call changes nothing and returns a preview plus a confirmToken, and only a repeat call with that token proceeds. The token is tied to exactly what was previewed: if the deal's price, the chosen option or quantity, or the cart's contents change between the two calls, the write is refused and a fresh preview is returned. groupon_purchase's preview also shows how many of that option are already in your cart, since Groupon may set the line to the new quantity rather than add to it. It still only fills the cart; you complete payment yourself at the checkout URL. groupon_clear_cart removes only the cart's line items, and accepts the previewed optionIds back as expectedOptionIds so it refuses if the cart has changed; if a removal fails partway it says which items were and were not removed.
variable | default | |
|
| What a write does on a client that cannot show a confirmation prompt (claude.ai, Claude Desktop). |
|
|
|
|
| How long a token stays valid. |
| random per process | Signing key; set it only if tokens must survive a server restart. |
Development
npm install
npm run build # tsc + esbuild bundle → dist/
npm test # tsc typecheck + vitestSee CLAUDE.md for architecture, conventions, and gotchas.
License
MIT
Available Tools
7 toolsgroupon_clear_cartADestructive
Remove ALL items from your signed-in Groupon cart. Once confirmed it removes every line item and re-reads the cart to verify it is empty. Asks the user to confirm first: a confirmation prompt where the client supports one; otherwise the first call returns a preview and a confirmToken, and only a repeat call with that token proceeds (see MCP_CONFIRM_MODE).
Inputs: confirmToken, expectedOptionIds.
groupon_get_dealARead-only
Fetch a single Groupon deal by its permalink slug (or full deal URL). Returns the slim projection by default (title, subtitle, merchant, price, rating, division, url, and every option's id/title/price/isSoldOut — pass an option id to groupon_purchase); set view="full" for Groupon's whole record.
Inputs: dealId (required), view, optionId.
groupon_healthcheckVerify credentials and upstream reachabilityARead-onlyIdempotent
Resolves the credential the way real tools do, then makes one authenticated request to www.groupon.com. Reports which source supplied the credential, whether www.groupon.com accepted it, the round-trip time, and a plain-English hint distinguishing 'no credential' from 'credential rejected' from 'a www.groupon.com-side problem'. Read-only; never returns the credential itself. Call this when a real tool fails and you want to know which hop broke.
Inputs: no named parameters.
groupon_list_categoriesARead-only
Fetch Groupon's category taxonomy tree. Returns a slim {title, url, children} tree by default; set view="full" for Groupon's whole payload.
Inputs: view.
groupon_purchaseADestructive
Add a Groupon deal option to your cart, ready for checkout. Once confirmed it adds the item, re-reads the cart to verify the line quantity, and returns the checkout URL for YOU to complete payment. It CANNOT place the order — Groupon checkout is native Apple/Google Pay, card, or PayPal. Asks the user to confirm first: a confirmation prompt where the client supports one; otherwise the first call returns a preview and a confirmToken, and only a repeat call with that token proceeds (see MCP_CONFIRM_MODE).
Inputs: dealId (required), isGift, optionId, quantity, +1 more.
groupon_search_dealsARead-only
Search or browse Groupon deals for a city (division). Pass query for a free-text search (e.g. "massage", "pizza"); omit it for a plain category/city browse. Returns slim deal summaries by default; set view="full" for Groupon's whole cards.
Inputs: view, limit, query, offset, +1 more.
groupon_view_cartARead-only
View the items currently in your signed-in Groupon cart. Requires a Groupon session (GROUPON_SESSION_COOKIE, or the fetchproxy browser bridge signed into groupon.com).
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct resource and action: search vs. single-deal fetch, cart view vs. cart clear vs. purchase, taxonomy listing, and a diagnostic. The boundary between search_deals and list_categories is clarified by the descriptions (free-text/option browse vs. raw taxonomy tree), so an agent can select reliably.
All seven tools share the groupon_ prefix followed by a consistent verb_noun pattern (search_deals, get_deal, list_categories, purchase, clear_cart, view_cart, healthcheck). No mixed casing or divergent verb styles.
Seven tools is well-scoped for a deals/browsing-plus-cart server. Each tool earns its place (browse, detail, taxonomy, purchase, cart view/clear, health), with no redundant or filler entries.
Core lifecycle is covered: discovery (search/deal/categories), cart read (view_cart), cart write (purchase, clear_cart), and diagnostics. The main gap is granular cart editing—no remove-single-item or quantity-update—but clear-all plus re-add lets agents work around it.
Maintenance
Related MCP Connectors
MCP server for searching Airweave collections with natural language queries.
Unofficial read-only MCP server for VeryChic hotel offers
Public MCP server for discovering open jobs. Search, filter, and get application links.
Geo-based flight search MCP server. Find more flights between any two places on earth
Related MCP Servers
- AlicenseBqualityDmaintenanceA Model Context Protocol server that aggregates and compares deals from multiple sources including Slickdeals, RapidAPI marketplace, and web scraping, enabling users to search, filter, and compare deals through a chat interface.68MIT
- AlicenseNot gradedqualityDmaintenanceProvides MCP tools for discovering Groupon-style deals (search, get, compare) for customers, and additionally merchant intelligence tools (category insights, market gaps, price positioning) for logged-in merchants.ISC
- FlicenseNot gradedqualityBmaintenanceMCP server for NYC Restaurant Week, enabling search and lookup of participating restaurants, date checks, and filter options.-
- AlicenseAqualityDmaintenanceMCP server that acts as a shopping assistant, enabling product search, comparison, deal finding, and price history tracking via Hound web search.6MIT