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.
