ThriveCart API and MCP server

• POST

  list_products

  Products in your account with type, status and ID.

  read

  Lists the products of your account with name, type, status and ID. Filter by status the way the Products page does; the default is Active, which holds live, test and disabled products and leaves out archived ones. Use the product_id of each item in the other tools.

  POST /api/v1/thrivecart/list_products

  Input

  Input: list_products

  Parameter	Type	Description
  status	enum	live, test, disabled, archived, active (all but archived) or all. Default: active.
  search	string	Part of the product name.

  Example response

  {
    "products": [
      {
        "product_id": "12",
        "name": "Landing Page Course",
        "type": "digital",
        "status": "live"
      },
      {
        "product_id": "15",
        "name": "Spring Workshop",
        "type": "digital",
        "status": "disabled"
      }
    ]
  }

• POST

  get_product

  One product with its pricing options, bumps, upsells and downsells.

  read

  Returns one product with its pricing options and the bumps, upsells and downsells in its funnel, each with its own ID and price. Use it to pick the product_ids for a coupon or an affiliate.

  POST /api/v1/thrivecart/get_product

  Input

  Input: get_product

  Parameter	Type	Description
  product_id required	string	Product ID from list_products.

  Example response

  {
    "product_id": "12",
    "name": "Landing Page Course",
    "status": "live",
    "pricing_options": [
      {
        "id": "po_1",
        "name": "One-time",
        "amount": "197.00",
        "currency": "USD"
      },
      {
        "id": "po_2",
        "name": "Monthly",
        "amount": "49.00",
        "currency": "USD"
      }
    ],
    "bumps": [
      {
        "bump_id": "31",
        "name": "Template pack",
        "amount": "27.00"
      }
    ],
    "upsells": [],
    "downsells": []
  }

• POST

  list_transactions

  Payments, rebills, refunds and cancellations with customer, product, amount and invoice ID.

  read

  Searches your transactions by customer name, email, order ID or invoice ID, and by type. Pages hold up to 100 transactions; pass page to read on. Use the transaction_id of an item in refund_transaction and the subscription_id of a rebill in pause_subscription or cancel_subscription.

  POST /api/v1/thrivecart/list_transactions

  Input

  Input: list_transactions

  Parameter	Type	Description
  query	string	Customer name or email, order ID or invoice ID.
  type	enum	any, charge, rebill, refund or cancel. Default: any.
  per_page	integer	1 to 100. Default: 50.
  page	integer	Page number, starting at 1. Default: 1.

  Example response

  {
    "transactions": [
      {
        "transaction_id": "tx_20418",
        "type": "charge",
        "customer": {
          "name": "Dana Client",
          "email": "client@example.com"
        },
        "product": "Landing Page Course",
        "amount": "97.00",
        "currency": "USD",
        "invoice_id": "INV-20418",
        "subscription_id": "sub_7731",
        "date": "2026-10-02"
      }
    ],
    "page": 1,
    "has_more": false
  }

• POST

  list_subscriptions

  Subscriptions with status and next payment, plus the count, monthly recurring revenue and yearly revenue of the filter.

  read

  Returns the subscriptions that match your filter, as the Subscriptions dashboard does, plus the number of matches and their monthly recurring revenue and yearly revenue. Use it to see how much paused or overdue subscriptions cost you. Cancelled (still active) means the customer cancelled renewals but has access until the last paid date.

  POST /api/v1/thrivecart/list_subscriptions

  Input

  Input: list_subscriptions

  Parameter	Type	Description
  status	enum	new_signups, trial, active, cancelled, cancelled_still_active, paused, completed, overdue or all. Default: active.
  product_id	string	Only this product.
  query	string	Customer name or email.

  Example response

  {
    "subscriptions": [
      {
        "subscription_id": "sub_7731",
        "customer": "Dana Client",
        "product": "Landing Page Course",
        "status": "overdue",
        "amount": "49.00",
        "currency": "USD",
        "billing": "monthly",
        "next_payment": "2026-10-05"
      },
      {
        "subscription_id": "sub_7802",
        "customer": "Sam Rivers",
        "product": "Membership",
        "status": "overdue",
        "amount": "97.00",
        "currency": "USD",
        "billing": "monthly",
        "next_payment": "2026-10-08"
      }
    ],
    "total": 2,
    "mrr": "146.00",
    "yearly_revenue": "1752.00",
    "currency": "USD"
  }

• POST

  list_coupons

  Coupons with code, discount, status, dates, products and number of uses.

  read

  Lists the coupons of the Coupons area with code, discount, status, redeemable dates, the products they work on and how many times each was used. Use the coupon_id of each item in update_coupon.

  POST /api/v1/thrivecart/list_coupons

  Input

  Input: list_coupons

  Parameter	Type	Description
  search	string	Part of the coupon name or code.

  Example response

  {
    "coupons": [
      {
        "coupon_id": "87",
        "name": "Black Friday 30% main course",
        "code": "BLACKFRIDAY",
        "status": "enabled",
        "discount": "30%",
        "starts_on": "2026-11-27",
        "ends_on": "2026-12-01",
        "max_uses": 100,
        "uses": 0,
        "product_ids": [
          "12"
        ]
      },
      {
        "coupon_id": "71",
        "name": "Spring 20% off",
        "code": "SPRING20",
        "status": "enabled",
        "discount": "20%",
        "starts_on": null,
        "ends_on": null,
        "max_uses": null,
        "uses": 14,
        "product_ids": [
          "15"
        ]
      }
    ]
  }

• POST

  list_affiliates

  Affiliates with their approval status per product.

  read

  Lists your affiliates with contact details and, for each product, whether the affiliate is approved or pending. Pages hold up to 25 affiliates; pass page to read on. Use the affiliate_id of an item in approve_affiliate and set_affiliate_commission.

  POST /api/v1/thrivecart/list_affiliates

  Input

  Input: list_affiliates

  Parameter	Type	Description
  product_id	string	Only affiliates of this product.
  query	string	Affiliate name, email or affiliate ID.
  page	integer	Page number, starting at 1. Default: 1.

  Example response

  {
    "affiliates": [
      {
        "affiliate_id": "3481",
        "name": "Jo Partner",
        "email": "jo@example.com",
        "products": [
          {
            "product_id": "12",
            "status": "pending"
          }
        ]
      }
    ],
    "page": 1,
    "has_more": false
  }

• POST

  create_coupon

  New coupon with a fixed or percentage discount, dates, use limit and products.

  asks first write

  Creates a coupon the way the Coupons area does. The code needs at least 3 characters, letters and digits only. A percentage coupon can apply to the funnel, the main product, bumps only or the main product plus bumps; a fixed coupon applies to the main product only, once. max_uses counts all uses together, not per customer. The coupon is enabled when created, so buyers can use it from the start date. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/thrivecart/create_coupon

  Input

  Input: create_coupon

  Parameter	Type	Description
  name required	string	Internal name.
  code required	string	At least 3 characters, letters and digits only.
  discount_type required	enum	fixed or percentage.
  discount required	string	Amount or percent, decimals allowed for percent, e.g. 20 or 12.5.
  applies_to	enum	Percentage only: funnel, main_product, bumps_only or main_and_bumps. Default: main_product.
  apply_to_recurring	boolean	Percentage only: also discount recurring payments.
  product_ids	string[]	Products it works on. Default: all products.
  starts_on	date	First day it works. Default: now.
  ends_on	date	Last day it works, until 23:59:59 in your account time zone.
  max_uses	integer	Disable after this many uses in total.
  affiliate_id	string	Credit this affiliate on every use.

  Example response

  {
    "coupon_id": "87",
    "name": "Black Friday 30% main course",
    "code": "BLACKFRIDAY",
    "status": "enabled",
    "discount": "30%",
    "applies_to": "main_product",
    "product_ids": [
      "12"
    ],
    "starts_on": "2026-11-27",
    "ends_on": "2026-12-01",
    "max_uses": 100,
    "uses": 0
  }

• POST

  update_coupon

  Enable or disable a coupon, or change its discount, dates, use limit or products.

  asks first write

  Changes one coupon. Disabling keeps the coupon and enabling turns it back on. Discount, dates and the use limit apply to the next buyer. If you add bumps to a product after creating a coupon, send product_ids again, because new bumps are not added automatically. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/thrivecart/update_coupon

  Input

  Input: update_coupon

  Parameter	Type	Description
  coupon_id required	string	Coupon ID from list_coupons.
  fields required	object	Any of status (enabled or disabled), discount, starts_on, ends_on, max_uses, product_ids.

  Example response

  {
    "coupon_id": "71",
    "code": "SPRING20",
    "status": "disabled",
    "discount": "20%",
    "uses": 14
  }

• POST

  clone_product

  Copy a product with its checkout and settings, e.g. for a new cohort.

  write

  Copies a product the way the copy button does, including archived products. Only the account owner can clone; for a sub-user the call fails with a permission error. The copy is a separate product with its own ID, ready for you to edit. clone_product runs without asking first: it sends nothing to anyone, and set_product_status archives the copy in one call.

  POST /api/v1/thrivecart/clone_product

  Input

  Input: clone_product

  Parameter	Type	Description
  product_id required	string	Product ID from list_products.
  name	string	Name for the copy. Default: ThriveCart's default for a copy.

  Example response

  {
    "product_id": "27",
    "name": "Spring Workshop, autumn cohort",
    "cloned_from": "15"
  }

• POST

  set_product_status

  Switch a product between live, test and disabled, or archive or restore it.

  asks first write

  Sets the status of a product. Live products can be bought, test products are in test mode, disabled products are inactive. Archiving removes a product from the active list and disables its checkout, while its stats and transactions stay in your reports; restoring makes it active again. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/thrivecart/set_product_status

  Input

  Input: set_product_status

  Parameter	Type	Description
  product_id required	string	Product ID from list_products.
  status required	enum	live, test, disabled, archived or restored.

  Example response

  {
    "product_id": "15",
    "name": "Spring Workshop",
    "status": "archived"
  }

• POST

  refund_transaction

  Full or partial refund of one payment, with an internal note. Does not cancel the subscription.

  asks first write

  Refunds one payment or rebill, in full or in part. You can refund partly several times, up to the transaction total and never more. A refund cannot be reversed, and the note stays internal. It does not cancel the subscription, so call cancel_subscription too. A PayPal refund fails if your PayPal account has too little balance. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/thrivecart/refund_transaction

  Input

  Input: refund_transaction

  Parameter	Type	Description
  transaction_id required	string	Transaction ID from list_transactions.
  amount	string	Partial amount. Default: the full remaining amount.
  note	string	Internal note, never shown to the customer.

  Example response

  {
    "transaction_id": "tx_20418",
    "status": "refunded",
    "amount": "97.00",
    "refunded_total": "97.00",
    "remaining": "0.00",
    "currency": "USD"
  }

• POST

  pause_subscription

  Pause billing indefinitely, for a number of billing periods or until a date.

  asks first write

  Pauses billing of one subscription. Without resume_on or periods the pause lasts until you resume it. Pausing does not remove payments the customer owes: a subscription with 5 rebills is still charged 5 times, later. resume_on must be at least 24 hours ahead. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/thrivecart/pause_subscription

  Input

  Input: pause_subscription

  Parameter	Type	Description
  subscription_id required	string	Subscription ID from list_subscriptions.
  resume_on	date	Resume automatically on this date, at least 24 hours from now.
  periods	integer	Pause for this many billing periods instead.

  Example response

  {
    "subscription_id": "sub_7731",
    "status": "paused",
    "resume_on": "2026-11-15"
  }

• POST

  cancel_subscription

  Stop all future payments of a subscription. Cannot be undone.

  asks first write

  Cancels one active or paused subscription for good. ThriveCart tells the payment processor, tags the original transaction as cancelled and adds a $0.00 transaction on that day to mark it. It does not refund anything. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/thrivecart/cancel_subscription

  Input

  Input: cancel_subscription

  Parameter	Type	Description
  subscription_id required	string	Subscription ID from list_subscriptions.

  Example response

  {
    "subscription_id": "sub_7731",
    "status": "cancelled",
    "cancelled_on": "2026-10-11"
  }

• POST

  approve_affiliate

  Approve or reject a pending affiliate application for one or more products.

  asks first write

  Approves or rejects an affiliate for the products you name. Approving needs a pending application for each of them. An affiliate approved for the main product is also approved for the upsells and downsells of its funnel. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/thrivecart/approve_affiliate

  Input

  Input: approve_affiliate

  Parameter	Type	Description
  affiliate_id required	string	Affiliate ID from list_affiliates.
  product_ids required	string[]	Product IDs to decide on.
  decision required	enum	approve or reject.
  trigger_emails	boolean	Send ThriveCart's emails to the affiliate and you.

  Example response

  {
    "affiliate_id": "3481",
    "name": "Jo Partner",
    "products": [
      {
        "product_id": "12",
        "status": "approved"
      }
    ]
  }

• POST

  set_affiliate_commission

  Custom commission for one affiliate on one product.

  asks first write

  Sets a custom commission for one approved affiliate on one product, instead of the default rate. It applies to all pricing options of the product, not to single ones. Upfront and recurring commissions are set separately. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/thrivecart/set_affiliate_commission

  Input

  Input: set_affiliate_commission

  Parameter	Type	Description
  affiliate_id required	string	Affiliate ID from list_affiliates.
  product_id required	string	Product ID from list_products.
  type required	enum	percentage or fixed.
  amount required	string	Percent or amount, e.g. 40.
  recurring_type	enum	percentage or fixed, for recurring payments.
  recurring_amount	string	Percent or amount for recurring payments.

  Example response

  {
    "affiliate_id": "3481",
    "product_id": "12",
    "upfront": {
      "type": "percentage",
      "amount": "40"
    }
  }

Each successful call uses credits for the work it takes; failed calls and timeouts cost nothing. A hard spend cap is on by default. Authenticate with the Authorization: Bearer header.