Get demand cut
get_demand_cutRead-only
Demand cut: which slots are searched in a given market, ranked by 12-month volume.
country: REQUIRED ISO-2 code (e.g. 'BR'). Unlike the REST endpoint (where country
is optional and omitting it returns the whole market map in one response), this
MCP tool requires exactly one market per call. A missing country returns an
error with a few example codes and a pointer to the full tracked-market list
(/docs/, or meta.coverage.markets_tracked on REST).
IMPORTANT — read before trusting a number from this tool:
1. The metric (volume_12m) is a SUM over a trailing 12-month window, not the
latest month's search volume. Ranking by "recent popularity" is exactly what
this number is NOT — a slot with a huge spike two months ago and nothing since
can still outrank one with steady recent demand.
2. Coverage is OUR CATALOGUE, not the market. This is demand for slots we track
(currently effectively single-provider), not total search demand for iGaming
content in that country. A number going up when we onboard a new provider is
catalogue growth, not market growth.
3. Each underlying slot x country pair carries a pairs_at_frontier_pct signal on
the REST endpoint (omitted here, see "What this tool omits" below): below 100%
it means the freshest month is not fully collected yet for that pair, and the
12-month sum is weighted toward older, complete months. Do not read a country
with lower coverage as having genuinely lower demand than one with full coverage.
by: cut axis — 'slot' (default), 'country', 'provider', 'theme', 'feature',
'mechanic', 'game_category'. 'theme'/'feature' are overlapping (a slot has many
of each, so per-group sums exceed the country total); the rest are not.
ordering: '-volume_12m' (default, highest demand first) or 'volume_12m'.
Catalogue filters (same whitelist as search_slots, all optional, all AND'ed):
volatility, mechanic, jackpot_type, has_bonus_buy, provider, theme, feature,
search, released_after / released_before (YYYY-MM-DD), rtp_min / rtp_max,
game_category.
cursor / page_size: pagination, same shape as search_slots.
What this tool omits (by design, not an oversight):
coverage (providers[], slots_total, pairs_at_frontier_pct, markets_tracked) is
NOT requested and NOT present in this tool's response. Call the REST endpoint
directly (with a token) for the coverage block.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| by | No | ||
| theme | No | ||
| cursor | No | ||
| search | No | ||
| country | Yes | ||
| feature | No | ||
| rtp_max | No | ||
| rtp_min | No | ||
| mechanic | No | ||
| ordering | No | ||
| provider | No | ||
| page_size | No | ||
| volatility | No | ||
| jackpot_type | No | ||
| game_category | No | ||
| has_bonus_buy | No | ||
| released_after | No | ||
| released_before | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||