# Coupon Swarm

> Coupon Swarm is an open-source MCP server for e-commerce. Read and contribute public coupon codes from inside MCP-capable AI assistants. It is available on CLI and API.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Repository:** https://github.com/geo-coder-17/coupon-swarm/tree/HEAD/mcp
- **MCP Registry name:** io.github.Geo-Coder-17/coupon-swarm
- **Categories:** [e-commerce](https://ai-powered.com/categories/e-commerce)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Tools

- `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).

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

## Alternatives

- [Coupossum](https://ai-powered.com/mcp/coupossum): Coupossum is a free MCP server for e-commerce.
- [Dealpuffin](https://ai-powered.com/mcp/dealpuffin): Dealpuffin is a free MCP server for e-commerce.
- [CouponSwift](https://ai-powered.com/mcp/couponswift): CouponSwift is a free MCP server for e-commerce.
- [ZoZoPeak: Verified Coupons & Deals MCP](https://ai-powered.com/mcp/zozopeak-verified-coupons-and-deals-mcp): ZoZoPeak: Verified Coupons & Deals MCP is a free MCP server for e-commerce.
- [Pinchy](https://ai-powered.com/mcp/pinchy): Pinchy is a free MCP server for e-commerce.
- [CouponLlama: Shopper-Rated Promo Codes](https://ai-powered.com/mcp/couponllama-shopper-rated-promo-codes): CouponLlama: Shopper-Rated Promo Codes is a free MCP server for e-commerce.
- [Cratejoy MCP by usefulapi](https://ai-powered.com/mcp/cratejoy-mcp-by-usefulapi): Cratejoy MCP by usefulapi is a freemium MCP server for e-commerce.
- [ConsignCloud MCP by usefulapi](https://ai-powered.com/mcp/consigncloud-mcp-by-usefulapi): ConsignCloud MCP by usefulapi is a freemium MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/coupon-swarm
