Football fixtures, live scores, standings, lineups, teams and players for 117 leagues and cups
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
SportAPI key from https://sportapi.ai/dashboard (free plan: 2,000 requests a day)
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
Part of a league or country name; omit to list all
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.
| Argument | Type | Description |
|---|---|---|
| query | string | Part of a league or country name; omit to list all |
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Part of a league or country name; omit to list all"
}
}
}Search players by name (e.g. "saka", "haaland"). Returns player ids, position, team id and the slug used by get_player.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Default 10 |
| query* | string | Part of the player name, at least 2 characters |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Default 10"
},
"query": {
"type": "string",
"description": "Part of the player name, at least 2 characters"
}
}
}Search teams by name (e.g. "arsenal", "real madrid"). Returns team ids, country and main league id for the other tools.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Default 10 |
| query* | string | Part of the team name, at least 2 characters |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Default 10"
},
"query": {
"type": "string",
"description": "Part of the team name, at least 2 characters"
}
}
}Past matches between two teams.
| Argument | Type | Description |
|---|---|---|
| team1_id* | integer | |
| team2_id* | integer |
{
"type": "object",
"required": [
"team1_id",
"team2_id"
],
"properties": {
"team1_id": {
"type": "integer"
},
"team2_id": {
"type": "integer"
}
}
}A league with its teams (ids), upcoming fixtures and recent results.
| Argument | Type | Description |
|---|---|---|
| league_id* | integer |
{
"type": "object",
"required": [
"league_id"
],
"properties": {
"league_id": {
"type": "integer"
}
}
}Matches being played right now with the current score and minute. Scores refresh every minute.
| Argument | Type | Description |
|---|---|---|
| league_id | integer | Only this league |
{
"type": "object",
"properties": {
"league_id": {
"type": "integer",
"description": "Only this league"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| include | array | Extra sections |
| match_id* | integer | Match id from get_matches |
{
"type": "object",
"required": [
"match_id"
],
"properties": {
"include": {
"type": "array",
"items": {
"enum": [
"stats",
"lineups"
],
"type": "string"
},
"description": "Extra sections"
},
"match_id": {
"type": "integer",
"description": "Match id from get_matches"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| date | string | YYYY-MM-DD, or today / yesterday / tomorrow (default today, Central European time) |
| status | string | Filter by state (default all) |
| league_id | integer | Only this league (id from find_leagues) |
{
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "YYYY-MM-DD, or today / yesterday / tomorrow (default today, Central European time)"
},
"status": {
"enum": [
"all",
"live",
"finished",
"upcoming"
],
"type": "string",
"description": "Filter by state (default all)"
},
"league_id": {
"type": "integer",
"description": "Only this league (id from find_leagues)"
}
}
}Player profile by slug (e.g. "bukayo-saka"): position, nationality, season stats, recent matches and next match.
| Argument | Type | Description |
|---|---|---|
| slug* | string |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string"
}
}
}Per-match statistics and totals for a player, found by name and team id.
| Argument | Type | Description |
|---|---|---|
| name* | string | Player name as shown in squads or lineups |
| team_id* | integer | |
| shirt_number | integer | Helps when two players share a name |
{
"type": "object",
"required": [
"name",
"team_id"
],
"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"
}
}
}Current league table with points, goals and form (last 6 matches, oldest first). Cups without a table return nothing.
| Argument | Type | Description |
|---|---|---|
| league_id* | integer |
{
"type": "object",
"required": [
"league_id"
],
"properties": {
"league_id": {
"type": "integer"
}
}
}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).
| Argument | Type | Description |
|---|---|---|
| slug | string | Team slug, used when team_id is not given |
| include | array | |
| team_id | integer |
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Team slug, used when team_id is not given"
},
"include": {
"type": "array",
"items": {
"enum": [
"squad",
"trophies"
],
"type": "string"
}
},
"team_id": {
"type": "integer"
}
}
}Top scorers, assist leaders or most-carded players of a league this season.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Default 10 |
| category | string | Default scorers |
| league_id* | integer |
{
"type": "object",
"required": [
"league_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Default 10"
},
"category": {
"enum": [
"scorers",
"assists",
"cards"
],
"type": "string",
"description": "Default scorers"
},
"league_id": {
"type": "integer"
}
}
}