Skip to content
MCP server

Coupon Swarm

Read and contribute public coupon codes from inside MCP-capable AI assistants

Pricing
Open source
Platforms
CLI, API
Version
0.1.0
Listing updated
today

Similar MCP servers

About Coupon Swarm

Coupon Swarm is an open-source MCP server for e-commerce. It is available on CLI and API.

The README describes this as a Python MCP server that lets assistants such as Claude Desktop, Claude Code, Cursor, Windsurf and Zed look up coupon codes from a shared public ledger. Lookups read the ledger directly from GitHub and are cached for five minutes, so no token is needed for browsing.

Writing is optional. With a GitHub personal access token scoped to the repository, the assistant can open issues to deposit single or batched codes and to report whether a code worked. The repository's intake workflow turns those issues into commits, so contributions stay visible and reviewable in the project's history.

The ledger is released under CC0. It suits people who want coupon data they can reuse, and developers who want to wire coupon lookups into an assistant without running their own database.

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

find_codes
Live codes from the public ledger, filtered by store, region, status and query.
get_ledger_stats
Counts per status, number of stores and last update time.
deposit_code
Opens a 'Deposit a coupon code' issue (requires token).
deposit_batch
Opens a JSON-batch issue of codes (requires token).
report_code
Opens a 'Report a code' issue on whether a code worked (requires token).

What it does

Live code lookup
Searches the ledger for codes filtered by store, region, status and free text.
Ledger statistics
Reports counts per status, the number of stores and the time of the last update.
Code deposits
Opens a GitHub issue to add one coupon code, with dates, through an authenticated tool call.
Batch submission
Accepts a JSON batch of codes in one issue for bulk contributions.
Success reporting
Lets users flag whether a stored code worked, which the intake workflow records.
Read-only mode
Works without a token; writes are only enabled when GITHUB_TOKEN is set.

Good for

  • Finding a currently listed discount code for a particular store while shopping with an assistant
  • Checking how many codes exist and when the ledger was last updated
  • Submitting codes found by a user to the shared public ledger
  • Reporting whether a stored code still works so others see accurate results
  • Building a coupon lookup into a custom assistant workflow using the MCP tools

Pricing

Open source

Free and open ledger; no paid plan mentioned.

Coupon Swarm FAQ

Does it need an account or token to search codes?

No. The README says the find_codes and get_ledger_stats tools need no token, and leaving out GITHUB_TOKEN gives a read-only setup.

How are deposited codes added to the ledger?

Writes open GitHub issues on the repository, and the repo's intake workflow turns those issues into commits.

What permission does the token need?

The README says it only needs issues: write on this one repo, and a fine-grained personal access token scoped to the repository is recommended.

What is the licence of the ledger data?

The registry entry describes the ledger as shared CC0 data.

Is Coupon Swarm free?

Yes. Coupon Swarm is open source, so you can use and self-host it for free.

What are the best alternatives to Coupon Swarm?

The closest alternatives to Coupon Swarm are Coupossum, Dealpuffin, CouponSwift, ZoZoPeak: Verified Coupons & Deals MCP and Pinchy.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.

How AIPoweredBot checks servers