Skip to main content
Glama
groupon-mcp

groupon-mcp

by chrischall

groupon-mcp

CI npm license

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

groupon_search_deals

Search or browse a city's deals

no

groupon_get_deal

One deal's detail, including each option's id and price

no

groupon_list_categories

Groupon's category taxonomy

no

groupon_healthcheck

One live request to Groupon, reporting what failed if anything did

no

groupon_view_cart

The items in your Groupon cart

yes

groupon_purchase

Add a deal option to your cart (after you confirm) and return the checkout URL

yes

groupon_clear_cart

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:

  1. 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 .sha256 file published beside it (shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256).

  2. 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

GROUPON_SESSION_COOKIE

unset

Full Cookie header from a signed-in www.groupon.com request, for the cart tools only. Leave unset to have the bridge pick up your session. Treat it like a password.

GROUPON_DISABLE_FETCHPROXY

unset

1 turns the browser-bridge path off; the cart tools then rely on GROUPON_SESSION_COOKIE.

GROUPON_GRAPHQL_URL

https://www.groupon.com/mobilenextapi/graphql

GraphQL endpoint override. The cart tools refuse any override that is not an https://*.groupon.com URL.

GROUPON_CACHE_TTL

60

Response-cache TTL for reads, in seconds (0 = off). Raise it if you hit rate limits.

FETCHPROXY_WS_PORT

37149

Concentrator port the ContextMint Bridge connects to. Every MCP on one machine shares it, so move it for all of them or none.

FETCHPROXY_WS_HOST

127.0.0.1

Bridge bind interface, a literal IP only. Keep on loopback; it exists for hosted deployments in their own network namespace.

FETCHPROXY_IDENTITY_DIR

~/.fetchproxy/identity/

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

MCP_CONFIRM_MODE

ask-user

What a write does on a client that cannot show a confirmation prompt (claude.ai, Claude Desktop). ask-user: two steps — the first call does nothing and returns a preview plus a token, and the model must get your approval in chat before calling again with it. auto: the same two steps, but the model may use the token after reviewing the preview itself. refuse: writes are refused on such clients. A client that can show prompts (Claude Code) always gets the real prompt, unless MCP_CONFIRM_ELICITATION=off. An unrecognised value is treated as refuse.

MCP_CONFIRM_ELICITATION

on

off never shows a confirmation prompt, so every client gets the MCP_CONFIRM_MODE behaviour. Set it for a client that says it can show prompts but never does (the write hangs — opencode 2.0.x). Any other value is treated as on, with a warning on stderr.

MCP_CONFIRM_TTL_SECONDS

600

How long a token stays valid.

MCP_CONFIRM_SECRET

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 + vitest

See CLAUDE.md for architecture, conventions, and gotchas.

License

MIT

Available Tools

7 tools
groupon_clear_cartA
Destructive

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_dealA
Read-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 reachabilityA
Read-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_categoriesA
Read-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_purchaseA
Destructive

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_dealsA
Read-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_cartA
Read-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

    A4.4/5.0

    Scored across 7 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityActive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A 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.
      6
      8
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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
    • F
      license
      Not graded
      quality
      B
      maintenance
      MCP server for NYC Restaurant Week, enabling search and lookup of participating restaurants, date checks, and filter options.
      -
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that acts as a shopping assistant, enabling product search, comparison, deal finding, and price history tracking via Hound web search.
      6
      MIT