FirstPromoter MCP server
Yes. FirstPromoter publishes an official MCP server at https://mcp.firstpromoter.com. It's hosted and lets you sign in with your FirstPromoter account. It offers 53 tools. We last checked it on 22 Nov 2026.
Official: answers MCP requests at mcp.firstpromoter.com, on FirstPromoter's own domain firstpromoter.com. Checked 22 Nov 2026. Maintained by Stuart Brameld.
Key facts
As of 22 Nov 2026, FirstPromoter's official MCP server scores 85/100 on MartechDB's Agent Readiness Index (v1.1), joint 7th of 17 in Affiliates & partners. It answered 56 of our 56 checks in the last 90 days and has 53 tools named in its documentation.
How the Agent Readiness Index works · Wrong? Suggest a correction
FirstPromoter MCP server review
85/100
FirstPromoter's MCP server scores 85/100 on MartechDB's Agent Readiness Index: one of the easiest marketing tools to connect an AI agent to. That ranks it joint 7th of 17 in Affiliates & partners.
The good
Hosted by FirstPromoter: connect by URL, with nothing to install
Sign in with your FirstPromoter account: your AI client sets up the sign-in itself, with no API key
Documented, with 53 tools known
Answered 100% of our checks in the last 90 days
The bad
Nothing we've found.
Not checked yet: what agent access costs. Anything not checked scores nothing.
Official MCP server
FirstPromoter MCP server
- Address
- https://mcp.firstpromoter.com
- Runs
- Hosted
- Sign-in
- Official MCP Registry
- Not listed
- How we know it's official
-
- Answers MCP requests at mcp.firstpromoter.com, on FirstPromoter's own domain firstpromoter.com.
- Documentation
- docs.firstpromoter.com/mcp/overview
- Tools
- 53 tools · from FirstPromoter's documentation
- First seen
- 1 Oct 2026
- Last checked
-
Reachable ·
16 Nov 2026: reachable17 Nov 2026: reachable18 Nov 2026: reachable19 Nov 2026: reachable20 Nov 2026: reachable21 Nov 2026: reachable22 Nov 2026: reachable
- Uptime
- 100% · 56 of 56 checks reachable since 1 Oct 2026
FirstPromoter MCP server tools (53)
The server needs sign-in before it lists its tools, so these are as FirstPromoter's documentation names them (read 2 Oct 2026). They may be out of date.
-
get_company_contextCampaigns, currency, active/pending promoter counts. The "what is this company?" entry point.
-
get_dashboard_statsRevenue, referrals, customers, accepted/pending promoters, pending commissions.
-
get_dashboard_trendingTop 3 trending promoters and campaigns over the last 30 days.
-
get_overview_reportRevenue, referrals, customers, clicks, sales, refunds, and earnings grouped by day, week, month, or year.
-
get_promoters_reportPerformance ranking per promoter for a date range.
-
get_campaigns_reportPerformance ranking per campaign for a date range.
-
get_urls_reportLanding-page traffic broken down by clicks, customers, sales, and revenue.
-
get_traffic_sources_reportWhere referral traffic comes from — direct, organic, social, paid.
-
list_campaignsEvery campaign with key metrics.
-
get_campaignFull detail for one campaign by ID.
-
create_campaignNew campaign in the company's default program; attach rewards in the same call.
-
update_campaignChange name, landing URL, cookie life, referral param, visibility, attached rewards.
-
list_promotersFilterable by status, signup/approval date, campaign, revenue. Supports a `q` parameter for fuzzy search across email, first/last name, and website.
-
get_promoterDetailed profile, balances, campaign membership, and all profile fields (name, country, address, social URLs, business details).
-
create_promoterNew promoter on an initial campaign with profile data.
-
update_promoterEvery field the admin Edit modal exposes: email, name, website, company name and number, VAT ID, phone, address, country, PayPal email, social URLs (Facebook, Twitter, Instagram, YouTube, LinkedIn, Twitch, TikTok), admin note, custom fields, and behaviour flags.
-
accept_promoterState change scoped to a single campaign. Verifies the per-campaign state actually persisted before reporting success.
-
reject_promoterState change scoped to a single campaign.
-
block_promoterState change scoped to a single campaign.
-
add_promoter_to_campaignEnrol in an additional campaign without affecting existing memberships.
-
move_promoter_to_campaignMove between campaigns; optionally soft-move existing referrals.
-
assign_parent_promoterSet or remove the parent in a sub-affiliate hierarchy.
-
restore_promoterBring an archived promoter back — history and referrals preserved.
-
update_promoter_campaignPer-promoter overrides on a specific campaign: ref token, coupon, display coupon, direct URL, state, and reward override.
-
list_referralsFilter by state, date range, campaign, promoter; sorted newest first.
-
get_referralSingle referral with promoter, campaign, customer email, and the full event log.
-
list_commissionsFilter by status, date, campaign, promoter.
-
list_payoutsCash rewards paid to promoters; amounts in cents.
-
mark_commission_fulfilledFor non-monetary commissions only (badges, points, free months).
-
mark_commission_unfulfilledRevert a fulfilled non-monetary commission.
-
list_rewardsAll reward rules defined in the company.
-
get_rewardSingle reward with name, type, schemas, tier level, and coupon.
-
create_rewardNew commission or discount rule.
-
update_rewardChange name, type, schemas, coupon, tier.
-
hide_rewardSoft-delete a reward. Existing attachments and pending commissions keep working, but it can no longer be attached to new campaigns or promoters.
-
list_promo_codesCodes attached to promoters or campaigns. Optionally filter by promoter campaign or include archived.
-
get_promo_codeSingle code with reward and scope details.
-
create_promo_codeNew code attached to a reward, optionally scoped to a specific promoter and campaign.
-
update_promo_codeChange code, description, reward, scope.
-
archive_promo_codeSoft-delete. Preserved for historical reporting; new redemptions are rejected.
-
list_productsSKUs that can have product-specific commission rules attached.
-
get_productSingle product detail.
-
create_productNew product with name, external billing-provider ID, and prices.
-
update_productUpdate name, external billing-provider ID, and prices.
-
delete_productPermanent delete. Historical sales referencing the product keep the name as a snapshot.
-
list_assetsMarketing assets (banners, swipe copy, images) promoters can download.
-
get_assetSingle asset detail.
-
list_contractsAffiliate program contracts (Terms of Service, NDAs) that promoters agree to.
-
get_contractSingle contract detail.
-
list_emailsFilter by status (`draft`, `scheduled`, `sent`, `failed`) and trigger event (`promoter_accepted`, `lead_signup`, `reward_created`, etc.). Use this to map an existing onboarding sequence.
-
get_emailFull HTML body and trigger configuration for a single email.
-
create_emailDraft a new transactional email tied to a trigger event. Created in draft status with the trigger disabled — an admin must review and enable it from the dashboard before anything sends. Merge tags like `{{promoter.first_name}}` and `{{promoter.email}}` are supported in the body.
-
update_emailEdit name, subject, body, or trigger on a non-sent email. Cannot touch emails already in sent status, and cannot flip a draft into a scheduled send.
Connect your AI to FirstPromoter
Add the official FirstPromoter MCP server to Claude, ChatGPT or your editor.
Connect FirstPromoter MCP to Claude
Claude.ai and Claude Desktop
Open Customize, then Connectors.
Click +, then Add custom connector.
Name it FirstPromoter, paste the address below and click Add.
Connect FirstPromoter MCP to ChatGPT
Open Settings, then Apps, then Advanced settings.
Turn on Developer mode, then click Create.
Name it FirstPromoter and paste the address below.
Connect FirstPromoter MCP to Cursor
Opens Cursor if it's installed. If nothing happens, use the JSON below.
Connect FirstPromoter MCP to VS Code
Opens VS Code if it's installed. Otherwise add the JSON settings from the Cursor tab to your .vscode/mcp.json.
FirstPromoter MCP server questions
Does FirstPromoter have an official MCP server?
Yes. FirstPromoter publishes its MCP server itself. Its address is on FirstPromoter's own domain (mcp.firstpromoter.com). MartechDB only lists servers a vendor publishes, never community copies.
What is the FirstPromoter MCP server URL?
The address is https://mcp.firstpromoter.com.
Does the FirstPromoter MCP server need an API key?
No. You sign in with your FirstPromoter account (OAuth), and your AI client handles the rest.
How do I connect FirstPromoter MCP to Claude, ChatGPT or Cursor?
In Claude, add https://mcp.firstpromoter.com as a custom connector (Customize, Connectors, Add custom connector). In ChatGPT, turn on developer mode (Settings, Apps, Advanced settings) and create an app with the same address. In Cursor, use the Add to Cursor link on MartechDB's page, or paste the JSON settings into your mcp.json. In Claude Code, run: claude mcp add --transport http firstpromoter https://mcp.firstpromoter.com
What can the FirstPromoter MCP server do?
It offers 53 tools, including get_company_context, get_dashboard_stats, get_dashboard_trending, get_overview_report and get_promoters_report (as its documentation names them, read on 2 Oct 2026).
Is the FirstPromoter MCP server in the official MCP Registry?
No. FirstPromoter hasn't published it to the official MCP Registry.
Is the FirstPromoter MCP server working?
Yes. It answered our most recent check. We last checked it on 22 Nov 2026.
What are the alternatives to FirstPromoter's MCP server?
In Affiliates & partners, the most agent-friendly alternatives with an official MCP server are Partnero (98/100), Strackr (94/100), Crossbeam (94/100), Synup (92/100) and Affise (91/100). FirstPromoter scores 85/100 on the same index.
Alternatives to FirstPromoter's MCP server
Vendors in Affiliates & partners with an official MCP server, the most agent-friendly first. FirstPromoter scores 85/100.
Compare all 26 Affiliates & partners vendors →Use with AI
Connect your AI to MartechDB
Then ask it about FirstPromoter, or any of the 1,851 marketing tools with an official MCP server. Free, no sign-in.
Claude.ai and Claude Desktop
Open Customize, then Connectors.
Click +, then Add custom connector.
Name it MartechDB, paste the address below and click Add. There's no sign-in.
The free plan allows one custom connector. On Team and Enterprise plans, an owner adds the connector first.
Claude Code
Run this in your terminal:
ChatGPT
Open Settings, then Apps, then Advanced settings.
Turn on Developer mode, then click Create.
Name it MartechDB, paste the address below and choose No authentication.
Developer mode is on Plus and Pro plans, and on Business, Enterprise and Edu if an admin allows it.
API
The same data as JSON, with no sign-in. See the OpenAPI description for every endpoint and field.
CLI
Search the directory and print the command to connect a vendor's server, from your terminal. Needs Node 18 or later. View on npm
Show that your MCP server is verified
If you work at FirstPromoter, add this badge to your MCP docs or README. It's free, it's the same for every vendor, and it updates from our daily checks: it shows uptime while the server responds, and says so if it stops.
Something wrong or out of date? Suggest a correction or email us, and we'll check it against the evidence. Every correction we make is listed on Corrections.