✏️Editing Incentives

The Fuul MCP lets you inspect and update incentive configurations directly from your AI assistant — including payout amounts, who gets rewarded, and the reward calculation strategy.

Changes made via MCP are saved as drafts. They do not take effect in production until you go to app.fuul.xyz → Incentives → Publish.

1. Find your project and incentives

"Find my project called Fuul and list our current configured incentives"

3. Edit payout amounts

You can target individual incentives or apply a change across all of them.

Change a specific amount

Goal	Example prompt
Update end user payout only	"Set the end user payout for [incentive name] to 5"
Update referrer payout only	"Set the referrer payout for [incentive name] to 10"
Update both	"Double the end user and referrer payouts for [incentive name]"

Only applies to incentives where payee_type is affiliate or both. If the incentive only rewards end users, you'd need to change the payee_type first.

Bulk-adjust all incentives by a percentage

Useful when you want to align all reward amounts with a target APR or a program-wide budget change:

"Reduce all incentive payouts by 20%"

4. Change who gets rewarded

Each incentive has a payee_type that controls which party receives the reward. You can change it at any time:

Value	Who gets rewarded
both	End user and referrer
end-user	End user only
affiliate	Referrer/affiliate only

Example prompts:

"Update [incentive name] to only reward referrers"

"Change [incentive name] to reward end users only with 15 points"

"Set [incentive name] to reward both sides — 2 points for end users, 6 for referrers"

5. Change the calculation strategy

The calculation_strategy controls how the reward amount is interpreted:

Strategy	Behavior
variable	Amount is a rate per unit of volume (e.g. points per USD traded). Requires a base_currency.
fixed	Amount is a flat reward per conversion regardless of volume.
proportional_pool	A fixed total budget is split among participants proportionally to their contribution (volume, revenue, or conversion count) over a period. See Pool Distribution.
leaderboard	Users are ranked by activity over a date range; each position or range of positions receives a predetermined reward. See Leaderboard Rewards.

Example prompts:

"Switch [incentive name] from variable to fixed rewards, keep 15 points for end users"

"Change [incentive name] to variable at 6 points per USD for referrers"

"Set up a pool distribution for [incentive name] with a 10,000 point budget split by volume"

"Configure [incentive name] as a leaderboard competition — 1st place gets 1,000 points, 2nd gets 500, 3rd–10th get 100 each"

When switching from variable to fixed, the base_currency field is automatically removed — it only applies to variable rewards. Pool and leaderboard strategies have additional required fields (budget, date range, rank configuration) that the MCP will prompt you for.

6. Publish to production

After editing, draft changes are not live until published. Go to the app and publish:

1. Open app.fuul.xyz

2. Navigate to your project → Incentives

3. Click Publish

All changes will take effect immediately after publishing.

You can review all pending draft changes in the Incentives section before publishing — useful to double-check a bulk update before it goes live.