Integration

Coupontools integration

Coupontools is a digital coupon platform. List and read coupons (campaigns) with their redeem locations, switch a coupon between example and active, list, search, read, update, validate, void and delete coupon sessions (the unique copy of a coupon each consumer gets), create single-use coupon URLs one by one or in bulk, send a coupon by email or text message through the account's connected marketing platform, push a notification to wallet users, manage subaccounts and the SMS and email contact groups, and check a webhook event by its id. Every call is a POST, reads included. Left out: single sign-on and password reset links (they log someone in), session barcodes (no documented answer), and the version 4 directories and wallet loyalty cards, which take their keys in other headers. Redeem location passwords, location PIN codes and subaccount API keys are stripped from answers. Authentication is the REST API client ID and client secret, found under Integrations, REST API in the Coupontools dashboard, sent in the X-Client-Id and X-Client-Secret headers.

Connect Coupontools How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Coupontools.Built from the 31 Coupontools tools below, on the connection you add once.

What you can do with Coupontools

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Coupon session, 10 operations

delete_coupon_sessionDelete coupon sessionPOSTDeletes one session of a coupon: the unique copy one consumer received.
get_coupon_sessionGet coupon sessionPOSTReturns one coupon session: its URL, sequence id and custom id, open, claim, validation, void and lock states with dates, the redeem location, the consumer's details and the coupon. Personal data.
list_claimed_sessionsList claimed sessionsPOSTLists only the sessions of a coupon that were claimed, 100 per page, with the same fields as list_coupon_sessions (states, dates, redeem location and the consumer's details). Personal data.
list_coupon_sessionsList coupon sessionsPOSTLists the sessions of a coupon (one per consumer copy), 100 per page: session code, sequence id, open, claim, validation, void and lock states with dates, redeem location, and the consumer's details. Personal data.
list_opened_sessionsList opened sessionsPOSTLists only the sessions of a coupon that were opened, 100 per page, with the same fields as list_coupon_sessions (states, dates, redeem location and the consumer's details). Personal data.
list_validated_sessionsList validated sessionsPOSTLists only the sessions of a coupon that were validated (redeemed), 100 per page, with the same fields as list_coupon_sessions. Personal data.
search_coupon_sessionsSearch coupon sessionsPOSTFinds coupon sessions across all coupons by custom validation code, phone number or email (each at least 5 characters): session code and URL, validation code, coupon and session states. Personal data.
search_coupon_sessions_in_couponSearch coupon sessions in couponPOSTFinds sessions of one coupon by custom validation code, phone number or email (each at least 5 characters): session code and URL, validation code and session states. Personal data.
update_coupon_sessionUpdate coupon sessionPOSTChanges one coupon session, a real consumer's coupon: operation claims, validates (redeems), unvalidates, voids, unvoids, locks, unlocks or activates it; also sets custom fields 1 to 7, a custom id and the money spent.
update_coupon_sessionsUpdate coupon sessionsPOSTChanges every session of a coupon (real consumers' coupons) from a start sequence id, up to an end sequence id, or between both (one is required): void, unvoid, lock, unlock, claim or activate, and custom fields 1 to 7.

Coupon, 5 operations

get_couponGet couponPOSTReturns one coupon: short code and URL, status, title and texts, expiry date and time zone, tags, category, images and redeem locations; with show_usage_stats, also how many custom validation codes exist and how many were claimed and validated.
list_couponsList couponsPOSTLists the account's coupons (campaigns): id, short code and URL, status, title, texts, expiry date and time zone, tags, category, images and redeem locations. Filters: only_active, a folder, tags or a category.
send_coupon_by_emailSend coupon by emailPOSTEmails a coupon to an address through the email marketing platform connected to the Coupontools account (new session unless couponsession is given). This sends a real email.
send_coupon_by_smsSend coupon by smsPOSTTexts a coupon to a phone number through the SMS platform connected to the Coupontools account; the unique coupon URL is appended to the body. This sends a real SMS.
set_coupon_statusSet coupon statusPOSTSets a coupon's status to active (live for real consumers) or example (a test coupon).

Subaccount, 4 operations

create_subaccountCreate subaccountPOSTCreates a subaccount for an email address, with an optional package (its permissions), trial or customer status, name, country, company and expiry date. The subaccount receives an email to set its password.
get_subaccountGet subaccountPOSTReturns one subaccount: username, company, contact name and email, package, language, last login and login count, currency, campaign limit and count, expiry date and its campaigns. API keys are not returned.
list_subaccountsList subaccountsPOSTLists the account's subaccounts: id, username, company, contact name and email, package, language, last login and login count, currency, campaign limit and count, expiry date and their campaigns. API keys are not returned.
update_subaccountUpdate subaccountPOSTChanges the package (and so the permissions) of a subaccount.

Email contact, 2 operations

add_email_contactAdd email contactPOSTAdds an email address, with an optional name and custom fields 1 to 10, to an email group. Returns the contact id.
list_email_contactsList email contactsPOSTLists the contacts of one email group: id, name, email or phone as returned, and whether they unsubscribed. Personal data.

Email group, 2 operations

create_email_groupCreate email groupPOSTCreates an email group in the Coupontools email service and returns its id.
list_email_groupsList email groupsPOSTLists the email groups of the Coupontools email service (id and name). Fails when the account is not connected to that service.

Single use url, 2 operations

create_multiple_single_use_urlsCreate multiple single use urlsPOSTIssues several single-use URLs (sessions, each a usable coupon) for a coupon at once, 10 by default, optionally voided or activated and with generated validation codes of a chosen prefix, length and type.
create_single_use_urlCreate single use urlPOSTIssues a single-use URL (a new session, a usable coupon) for a coupon, optionally prefilled with the consumer's name, email, phone, custom id and fields, a custom or generated validation code, UTM tags and its own expiry date.

Sms contact, 2 operations

add_sms_contactAdd sms contactPOSTAdds a phone number, with an optional name and custom fields 1 to 7, to an SMS group. Returns the contact id.
list_sms_contactsList sms contactsPOSTLists the contacts of one SMS group: id, phone number, name, and whether and when they unsubscribed. Personal data.

Sms group, 2 operations

create_sms_groupCreate sms groupPOSTCreates an SMS group in the Coupontools SMS service and returns its id.
list_sms_groupsList sms groupsPOSTLists the SMS groups of the Coupontools SMS service (id and name). Fails when the account is not connected to that service.

Push notification, 1 operation

send_push_notificationSend push notificationPOSTSends a push notification to every consumer who saved the coupon in a mobile wallet. This notifies real people.

Webhook event, 1 operation

get_webhook_eventGet webhook eventPOSTReturns what Coupontools recorded for a webhook event id (from a received webhook payload): type, date and what it is about (coupon and session code, subaccount, landing page, or directory and user), to check a webhook as genuine.

Use Coupontools from Claude Code, Cursor or Codex

Connect Coupontools in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Coupontools operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Coupontools

Create your workspace
Sign up free. Nothing to install.
Connect Coupontools once
Add your Coupontools connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.