FirstPromoter MCP Server

Documentation

Documentation link · transport

Tools

• get_company_context — Campaigns, currency, active/pending promoter counts. The "what is this company?" entry point.
• get_dashboard_stats — Revenue, referrals, customers, accepted/pending promoters, pending commissions.
• get_dashboard_trending — Top 3 trending promoters and campaigns over the last 30 days.
• get_overview_report — Revenue, referrals, customers, clicks, sales, refunds and earnings grouped by day, week, month or year.
• get_promoters_report — Performance ranking per promoter for a date range.
• get_campaigns_report — Performance ranking per campaign for a date range.
• get_urls_report — Landing-page traffic broken down by clicks, customers, sales and revenue.
• get_traffic_sources_report — Where referral traffic comes from - direct, organic, social, paid.
• list_campaigns — Every campaign with key metrics.
• get_campaign — Full detail for one campaign by ID.
• create_campaign — New campaign in the company's default program; attach rewards in the same call.
• update_campaign — Change name, landing URL, cookie life, referral param, visibility, attached rewards.
• list_promoters — Filterable by status, signup/approval date, campaign, revenue. Supports a q parameter for fuzzy search.
• get_promoter — Detailed profile, balances, campaign membership and all profile fields.
• create_promoter — New promoter on an initial campaign with profile data.
• update_promoter — Every field the admin Edit modal exposes, including custom fields and behaviour flags.
• accept_promoter — State change scoped to a single campaign; verifies the per-campaign state persisted.
• reject_promoter — State change scoped to a single campaign.
• block_promoter — State change scoped to a single campaign.
• add_promoter_to_campaign — Enrol in an additional campaign without affecting existing memberships.
• move_promoter_to_campaign — Move between campaigns; optionally soft-move existing referrals.
• assign_parent_promoter — Set or remove the parent in a sub-affiliate hierarchy.
• restore_promoter — Bring an archived promoter back - history and referrals preserved.
• update_promoter_campaign — Per-promoter overrides on a specific campaign - ref token, coupon, direct URL, state, reward override.
• list_referrals — Filter by state, date range, campaign, promoter; sorted newest first.
• get_referral — Single referral with promoter, campaign, customer email and the full event log.
• list_commissions — Filter by status, date, campaign, promoter.
• list_payouts — Cash rewards paid to promoters; amounts in cents.
• mark_commission_fulfilled — For non-monetary commissions only (badges, points, free months).
• mark_commission_unfulfilled — Revert a fulfilled non-monetary commission.
• list_rewards — All reward rules defined in the company.
• get_reward — Single reward with name, type, schemas, tier level and coupon.
• create_reward — New commission or discount rule.
• update_reward — Change name, type, schemas, coupon, tier.
• hide_reward — Soft-delete a reward; existing attachments and pending commissions keep working.
• list_promo_codes — Codes attached to promoters or campaigns; optional filters for promoter campaign and archived.
• get_promo_code — Single code with reward and scope details.
• create_promo_code — New code attached to a reward, optionally scoped to a promoter and campaign.
• update_promo_code — Change code, description, reward, scope.
• archive_promo_code — Soft-delete; preserved for historical reporting, new redemptions rejected.
• list_products — SKUs that can have product-specific commission rules attached.
• get_product — Single product detail.
• create_product — New product with name, external billing-provider ID and prices.
• update_product — Update name, external billing-provider ID and prices.
• delete_product — Permanent delete; historical sales keep the name as a snapshot.
• list_assets — Marketing assets (banners, swipe copy, images) promoters can download.
• get_asset — Single asset detail.
• list_contracts — Affiliate program contracts (Terms of Service, NDAs) that promoters agree to.
• get_contract — Single contract detail.
• list_emails — Filter by status (draft, scheduled, sent, failed) and trigger event.
• get_email — Full HTML body and trigger configuration for a single email.
• create_email — Draft a new transactional email tied to a trigger event; created disabled for admin review.
• update_email — Edit name, subject, body or trigger on a non-sent email.

About MCP

The Model Context Protocol (MCP) is an open protocol Anthropic introduced for connecting LLM-based agents to external tools and data sources. Providers publish MCP servers that expose their API surface as structured, discoverable tools — an MCP-compatible client (Claude Desktop, Cursor, Cline, Continue, etc.) can connect to the server and call its tools without any per-provider integration code.

Browse every MCP server on the APIs.io network or compare with the broader Agent Skill surfaces of the same providers.

Work with this as data

Every MCP server here is available over the APIs.io API and to AI agents over MCP.

curl "https://apis.io/api/v1/mcp/firstpromoter-mcp-server"

curl "https://apis.io/api/v1/mcp?limit=25"