SportAPI Football Data
Football fixtures, live scores, standings, lineups, teams and players for 117 leagues and cups
使うべきか
品質と安全性
検出事項（1）
- LOWTool 'get_head_to_head' description lacks action verbget_head_to_head 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"football": {
"url": "https://sportapi.ai/mcp"
}
}
}リモートエンドポイント
https://sportapi.ai/mcpstreamable-httpできること
ツール一覧
ツール（13）
🟢find_leagues(query)
List covered leagues and cups with their ids. Optionally filter by a name or country fragment (e.g. "premier", "spain", "champions"). Use the id with the other tools.
入力スキーマ
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Part of a league or country name; omit to list all"
}
}
}🟢find_teams(query, limit)
Search teams by name (e.g. "arsenal", "real madrid"). Returns team ids, country and main league id for the other tools.
入力スキーマ
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Part of the team name, at least 2 characters"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "Default 10"
}
},
"required": [
"query"
]
}🟢find_players(query, limit)
Search players by name (e.g. "saka", "haaland"). Returns player ids, position, team id and the slug used by get_player.
入力スキーマ
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Part of the player name, at least 2 characters"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "Default 10"
}
},
"required": [
"query"
]
}🟢get_matches(date, league_id, status)
Fixtures and results for one day, optionally for one league or only live/finished/upcoming matches. Status is one of Scheduled, LIVE, HT, FT, AET, PENS, Postponed, Cancelled, Suspended.
入力スキーマ
{
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "YYYY-MM-DD, or today / yesterday / tomorrow (default today, Central European time)"
},
"league_id": {
"type": "integer",
"description": "Only this league (id from find_leagues)"
},
"status": {
"type": "string",
"enum": [
"all",
"live",
"finished",
"upcoming"
],
"description": "Filter by state (default all)"
}
}
}🟢get_live_matches(league_id)
Matches being played right now with the current score and minute. Scores refresh every minute.
入力スキーマ
{
"type": "object",
"properties": {
"league_id": {
"type": "integer",
"description": "Only this league"
}
}
}🟢get_match(match_id, include)
One match: teams, score, venue, coaches and events (goals, cards, substitutions). Optionally team statistics and lineups (each adds one request). Lineups and stats exist only for competitions covered in detail.
入力スキーマ
{
"type": "object",
"properties": {
"match_id": {
"type": "integer",
"description": "Match id from get_matches"
},
"include": {
"type": "array",
"items": {
"type": "string",
"enum": [
"stats",
"lineups"
]
},
"description": "Extra sections"
}
},
"required": [
"match_id"
]
}🟢get_head_to_head(team1_id, team2_id)
Past matches between two teams.
入力スキーマ
{
"type": "object",
"properties": {
"team1_id": {
"type": "integer"
},
"team2_id": {
"type": "integer"
}
},
"required": [
"team1_id",
"team2_id"
]
}🟢get_standings(league_id)
Current league table with points, goals and form (last 6 matches, oldest first). Cups without a table return nothing.
入力スキーマ
{
"type": "object",
"properties": {
"league_id": {
"type": "integer"
}
},
"required": [
"league_id"
]
}🟢get_league(league_id)
A league with its teams (ids), upcoming fixtures and recent results.
入力スキーマ
{
"type": "object",
"properties": {
"league_id": {
"type": "integer"
}
},
"required": [
"league_id"
]
}🟢get_top_players(league_id, category, limit)
Top scorers, assist leaders or most-carded players of a league this season.
入力スキーマ
{
"type": "object",
"properties": {
"league_id": {
"type": "integer"
},
"category": {
"type": "string",
"enum": [
"scorers",
"assists",
"cards"
],
"description": "Default scorers"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "Default 10"
}
},
"required": [
"league_id"
]
}🟢get_team(team_id, slug, include)
A team by id or slug (e.g. "arsenal") with recent and upcoming matches. Optionally the squad (player slugs) and trophies (each adds one request; the slug form already includes the squad).
入力スキーマ
{
"type": "object",
"properties": {
"team_id": {
"type": "integer"
},
"slug": {
"type": "string",
"description": "Team slug, used when team_id is not given"
},
"include": {
"type": "array",
"items": {
"type": "string",
"enum": [
"squad",
"trophies"
]
}
}
}
}🟢get_player(slug)
Player profile by slug (e.g. "bukayo-saka"): position, nationality, season stats, recent matches and next match.
入力スキーマ
{
"type": "object",
"properties": {
"slug": {
"type": "string"
}
},
"required": [
"slug"
]
}🟢get_player_match_stats(name, team_id, shirt_number)
Per-match statistics and totals for a player, found by name and team id.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Player name as shown in squads or lineups"
},
"team_id": {
"type": "integer"
},
"shirt_number": {
"type": "integer",
"description": "Helps when two players share a name"
}
},
"required": [
"name",
"team_id"
]
}コミュニティ
エビデンス