Integration

PromoteKit integration

PromoteKit runs affiliate programs for Stripe merchants. List, create and update affiliates, campaigns and referred customers, record commissions by hand, correct an unpaid commission's amount or mark it paid, and read payouts. Authentication is an API key created in the PromoteKit dashboard (Settings, API Keys), sent as a Bearer token; the organization needs an active or trialing PromoteKit subscription (403 otherwise), and each key may make 200 requests per minute. Webhooks are configured in the dashboard, not here.

Connect PromoteKit How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

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

What you can do with PromoteKit

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.

Affiliate, 4 operations

create_affiliateCreate affiliatePOSTCreates an affiliate (email, first_name, last_name required), approved at once unless approved is false. A promo_code missing in Stripe is created in the merchant's Stripe account. Returns the affiliate.
get_affiliateGet affiliateGETReturns one affiliate by UUID: name, emails, referral links and promo codes, clicks, approved and banned flags, signup answers and campaign. Personal data.
list_affiliatesList affiliatesGETLists affiliates (names, emails, payout email, links, promo codes, clicks, approval, campaign), 10 per page by default (limit up to 100, page from 1). Filter by campaign_id, email, ref_code or promo_code.
update_affiliateUpdate affiliatePUTUpdates an affiliate; every field is optional. banned true stops future commissions and payouts, approved sets whether they may promote; a promo_code missing in Stripe is created there. Returns the affiliate.

Campaign, 4 operations

create_campaignCreate campaignPOSTCreates a campaign: name, commission_type, commission_amount and code_mode are required; website_url is needed for link codes and reference_coupon (a Stripe coupon ID) for coupon codes.
get_campaignGet campaignGETReturns one campaign by UUID: commission type and rate, code mode, Stripe coupon, cookie duration, approval and signup form settings.
list_campaignsList campaignsGETLists the organization's campaigns with commission type and rate, code mode, default flag and signup settings, 10 per page by default (limit up to 100, page from 1).
update_campaignUpdate campaignPUTUpdates a campaign's name, commission type or rate, code mode, website URL, Stripe coupon or default flag; every field is optional. Returns the campaign.

Commission, 4 operations

create_commissionCreate commissionPOSTRecords a commission by hand for a referral (referral_id, revenue_amount and commission_amount above 0 required). It is owed to the affiliate and appears in payouts. Returns it.
get_commissionGet commissionGETReturns one commission by UUID: revenue and commission amounts, currency, payout status, Stripe payment ID, metadata, and its affiliate, referral and payout.
list_commissionsList commissionsGETLists commissions with revenue, commission amount, currency, payout status, affiliate, referral and payout, 10 per page by default. Filter by affiliate_id, payout_status or payout_id.
update_commissionUpdate commissionPUTChanges an unpaid commission's amount and/or marks it paid (payout_status paid, irreversible). Paid commissions or ones in a payout are locked (409). Returns the commission.

Referral, 3 operations

create_referralCreate referralPOSTRecords a referred customer for an affiliate (affiliate_id and email required), optionally with a Stripe customer ID, subscription status and company. Returns the referral.
list_referralsList referralsGETLists referred customers (email, company, Stripe customer ID, subscription status, signup date, affiliate), 10 per page by default. Filter by affiliate_id, email, stripe_customer_id or statuses.
update_referralUpdate referralPUTUpdates a referral's stripe_customer_id, subscription_status or company (at least one). This tool cannot clear a value. Returns the referral.

Payout, 2 operations

get_payoutGet payoutGETReturns one payout by UUID: affiliate and payout email, amount, currency, period, number of payments, status (pending to completed for Stripe) and method.
list_payoutsList payoutsGETLists payouts to affiliates (amount, currency, period, payment count, status, method, affiliate), 10 per page by default (limit up to 100). Filter by affiliate_id.

Use PromoteKit from Claude Code, Cursor or Codex

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

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