Repository avatar
Monitoring
v0.1.3
active

openpromoter-mcp

io.github.openpromoter/openpromoter-mcp

Affiliate program data and actions from OpenPromoter. No tool can send money.

Documentation

OpenPromoter logo

OpenPromoter

Open-source affiliate and referral program software for SaaS

A self-hosted alternative to Rewardful, FirstPromoter and Tolt. Track referrals from Stripe, stop affiliate fraud and pay partners with 0% payout fees.

Website · Watch the film (1:20) · Live demo · Docs · Self-hosting · API · Discussions

License: AGPL-3.0 Self-host with Docker Payout fees: 0% MCP server

OpenPromoter launch film: 0% payout fees. Play the 80-second film on YouTube

▶ Watch OpenPromoter in 80 seconds: one sale from a partner link to a paid payout.



OpenPromoter affiliate program dashboard with referred revenue, partner balance and payouts waiting for approval

Why OpenPromoter

Affiliate software for SaaS usually costs $49 to $99 a month, and some tools also take a share of every payout. OpenPromoter is open-source affiliate software that you can self-host for free. Every feature ships in this repository.

Use it for an affiliate program with creators, a referral program for your customers or a partner program with agencies. Partners share a link or a coupon. OpenPromoter turns each paid sale into a commission and pays it out.

  • 0% of your payouts on every plan, self-hosted or Cloud.
  • Every billing system at once: Stripe, Paddle, Lemon Squeezy, Polar and Chargebee.
  • Fraud checks before money moves: risky commissions are held for review.
  • AI with an undo button: it designs the program and drafts the work. A person approves every payout.
  • Your data on your server: one docker compose up and Postgres.

Open-source alternative to Rewardful and FirstPromoter

Here is how OpenPromoter compares with the paid affiliate tools most SaaS founders look at first.

Entry priceFee on payoutsOpen source
OpenPromoter$0 (self-host or Cloud Free)0%Yes (AGPL-3.0)
Rewardful$49/mo0%, or 3% with Managed PayoutsNo
FirstPromoter$49/moNone listedNo
Tolt$99/mo2% of payoutsNo
Dub Partners$81/mo5%, or 8% card-fundedPartner code is closed
PartnerStackQuote after a demoUnpublished processing feeNo

List prices from each vendor's pricing page as of November 2026. Sources and full comparisons: Rewardful, FirstPromoter, Tolt, Dub Partners and PartnerStack. See every alternative.

Switching is a CSV import of your partners, the customers they referred and their balances. Links that use ?via=, ?fpr=, ?ref=, ?gspk= or Lemon Squeezy's ?aff= keep working. Renewals keep paying the same partner and unpaid balances go into the next payout. Partners don't have to change anything. See switching from another affiliate tool.

Try the live demo

Open the live demo to use a working account with sample data. It has the founder dashboard and the partner portal with no sign-up and no card. It rebuilds every day and is read-only.

Quick start

git clone https://github.com/openpromoter/openpromoter
cd openpromoter
docker compose up

Open http://localhost:3000 and sign in to the demo workspace with demo@openpromoter.test and openpromoter-demo. It holds 100,000 clicks, 10,000 conversions and payouts waiting for approval. Emails land in Mailpit at http://localhost:8025.

Deploy to a server

Deploy to Render

Render reads render.yaml and creates the app and its Postgres database. On Railway, Fly.io or your own VPS, run the Dockerfile with Postgres 16 and set these variables:

VariableWhat it is
DATABASE_URLPostgres connection string
APP_URLThe public URL such as https://affiliates.yourapp.com
BETTER_AUTH_SECRETA long random string for sessions
ENCRYPTION_KEYA long random string that encrypts provider keys and tax IDs
SMTP_URL or RESEND_API_KEYWhere email goes, with EMAIL_FROM as the sender
SEED_DEMOfalse in production

The container refuses to start on a public URL with the placeholder secrets. Every setting is in .env.example, and the self-hosting guide walks through Railway, Render and upgrades.

How it works

  1. Paste your website. OpenPromoter pulls your logo, color and copy to brand the partner portal.
  2. Connect Stripe with a restricted key, or OAuth on Cloud. It imports products, customers and subscriptions and registers the webhook.
  3. Accept the AI-designed program. Rate, duration, cookie window, customer discount, tiers and payout rules each come with a short reason.
  4. Install the tracking script. Add one script tag, use the npm SDK or paste one prompt into any coding agent.
  5. Invite partners. The recruiter has already ranked your happiest paying customers.

Features

Affiliate tracking with Stripe attribution

  • First-party cookie through op.js with a configurable window and first-click or last-click attribution.
  • Consent mode, cookieless mode and a first-party route that ad blockers leave alone.
  • Server-side attribution through Stripe Checkout client_reference_id, customer metadata and promotion codes.
  • Coupon attribution without a click and signup (lead) tracking.
  • A discount for referred customers, applied at Stripe Checkout by the SDK.
  • Short links, deep links, sub-IDs, UTM capture, QR codes and custom domains such as partners.yourapp.com.
  • Trials, upgrades, refunds, chargebacks and cancellations adjust commissions automatically.

Read more: affiliate tracking.

Fraud detection

Every referral gets a risk score from 0 to 100. It checks self-referral, shared networks, duplicate accounts, coupon leaks and paid ads on your brand. It also catches click spam, bots, refunds after payout, fast churn, shared payout accounts and self-recruiting. Commissions above your threshold are held until you review them.

Read more: affiliate fraud detection.

Partner and affiliate management

  • A branded partner portal on your own domain or embedded in your app.
  • Applications with custom questions and auto-approve rules. Approved and rejected applicants each get an email.
  • Tiers with automatic promotion and per-partner rates.
  • Public, private or invite-only programs.
  • Messages, announcements, campaigns, bounties and contests.
  • Two-tier commissions, one level deep and off by default.
  • A public partner marketplace that founders opt into.

Read more: partner portal.

Switching from another affiliate tool

  • Import three CSV files in Settings > Import: partners, the customers they referred and their balances.
  • Partners keep their codes exactly as exported. Old ?via=, ?fpr=, ?ref=, ?gspk= and Lemon Squeezy's ?aff= links keep working.
  • Each customer stays with the partner who brought them. Renewals keep paying that partner and a one-time commission is never paid twice.
  • Files that name partners only by the old tool's ID still match. Tolt exports work this way.
  • Unpaid balances join the next payout. Totals already paid count toward each partner's lifetime earnings.
  • Lists of single commissions, amounts in cents and exports split across files all work. Running a file twice adds nothing.

Read more: the import guide.

Payouts and tax

  • A ledger that moves each commission from pending to approved to paid, or to held and reversed.
  • Refund hold periods, minimum payouts and multiple currencies.
  • Pay through Stripe Connect Express, PayPal Payouts, Wise or a CSV export.
  • Every batch waits for a person to approve it. Large batches ask for a fresh 2FA code.
  • W-9 and W-8BEN collection, a 1099-NEC export and self-billed invoices with EU reverse charge and VIES checks.

Read more: affiliate payouts.

AI that you can undo

AI features run on Anthropic by default. OpenAI and any OpenAI-compatible endpoint such as Ollama or LM Studio also work. Without a key, rules and templates stand in for the model.

  • Program designer proposes commission, duration and tiers from your prices.
  • Recruiter ranks customers and creators and drafts their invites.
  • Weekly Autopilot re-engages quiet partners, promotes top performers and pauses risky ones. Every action is logged with an undo.
  • Campaign builder turns one sentence into a ready boost or contest.
  • Content kit writes swipe copy, posts and emails for partners.
  • Assistant answers questions about your program in plain English.

AI never moves money. API keys, the MCP server and AI can prepare payouts, and only a signed-in person can approve them.

Read more: AI Autopilot.

Analytics

  • Referred revenue, MRR, clicks, signups, conversion, EPC and LTV for each partner.
  • Funnel, cohorts, top sources and links, owed against paid and period comparison.
  • Visitor analytics for every partner: clicks per day, sources, countries, devices, landing pages and sub-IDs. Partners see their own on a Traffic page.
  • CSV exports and weekly or monthly email reports.

Team and security

  • Workspaces with several programs and owner, admin, finance and viewer roles.
  • An audit log of every money, permission and AI action.
  • TOTP two-factor sign-in, encrypted provider keys and hashed IP addresses. Details: SECURITY.md.

Payout approval queue with partner amounts and payout methods Fraud review queue with risk scores and flags Autopilot suggestions with an undo for every action Partner list with status, revenue and earnings

Integrations

BillingPayoutsTrackingAlerts
StripeStripe Connect ExpressScript tag (op.js)Slack
PaddlePayPal PayoutsTypeScript SDKDiscord
Lemon SqueezyWiseREST APISigned webhooks
PolarCSV exportStripe metadataEmail reports
ChargebeeCoupon codes

Any other billing system can report payments through POST /api/v1/conversions. Setup guides for each one are on the integrations page.

For developers and AI agents

  • REST API with an OpenAPI spec at /api/openapi.json and scoped API keys.
  • Webhooks signed with HMAC-SHA256, with retries and a delivery log.
  • TypeScript SDK: npm install openpromoter. See packages/sdk.
  • CLI: npx openpromoter-cli. Its listen command forwards events to localhost. See packages/cli.
  • MCP server for any MCP client: Claude Desktop, Claude Code, Codex, Cursor, VS Code with GitHub Copilot, Windsurf, Gemini CLI and Zed. It is read-only by default and no tool can send money. See packages/mcp.
  • Remote MCP server at /mcp on your OpenPromoter URL (https://app.openpromoter.com/mcp on Cloud). Claude, ChatGPT and other apps connect with a sign-in. You pick the workspace and whether the app can make changes.
  • Agent skill: npx -y openpromoter-cli skill installs an "add an affiliate program" skill for Claude Code, Codex and Cursor. Any other coding agent works with the one-prompt install.
{
  "mcpServers": {
    "openpromoter": {
      "command": "npx",
      "args": ["-y", "openpromoter-mcp"],
      "env": { "OPENPROMOTER_API_KEY": "op_sk_...", "OPENPROMOTER_URL": "http://localhost:3000" }
    }
  }
}

Pricing

Self-host: free, with every feature and no limits on partners or revenue.

OpenPromoter Cloud: free up to $1,000 a month in partner revenue. Above that, plans cost $29, $79 or $199 a month, or 2 months free when you pay yearly ($290, $790 or $1,990), with AI included. No plan takes a percentage of your payouts.

FAQ

Is OpenPromoter free?

Yes. Self-hosting is free, with every feature and no limit on partners or revenue. OpenPromoter Cloud is also free until your partners bring in $1,000 a month.

Is there an open-source alternative to Rewardful?

OpenPromoter is one. It tracks Stripe and Paddle sales like Rewardful does and adds Lemon Squeezy, Polar and Chargebee. You can import your Rewardful partners, their referred customers and their commissions from CSV files.

How do I switch from another affiliate tool?

Export partners, referred customers and balances from Rewardful, FirstPromoter, Tolt or PartnerStack as CSV. Import them in that order in Settings > Import. Old links keep working and renewals keep paying the same partner.

Does it work without Stripe?

Yes. Paddle, Lemon Squeezy, Polar and Chargebee each connect directly. Any other billing system can send sales to the REST API.

Do I need cookies to track referrals?

No. A cookieless mode is built in, and Stripe sales are credited on the server through checkout and customer metadata. A renewal months later still pays the right partner.

What do I need to self-host it?

A server that runs Docker and a Postgres 16 database. The self-hosting guide covers Render, Railway and a plain VPS.

Tech stack

Next.js, React, TypeScript, PostgreSQL with Drizzle ORM, Better Auth, Tailwind CSS and Docker. Architecture notes are in ARCHITECTURE.md.

Development

pnpm install
docker compose up -d postgres mailpit
cp .env.example apps/app/.env.local
pnpm db:migrate && pnpm db:seed
pnpm --filter @openpromoter/app dev   # http://localhost:3000
pnpm test && pnpm e2e && pnpm lint

Contributing

Bug reports, ideas and pull requests are welcome. Read CONTRIBUTING.md first and sign the contributor agreement in your pull request. Ask questions in GitHub Discussions. Report security issues privately as SECURITY.md explains.

If OpenPromoter helps you, a star on GitHub helps other founders find it.

License

The app and server are AGPL-3.0. Anyone can use and self-host them for free. If you run a modified version as a service for others, you must publish your changes under AGPL-3.0.

The pieces you install in your own code or website are MIT. They are the SDK, the CLI, the MCP server and the scripts served to your site (op.js and embed.js).

Who builds it

OpenPromoter is built by Yash Kapoor, founder of DevDiggers. DevDiggers also makes a WooCommerce affiliate plugin that online stores use to run their own affiliate programs. OpenPromoter brings that experience to SaaS as open source.

Follow along on X, GitHub or LinkedIn.

NPM
openpromoter-mcp
Install Command
npm install openpromoter-mcp