Browse affiliates, referrals, commissions and payouts, and set up campaigns and affiliates. Hosted by usefulapi — connect from Claude, Cursor, or any MCP client.
Add to your MCP config, then reload & authorize:
{
"mcpServers": {
"rewardful": {
"url": "https://rewardful.usefulapi.io/mcp"
}
}
}| Tool | Type | What it does |
|---|---|---|
rewardful_list_campaigns | read | List campaigns List the affiliate program's campaigns with their reward rules (percent or fixed commission, payout minimum, referral expiry) and totals (visitors, leads, conversions, affiliates). Rewardful: GET /v1/campaigns. |
rewardful_get_campaign | read | Get one campaign Fetch a single campaign by id. Rewardful: GET /v1/campaigns/:id. |
rewardful_list_affiliates | read | List affiliates List affiliates, newest first, with visitors/leads/conversions. Filter by campaign, or look one up by email or Stripe customer id (returns zero or one). Expand campaign, links or commission_stats for more detail. Rewardful: GET /v1/affiliates. |
rewardful_get_affiliate | read | Get one affiliate Fetch a single affiliate by id, including their campaign, links, coupon and visitor/lead/conversion counts. Rewardful: GET /v1/affiliates/:id. |
rewardful_list_affiliate_links | read | List affiliate links List affiliate links (URL, token, visitors, leads, conversions, affiliate_id), newest first. Rewardful: GET /v1/affiliate_links. |
rewardful_get_affiliate_link | read | Get one affiliate link Fetch a single affiliate link by id. Rewardful: GET /v1/affiliate_links/:id. |
rewardful_list_affiliate_coupons | read | List affiliate coupons List affiliate coupon / promotion codes (token, Stripe id, leads, conversions, archived), optionally for one affiliate. Rewardful: GET /v1/affiliate_coupons. |
rewardful_get_affiliate_coupon | read | Get one affiliate coupon Fetch a single affiliate coupon by id. Rewardful: GET /v1/affiliate_coupons/:id. |
rewardful_list_referrals | read | List referrals List referrals — visitors who arrived via an affiliate link — newest first, with their conversion state (visitor, lead, conversion), customer and link. Filter by affiliate, state, email, Stripe customer or an updated-at window. Rewardful: GET /v1/referrals. |
rewardful_list_commissions | read | List commissions List commissions (rewards owed for referred customers' payments) newest first, with amount in cents, currency and state (pending, due, paid, voided). Filter by affiliate or state; expand the sale (with referral, customer and affiliate) or campaign. Rewardful: GET /v1/commissions. |
rewardful_get_commission | read | Get one commission Fetch a single commission by id, with its campaign and the sale (charge, refund and tax amounts, referral, customer, affiliate) that earned it. Rewardful: GET /v1/commissions/:id. |
rewardful_list_payouts | read | List payouts List payouts — bundles of an affiliate's payable commissions — newest first, with amount, currency and state (pending, due, processing, paid). Filter by affiliate or state; expand affiliate or commissions. Rewardful: GET /v1/payouts. |
rewardful_get_payout | read | Get one payout Fetch a single payout by id, with the affiliate and the commissions it bundles. Rewardful: GET /v1/payouts/:id. |
rewardful_create_campaign | write | Create a campaign Create a new affiliate campaign with its reward rule. For reward_type percent pass commission_percent; for amount pass commission_amount_cents and commission_amount_currency. Rewardful: POST /v1/campaigns. |
rewardful_update_campaign | write | Update a campaign Change a campaign's name, URL, visibility, reward rule, payout minimum or coupon. Only the fields you pass change. Rewardful: PUT /v1/campaigns/:id. |
rewardful_create_affiliate | write | Create an affiliate Add an affiliate (or a customer referrer, by passing stripe_customer_id). Rewardful sends NO welcome email for API-created affiliates. Rewardful: POST /v1/affiliates. |
rewardful_update_affiliate | write | Update an affiliate Change an affiliate's name, email, payout emails, notifications, campaign (moves them) or state. Setting state to disabled stops tracking and earning; set it back to active to undo. Rewardful: PUT /v1/affiliates/:id. |
rewardful_create_affiliate_link | write | Create an affiliate link Give an affiliate an additional tracking link. A token is generated if omitted. Growth/Enterprise plans only. Rewardful: POST /v1/affiliate_links. |
rewardful_update_affiliate_link | write | Change an affiliate link's token Change the token of an existing affiliate link. WARNING: the old token stops tracking immediately — links already shared with it break. Prefer rewardful_create_affiliate_link to add a second token. Rewardful: PUT /v1/affiliate_links/:id. |
rewardful_create_affiliate_coupon | write | Create an affiliate coupon Assign a coupon / promotion code to an affiliate so sales using it are credited to them. The code must match one defined in Stripe, and the affiliate's campaign must have a campaign coupon set in the dashboard. Rewardful: POST /v1/affiliate_coupons. |
rewardful_usage_status | Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter. | |
rewardful_upgrade | Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED Rewardful tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Read-only; does not count against the meter. |
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 100 tool calls / month |
| Proper user | $9/mo · $90/yr | Unlimited |
This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.