content_ranking
ActiveTool of gapup-mcp
Return the TOP-ranked content entities in a category, by a chosen criterion — the direct answer to superlative / decision queries: 'best video games', 'top RPGs', 'cheapest games', 'best value RPGs', 'best FPS playable right now', 'most popular music artists'. Criteria: critic_score, popularity, price, value (critic score per unit price). `direction` flips it (asc = cheapest/lowest first). `available_only` restricts to entities currently buyable. Sliceable by genre and release-year window; every result carries its score, price and source. When to use: an agent must produce a ranked shortlist to support a recommendation, a purchase or a 'what is the best X' decision.
Parameters schema
{
"type": "object",
"required": [
"domain"
],
"properties": {
"async": {
"type": "boolean",
"description": "If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts."
},
"genre": {
"type": "string",
"description": "Optional genre filter, e.g. 'RPG', 'FPS', 'thriller'"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Number of ranked results (default 20)"
},
"domain": {
"enum": [
"music",
"film",
"tv",
"video-game"
],
"type": "string",
"description": "Content domain to rank within"
},
"year_to": {
"type": "integer",
"description": "Optional latest release year"
},
"criterion": {
"enum": [
"critic_score",
"popularity",
"price",
"value"
],
"type": "string",
"description": "critic_score (0-100, default) · popularity · price · value (critic score per unit price)"
},
"direction": {
"enum": [
"desc",
"asc"
],
"type": "string",
"description": "desc = best/highest first (default); asc = cheapest/lowest/least first. Defaults to asc for price."
},
"year_from": {
"type": "integer",
"description": "Optional earliest release year"
},
"available_only": {
"type": "boolean",
"description": "If true, restrict to entities currently available to buy/play (default false)"
}
}
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
gapup-mcp
https://github.com/getgapup/gapup-mcp-public
2/7 registries