API-Football MCP. Analyze live scores and league stats 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 connects your AI agent to real-time global football data. Get live scores, league standings, and detailed player stats for over 1,000 competitions instantly.
It lets you audit match history, check team rankings, or track top scorers just by asking a question. Stop switching between multiple sports websites; get all the competitive details from one authorized source.
What your AI agents can do
Get fixtures
Lists scheduled match fixtures for specific dates or leagues.
Get league topscorers
Retrieves a list of the top scoring players in a given league.
Get player info
Fetches detailed performance statistics and profile data for a specific player.
Get the score and current status for live games across thousands of leagues worldwide.
Access official, up-to-date tables showing which teams are leading in major competitions.
Compare the head-to-head results between any two specific teams to gauge their competitive history.
Retrieve detailed statistics and background information for individual players or entire clubs.
List all scheduled matches or fixtures for a specific date range or league.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
API-Football: 8 Available Tools
These tools let you retrieve everything related to global football data, including live scores, league rankings, and detailed player metrics.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using API-Football on Vinkius019d8416get fixtures
Lists scheduled match fixtures for specific dates or leagues.
019d8416get league topscorers
Retrieves a list of the top scoring players in a given league.
019d8416get player info
Fetches detailed performance statistics and profile data for a specific player.
019d8416get standings
Gets the current league table, showing points, wins, and ranking for all teams.
019d8416get team info
Retrieves general details about a specific football club or team.
019d8416list leagues
Returns a list of all available football leagues you can query data for.
019d8416list live fixtures
Gets the details and scores for matches currently in progress globally.
019d8416search football teams
Searches the database to find teams by name or other criteria.
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,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ 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
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.
The headache of tracking sports data manually
Today, if you want a full picture of the league—say, checking scores, seeing who's leading, and then looking up player stats for three different teams—you open ten tabs. You copy match IDs here, paste them there. You navigate between official scoring sites, dedicated stat trackers, and news archives. It takes time, it’s clunky, and you always fear missing a key update.
With this MCP, that whole process vanishes. You tell your agent what you need—e.g., 'Give me the live scores for the league leaders.' The system automatically handles fetching the data from multiple sources (live status, standings) and hands you one clean answer. It’s instant.
Get match data with API-Football MCP
You don't have to manually check the league table (`get_standings`), then search for player names, and finally cross-reference an opponent's history. The agent orchestrates this: it pulls the basic match details, runs a historical comparison with `get_fixtures`, and delivers all three pieces of information in one structured output.
It’s simple. You ask the question once, and you get the full audit trail—the current score, the league context, and the player performance metrics—without lifting a finger.
What you can do with this MCP connector
Need to keep tabs on global football action? This MCP gives your agent access to professional-grade data for thousands of leagues. Instead of manually checking dozens of websites—one for scores, another for standings, and a third for player stats—you just talk to your AI client. Your agent acts like a dedicated sports coordinator, pulling together everything you need in one go.
You can ask about live matches, check out the current league table, or even compare how two teams performed against each other historically. Everything comes from this single source of truth. If you're building anything that tracks sports data, connecting this MCP via Vinkius lets your agent run complex audits and keep up with fan engagement without ever needing to touch a dashboard.
019d8416-bdd9-71b9-9a34-b1d19d31b762 
How API-Football MCP Works
- 1 Subscribe to the API-Football MCP and input your unique API key.
- 2 Connect this MCP to your preferred AI client (like Claude, Cursor, etc.) through Vinkius.
- 3 Ask your agent a natural language question, and it uses the available tools to fetch the specific data you need.
The bottom line is that once connected, your agent handles all the API calls for you; you just ask the question.
Who Is API-Football MCP For?
Anyone who spends time tracking sports performance—from casual fantasy league managers to professional data analysts. If your job requires knowing what happened on the pitch right now, this is for you.
Monitoring player statistics and checking team standings across multiple leagues to make weekly roster decisions.
Running seasonal performance audits, comparing historical head-to-head records, or tracking league trends for client reports.
Building AI workflows that need reliable, structured data feeds for live score dashboards or analytics tools.
What Changes When You Connect
- Stop wasting time on manual research. Instead of checking multiple sites for scores, use the
list_live_fixturestool to get real-time updates in one query. - You can track team health without leaving your workspace. Just ask your agent to run a league audit using
get_standings, and it provides accurate rankings immediately. - Need context on rivals? Running an H2H comparison is simple. You can use the data to compare two teams' competitive history instantly, rather than digging through archives.
- Never guess about player performance again. The
get_player_infotool gives you deep metrics—goals, assists, minutes played—all in one go for your fantasy team. - Planning ahead? Use
get_fixturesto pull up a full list of upcoming matches. This helps you coordinate data gathering before the season even starts.
Real-World Use Cases
Tracking a sudden league shift
A fan notices a team's form dropping. They ask their agent to run get_standings and then use get_player_info for the key players on that team, immediately understanding who might be underperforming.
Pre-match analysis
A developer needs pre-game stats. They first call list_leagues to confirm IDs, then use get_fixtures for the match details and finally run a detailed comparison using historical data.
Fantasy league roster check
A manager needs to know if their star player is performing. They ask about the player's stats, and the agent calls get_player_info to pull up goal counts, assist totals, and minutes played instantly.
Verifying team details
A researcher needs basic facts on a club. They use search_football_teams first to find the ID, then call get_team_info for their history, squad size, and stadium details.
The Tradeoffs
Searching by vague terms
Asking your agent: 'Tell me about the league.' This is too broad; it doesn't know which season or region you mean.
→
Start specific. First, use list_leagues to find the correct competition ID, then ask for the standings using get_standings with that precise ID.
Mixing up live and scheduled data
Assuming 'fixtures' means what is happening right now. You might miss current scores if you only check upcoming dates.
→
If the game is active, use list_live_fixtures. If it's planned for later, use get_fixtures to look at future match lists.
Ignoring player-specific metrics
Only checking if a team won or lost. This ignores how they played or who contributed the most goals.
→
Always follow up with get_player_info for key players to get detailed performance stats that show true contribution.
When It Fits, When It Doesn't
Use this MCP if your workflow depends on structured, quantitative sports data. You need to know who is leading (get_standings), when something happens (get_fixtures or list_live_fixtures), or how good a specific person is (get_player_info). Don't use it if you just want general commentary; the tool only pulls facts. If your goal is to find a team, start with search_football_teams. If you need league context, always check list_leagues first before attempting to call get_standings or similar endpoints.
Common Questions About API-Football MCP
How do I find out what games are happening right now using list_live_fixtures? +
You use list_live_fixtures. This tool gives you the details and scores for every match that is currently in progress, letting you know who's playing and what the current score is.
Can I check league standings using get_standings? +
Yes. get_standings fetches the official league table for any major competition, listing every team's position, points, and goal difference.
How do I look up player statistics with get_player_info? +
You call get_player_info and provide the specific player ID. It returns a detailed profile including minutes played, goals scored, assists, and other performance metrics.
Do I need to search_football_teams first before getting info? +
It's helpful to use search_football_teams if you only know the team name. This helps confirm the exact ID required for reliable lookups using other tools.
How do I find out what games are scheduled next? +
Use get_fixtures. This tool lets you list all matches that are planned for a specific date or set of dates, so you can plan your analysis ahead of time.
Before I use get_league_topscorers, how do I find out what leagues are available using list_leagues? +
You must run list_leagues first. This tool gives you the necessary league IDs and names to filter your search accurately. Use the ID returned from this call when making subsequent requests for scorers or standings.
Does get_team_info give me more than just current season stats about a club? +
Yes, it provides deeper metadata beyond active statistics. You can retrieve structural details like the team's stadium capacity, founding date, and full historical roster names for context.
How do I ensure that get_fixtures returns matches only within a specific date range? +
You pass the required start and end dates as parameters. This limits the fixture list to your desired window, preventing you from getting irrelevant historical or future data.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.