FirstPromoter MCP server for your AI

Accepts promoters into one campaign.

Adds promoters to one more campaign, keeping the ones they are in.

Blocks promoters on one campaign, which stops them earning there.

Adds a promoter.

Reads one promoter in full.

Lists promoters (affiliates), with stats and the campaigns each one is in.

Moves promoters from one campaign to another, keeping their referral id.

Rejects promoters from one campaign.

Changes a promoter's email, cust_id, custom fields or profile.

Reads one referral with its promoter and campaign.

Lists referrals: the leads and customers promoters brought in.

Reads what is due to be paid, with the program's payout terms.

Lists payouts to promoters.

Lists what each promoter is owed, grouped by promoter, with their payout method.

Records payouts as paid, for money sent outside FirstPromoter.

Approves commissions, making them payable to promoters.

Creates a commission, which is money owed to a promoter once approved.

Denies commissions, so they are not paid.

Reports each campaign's performance.

Reports the whole program over time: revenue, referrals, customers, clicks and more.

Reports each promoter's performance.

Lists commissions: what promoters earned.

Creates a promo code for a promoter.

Reads one campaign in full.

Lists campaigns, with their stats, links and rewards.

Lists promo codes.

Shows what is due to be paid and who is owed what, with each promoter's payout method and the program's payout terms, in one call.

Shows how the affiliate program stands now in one call: revenue, referrals, customers, promoters, pending commissions, what is due to pay, and who is trending.

Shows everything about one promoter in one call: profile and campaigns, referral links, results over a date range, and commissions waiting for review.

Finds a promoter campaign by text, such as a promoter's name or email.

Ranks promoters by one measure over a date range, such as who brought the most revenue last month.

Waits up to about 25 seconds for a bulk action to finish, then answers how many worked and how many failed.

Reads the headline numbers on the dashboard: revenue, referrals, customers, promoters and pending commissions.

Lists reward rules: how promoters earn and what referred customers get.

Records a sale, which creates commissions for the promoter.

Records a signup as a lead for the promoter who referred it.

Reads one background job: status, how many it processed and any that failed.

Older V1 API: adds one promoter to another campaign.

Older V1 API: creates a payout for a promoter from what they are due.

Older V1 API: adds a promoter.

Older V1 API: gives a non-cash reward such as points, credits or free months.

Older V1 API: deletes one lead by id, uid or email.

Older V1 API: deletes a promoter.

Older V1 API: reports by campaign.

Older V1 API: reads one lead by id, uid or email.

Older V1 API: reports the whole program.

Older V1 API: reads one promoter by id, promoter_email, cust_id, ref_id or auth_token.

Older V1 API: reports by promoter.

Older V1 API: lists leads and customers.

Older V1 API: lists payouts.

Older V1 API: lists promoters.

Older V1 API: lists rewards and commissions.

Older V1 API: moves one promoter between campaigns.

Older V1 API: replaces a promoter's auth token, which stops the old one working, and answers the new one.

Older V1 API: records that a customer cancelled.

Older V1 API: records a refund, which takes commission back.

Older V1 API: records a sale, creating commissions.

Older V1 API: records a signup.

Older V1 API: records a newsletter or mailing list subscriber as a lead.

Older V1 API: changes a lead.

Older V1 API: changes a payout's status.

Older V1 API: changes a promoter.

Older V1 API: changes a reward's status.

Archives promoters, hiding them from everyday lists.

Makes one promoter the parent of others, for sub-affiliate commissions.

Reads one promoter's daily or monthly series for one measure: revenue, clicks, referrals, customers or cancellations.

Lists one promoter's referral links: their default link and any campaign or custom links.

Brings archived promoters back, with their history.

Approves referrals waiting for review.

Adds a referral by hand, credited to one promoter.

Deletes referrals.

Disables referrals, so they stop earning commissions.

Enables disabled referrals again, so they earn commissions.

Imports a referral's earlier sales from Stripe, which can create commissions.

Lists your own referral statuses, such as Contacted or Qualified.

Moves referrals to another promoter.

Adds, renames, orders or deletes your own referral statuses.

Changes a referral's email, uid, username, promoter_campaign_id, fraud_check, split_details, or custom status.

Makes a copy of an email, to edit without touching the original.

Creates an email to promoters.

Deletes an email.

Deletes invoices.

Answers invoices as CSV text.

Starts a background job that makes one zip of every invoice PDF.

Finalizes draft invoices, so they can no longer be edited.

Reads one email with its full HTML and trigger.

Reads the HTML theme around all your emails.

Reads one invoice, with a link to its PDF.

Reads the HTML of the invoice template.

Lists emails to promoters.

Lists promoter invoices.

Renders the invoice a promoter would get, as HTML, creating nothing.

Renders template HTML as a sample invoice, saving nothing.

SENDS TO REAL PEOPLE: sends this email to its promoters now, which cannot be undone.

Sends a test of this email to the account's own user, not to promoters.

Sends a test of the email theme to the account's own user.

Replaces an email.

Replaces the HTML theme around all your emails with html.

Replaces the invoice template with the HTML in html.

Voids invoices.

Creates a batch to pay all due payouts for one method: paypal, bank, wise, crypto or dots.

Subscribes a URL to events.

Deletes a payments batch that has not been paid.

Deletes payouts.

Deletes a webhook subscription, which stops its events at once.

Reads payout totals.

Reads one webhook subscription.

Reads one webhook delivery with its status and response.

Lists what a webhook sent and whether it arrived.

Lists every event a webhook can subscribe to, such as commission.created.

Lists webhook subscriptions.

Reverses a paid record, so the payout is due again.

SENDS REAL MONEY: starts paying a payments batch.

Sends a failed webhook delivery again.

Sends a sample event to a URL now, to check it works.

Changes a webhook's URL, events or campaigns, or pauses it with active false.

Deletes commissions, removing what promoters are owed.

Answers a report as CSV text.

Creates payouts now for approved commissions, without waiting for the payout cycle.

Reports one promoter's performance over time.

Reports where one promoter's traffic comes from, by source and over time.

Reports one promoter's results by landing page URL.

Reports where referral traffic comes from.

Reports results by landing page URL.

Marks non-cash commissions, such as credits or free months, as delivered.

Marks non-cash commissions as not yet delivered.

Changes a commission's internal_note or external_note.

Adds a marketing asset.

Deletes assets.

Reads one asset.

Lists asset categories.

Lists marketing assets promoters can use: images, documents, links and text.

Changes an asset.

Adds, renames, orders or deletes asset categories.

Moves assets to a category.

Creates an agreement.

Deletes an agreement.

Reads one agreement.

Reads one signed or pending agreement.

Lists the agreements promoters have to sign or have signed.

Lists affiliate agreements promoters must accept.

Changes an agreement, which can ask promoters to accept it again.

Archives a promo code.

Creates a campaign.

Adds a payout method for a promoter, which decides where their money goes.

Adds a product.

Deletes a campaign.

Removes a promoter's payout method.

Deletes a product.

Reads one payout method.

Reads one product.

Reads one promo code.

Reads the series for one measure, for one promoter on one campaign.

Lists one promoter's payout methods.

Lists products that can have their own commission rules.

Lists the referral links for one promoter on one campaign.

Lists promoter campaigns: the records linking one promoter to one campaign.

Changes a campaign's name, landing page, cookie life, visibility, links or rewards.

Changes a payout method, which decides where a promoter's money goes.

Changes a product's name, ext_id or prices.

Changes a promo code's code, description or promoter.

Changes one promoter's terms on one campaign: ref_token, state, coupon, display_coupon, direct_url, or their own rewards.

Creates a reward rule.

Reads the dashboard's series for one measure: revenue, commissions, clicks, referrals, customers or cancellations.

Reads the dashboard's payout and commission totals.

Reads the trending promoters and campaigns.

Hides a reward so it cannot be attached to anything new.

Records that a customer cancelled, which lowers the monthly revenue they count for.

Records a refund, which takes commission back.

Changes a reward rule.

Reads the progress of background jobs.

Lists background jobs from bulk actions.

Mints a short-lived login token for one promoter, for embedding their dashboard in your own app.

Ends a promoter's embedded dashboard sessions.