PopMCP
rewardful_affiliate_See one affiliate in full in one call: their details and links, what they earned by state and currency, their payouts, coupons and most recent referrals.
Rewardful MCP server for your AI
Ask who your best affiliates are, see which referrals turned into paying customers, check who is due a payout and record it once it is paid, all in the Rewardful account that already runs your affiliate program.
PopMCPRewardful
How is our affiliate program doing, and how much do we owe right now?
Supported Rewardful tools
Every documented endpoint in Rewardful's REST API, with the everyday program tools loaded by default, plus one-call answers for how the program is doing, how one affiliate is doing and who is owed money.
34 tools in the full catalog: 19 read and 15 write. 30 load by default, and the rest are found with tool search.
rewardful_find_Find affiliates by email, name or referral code.
rewardful_payouts_See who is owed money now: every due payout with the affiliate's name, email, PayPal and Wise addresses, and totals by currency.
rewardful_program_Get the state of the whole affiliate program in one call: each campaign's visitors, leads, conversions and affiliates; how many affiliates, referrals by state and commissions by state; and what is due to be paid, by currency.
rewardful_record_Put a refund on a manually recorded sale, keeping everything else as it was.
rewardful_top_Rank affiliates by visitors, leads or conversions, with each one's commission figures.
rewardful_create_Add an affiliate, in your default campaign unless campaign_id is given.
rewardful_get_Read one affiliate: name, email, payout emails, state, campaign, links, coupon and totals.
rewardful_list_List affiliates, newest first, with state, email, campaign, links and their visitors, leads and conversions.
rewardful_update_Change an affiliate.
rewardful_create_Give an affiliate an extra link.
rewardful_create_Create a campaign.
rewardful_get_Read one affiliate link with its visitors, leads and conversions.
rewardful_get_Read one campaign in full: its reward, payout rules, referral expiry, dashboard text and totals.
rewardful_get_Read one commission with its sale, referral and affiliate.
rewardful_list_List affiliate links, newest first, across all affiliates: full url, token, visitors, leads, conversions and affiliate_id.
rewardful_list_List your affiliate campaigns: each one's name, base link, reward (percent or fixed amount in cents), minimum payout in cents, and its visitors, leads, conversions and affiliates.
rewardful_list_List commissions, newest first: what affiliates earned.
rewardful_update_Change a link's token.
rewardful_update_Change a campaign.
rewardful_create_Assign a coupon code to an affiliate so sales using it are credited to them.
rewardful_create_Record a sale directly, for a payment made outside a connected payment processor.
rewardful_get_Read one affiliate coupon.
rewardful_get_Read one payout with its affiliate and commissions.
rewardful_list_List affiliate coupons: the code (token), the id at the payment processor, whether it is archived, leads, conversions and affiliate_id.
rewardful_list_List payouts, newest first: the commissions owed to one affiliate, bundled.
rewardful_list_List sales from referred customers.
rewardful_mark_Record a payout and all its commissions as paid.
rewardful_convert_Mark a visitor referral as a lead when they sign up, with their name and email.
rewardful_list_List referrals, newest first: people who arrived through an affiliate link, with their state (visitor, lead or conversion), customer details, link, visits and key dates.
rewardful_create_Make an one-time link that logs an affiliate straight into their Rewardful dashboard.
rewardful_delete_Permanently delete a commission and recalculate the affiliate's and campaign's figures.
rewardful_update_Change a commission's paid_at or due_at.
rewardful_update_Replace a manually recorded sale.
Connect Rewardful to Claude, ChatGPT and Claude Code
Credentials off one Rewardful screen, then an endpoint your client signs into. Nothing to deploy, and nothing to install.
Open Company settings in Rewardful, copy the API Secret, and paste it into PopMCP. Copy the secret rather than the API Key shown on the same page, which is only for the tracking script. There is no app to review and nothing to deploy.
API Secret
••••••••••••3f7aConnectionVerified
Adding affiliates, recording sales, editing commissions and marking payouts as paid are writes and wait until an owner or admin allows write actions; new connections start read-only. Rewardful's API Secret has no narrower kind, so this switch in PopMCP is the limit that counts. The AI is told to ask before anything that changes money records.
Reach Rewardful
Reach other connectors
Teammates on read-only
Drop the PopMCP URL into Claude, ChatGPT, Claude Code, Codex or any other supported client. It signs in through PopMCP with OAuth, so your Rewardful credential never leaves the server.
app.popmcp.com/mcp
Claude wants to connectApproveAsk for something harmless before the agent changes anything. Writes run as soon as it calls them, so confirm it reads the right account first.
How is our affiliate program doing, and how much do we owe right now?
rewardful_program_overviewok
Then just ask for the work
“How is our affiliate program doing, and how much do we owe right now?”
- program_overview
“Who are our top ten affiliates by conversions, and what have they earned?”
- top_affiliates
“Show me everything on Adam Jones: his links, earnings, payouts and latest referrals”
- find_affiliate
- affiliate_overview
“Who is due a payout, and what PayPal or Wise address does each of them use?”
- payouts_due
“Mark Joe's due payout as paid”
- payouts_due
- mark_payout_paid
“Add Priya Shah as an affiliate on the partners campaign with the code priya”
- list_campaigns
- create_affiliate
“Which referrals became paying customers this month, and through which affiliate?”
- list_referrals
“We refunded 25 dollars on order abc-123. Update that sale in Rewardful”
- record_sale_refund
Use Rewardful from the assistant you already open
One hosted endpoint, registered once per client. The same tools and the same permissions, whichever window the request comes from.
Claude DesktopCustom connector
Add the PopMCP URL under Customize → Connectors and the tools appear in every chat.
Claude WebCustom connector
The same endpoint, registered in the browser. Nothing to install on the machine you are working from.
ChatGPTCustom connector
Register PopMCP as a custom connector, then let ChatGPT read and update the account.
CodexDesktop & CLI
Wire the endpoint into Codex or the Codex CLI when a task needs live business context, not a fixture.
OpenCodeCoding agent
Register the remote MCP server in OpenCode's config for terminal-first and scripted agent runs.
ZCodeDesktop app
Add PopMCP as an MCP server in Z.ai's desktop app and work the account from the same window.
Explore other MCP servers
Every one of them runs on the same hosted endpoint, with the same controls.
FAQ
Rewardful MCP server questions
What teams ask before putting Rewardful behind an AI client.
What does PopMCP need to connect Rewardful?
Your API Secret, from the Company settings page in Rewardful. It is one field. PopMCP stores it encrypted and checks it against Rewardful when you connect. The secret never reaches your AI client.
Which value do I copy, the API Key or the API Secret?
The API Secret. Company settings shows both, and the API Key only works in the tracking script on your website. If you paste the API Key, Rewardful refuses it and PopMCP tells you to copy the secret instead.
Can I give the AI read-only access?
Yes, and new connections start that way. Rewardful's API Secret always has full access to the account, so the limit is PopMCP's: while write actions are off, every tool that changes something is hidden and refused.
Does marking a payout as paid send the money?
Rewardful documents it as a record, not a transfer: the payout and its commissions are marked as paid. Pay the affiliate through your own route, such as PayPal or Wise. The answer usually says processing, which is normal, because Rewardful queues the change.
Which Rewardful plan do I need?
Any of them. Rewardful lists REST API access on Starter, Growth and Enterprise. A few actions depend on the plan: Starter allows one campaign and no invite-only campaigns, and Rewardful's API docs limit extra affiliate links and a Stripe coupon on a campaign to Growth and Enterprise.
Can the AI log in as one of my affiliates?
Only if you allow write actions and ask for it. A magic link logs an affiliate into their dashboard, lasts one minute, works once and cancels their earlier links, so it is treated as a write and stays out of the default tools.
Do I have to run or host the Rewardful MCP server myself?
No. PopMCP hosts it and gives you a Streamable HTTP MCP URL. There is nothing to deploy, no callback URL to register, and no infrastructure to keep running or patch.
Which AI clients can use this MCP server?
Any client that supports a remote Streamable HTTP MCP server: Claude Desktop, Claude Web, Claude Code, ChatGPT custom connectors, Codex and the Codex CLI, OpenCode and Z.ai's ZCode, as well as editors such as Cursor, Windsurf and Zed. Your client signs in to PopMCP with OAuth; the provider credential never leaves the server.
How do I connect Rewardful to Claude Code?
Connect Rewardful in PopMCP first, then run claude mcp add --transport http popmcp https://app.popmcp.com/mcp in a terminal. Inside Claude Code, run /mcp and sign in to PopMCP in the browser window it opens, ticking Rewardful on the consent screen. The Rewardful tools are then available in that session, and no Rewardful credential is stored on your machine.
Why do only 30 of the 34 tools load by default?
Loading 34 tool definitions into every conversation burns context before the work starts. PopMCP loads a curated 30-tool set covering the everyday workflows and keeps the rest searchable, so your AI pulls a specialist tool only when a task needs it. Every tool stays searchable, and on Scale the owner can load the full catalog for a teammate's connection.
What is the difference between a tool and a trigger?
A tool is something your AI calls, and there are 34 here. A trigger is something PopMCP watches for you: 11 Rewardful events that can start work on the PopMCP side. Triggers never enter your AI client's context, and none of them ask you to paste a callback URL into Rewardful.
Connect Rewardful to your AI in minutes
Launch a hosted MCP endpoint for Rewardful, keep tool access under control, and start testing real workflow prompts right away.