integrations tools rewardful
Rewardful MCP for your AI agent
Cogny's Rewardful integration exposes 23 tools (14 read, 8 write, 1 destructive) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app.
- 14readonly reads data.
- 8writecreates or changes something.
- 1destructivedeletes, removes or replaces something.
Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. Plans, approvals and limits
set it up.
Add Cogny to your AI client once, then connect Rewardful in Cogny. Every Rewardful tool below appears in the client.
- Claude CodeRun
claude mcp add --transport http cogny https://app.cogny.com/mcp, then authorise in the browser. - Claude.aiSettings → Connectors → Add custom connector, URL
https://app.cogny.com/mcp, then log in and pick your workspace. - ChatGPTSettings → Apps → Advanced settings → Developer mode → Create app, URL
https://app.cogny.com/mcp, authentication OAuth. - CursorIn Cogny, Settings → Data & Integrations → Connect AI Clients shows the block to paste into
.mcp.json, with an API key. - CodexRun
codex mcp add cogny --url https://app.cogny.com/mcp.
Notes
Rewardful connects with the account's API Secret, found on Rewardful's Company Settings page. Rewardful has one secret per account and no read-only or scoped keys: the secret gives full access to the account, so the tools listed here are what limits Cogny. The secret is sent only to api.getrewardful.com. If you rotate it in Rewardful, update the connection in Cogny; a rejected secret marks the connection as needing a reconnect.
Every id is a UUID that comes from a list tool. Money is in cents with an ISO currency code, and timestamps are ISO 8601.
Lists return up to 100 rows a page (Rewardful's default is 25) with a pagination object: next_page is null on the last page and total_count gives the full size. expand nests related objects where Rewardful supports it: campaign, links and commission_stats on affiliates, affiliate on referrals, commission on sales, sale and campaign on commissions, affiliate and commissions on payouts.
Rewardful's API allows about 45 requests per 30 seconds and answers HTTP 429 above that. The connector reports the limit so the agent waits and retries.
Two writes only run with confirm=true. update_affiliate_link replaces a link's token, and the old token stops tracking visits at once wherever the affiliate has published it. mark_payout_paid records a payout and every commission in it as paid. It is bookkeeping: Rewardful records that you paid the affiliate, and the payment itself happens outside this integration.
An affiliate created with create_affiliate gets no welcome email from Rewardful. Extra affiliate links (create_affiliate_link) and campaign Stripe coupons need Rewardful's Growth or Enterprise plan. create_affiliate_coupon only works for an affiliate whose campaign already has a campaign coupon, which is set up in the Rewardful dashboard, and the code must match one defined in Stripe.
Known gaps
- Not yet run against a live Rewardful account. Every endpoint, parameter and request body was checked against Rewardful's published REST API reference, but responses have only been tested against samples.
- No date-range filter on sales, commissions or payouts: Rewardful's API has none. Lists are newest first, so the agent pages back until it passes the period it needs. Referrals can be filtered by when they were last updated.
- Sales and referrals can be listed but not fetched one at a time: Rewardful's API has no single-record endpoint for them.
- Rewardful documents
pageandlimiton the affiliate, referral and commission lists. The other lists accept the same two arguments here, but Rewardful's reference doesn't spell them out per endpoint. - No delete tools. Rewardful's API can permanently delete a commission; that is left to the Rewardful dashboard.
- No affiliate magic link. Rewardful's API can return a one-time login URL for an affiliate's dashboard; Cogny doesn't expose it.
- No recording of sales or leads. Creating or editing a sale by hand and converting a referral to a lead belong to a custom payment integration and aren't offered.
- No un-paying a payout: Rewardful's API has no such call. A single commission can be marked unpaid again with
update_commission. - Campaign settings beyond name, URL, visibility, commission terms, minimum payout and Stripe coupon (cookie window, commission duration, dashboard texts) can be read but not changed: Rewardful's API doesn't accept them.
- An affiliate's link token can be set when the affiliate is created, and changed afterwards with
update_affiliate_link, not withupdate_affiliate. - Webhooks aren't used: Cogny reads on request and doesn't receive Rewardful events.
what each tool does.
Read 14 · only reads data
list_campaignsReadList your Rewardful campaigns with their commission terms and totals for visitors, leads, conversions and affiliates.get_campaignReadGet one Rewardful campaign: its URL, reward type, commission, minimum payout and visitor, lead and conversion totals.list_affiliatesReadList your Rewardful affiliates, newest first, with their state and visitor, lead and conversion counts.get_affiliateReadGet one Rewardful affiliate with their campaign, links, coupon, state and visitor, lead and conversion counts.list_affiliate_linksReadList the affiliate links in your Rewardful account, newest first, each with its URL, token and visitor, lead and conversion counts.get_affiliate_linkReadGet one Rewardful affiliate link: its full URL, token, owner and visitor, lead and conversion counts.list_affiliate_couponsReadList the coupon and promotion codes assigned to your Rewardful affiliates, with the leads and conversions each code brought in.get_affiliate_couponReadGet one Rewardful affiliate coupon: its code, the affiliate it belongs to, whether it is archived, and its leads and conversions.list_referralsReadList the visitors your Rewardful affiliates referred, newest first, and whether each is still a visitor, a lead or a paying customer.list_salesReadList the purchases made by referred customers in Rewardful, with charged, refunded and tax amounts and the referral behind each sale.list_commissionsReadList the commissions your Rewardful affiliates have earned, newest first, with amount, currency and whether each is pending, due, paid or voided.get_commissionReadGet one Rewardful commission: its amount, state, due and paid dates, and the campaign and sale it came from.list_payoutsReadList your Rewardful payouts, newest first: what each affiliate is owed or has been paid, and whether the payout is pending, due, processing or paid.get_payoutReadGet one Rewardful payout with its amount, state, the affiliate it is owed to and the commissions it bundles.
Write 8 · creates or changes something
create_campaignWriteCreate a new campaign in your Rewardful account with its own URL and commission terms.update_campaignWriteChange a Rewardful campaign's name, URL, visibility, commission terms or minimum payout.create_affiliateWriteAdd a new affiliate to your Rewardful account, in a campaign of your choice or the default one.update_affiliateWriteChange a Rewardful affiliate's details, state, payout address or campaign.create_affiliate_linkWriteCreate an additional tracking link for a Rewardful affiliate.update_affiliate_linkWriteChange the token of a Rewardful affiliate link.create_affiliate_couponWriteAssign a coupon or promotion code to a Rewardful affiliate so sales made with that code are credited to them.update_commissionWriteChange when a Rewardful commission is due, or record it as paid or unpaid.
Destructive 1 · deletes, removes or replaces something
mark_payout_paidDestructiveRecord a Rewardful payout, and every commission in it, as paid.
Exact input schemas come from tools/list once Rewardful is connected; the free plan is enough to check. Missing something? Your agent can ask for it with request_feature.