Ball Ranks
Fantasy football and basketball rankings and player projections from Ball Ranks.
使うべきか
品質と安全性
A
検出事項（1）
- LOWTool 'get_season_rankings' description lacks action verbget_season_rankings 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~2,847トークン数（ツール定義）
~7.4 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 2.22%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"ball-ranks": {
"url": "https://ballranks.com/api/mcp"
}
}
}リモートエンドポイント
https://ballranks.com/api/mcpstreamable-httpできること
ツール一覧
ツール（4）
🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢get_week_rankings(sport, season, week, position, scoring_format, ...)
Return published weekly fantasy football rankings for one position, week, and scoring format. Use this for start/sit comparisons or a ranked position list. This tool does not support basketball.
入力スキーマ
{
"type": "object",
"properties": {
"sport": {
"default": "football",
"type": "string",
"enum": [
"basketball",
"football"
]
},
"season": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
]
},
"week": {
"type": "integer",
"minimum": 1,
"maximum": 18
},
"position": {
"default": "RB",
"type": "string",
"enum": [
"QB",
"RB",
"WR",
"TE",
"K",
"DST"
]
},
"scoring_format": {
"default": "ppr",
"type": "string",
"enum": [
"standard",
"half_ppr",
"ppr"
]
},
"model": {
"default": "v0",
"type": "string",
"enum": [
"v0",
"v1"
]
},
"limit": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"default": 0,
"type": "integer",
"minimum": 0,
"maximum": 10000
}
},
"required": [
"week"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"meta": {
"type": "object",
"properties": {
"apiVersion": {
"type": "string",
"const": "1"
},
"capability": {
"type": "string",
"enum": [
"weekly_rankings",
"season_rankings",
"player_rankings",
"player_projections"
]
},
"sport": {
"type": "string",
"enum": [
"basketball",
"football"
]
},
"model": {
"type": "string",
"enum": [
"v0",
"v1"
]
},
"modelDataVersion": {
"type": "string"
},
"generatedAt": {
"type": [
"string",
"null"
]
},
"updatedAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"apiVersion",
"capability",
"sport",
"model",
"modelDataVersion",
"generatedAt",
"updatedAt"
],
"additionalProperties": false
},
"sourceUrl": {
"type": "string",
"format": "uri"
},
"query": {
"type": "object",
"properties": {
"season": {
"type": [
"string",
"number"
]
},
"week": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"position": {
"type": "string",
"enum": [
"QB",
"RB",
"WR",
"TE",
"K",
"DST"
]
},
"scoringFormat": {
"type": "string",
"enum": [
"standard",
"half_ppr",
"ppr"
]
},
"limit": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"offset": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"season",
"week",
"position",
"scoringFormat",
"limit",
"offset"
],
"additionalProperties": false
},
"total": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"rankings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"player": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"team": {
"type": [
"string",
"null"
]
},
"position": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"team",
"position"
],
"additionalProperties": false
},
"rank": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"projectedPoints": {
"type": "number"
}
},
"required": [
"player",
"rank",
"projectedPoints"
],
"additionalProperties": false
}
}
},
"required": [
"meta",
"sourceUrl",
"query",
"total",
"rankings"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_season_rankings(sport, season, scoring_format, model, limit, ...)
Return a paginated Ball Ranks season ranking board for fantasy basketball or football. Basketball uses nine-category per-game rankings; football accepts standard, half-PPR, or PPR scoring.
入力スキーマ
{
"type": "object",
"properties": {
"sport": {
"type": "string",
"enum": [
"basketball",
"football"
]
},
"season": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
]
},
"scoring_format": {
"type": "string",
"enum": [
"standard",
"half_ppr",
"ppr"
]
},
"model": {
"default": "v0",
"type": "string",
"enum": [
"v0",
"v1"
]
},
"limit": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"default": 0,
"type": "integer",
"minimum": 0,
"maximum": 10000
}
},
"required": [
"sport"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"meta": {
"type": "object",
"properties": {
"apiVersion": {
"type": "string",
"const": "1"
},
"capability": {
"type": "string",
"enum": [
"weekly_rankings",
"season_rankings",
"player_rankings",
"player_projections"
]
},
"sport": {
"type": "string",
"enum": [
"basketball",
"football"
]
},
"model": {
"type": "string",
"enum": [
"v0",
"v1"
]
},
"modelDataVersion": {
"type": "string"
},
"generatedAt": {
"type": [
"string",
"null"
]
},
"updatedAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"apiVersion",
"capability",
"sport",
"model",
"modelDataVersion",
"generatedAt",
"updatedAt"
],
"additionalProperties": false
},
"sourceUrl": {
"type": "string",
"format": "uri"
},
"query": {
"type": "object",
"properties": {
"season": {
"type": [
"string",
"number"
]
},
"scoring": {
"type": "string",
"const": "nine_category"
},
"mode": {
"type": "string",
"const": "per_game"
},
"scoringFormat": {
"type": "string",
"enum": [
"standard",
"half_ppr",
"ppr"
]
},
"limit": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"offset": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"season",
"limit",
"offset"
],
"additionalProperties": false
},
"total": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"rankings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"player": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"team": {
"type": [
"string",
"null"
]
},
"position": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"team",
"position"
],
"additionalProperties": false
},
"rank": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"value": {
"type": "number"
},
"mode": {
"type": "string",
"const": "per_game"
},
"scoring": {
"type": "string",
"const": "nine_category"
},
"positionRank": {
"type": [
"number",
"null"
]
},
"projectedPoints": {
"type": [
"number",
"null"
]
}
},
"required": [
"player",
"rank"
],
"additionalProperties": false
}
}
},
"required": [
"meta",
"sourceUrl",
"query",
"total",
"rankings"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_player_rankings(sport, player, season, scoring_format, model)
Look up one player's published Ball Ranks season ranking by player ID or slug. Use this when the user asks where a specific player ranks.
入力スキーマ
{
"type": "object",
"properties": {
"sport": {
"type": "string",
"enum": [
"basketball",
"football"
]
},
"player": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"season": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
]
},
"scoring_format": {
"type": "string",
"enum": [
"standard",
"half_ppr",
"ppr"
]
},
"model": {
"default": "v0",
"type": "string",
"enum": [
"v0",
"v1"
]
}
},
"required": [
"sport",
"player"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"meta": {
"type": "object",
"properties": {
"apiVersion": {
"type": "string",
"const": "1"
},
"capability": {
"type": "string",
"enum": [
"weekly_rankings",
"season_rankings",
"player_rankings",
"player_projections"
]
},
"sport": {
"type": "string",
"enum": [
"basketball",
"football"
]
},
"model": {
"type": "string",
"enum": [
"v0",
"v1"
]
},
"modelDataVersion": {
"type": "string"
},
"generatedAt": {
"type": [
"string",
"null"
]
},
"updatedAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"apiVersion",
"capability",
"sport",
"model",
"modelDataVersion",
"generatedAt",
"updatedAt"
],
"additionalProperties": false
},
"sourceUrl": {
"type": "string",
"format": "uri"
},
"player": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"team": {
"type": [
"string",
"null"
]
},
"position": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"team",
"position"
],
"additionalProperties": false
},
"season": {
"type": [
"string",
"number"
]
},
"scoringFormat": {
"type": "string",
"enum": [
"standard",
"half_ppr",
"ppr"
]
},
"ranking": {
"type": "object",
"properties": {
"rank": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"value": {
"type": "number"
},
"mode": {
"type": "string",
"const": "per_game"
},
"scoring": {
"type": "string",
"const": "nine_category"
},
"positionRank": {
"type": [
"number",
"null"
]
},
"projectedPoints": {
"type": [
"number",
"null"
]
}
},
"required": [
"rank"
],
"additionalProperties": false
}
},
"required": [
"meta",
"sourceUrl",
"player",
"season",
"ranking"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_player_projections(sport, player, scope, season, week, ...)
Look up one player's published season projection, or a weekly football projection, by player ID or slug. Weekly projections require scope=weekly and a week number.
入力スキーマ
{
"type": "object",
"properties": {
"sport": {
"type": "string",
"enum": [
"basketball",
"football"
]
},
"player": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"scope": {
"default": "season",
"type": "string",
"enum": [
"season",
"weekly"
]
},
"season": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
]
},
"week": {
"type": "integer",
"minimum": 1,
"maximum": 18
},
"scoring_format": {
"type": "string",
"enum": [
"standard",
"half_ppr",
"ppr"
]
},
"model": {
"default": "v0",
"type": "string",
"enum": [
"v0",
"v1"
]
}
},
"required": [
"sport",
"player"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"meta": {
"type": "object",
"properties": {
"apiVersion": {
"type": "string",
"const": "1"
},
"capability": {
"type": "string",
"enum": [
"weekly_rankings",
"season_rankings",
"player_rankings",
"player_projections"
]
},
"sport": {
"type": "string",
"enum": [
"basketball",
"football"
]
},
"model": {
"type": "string",
"enum": [
"v0",
"v1"
]
},
"modelDataVersion": {
"type": "string"
},
"generatedAt": {
"type": [
"string",
"null"
]
},
"updatedAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"apiVersion",
"capability",
"sport",
"model",
"modelDataVersion",
"generatedAt",
"updatedAt"
],
"additionalProperties": false
},
"sourceUrl": {
"type": "string",
"format": "uri"
},
"player": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"team": {
"type": [
"string",
"null"
]
},
"position": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"team",
"position"
],
"additionalProperties": false
},
"scope": {
"type": "string",
"enum": [
"season",
"weekly"
]
},
"season": {
"type": [
"string",
"number"
]
},
"week": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"scoringFormat": {
"type": "string",
"enum": [
"standard",
"half_ppr",
"ppr"
]
},
"projection": {
"type": "object",
"properties": {
"games": {
"type": [
"number",
"null"
]
},
"minutesPerGame": {
"type": "number"
},
"projectedPoints": {
"type": [
"number",
"null"
]
},
"positionRank": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"opponent": {
"type": [
"string",
"null"
]
},
"home": {
"type": "boolean"
},
"stats": {
"type": "object",
"properties": {
"pts": {
"type": "number"
},
"reb": {
"type": "number"
},
"ast": {
"type": "number"
},
"stl": {
"type": "number"
},
"blk": {
"type": "number"
},
"fg3m": {
"type": "number"
},
"fg_pct": {
"type": "number"
},
"ft_pct": {
"type": "number"
},
"tov": {
"type": "number"
}
},
"required": [
"pts",
"reb",
"ast",
"stl",
"blk",
"fg3m",
"fg_pct",
"ft_pct",
"tov"
],
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"required": [
"meta",
"sourceUrl",
"player",
"scope",
"season",
"projection"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}コミュニティ
エビデンス
最近の観測
検証済みバージョンは記録されていませんツール 4 件