Rewardful MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.39.1Updated Nov 14, 2026

Browse affiliates, referrals, commissions and payouts, and set up campaigns and affiliates.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server for Rewardful that lets an assistant browse affiliate campaigns, affiliates, referrals, commissions and payouts, and create or update…

What you can do
  • List and fetch campaigns, affiliates, affiliate links and coupons, with filters and optional expansion
  • List and fetch referrals, commissions and payouts, including amounts, currency and states
  • Create and update campaigns, including reward rules and payout minimums
  • Create and update affiliates, including moving them between campaigns or disabling them
  • Create affiliate links and assign Stripe coupon codes to affiliates
  • Check usage, request a feature, upgrade or cancel the paid plan
When to use it
Useful when you run a Rewardful affiliate program and want to ask questions about affiliate performance, owed commissions or recent payouts in chat, or set up campaigns, affiliates, links and coupons without opening the dashboard.
Requirements
Remote MCP endpoint; no local install. Connect with the URL only and sign in through OAuth, providing your Rewardful API Secret from the company API settings. A free tier allows 50 tool calls per month; paid plans raise the limit.
Before you install
You hand your Rewardful API Secret to a third-party host, which stores it per user. Write tools change live affiliate-program data: disabling an affiliate stops tracking and earning, and changing a link token immediately breaks links already shared. Paid plans cost money and are billed through a checkout link; upgrades charge the price difference immediately and cancellation gives no refund for the current period.

Installation

In SourceWeft

  1. Open Rewardful MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Frewardful/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "rewardful-by-usefulapi": {
      "type": "http",
      "url": "https://rewardful.usefulapi.io/mcp"
    }
  }
}

README

Rewardful MCP by usefulapi

Use Rewardful from Claude, Cursor, or any MCP client — list campaigns, affiliates, links, coupons, referrals, commissions and payouts, and set up campaigns and affiliates. Hosted, no local install: connect with your own Rewardful credentials.

Live endpoint: https://rewardful.usefulapi.io/mcp · Homepage: https://usefulapi.io/rewardful

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://rewardful.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http rewardful https://rewardful.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "rewardful": {      "url": "https://rewardful.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Rewardful credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/rewardful/

On first connect you'll provide your Rewardful API Secret (Company settings, API section). They're validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
rewardful_list_campaignsreadList campaigns
rewardful_get_campaignreadGet one campaign
rewardful_list_affiliatesreadList affiliates
rewardful_get_affiliatereadGet one affiliate
rewardful_list_affiliate_linksreadList affiliate links
rewardful_get_affiliate_linkreadGet one affiliate link
rewardful_list_affiliate_couponsreadList affiliate coupons
rewardful_get_affiliate_couponreadGet one affiliate coupon
rewardful_list_referralsreadList referrals
rewardful_list_commissionsreadList commissions
rewardful_get_commissionreadGet one commission
rewardful_list_payoutsreadList payouts
rewardful_get_payoutreadGet one payout
rewardful_create_campaignwriteCreate a campaign
rewardful_update_campaignwriteUpdate a campaign
rewardful_create_affiliatewriteCreate an affiliate
rewardful_update_affiliatewriteUpdate an affiliate
rewardful_create_affiliate_linkwriteCreate an affiliate link
rewardful_update_affiliate_linkwriteChange an affiliate link's token
rewardful_create_affiliate_couponwriteCreate an affiliate coupon
rewardful_usage_statusmetaUsage status (free-tier meter)
rewardful_request_featuremetaRequest a missing feature
rewardful_upgrademetaUpgrade to Pro or Pro+
rewardful_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+ (per user)$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run rewardful_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with rewardful_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with rewardful_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by Rewardful.

Source: servers/rewardful/README.md at commit f22f848

Tools

20

rewardful_list_campaigns

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.

Parameterspagelimit

rewardful_get_campaign

Get one campaign

Fetch a single campaign by id. Rewardful: GET /v1/campaigns/:id.

Parameterscampaign_idrequired

rewardful_list_affiliates

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.

Parameterspageemaillimitexpandcampaign_idstripe_customer_id

rewardful_get_affiliate

Get one affiliate

Fetch a single affiliate by id, including their campaign, links, coupon and visitor/lead/conversion counts. Rewardful: GET /v1/affiliates/:id.

Parametersaffiliate_idrequired

rewardful_list_affiliate_coupons

List affiliate coupons

List affiliate coupon / promotion codes (token, Stripe id, leads, conversions, archived), optionally for one affiliate. Rewardful: GET /v1/affiliate_coupons.

Parameterspagelimitaffiliate_id

rewardful_get_affiliate_coupon

Get one affiliate coupon

Fetch a single affiliate coupon by id. Rewardful: GET /v1/affiliate_coupons/:id.

Parameterscoupon_idrequired

rewardful_list_referrals

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.

Parameterspageemaillimitexpandaffiliate_idupdated_sinceupdated_untilconversion_statestripe_customer_id

rewardful_list_commissions

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.

Parameterspagelimitstateexpandaffiliate_id

rewardful_get_commission

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.

Parameterscommission_idrequired

rewardful_list_payouts

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.

Parameterspagelimitstateexpandaffiliate_id

rewardful_get_payout

Get one payout

Fetch a single payout by id, with the affiliate and the commissions it bundles. Rewardful: GET /v1/payouts/:id.

Parameterspayout_idrequired

rewardful_create_campaign

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.

Parametersurlrequirednamerequiredprivatereward_typerequiredstripe_coupon_idcommission_percentminimum_payout_centscommission_amount_centscommission_amount_currency

rewardful_update_campaign

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.

Parametersurlnameprivatecampaign_idrequiredreward_typestripe_coupon_idcommission_percentminimum_payout_centscommission_amount_centscommission_amount_currency

rewardful_create_affiliate

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.

Parametersemailrequiredstatetokenlast_namerequiredfirst_namerequiredwise_emailcampaign_idpaypal_emailstripe_customer_idreceive_new_commission_notifications

rewardful_update_affiliate

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.

Parametersemailstatelast_namefirst_namewise_emailcampaign_idaffiliate_idrequiredpaypal_emailstripe_customer_idreceive_new_commission_notifications

rewardful_create_affiliate_coupon

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.

Parameterstokenrequiredaffiliate_idrequired

Version history

25
  1. v1.39.1LatestNov 13, 2026
  2. v1.38.0Nov 12, 2026
  3. v1.37.3Nov 11, 2026
  4. v1.36.5Nov 8, 2026
  5. v1.36.4Nov 7, 2026
  6. v1.35.3Nov 5, 2026
  7. v1.35.2Nov 5, 2026
  8. v1.35.1Nov 4, 2026
  9. v1.35.0Nov 3, 2026
  10. v1.34.1Nov 3, 2026
  11. v1.33.0Nov 1, 2026
  12. v1.31.0Oct 31, 2026
  13. v1.30.0Oct 31, 2026
  14. v1.29.2Oct 30, 2026
  15. v1.29.0Oct 30, 2026
  16. v1.24.0Oct 26, 2026
  17. v1.21.3Oct 25, 2026
  18. v1.21.0Oct 25, 2026
  19. v1.20.0Oct 24, 2026
  20. v1.17.0Oct 23, 2026
  21. v1.16.4Oct 22, 2026
  22. v1.16.3Oct 21, 2026
  23. v1.11.1Oct 9, 2026
  24. v1.10.0Oct 9, 2026
  25. v1.0.0Sep 30, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations