SportAPI Football Data
Football fixtures, live scores, standings, lineups, teams and players for 117 leagues and cups
¿Debería usar esto?
Calidad y seguridad
Hallazgos (1)
- LOWTool 'get_head_to_head' description lacks action verben get_head_to_head
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"football": {
"url": "https://sportapi.ai/mcp"
}
}
}Puntos de conexión remotos
https://sportapi.ai/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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).
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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"
]
}Comunidad
Evidencia