MCP server
Rewardful MCP by usefulapi
Browse affiliates, referrals, commissions and payouts, and set up campaigns and…
- Runs
- Remotely
- Version
- 1.40.0
- Listing updated
- 4 days ago
About Rewardful MCP by usefulapi
Rewardful MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Browse affiliates, referrals, commissions and payouts, and set up campaigns and affiliates.
Install
Run in a terminal
claude mcp add --transport http rewardful https://rewardful.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://rewardful.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"rewardful": {
"url": "https://rewardful.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"rewardful": {
"type": "http",
"url": "https://rewardful.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"rewardful": {
"serverUrl": "https://rewardful.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"rewardful": {
"type": "http",
"url": "https://rewardful.usefulapi.io/mcp"
}
}
}Tools this server provides (20)
Read directly from the server.
- rewardful_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
- Fetch a single campaign by id. Rewardful: GET /v1/campaigns/:id.
- rewardful_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
- 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
- List affiliate links (URL, token, visitors, leads, conversions, affiliate_id), newest first. Rewardful: GET /v1/affiliate_links.
- rewardful_get_affiliate_link
- Fetch a single affiliate link by id. Rewardful: GET /v1/affiliate_links/:id.
- rewardful_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
- Fetch a single affiliate coupon by id. Rewardful: GET /v1/affiliate_coupons/:id.
- rewardful_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
- 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
- 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
- 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
- Fetch a single payout by id, with the affiliate and the commissions it bundles. Rewardful: GET /v1/payouts/:id.
- rewardful_create_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
- 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
- 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
- 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
- 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
- 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
- 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 MCP by usefulapi FAQ
How do I add Rewardful MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http rewardful https://rewardful.usefulapi.io/mcp