> For the complete documentation index, see [llms.txt](https://docs.fuul.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fuul.xyz/fuul-mcp-server/managing-incentives/incentive-analytics.md).

# Incentive Analytics

See how each incentive program is performing directly from Cursor, Claude, or any agent — no dashboard, no manual exports.

Read-only tools, same credentials as the dashboard. No Project API key required.

## Ranking all incentives

List all incentives in a project ranked by the metric of your choice:

> "Which incentives are underperforming in the last 30 days?"

{% hint style="info" %}
Sorts by active users, volume, earnings, or revenue. When the date range allows it, results include week-over-week and month-over-month comparisons.
{% endhint %}

## Stats for a single incentive

Get a full snapshot of one program:

> "How is the Uniswap LP incentive performing this month?"

{% hint style="info" %}
Returns participant count, volume, revenue, earnings across all reward currencies, comparison against the project median, and WoW / MoM deltas.
{% endhint %}

## Performance over time

Pull the time series for a single incentive:

> "Show me day-by-day activity for the Morpho incentive over the last 30 days"

Supports `daily`, `weekly`, or `monthly` granularity. All three tools support: last 7 / 30 / 90 days, month-to-date, quarter-to-date, all-time, or a custom date range.

{% hint style="warning" %}
`get_incentive_history` requires a bounded date range and does not support all-time. If you use all-time on stats or breakdown, WoW / MoM comparisons will be empty — that means no prior period to compare against, not zero change.
{% endhint %}