API-Football MCP. Get real-time scores and league standings instantly
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
API-Football provides access to global football data. Use it to get real-time live scores, full league standings, and deep player stats for over 1,000 leagues.
It lets your AI agent handle everything from fixture checking to head-to-head history in a single chat session.
What your AI agents can do
Get fixtures
Lists upcoming and past match fixtures for a specific league or date range.
Get league topscorers
Retrieves a list of players who have scored the most goals in a given competition.
Get player info
Fetches detailed performance metrics and profile data for any specific player.
The agent pulls real-time scores and status updates for ongoing global football matches using list_live_fixtures.
The agent retrieves the current league standings and team positions for any specified competition using get_standings.
The agent can list all scheduled matches for specific dates or find fixtures for a given league using get_fixtures or list_leagues.
The agent fetches detailed performance statistics, including stats and profiles, for individual players using get_player_info.
The agent retrieves core details, historical data, and current status for any football club using get_team_info.
The agent determines and lists the players with the most goals scored in a given league using get_league_topscorers.
The agent searches the database and returns information about specific football teams using search_football_teams.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
API-Football MCP Server: 8 Tools for Football Data
Use these tools to programmatically fetch everything from live scores to player performance metrics across global football leagues.
019d8416get fixtures
Lists upcoming and past match fixtures for a specific league or date range.
019d8416get league topscorers
Retrieves a list of players who have scored the most goals in a given competition.
019d8416get player info
Fetches detailed performance metrics and profile data for any specific player.
019d8416get standings
Returns the current league table and ranking for a specified competition.
019d8416get team info
Gets detailed background information and current status for a football club.
019d8416list leagues
Returns a list of all available football leagues and their unique identifiers.
019d8416list live fixtures
Gets a list of all matches currently in progress across various leagues.
019d8416search football teams
Searches the database and returns details for football teams matching a query.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with API-Football, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
API-Football MCP Server - Live Scores & Stats
Yo, listen up. This server connects your AI client to massive amounts of global football data. You don't wanna be jumping between a dozen tabs just to track a game or check stats. This thing makes your agent the single source of truth for everything football, from live scores to deep player metrics.
It handles all the heavy lifting, so you just chat with it.
Live Match Details
Your agent pulls real-time scores and status updates for any ongoing global match using list_live_fixtures. You can also get a list of all available football leagues and their unique identifiers by running list_leagues. When you need to check what's coming up, your agent lists scheduled matches for specific dates or finds fixtures for a given league using get_fixtures.
You can also search the database to find details for specific football teams using search_football_teams.
League and Team Info
To see who's winning, your agent grabs the current league table and team positions for any specified competition using get_standings. You can get detailed background information and the current status for any football club using get_team_info. Want to know who's got the most goals? Your agent lists the players with the most goals scored in a given competition with get_league_topscorers.
If you need deep stats on a player, your agent fetches detailed performance metrics and profiles for any individual player using get_player_info. For more info on a club, your agent uses search_football_teams to get details about specific football teams.
How It Works
You just subscribe to the API-Football server and plug in your API-Football Key. Then, you let your AI agent handle the querying through your preferred client. It's that simple. Your agent doesn't need to know the API structure; it just knows how to ask for what you need, pulling accurate results into one chat window.
You can't beat having all that data right there, right when you need it.
How API-Football MCP Works
- 1 You subscribe to the server and provide your API-Football Key.
- 2 You ask your agent a complex question, like 'Show me the top scorers for the Premier League and the current standings.'
- 3 The agent executes the necessary tools (
get_league_topscorersandget_standings) and compiles a single, readable answer for you.
The bottom line is, you talk to your agent, and it handles the data calls needed to build the answer.
Who Is API-Football MCP For?
Football analysts and fantasy league managers need this. If you're tired of opening five different tabs—one for scores, one for standings, one for player stats—this server puts all that data into a single conversation flow. It's for people who need data, fast.
Runs seasonal performance audits, cross-referencing league standings (get_standings) with historical player data (get_player_info) to pinpoint trends.
Monitors player statistics and team performance in real-time. They check list_live_fixtures and get_player_info to make weekly roster moves.
Integrates professional-grade sports data into a custom application. They use the specific tools like get_fixtures and get_team_info to build features.
What Changes When You Connect
- Get instant league audits. Instead of manually checking multiple tabs, the agent runs
get_standingsand delivers the full league table immediately. - Track matches live. Use
list_live_fixturesto pull real-time scores and match status for thousands of games without leaving your chat window. - Analyze player performance depth.
get_player_infoprovides deep metrics, letting you audit a player's season stats without needing a separate stats dashboard. - Build historical comparisons. You can run a head-to-head audit between any two teams, something that’s tedious to compile from multiple sources.
- Plan future coverage. Quickly list all upcoming matches using
get_fixturesor see all available leagues usinglist_leaguesto plan your content calendar. - Identify key talent. Use
get_league_topscorersto pinpoint the star players and their goal counts in any major competition.
Real-World Use Cases
Checking a weekend's scores
The user needs to know what happened over the weekend. They ask their agent, 'What were the final scores for the Premier League last weekend?' The agent runs get_fixtures and list_live_fixtures to provide the full results.
Auditing a rivalry's history
A fan wants to know the historical matchup data between two rival clubs. They ask their agent, 'What's the H2H history between Team A and Team B?' The agent uses the available data to generate a full comparison.
Fantasy roster adjustment
A manager needs to adjust their team before the next round. They ask their agent, 'Who are the top three scorers in the Bundesliga right now?' The agent uses get_league_topscorers and get_player_info to give actionable advice.
Researching a new league
A developer is integrating data for a new market. They first ask the agent to run list_leagues to see what's available, then use get_team_info and search_football_teams to gather initial data.
The Tradeoffs
Asking for combined data in one query
Trying to get 'Standings, Top Scorers, and Live Scores' in a single, ambiguous prompt. The agent might fail or only execute one tool.
→
Break it down. First, run get_standings to get the current table. Then, run get_league_topscorers for the scorers. Finally, run list_live_fixtures to see what's happening right now. This structured approach guarantees all data points.
Assuming data completeness
The user asks for a player's injury status, but the agent only checks get_player_info and finds incomplete data. The user assumes the tool has everything.
→
If the initial query is general, always start by calling get_team_info or list_leagues first. This helps narrow the context and confirms the league or team ID before querying specific player data.
Searching without parameters
Asking the agent, 'Show me the team data.' The agent doesn't know which team you mean and returns a massive error dump.
→
Use search_football_teams first to get the ID or name of the team you want. Then, pass that specific ID to get_team_info to get the exact details you need.
When It Fits, When It Doesn't
Use this server if your job requires tracking, analyzing, or reporting on structured football data. Specifically, you need to: 1) Check current standings (get_standings); 2) Track live scores (list_live_fixtures); or 3) Audit player/team metrics (get_player_info, get_team_info).
Don't use this if you just need general sports news or qualitative analysis. For example, if you're looking for match commentary or fan opinion, this server won't help. If you only need a simple list of available leagues, list_leagues is sufficient, but if you need the data from those leagues, you need the full suite.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by API-Football. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 8 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Tracking sports data across multiple websites is a massive time sink.
Right now, you have to open ESPN, then FIFA, then a dedicated stats site, and then maybe a local league's website. You copy scores into a spreadsheet, you cross-reference player stats, and you spend hours just gathering the data before you even start your analysis.
With the API-Football MCP Server, you ask your agent one question—'What's the current status of the Premier League?'—and it pulls all the necessary live scores, standings, and player data into a single, immediate response. The data is ready to use.
API-Football MCP Server: Get full match data in chat.
Forget manually checking match schedules, league tables, and historical head-to-head records. You just prompt the agent: 'Compare the last 10 matches between Team X and Team Y.' The agent executes the necessary calls and gives you the full, calculated history.
You stop wasting time on data aggregation. You start analyzing.
Common Questions About API-Football MCP
How do I use the get_standings tool with API-Football? +
You need to specify the league ID and the season year. The agent will handle the format, but you must provide the correct league context for get_standings to work.
Can get_player_info handle live scores? +
No. get_player_info retrieves historical and profile data for a player. For live scores, use list_live_fixtures.
What is the difference between get_fixtures and list_live_fixtures? +
get_fixtures retrieves scheduled matches (upcoming or past). list_live_fixtures only shows matches that are currently in progress.
Do I need to call list_leagues before using get_team_info? +
No. While list_leagues gives you context, you can often use search_football_teams to find a team ID directly, which is what get_team_info needs.
How does the `search_football_teams` tool handle team name variations? +
The search_football_teams tool searches by partial names or common identifiers. You don't need the exact name; the tool handles variations like 'Man Utd' or 'Manchester United' for accurate results.
What information is returned when I use `get_league_topscorers`? +
It returns a list of top scorers for a specific league. For each player, you get their name, total goals, and the number of matches played in that league.
Are there any restrictions when using `list_live_fixtures`? +
The list_live_fixtures tool requires you to specify a date range and league ID. If you don't provide these parameters, the tool will return an error.
How can I use `get_player_info` to compare player stats? +
You call get_player_info separately for each player and then instruct your agent to compare the resulting data points. The tool provides the raw stats; your agent does the comparison.
How do I find my API-Football (API-SPORTS) Key? +
Log in to the API-SPORTS Dashboard, navigate to the 'API-Key' section, and copy your unique token.
Does the API provide real-time updates? +
Yes! The list_live_fixtures tool retrieves results from the real-time match engine of API-Football, covering goals, cards, and status updates as they happen.
Can I filter leagues by country? +
Yes! Use the list_leagues tool and provide the country parameter (e.g., 'Brazil', 'England') to see only the competitions available in that specific region.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
South Korea KOSIS
Query official South Korean government statistics — demographics, GDP, trade, technology, and industry — from the KOSIS national database.
Symbl.ai
Extract conversation intelligence from audio, video, and text — get summaries, action items, and topics directly from any AI agent.
Replicate Alternative
Run ML models via Replicate — generate images, text, audio and video from community models, track predictions and explore collections from any AI agent.
You might also like
7shifts
Schedule restaurant staff, manage shifts, track labor costs, and coordinate your team with intelligent workforce planning.
ECB Discovery — Universal Statistical Data Access
Explore the complete ECB statistical catalog: browse all available dataflows (datasets) and query any ECB SDMX dataset with custom series keys — from exchange rates and monetary aggregates to banking supervision and payment statistics.
360Learning
Collaborative learning platform — manage users, courses, paths, and training statistics via AI.