Developers | McClipFace

What McClipFace is

McClipFace helps AI assistants get the shopper the lowest total for what they’re buying. Coupons are one tool: the McClipFace skill has the assistant compare the final price (shipping, tax and fees), then delivery and returns, and look beyond McClipFace. When a shopper is buying, asks for a code or compares stores, the assistant asks McClipFace and gets current coupon codes and no-code deals for that store or product. A lookup sends only the store or product name and the currency, never the cart, prices or who the shopper is. No account is needed.

Codes come from affiliate programs, brands directly and a licensed coupon data partner. Some links are affiliate links and may earn a commission at no added cost to the shopper. Codes aren’t guaranteed: store terms apply, and the store’s checkout has the final say.

MCP endpoints

https://mcclipface.com/mcpStreamable HTTP

The main connector. It’s listed on the official MCP Registry as co.getclippy/clippy (version 1.2.0), so registry clients can find it by that name.

https://mcclipface.com/mcp/readPublic

The same connector at a second address, with the same instructions, tools, schemas and results. Its lookup tools are read-only; the one write tool, report_coupon_result, is optional and off by default.

Full inputs, outputs, errors and examples are on the MCP server documentation page.

Tools

find_coupons: Look up current coupon codes and deals for one store the shopper names. Returns up to 20 offers, best first. An optional target_url returns a shopping link to a product page on that store.
find_product_coupons: Find current coupon codes for a specific product the shopper names, such as “Dyson vacuum”, across all the stores McClipFace covers.
discover_deals: The main tool for deals across stores when the shopper doesn’t name one store or product. Call it with no arguments for general deals, or with the categories or keywords the shopper stated.
get_dealsDeprecated: A current deal digest across stores. Use discover_deals instead; this tool keeps working for existing callers.
report_coupon_resultWrite: Record whether a McClipFace code or no-code deal worked at checkout. Not a lookup. Stores no personal or cart data. Optional and off by default (Private mode).

Add it to an assistant

ChatGPT: add the McClipFace app in ChatGPT.
Skill: run npx skills add https://mcclipface.com, or follow the setup steps and the install guide.
Any MCP client: add https://mcclipface.com/mcp as a remote server. No key or sign-in.

Public REST API

Base URL https://mcclipface.com. Every endpoint below is public and needs no key. The OpenAPI spec has the parameters and response fields.

GET /api/coupons: Coupon codes and deals for one store, or codes for a product across stores.
GET /api/deals: A current deal digest across stores.
POST /api/discover: Deals that match a shopper’s interests, without naming a store.
POST /api/deeplink: A tracked link to one product or search page at a store.
POST /api/reports/coupon: Report a confirmed coupon result (Community mode only).
GET /api/shop/proof: One live code for a store, for a proof card.
GET /api/activity/recent: Recently added US coupon codes, one event per store.
GET /api/stats: Public coverage numbers.
GET /api/version: The current McClipFace skill version.

Auth and rate limits

Auth: none. No account, API key or OAuth for the MCP endpoints or the public API.
MCP: 300 requests per minute per client IP address, with an overall cap of 3,000 requests per minute across all clients. report_coupon_result stores at most 30 reports an hour per client.
REST lookups: GET /api/coupons, GET /api/deals, GET /api/shop/proof and POST /api/deeplink allow 30 requests per caller per clock hour, or 600 when the User-Agent names a known AI assistant fetcher. Over the limit you get a 429 with Retry-After.

Contact

Building something with McClipFace, or found a bug? Email hello@mcclipface.com. McClipFace is operated by GetClippy LLC.