MCPサーバー

rewardful

io.usefulapi/rewardful
マーケティング・広告 営業・CRM 公開・接続可能 MCP 2026-07-28

このMCPでできること

Manages affiliate campaigns, affiliates, tracking links, coupons, referrals, commissions and payouts.

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.
破壊的操作あり
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['first_name', 'last_name', 'email'], 'properties': {'email': {'type': 'string', 'minLength': 3, 'description': 'Email address.'}, 'state': {'enum': ['active', 'disabled', 'suspicious'], 'type': 'string', 'description': "Affiliate state. Disabled/suspicious affiliates stop tracking and earning and can't log in."}, 'token': {'type': 'string', 'pattern': '^[A-Za-z0-9-]+$', 'description': 'Link token, e.g. `jb007` for ?via=jb007. Letters, numbers and dashes only.'}, 'last_name': {'type': 'string', 'minLength': 1, 'description': 'Last name.'}, 'first_name': {'type': 'string', 'minLength': 1, 'description': 'First name.'}, 'wise_email': {'type': 'string', 'description': 'Wise address commissions should be paid to.'}, 'campaign_id': {'type': 'string', 'description': 'Campaign to put the affiliate in (default campaign if omitted on create).'}, 'paypal_email': {'type': 'string', 'description': 'PayPal address commissions should be paid to.'}, 'stripe_customer_id': {'type': 'string', 'description': 'Customer-referral programs only: the live-mode Stripe customer that receives account credits.'}, 'receive_new_commission_notifications': {'type': 'boolean', 'description': 'Email the affiliate when they earn a commission (default true).'}}}
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.
破壊的操作あり
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['affiliate_id', 'token'], 'properties': {'token': {'type': 'string', 'minLength': 1, 'description': 'The exact coupon / promotion code as defined in Stripe, e.g. MYCODE.'}, 'affiliate_id': {'type': 'string', 'minLength': 1, 'description': "The affiliate's id (UUID)."}}}
rewardful_create_affiliate_link
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.
破壊的操作あり
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['affiliate_id'], 'properties': {'token': {'type': 'string', 'pattern': '^[A-Za-z0-9-]+$', 'description': 'Link token, e.g. `jb007` for ?via=jb007. Letters, numbers and dashes only.'}, 'affiliate_id': {'type': 'string', 'minLength': 1, 'description': "The affiliate's id (UUID)."}}}
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.
破壊的操作あり
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['name', 'url', 'reward_type'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Base URL used to build affiliate links, e.g. https://example.com.'}, 'name': {'type': 'string', 'minLength': 1, 'description': "The campaign's name."}, 'private': {'type': 'boolean', 'description': 'true = invite-only; false = anyone can sign up.'}, 'reward_type': {'enum': ['percent', 'amount'], 'type': 'string', 'description': 'Percent of each sale, or a fixed amount.'}, 'stripe_coupon_id': {'type': 'string', 'description': 'Stripe coupon for double-sided incentives. Growth/Enterprise plans only.'}, 'commission_percent': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Commission percentage. Required when reward_type is percent.'}, 'minimum_payout_cents': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': "Minimum cumulative commissions before a payout, in cents of the company's display currency."}, 'commission_amount_cents': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Fixed commission in cents. Required when reward_type is amount.'}, 'commission_amount_currency': {'type': 'string', 'maxLength': 3, 'minLength': 3, 'description': 'ISO currency code of the fixed commission, e.g. USD. Required when reward_type is amount.'}}}
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.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['affiliate_id'], 'properties': {'affiliate_id': {'type': 'string', 'minLength': 1, 'description': "The affiliate's id (UUID)."}}}
rewardful_get_affiliate_coupon
Get one affiliate coupon
Fetch a single affiliate coupon by id. Rewardful: GET /v1/affiliate_coupons/:id.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['coupon_id'], 'properties': {'coupon_id': {'type': 'string', 'minLength': 1, 'description': "The affiliate coupon's id (UUID)."}}}
rewardful_get_affiliate_link
Get one affiliate link
Fetch a single affiliate link by id. Rewardful: GET /v1/affiliate_links/:id.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['link_id'], 'properties': {'link_id': {'type': 'string', 'minLength': 1, 'description': "The affiliate link's id (UUID)."}}}
rewardful_get_campaign
Get one campaign
Fetch a single campaign by id. Rewardful: GET /v1/campaigns/:id.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['campaign_id'], 'properties': {'campaign_id': {'type': 'string', 'minLength': 1, 'description': "The campaign's id (UUID)."}}}
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.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['commission_id'], 'properties': {'commission_id': {'type': 'string', 'minLength': 1, 'description': "The commission's id (UUID)."}}}
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.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['payout_id'], 'properties': {'payout_id': {'type': 'string', 'minLength': 1, 'description': "The payout's id (UUID)."}}}
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.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Page number, from 1. See pagination.next_page.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Results per page, 1-100 (default 25).'}, 'affiliate_id': {'type': 'string', 'description': "Only this affiliate's coupons."}}}
rewardful_list_affiliate_links
List affiliate links
List affiliate links (URL, token, visitors, leads, conversions, affiliate_id), newest first. Rewardful: GET /v1/affiliate_links.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Page number, from 1. See pagination.next_page.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Results per page, 1-100 (default 25).'}}}
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.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Page number, from 1. See pagination.next_page.'}, 'email': {'type': 'string', 'description': 'Only the affiliate with this email.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Results per page, 1-100 (default 25).'}, 'expand': {'type': 'array', 'items': {'enum': ['campaign', 'links', 'commission_stats'], 'type': 'string'}, 'description': 'Nested objects to include for each affiliate.'}, 'campaign_id': {'type': 'string', 'description': 'Only affiliates in this campaign.'}, 'stripe_customer_id': {'type': 'string', 'description': 'Only the customer-referrer affiliate tied to this Stripe customer (cus_...).'}}}
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.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Page number, from 1. See pagination.next_page.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Results per page, 1-100 (default 25).'}}}
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.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Page number, from 1. See pagination.next_page.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Results per page, 1-100 (default 25).'}, 'state': {'type': 'array', 'items': {'enum': ['pending', 'due', 'paid', 'voided'], 'type': 'string'}, 'description': 'Only commissions in these states.'}, 'expand': {'type': 'array', 'items': {'enum': ['sale', 'campaign'], 'type': 'string'}, 'description': 'Nested objects to include for each commission.'}, 'affiliate_id': {'type': 'string', 'description': "Only this affiliate's commissions."}}}
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.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Page number, from 1. See pagination.next_page.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Results per page, 1-100 (default 25).'}, 'state': {'type': 'array', 'items': {'enum': ['pending', 'due', 'processing', 'paid'], 'type': 'string'}, 'description': 'Only payouts in these states.'}, 'expand': {'type': 'array', 'items': {'enum': ['affiliate', 'commissions'], 'type': 'string'}, 'description': 'Nested objects to include for each payout.'}, 'affiliate_id': {'type': 'string', 'description': "Only this affiliate's payouts."}}}
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.
読み取り専用
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Page number, from 1. See pagination.next_page.'}, 'email': {'type': 'string', 'description': 'Only referrals with this customer email.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Results per page, 1-100 (default 25).'}, 'expand': {'type': 'array', 'items': {'enum': ['affiliate'], 'type': 'string'}, 'description': 'Include the full affiliate object for each referral.'}, 'affiliate_id': {'type': 'string', 'description': "Only this affiliate's referrals."}, 'updated_since': {'type': 'string', 'description': 'ISO 8601 timestamp: only referrals updated after it.'}, 'updated_until': {'type': 'string', 'description': 'ISO 8601 timestamp: only referrals updated before it.'}, 'conversion_state': {'type': 'array', 'items': {'enum': ['visitor', 'lead', 'conversion'], 'type': 'string'}, 'description': 'Only referrals currently in these conversion states.'}, 'stripe_customer_id': {'type': 'string', 'description': 'Only referrals with this Stripe customer (cus_...).'}}}
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.
破壊的操作あり
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['affiliate_id'], 'properties': {'email': {'type': 'string', 'minLength': 3, 'description': 'Email address.'}, 'state': {'enum': ['active', 'disabled', 'suspicious'], 'type': 'string', 'description': "Affiliate state. Disabled/suspicious affiliates stop tracking and earning and can't log in."}, 'last_name': {'type': 'string', 'minLength': 1, 'description': 'Last name.'}, 'first_name': {'type': 'string', 'minLength': 1, 'description': 'First name.'}, 'wise_email': {'type': 'string', 'description': 'Wise address commissions should be paid to.'}, 'campaign_id': {'type': 'string', 'description': 'Campaign to put the affiliate in (default campaign if omitted on create).'}, 'affiliate_id': {'type': 'string', 'minLength': 1, 'description': "The affiliate's id (UUID)."}, 'paypal_email': {'type': 'string', 'description': 'PayPal address commissions should be paid to.'}, 'stripe_customer_id': {'type': 'string', 'description': 'Customer-referral programs only: the live-mode Stripe customer that receives account credits.'}, 'receive_new_commission_notifications': {'type': 'boolean', 'description': 'Email the affiliate when they earn a commission (default true).'}}}
rewardful_update_affiliate_link
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.
破壊的操作あり
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['link_id', 'token'], 'properties': {'token': {'type': 'string', 'pattern': '^[A-Za-z0-9-]+$', 'description': 'Link token, e.g. `jb007` for ?via=jb007. Letters, numbers and dashes only.'}, 'link_id': {'type': 'string', 'minLength': 1, 'description': "The affiliate link's id (UUID)."}}}
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.
破壊的操作あり
入力スキーマ
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['campaign_id'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Base URL used to build affiliate links, e.g. https://example.com.'}, 'name': {'type': 'string', 'minLength': 1, 'description': "The campaign's name."}, 'private': {'type': 'boolean', 'description': 'true = invite-only; false = anyone can sign up.'}, 'campaign_id': {'type': 'string', 'minLength': 1, 'description': "The campaign's id (UUID)."}, 'reward_type': {'enum': ['percent', 'amount'], 'type': 'string', 'description': 'Percent of each sale, or a fixed amount.'}, 'stripe_coupon_id': {'type': 'string', 'description': 'Stripe coupon for double-sided incentives. Growth/Enterprise plans only.'}, 'commission_percent': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Commission percentage. Required when reward_type is percent.'}, 'minimum_payout_cents': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': "Minimum cumulative commissions before a payout, in cents of the company's display currency."}, 'commission_amount_cents': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Fixed commission in cents. Required when reward_type is amount.'}, 'commission_amount_currency': {'type': 'string', 'maxLength': 3, 'minLength': 3, 'description': 'ISO currency code of the fixed commission, e.g. USD. Required when reward_type is amount.'}}}
追加
rewardful_create_affiliate_coupon
2026年10月2日2:40
追加
rewardful_update_affiliate_link
2026年10月2日2:40
追加
rewardful_create_affiliate_link
2026年10月2日2:40
追加
rewardful_update_affiliate
2026年10月2日2:40
追加
rewardful_create_affiliate
2026年10月2日2:40
追加
rewardful_update_campaign
2026年10月2日2:40
追加
rewardful_create_campaign
2026年10月2日2:40
追加
rewardful_get_payout
2026年10月2日2:40
追加
rewardful_list_payouts
2026年10月2日2:40
追加
rewardful_get_commission
2026年10月2日2:40
追加
rewardful_list_commissions
2026年10月2日2:40
追加
rewardful_list_referrals
2026年10月2日2:40
追加
rewardful_get_affiliate_coupon
2026年10月2日2:40
追加
rewardful_list_affiliate_coupons
2026年10月2日2:40
追加
rewardful_get_affiliate_link
2026年10月2日2:40
追加
rewardful_list_affiliate_links
2026年10月2日2:40
追加
rewardful_get_affiliate
2026年10月2日2:40
追加
rewardful_list_affiliates
2026年10月2日2:40
追加
rewardful_get_campaign
2026年10月2日2:40
追加
rewardful_list_campaigns
2026年10月2日2:40