Caramel documentation
Everything about the free, open-source Caramel coupon extension in one place: how to install it, how it finds and tests codes, what it does with your data, how to reach a human, and the machine-readable resources for AI agents.
What Caramel is
Caramel is a free, open-source, privacy-first browser extension that finds and applies coupon codes automatically at checkout. It does not sell browsing data and does not overwrite creators’ affiliate commissions.
It is free to use, with no paid tier and no account required to install. It is open source under the AGPL-3.0 license, built and maintained by Devino Solutions together with community contributors.
- Source code on GitHub
- Pricing: the plan structure: Caramel is free
- FAQ: the questions shoppers actually ask, answered
Install
Caramel is available for Chrome, Firefox, Microsoft Edge and Safari. Pick the store listing for your browser; no account is needed to install.
The Safari version ships through the App Store for Mac and for iPhone and iPad, and it is free there like every other version.
- Chrome: Chrome Web Store
- Firefox: Firefox Add-ons
- Microsoft Edge: Microsoft Edge Add-ons
- Safari: App Store
- All download options: the official store badges and what the installed extension does on each browser
How codes are found and tested
Caramel works in four steps while you shop:
- You shop normally; Caramel detects a supported store’s checkout page.
- It looks up known coupon codes for that store from its own catalog.
- It tries the codes at checkout and keeps the one with the best discount.
- It reports whether a code worked so the catalog’s rankings stay accurate.
Supported stores
Caramel’s catalog holds over 100,000 coupon codes across more than 4,000 online stores, and it is refreshed continuously as new codes are found and dead ones are retired.
You can search the supported stores, browse them A to Z, or open a store’s own page (for example /coupons/amazon.com) to see its codes.
- Supported stores: search the stores and see the ones added most recently
- Store directory A–Z: every store with live codes, by first letter
Using Caramel with an AI agent
Paste one sentence into Claude Code, Codex, Cursor, OpenCode or GitHub Copilot and it installs the Caramel coupon skill and verifies the public coupon API. No API key and no account are needed.
The coupon API is public, unauthenticated, read-only JSON: query it with ?site=<domain> or ?search=<text>, and resolve store domains with /api/coupons/stores?q=<prefix>. There is no Caramel MCP server or SDK; the browser extension itself is for you to install.
- Agent setup: the sentence to paste, and a guide for each supported agent
- Agent setup instructions (Markdown): the machine-readable instructions an agent follows
- Coupon API: public, read-only JSON
Privacy and data
Caramel never sells personal information and shares it only with the service providers named in its privacy policy, and ships no ads and no third-party trackers.
The extension talks only to Caramel’s own servers: at checkout on a supported store it fetches coupon codes for that store’s domain, sends page and cart context (page title and item names, never payment details) so the right category of codes is chosen, and reports whether a code worked. Settings and the optional sign-in are kept in the browser’s extension storage.
Sharing a code you typed at checkout is off by default and happens only if you agree.
- Privacy policy: what data Caramel does and does not collect
Support
Report a problem, request a feature, or ask a question on the support page. Tick “I’d like a reply” and a human replies within 1 business day.
Security reports use the same support page; /.well-known/security.txt points there.
- Contact support
- Discord community: ask other shoppers and follow updates; for anything about your account, use the support form
Machine-readable resources
Public pages with a Markdown alternate have a .md twin (this page: /docs.md; the home page: /index.md). Request a page with Accept: text/markdown to read the same content as Markdown.
- llms.txt: the short index of what Caramel is and where to look
- llms-full.txt: the same facts plus the FAQ questions and answers and a privacy summary, in one document
- Markdown twin of this page
- security.txt: how to report a security problem
- sitemap.xml
