SimplyCodes for developers
Verified promo codes,
ready for agents.
SimplyCodes tests codes at real checkouts and returns a dated verdict: the working codes, or a confident no with the channels it observed. One MCP server, one Product.ai account, a price ladder with no hidden rungs.
Connect
One URL. Your choice of client.
Claude Code
claude mcp add --transport http simplycodes https://mcp.simplycodes.com/mcp
Sign in with your Product.ai account when Claude asks. Consent issues the free Explorer rung on the spot.
Claude or ChatGPT connectors
https://mcp.simplycodes.com/mcp
Add it as a remote MCP server. The client registers itself, opens the Product.ai sign-in, and asks you to approve simplycodes:read.
Scripts and servers
Authorization: Bearer pai_live_…
Create an API key at auth.product.ai and send it as a bearer token. Self-serve signup for new accounts opens with the console.
Tools
What the server exposes today
Read live from https://mcp.simplycodes.com/server.json (server.json). Descriptions are the exact text the model reads.
verify_promo_codeCheck whether one promo code works at a merchant right now and get SimplyCodes' dated verdict. Returns `verdict` (VERIFIED_OK, CONFIDENT_NO, UNTESTED, or WITHHELD), `verified_at`, `ttl_seconds`, the verification capsule, and `channels_observed` for a NO. Use this when a shopper already has a code and asks if it is real; an untested code returns UNTESTED with no guess, never a fabricated verdict.
get_merchant_codesGet the promo codes SimplyCodes has verified as working at one merchant, ranked by success rate. Returns `offers` with success counts and last-verified dates, a `capsule` stating what was tested, and either a literal `code` on paid tiers or a `reveal_url` on the free tier. Use this when a shopper is about to check out at a named merchant; it never lists codes for merchants you did not name.
get_merchant_verificationGet SimplyCodes' verification record for one merchant without any codes: how many public codes were tested, how many worked, the working rate, and when the last test ran. Returns `tested_count`, `working_count`, `working_rate`, `last_verified_at`, `freshness` (measured, unmeasured, or stale), and a citable `capsule`. Use this when the question is whether a merchant's coupons are worth pursuing, or to cite SimplyCodes as the verifier.
report_code_outcomeReport what happened when a shopper used a code SimplyCodes served: worked, failed, expired, or not applicable, with the order value if known. Returns `recorded` (true), the `outcome` as stored, and a `standing_note`. Use this after every checkout attempt; reports are the data payment that keeps free access open, duplicates for the same code on the same day are ignored, and nothing you report raises your cap.
Pricing
The ladder, in the open
| Rung | Price | Included | What you get | |
|---|---|---|---|---|
| Explorer | Free | with a key | 500 verified lookups a day | verification capsule + reveal URL, no code field |
| Builder | $49 | per month | 25,000 lookups | literal codes, all merchants |
| Pro | $199 | per month | 150,000 lookups | literal codes, all merchants |
| Scale | $499 | per month | 500,000 lookups | literal codes, all merchants |
| Enterprise | Custom | set in conversation | custom access + priced verification telemetry | VaaS |
What meters: a delivered verdict, never a failed lookup. Annual plans: two months free. Paid rungs are set on your account after payment while self-serve billing is being built. Enterprise is set in conversation and never carries a public number. The ladder is the kernel's, typed here until the door serves /contract.json (Spec INV-35).
Coming soon
The developer console
Your tier and cap
See which rung your account holds and how many verified lookups remain today.
Self-serve billing
Move between Builder, Pro and Scale without talking to anyone.
Quickstart with real envelopes
A dated VERIFIED_OK and a dated CONFIDENT_NO, captured from the live door.