What is API-Sports MCP?

It's an MCP (Model Context Protocol) server that connects API-Sports to your AI, giving the agent tools to act on your data — through a single remote link.

Which AI clients does it work with?

Any MCP-compatible client: Claude (web, desktop and mobile), Cursor, ChatGPT with connectors, OpenClaw and other agents.

No. Paste the remote URL into your client, authenticate once, and you're done — no packages to install, no code to write.

Is it secure? Can the AI change my data?

Access is authorized by you and can be revoked anytime. Permissions follow what API-Sports exposes; you approve them when connecting.

How much does it cost?

You start free and upgrade when you need more usage. Billing and limits are managed in your mcp.ai account.

Can I cancel anytime?

Yes. Plans are monthly and can be cancelled at any time, with no lock-in.

API-Sports MCP Server and REST API

API-Sports

Connect your API-Sports account and use 67 tools for developer tools straight from your AI agent. Connect with your own API key. API-Sports provides comprehensive sports data APIs covering over 2,000 competitions with more than 15 years of historical data, offering real-time updates and easy integration for developers.

Install in your client

MCP server URL

https://api.mcp.ai/p_api_sports

Secure connection via OAuth 2.0

Tools (67)

For developers

API & agent docs

Machine-readable docs to plug this server into an agent or call it over REST.

Skill (how to use)

Markdown: use via MCP or via the direct REST API.

Open

llms.txt

Agent-readable spec of this server.

Open

For agents

Install prompt — paste into Claude, ChatGPT, Cursor or any MCP agent and it sets itself up.

Open

Postman collection

Import the REST API into Postman.

Download

FAQ

API-Sports

Tools (67)

API & agent docs

Frequently asked questions

Example prompts

Related tags

API-Sports

Tools (67)

api_sports_get_afl_gamesTool to retrieve AFL games and matches. Use when filtering games by id, date, league, season, team, or timezone to get upcoming, past, or live matches.

api_sports_get_afl_games_statistics_playersTool to retrieve player statistics from AFL (Australian Football League) game(s). Use when you need detailed player performance data for specific AFL games by game ID, player ID, or season.

api_sports_get_afl_seasonsTool to get the list of available seasons for AFL. All seasons are 4-digit keys (e.g., 2018 for 2018-2019 season). Use when you need season filters for AFL endpoints.

api_sports_get_afl_standingsTool to retrieve AFL standings for a league. Use when needing current team rankings, points, and positions for a specific season.

api_sports_get_baseball_games_h2hTool to get head-to-head baseball games between two teams. Use when comparing the match history between two specific baseball teams.

api_sports_get_basketball_betsTool to get all available basketball bet types. Use when you need to retrieve available betting options for basketball games.

api_sports_get_basketball_bookmakersTool to get all available basketball bookmakers. Use when you need to retrieve available bookmakers for basketball odds and betting data.

api_sports_get_basketball_statisticsTool to get basketball statistics for a team in a given league and season. Use when you need detailed basketball team statistics including games played, wins, losses, points, and other performance met

api_sports_get_circuitsTool to get the list of available Formula 1 circuits. Use when searching for circuits by id, competition, name, or search term.

api_sports_get_coachsTool to fetch coaches and their career history. Use when you need coach info by ID, team filter, or name search.

api_sports_get_countriesTool to fetch available countries for league queries. Use when filtering by name, code, or search string before retrieving leagues.

api_sports_get_fighters_recordsTool to get fighter career statistics. Use when you need a fighter's complete record including wins, losses, draws, knockouts, and submissions.

api_sports_get_fixturesTool to retrieve football fixtures/matches. Use when filtering fixtures by id, date, league, season, team, or date ranges to get upcoming or past matches. Always provide at least one of season, date,

api_sports_get_fixtures_eventsTool to get events (goals, cards, substitutions, VAR, etc.) from a fixture. Use when you need detailed event data after confirming the fixture ID.

api_sports_get_fixtures_headtoheadTool to get head-to-head fixtures between two teams. Use after determining team IDs to compare their direct match history.

api_sports_get_fixtures_lineupsTool to retrieve starting XI and substitutes for a fixture. Use after confirming fixture ID; optionally filter by team, player, or section (startXI/substitutes). Lineups appear ~20-40 minutes before k

api_sports_get_fixtures_playersTool to get player statistics from a fixture. Use when you need detailed per-player stats for a specific match. Optionally filter by team.

api_sports_get_fixtures_roundsTool to get the rounds for a league or cup. Use after confirming league and season to retrieve available round identifiers (optionally with dates) for filtering fixtures.

api_sports_get_fixtures_statisticsTool to get statistics for a fixture. Use when you need detailed match stats (shots, fouls, possession, cards, passes, etc.), optionally filtered by team, statistic type, or including halftime data.

api_sports_get_formula1_competitionsTool to retrieve Formula 1 competitions (Grand Prix races). Use when filtering competitions by id, name, country, city, or search term.

api_sports_get_formula1_racesTool to retrieve Formula 1 race information for a given season. Use when you need to get race schedules, results, or details for a specific Formula 1 competition season.

api_sports_get_formula1_rankings_startinggridTool to retrieve the starting grid for a Formula 1 race. Use when you need to get the qualifying positions and times for drivers before a race starts.

api_sports_get_games_eventsTool to get events (goals, penalties, etc.) from a game. Use when you need detailed event data after confirming the game ID.

api_sports_get_games_quartersTool to retrieve AFL game quarter scores. Use when you need detailed scoring breakdown by quarter for one or multiple AFL games.

api_sports_get_games_statistics_teamsTool to get team statistics from a game by ID. Use when you need detailed team stats (assists, blocks, field goals, rebounds, steals, turnovers, etc.) for a specific game or multiple games.

api_sports_get_injuriesTool to get injured or suspended players. Use when you need a list of sidelined players filtered by league, season, fixture, team, player, date, ids, or timezone.

api_sports_get_leaguesTool to retrieve leagues and cups. Use when filtering competitions by id, name, country, code, season, team, type, current, search, or last.

api_sports_get_leagues_seasonsTool to get the list of available seasons for all leagues. Use when you need season filters for other league endpoints.

api_sports_get_mma_categoriesTool to fetch the list of all available MMA categories. Use when you need to get weight class categories (e.g., 'Flyweight', 'Lightweight', 'Heavyweight') for MMA fights.

api_sports_get_mma_fightersTool to fetch MMA fighters data. Use when you need to get fighter information by id, team, name, category, or search term.

api_sports_get_mma_fightsTool to retrieve the list of MMA fights according to given parameters. Use when filtering fights by id, date, season, fighter, or weight category to get upcoming or past MMA fight details.

api_sports_get_mma_fights_resultsTool to retrieve results from one or several MMA fights. Use when you need outcome details like victory method, round, time, knockout type, or judge scores for specific fights by id(s) or date.

api_sports_get_mma_fights_statistics_fightersTool to get fighter statistics from MMA fights. Use when you need detailed strike, takedown, and grappling statistics for fighters in specific fights or on a specific date.

api_sports_get_nba_games_statisticsTool to get NBA game statistics including player stats for both teams. Use when you need detailed statistics for a specific NBA game such as points, rebounds, assists, field goals, free throws, and ot

api_sports_get_nfl_standings_conferencesTool to retrieve the list of available conferences for the NFL to be used in the standings endpoint. Use when you need to know which conferences are available for a specific NFL league and season befo

api_sports_get_oddsTool to fetch pre-match odds. Use when you need odds filterable by fixture, league, season, date, timezone, bookmaker, bet, or to navigate pages.

api_sports_get_odds_betsTool to get all available pre-match bet types. Use when filtering by bet ID or searching bet names before fetching odds.

api_sports_get_odds_bookmakersTool to list all available pre-match bookmakers. Use when you need to discover or filter bookmakers before fetching odds.

api_sports_get_odds_liveTool to fetch in-play odds for fixtures in progress. Use during live matches to get in-play odds.

api_sports_get_odds_live_betsTool to fetch all available bet types for in-play odds. Use when you need to retrieve bet IDs or names (optionally filtering by id or search) before fetching live odds.

api_sports_get_odds_mappingTool to get the list of available fixture IDs for the odds endpoint. Use when you need to discover which fixtures have odds data available.

api_sports_get_playersTool to get player statistics. Use when fetching players by id, team, league, season, search, or pagination. Returned player IDs are used as inputs to downstream tools such as fixtures statistics, pre

api_sports_get_players_profilesTool to get the list of all available players. Use when you need player profiles optionally filtered by ID, name search, or page.

api_sports_get_players_seasonsTool to list all available seasons for player statistics. Use when building a player statistics query, optionally filtering by a specific player id.

api_sports_get_players_squadsTool to get player squads. Use when fetching the current squad of a team (with team ID) or finding which teams a player belongs to (with player ID).

api_sports_get_players_statisticsTool to get player statistics for a specific basketball game. Use when you need detailed performance stats like points, rebounds, assists, field goals, three pointers, free throws, etc. Requires at le

api_sports_get_players_teamsTool to get the list of teams and seasons in which a player played during his career. Use after confirming the player ID to retrieve club history.

api_sports_get_players_top_assistsTool to get the 20 best players (top assists) for a league or cup. Use after confirming league and season.

api_sports_get_players_top_red_cardsTool to get the 20 players with the most red cards for a league or cup. Use after confirming league and season.

api_sports_get_players_top_scorersTool to get the 20 best players (top scorers) for a league or cup. Use after confirming league and season.

api_sports_get_players_top_yellow_cardsTool to get the 20 players with the most yellow cards for a league or cup. Use after confirming league and season.

api_sports_get_predictionsTool to get predictions about a fixture. Use when you need calculated predictions for a given fixture ID. Predictions may not be available for all fixtures; empty or null responses indicate no predict

api_sports_get_rankings_driversTool to retrieve Formula 1 driver rankings for a season. Use when querying driver standings, championship positions, or filtering by specific driver or team.

api_sports_get_rankings_fastest_lapsTool to get the ranking of the fastest laps for a Formula 1 race. Use when retrieving fastest lap times, speeds, and rankings by race, team, or driver.

api_sports_get_rankings_racesTool to retrieve rankings for a specific Formula 1 race. Use when you need to get finishing positions, lap times, and pit stop information for drivers in a race.

api_sports_get_rankings_teamsTool to retrieve Formula 1 team rankings for a specific season. Use when you need to get championship standings showing teams ordered by points.

api_sports_get_sidelinedTool to get sidelined information (injuries, suspensions, etc.). Use when you need current sidelined records filtered by player or coach.

api_sports_get_standings_divisionsTool to retrieve the list of available divisions for an NFL competition to be used in the standings endpoint. Use when you need to know which divisions are available for a specific league and season b

api_sports_get_standings_groupsTool to retrieve the list of available groups for a league to be used in the standings endpoint. Use when querying standings groups for a specific league and season before fetching detailed standings

api_sports_get_standings_stagesTool to retrieve the list of available stages for a league to be used in the standings endpoint. Use when you need to know which stages or groups are available for a specific league and season before

api_sports_get_teamsTool to retrieve available teams. Use when filtering teams by id, name, league, season, country, code, venue, or search before fetching detailed team data. Team IDs are not inferrable from names; use

api_sports_get_teams_seasonsTool to get the list of seasons available for a team. Use when you need to know which seasons a specific team has data for.

api_sports_get_teams_statisticsTool to get detailed statistics of a team for a given league and season. Use after confirming league, season, and team ID.

api_sports_get_timezoneTool to fetch the complete list of available timezones for fixture queries. Use when you need valid timezone identifiers (e.g., 'Europe/London') before calling fixtures endpoints.

api_sports_get_transfersTool to get all available transfers for players and teams. Use when you need transfer history filtered by player or team.

api_sports_get_trophiesTool to get trophies for a player or coach. Use when you need to list honors filtered by player(s) or coach(es).

api_sports_get_venuesTool to retrieve available venues. Use when filtering venues by id, name, city, country, or search before fetching detailed venue data.

API & agent docs

Frequently asked questions

What is API-Sports MCP?

Which AI clients does it work with?

Do I need to code?

Is it secure? Can the AI change my data?

How much does it cost?

Can I cancel anytime?

Example prompts

Related tags