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 verb在 get_head_to_head 中
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `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"
]
}社区
证据