{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json",
  "name": "com.simplycodes/simplycodes-mcp",
  "description": "Verified promo-code intelligence for shopping agents: SimplyCodes tests codes at real checkouts and returns a dated verdict — the working codes, or a confident no with the channels it observed. Sign in with a Product.ai account; a free Explorer tier is issued on consent.",
  "version": "0.1.0",
  "repository": {
    "url": "https://github.com/demandio/simplycodes-mcp",
    "source": "github"
  },
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://mcp.simplycodes.com/mcp"
    }
  ],
  "tools": [
    {
      "name": "verify_promo_code",
      "description": "Check 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."
    },
    {
      "name": "get_merchant_codes",
      "description": "Get 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."
    },
    {
      "name": "get_merchant_verification",
      "description": "Get 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."
    },
    {
      "name": "report_code_outcome",
      "description": "Report 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."
    }
  ]
}