get_leaderboard
Pack: speedrun · Endpoint: https://gateway.pipeworx.io/speedrun/mcp
Fetch the world-record / top-N leaderboard for a specific game category. Returns ranked runs with finish times (ISO-8601 duration plus seconds), run date, players, and weblink. Get game_id from search_games and category_id from get_categories. Example: get_leaderboard({ game_id: “o1y9wo6q”, category_id: “7kjpp4k3”, top: 10 })
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
game_id | string | yes | Speedrun.com game ID, as returned by search_games |
category_id | string | yes | Speedrun.com category ID, as returned by get_categories |
top | number | no | Number of top-ranked runs to return (default 10) |
_apiKey | string | no | Optional speedrun.com API key for authenticated access; omit to use the shared platform key |
Example call
curl -X POST https://gateway.pipeworx.io/speedrun/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_leaderboard","arguments":{}}}'Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"speedrun": {
"url": "https://gateway.pipeworx.io/speedrun/mcp"
}
}
}See Getting Started for client-specific install steps.