Integration

SamCart integration

SamCart is a checkout and e-commerce platform for selling digital and physical products, subscriptions and courses. Read orders, charges, refunds, failed charges, customers, prospects, subscriptions and their history, coupons, products, upsells, funnels and bookings, run sales, subscription, MRR, LTV and churn reports, create products, coupons, upsells and funnels, issue refunds, cancel, restart or reschedule subscriptions, and add products to existing orders. Card digits and expiry dates, the buyer's IP address and the raw landing-page URLs and query parameters captured at checkout are left out of the outputs (UTM values are kept). This integration covers SamCart API v2 only; API v1 still runs with the same key but is not included. Authentication is an API key sent in the sc-api header (SamCart Settings, API); a plan without API access answers 403.

Connect SamCart How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

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

What you can do with SamCart

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.

Funnel, 5 operations

create_funnelCreate funnelPOSTCreate a funnel from one or more existing upsells.
get_funnelGet funnelGETRetrieve a single funnel.
get_funnels_reportGet funnels reportGETRetrieve funnel performance for a date range. Rows are ordered by total revenue, highest first, and capped by the limit parameter.
list_funnelsList funnelsGETRetrieve a cursor-paginated list of funnels.
update_funnelUpdate funnelPATCHChange what this funnel offers, where it is shown, or both.

Upsell, 5 operations

create_upsellCreate upsellPOSTCreate an upsell that offers an existing product.
get_upsellGet upsellGETRetrieve a single upsell by id (ULID). Soft-deleted upsells are returned with deleted set to true instead of a 404, so ids referenced by other resources always resolve.
get_upsells_reportGet upsells reportGETRetrieve upsell performance for a date range. Rows are ordered by additional revenue, highest first, and capped by the limit parameter.
list_upsellsList upsellsGETRetrieve a cursor-paginated list of upsells. Archived upsells are included unless filtered with the archived parameter. Soft-deleted upsells are never returned.
update_upsell_placementUpdate upsell placementPATCHChange which products this upsell is shown after.

Coupon, 4 operations

create_couponCreate couponPOSTCreate a coupon (flat rate or percentage, one-time or recurring, unlimited, one-time or unique-per-email usage). Several product_ids create one coupon per product sharing the code; none applies it to every product.
get_couponGet couponGETRetrieve a single coupon by id. Soft-deleted coupons are returned with a non-null deleted_at instead of a 404, so coupon ids referenced by other resources always resolve.
list_couponsList couponsGETRetrieve a cursor-paginated list of coupons.
update_coupon_productsUpdate coupon productsPATCHChange which products a coupon applies to.

Product, 4 operations

create_productCreate productPOSTCreate a product. The product is created live and not archived, priced in the marketplace currency, with the marketplace defaults for every setting the request body does not cover.
get_productGet productGETRetrieve a single product by id (ULID). Soft-deleted products are returned with deleted set to true instead of a 404, so ids referenced by other resources always resolve.
list_productsList productsGETRetrieve a cursor-paginated list of products. Archived products are included unless filtered with the archived parameter. Soft-deleted products are never returned.
update_productUpdate productPATCHUpdate a product. Only the fields present in the request body are written; omitted fields keep their current value and unknown fields are ignored.

Subscription, 4 operations

get_subscriptionGet subscriptionGETRetrieve a single subscription by id.
get_subscriptions_reportGet subscriptions reportGETRetrieve subscription and trial performance for a date range, one row per day.
list_subscriptionsList subscriptionsGETRetrieve a cursor-paginated list of subscriptions.
update_subscription_rebill_dateUpdate subscription rebill datePATCHUpdate a subscription. Currently supports changing the next rebilling date. Only subscriptions with an active or delinquent status can be updated.

Order, 3 operations

get_orderGet orderGETRetrieve a single order by id, including addresses, attribution, custom fields, and full cart item detail.
list_ordersList ordersGETRetrieve a cursor-paginated list of orders.
update_order_custom_fieldsUpdate order custom fieldsPATCHOverwrite buyer answers in an order's custom fields. custom_fields maps each field slug (from get_order custom_fields entries) to new text; only sent slugs change; an empty string or null ERASES the answer. Returns the full order.

Batch add to order, 2 operations

batch_add_products_to_ordersBatch add products to ordersPOSTCharge every listed product to every listed order (real money), using each order's saved payment method. Runs asynchronously: poll get_batch_add_to_order_status with the batch_id; done when processed equals total.
get_batch_add_to_order_statusGet batch add to order statusGETRetrieve the progress and per-charge results of a batch add-to-order request. The batch is complete once processed equals total.

Charge, 2 operations

get_chargeGet chargeGETRetrieve a single charge by id.
list_chargesList chargesGETList charges, newest first, 25 per page by default (max 100); page with cursor = meta.next_cursor. total is what the processor captured, never reduced by refunds; status says charged, refunded or partially_refunded.

Customer, 2 operations

get_customerGet customerGETRetrieve a single customer by id. Returns the same fields as the list endpoint plus all addresses on file for the customer and their stored payment methods.
list_customersList customersGETRetrieve a cursor-paginated list of customers. Lifetime value, order count and last charge date are not available on this endpoint.

Prospect, 2 operations

get_prospectGet prospectGETRetrieve a single prospect by id. Returns the list fields plus the billing and shipping addresses captured at checkout.
list_prospectsList prospectsGETRetrieve a cursor-paginated list of prospects. A prospect is someone who entered their details on a checkout without completing a purchase.

Refund, 2 operations

issue_refundIssue refundPOSTRefund real money on a charge (charge_id from list_charges). Leave out amount for a full refund, or pass an amount in the smallest currency unit for a partial one. Cannot be undone.
list_refundsList refundsGETRetrieve a cursor-paginated list of refunds, filterable by charge_id, order_id, customer_id, creation date range and test_mode. amount is the amount of that single refund, in the smallest currency unit.

Schedule cancel, 2 operations

remove_scheduled_cancellationRemove scheduled cancellationDELETERemove a pending scheduled cancellation so the subscription keeps billing past the date it was going to cancel on. Returns `invalid_state` when nothing is scheduled.
schedule_subscription_cancellationSchedule subscription cancellationPOSTSchedule a subscription to cancel at a future date. Only active subscriptions can be scheduled.

Add to order, 1 operation

add_product_to_orderAdd product to orderPOSTCharge a product to an existing order right away, using the payment method already on the order (real money, synchronous). Then read the order with get_order to see the new charge.

Apply coupon, 1 operation

apply_coupon_to_subscriptionApply coupon to subscriptionPOSTApply a coupon to an active or delinquent subscription so its future charges are discounted.

Booking, 1 operation

list_bookingsList bookingsGETRetrieve a cursor-paginated list of bookings. A booking is created when a buyer pays for a bookable product at checkout or accepts one as an upsell, and it starts as pending.

Cancel, 1 operation

cancel_subscriptionCancel subscriptionPOSTCancel a subscription immediately; the customer is notified unless silent_cancel is true. To cancel later instead, use schedule_subscription_cancellation. Returns the full subscription record.

Churn cohort, 1 operation

get_churn_cohorts_reportGet churn cohorts reportGETRetrieve subscription retention by signup month and product.

Consent, 1 operation

update_sms_consentUpdate sms consentPUTReport a buyer's SMS reply to SamCart: opted_in confirms a pending consent (buyer replied YES), opted_out opts the phone number out (STOP). Needs a key with full access or the consents.write scope.

Daily sale, 1 operation

get_daily_sales_reportGet daily sales reportGETRetrieve daily sales performance for a date range, one row per day and currency. A day with no activity is omitted rather than returned as a zero row.

Failed charge, 1 operation

list_failed_chargesList failed chargesGETRetrieve a cursor-paginated list of failed charges. Each entry is a payment attempt that did not succeed, with the processor error text in `error`.

History, 1 operation

list_subscription_historyList subscription historyGETRetrieve a cursor-paginated log of a subscription's status changes, newest first by default.

Ltv, 1 operation

get_ltv_reportGet ltv reportGETRetrieve customer lifetime value by acquisition cohort, one row per cohort month.

Mrr, 1 operation

get_mrr_reportGet mrr reportGETRetrieve current monthly recurring revenue across all active subscriptions. Takes no parameters and always reports the present value rather than a date range.

Order bump, 1 operation

get_order_bumps_reportGet order bumps reportGETRetrieve order bump performance for a date range. Rows are ordered by additional revenue, highest first, and capped by the limit parameter.

Product sale, 1 operation

get_product_sales_reportGet product sales reportGETRetrieve sales performance per product for a date range. Rows are ordered by gross sales, highest first, and capped by the limit parameter.

Restart, 1 operation

restart_subscriptionRestart subscriptionPOSTRestart a delinquent or canceled subscription so it bills again.

Use SamCart from Claude Code, Cursor or Codex

Connect SamCart in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its SamCart 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 SamCart

Create your workspace
Sign up free. Nothing to install.
Connect SamCart once
Add your SamCart 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.