`summoner_top_mastery`

Pack: riot-games · Endpoint: https://gateway.pipeworx.io/riot-games/mcp

Highest champion mastery entries for one League of Legends account from the Riot Games API, given a puuid and a platform routing value such as na1, euw1, or kr, with count controlling how many champions come back (default 3). Returns championId, championLevel, championPoints, last play time, and chest and token flags for those champions. Answers which champions a League of Legends player has played most and mastered furthest.

Parameters

Name	Type	Required
`platform`	string	yes
`puuid`	string	yes
`count`	number	no

Example call

Arguments

{
  "platform": "na1",
  "puuid": "player-puuid-123456",
  "count": 5
}

curl

curl -X POST https://gateway.pipeworx.io/riot-games/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"summoner_top_mastery","arguments":{"platform":"na1","puuid":"player-puuid-123456","count":5}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('summoner_top_mastery', {
  "platform": "na1",
  "puuid": "player-puuid-123456",
  "count": 5
});

Response shape

Always returns: items, count

Field	Type	Description
`items`	array	Top N champion mastery entries
`count`	integer	Number of items returned.

Full JSON Schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "championId": {
            "type": "number",
            "description": "Champion ID"
          },
          "championLevel": {
            "type": "number",
            "description": "Mastery level"
          },
          "championPoints": {
            "type": "number",
            "description": "Mastery points"
          },
          "lastPlayTime": {
            "type": "number",
            "description": "Last play time timestamp"
          }
        }
      },
      "description": "Top N champion mastery entries"
    },
    "count": {
      "type": "integer",
      "description": "Number of items returned."
    }
  },
  "required": [
    "items",
    "count"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "riot-games": {
      "url": "https://gateway.pipeworx.io/riot-games/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

summoner_top_mastery