API-Football Connector for AI agents.
8 live capabilities
Access real-time football scores and player stats from over 1,000 leagues.
Waiting for input…
Why people use API-Football
API-Football Data for Real-Time Sports Analytics
This Connector puts that data directly into your chat. Just ask for the current standings or a player's season stats, and the agent pulls it instantly from a professional source. You get the facts without the friction.
What Vinkius changes
You get instant access to global football data without ever leaving your chat interface.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 6,100+ Connectors
- Real-world use case 01
Fantasy Draft Prep
A manager asks for the top scorers in the Bundesliga to decide on a striker.
- Real-world use case 02
Live Match Reporting
A creator asks for live scores in the Premier League to update their social feed.
- Real-world use case 03
Historical Research
An analyst asks for the head-to-head history between two clubs to predict an upcoming derby.
Complete set · 8capabilities
The complete API-Football capability set.
These are the exact actions your AI can choose when you ask it to work with API-Football.
01—04
4 capabilities in this set.
Part of 8 available through API-Football.
- 01 Capability
Get fixtures
Pull a list of scheduled matches for a specific date or league. This helps you plan for upcoming games without manual searching.
- 02 Capability
Get league topscorers
See which players are leading the goal charts in a specific competition. It helps you identify top performers quickly.
- 03 Capability
Get player info
Get detailed performance statistics and profile data for any individual player. Use this to dig into specific athlete metrics.
- 04 Capability
Get standings
Retrieve the current league table, including points and rankings. This keeps you updated on every promotion and relegation.
05—08
4 capabilities in this set.
Part of 8 available through API-Football.
- 05 Capability
Get team info
Fetch comprehensive details and profile information for a specific football club. It gives you a solid overview of any team.
- 06 Capability
List leagues
Get a full list of available football leagues from across the globe. See which competitions you can track in one list.
- 07 Capability
List live fixtures
Get a real-time list of all football matches currently in progress. Use this to stay on top of live action as it happens.
- 08 Capability
Search football teams
Search for specific clubs to find their unique IDs and basic team data. This saves you from having to guess IDs for other capabilities.
Set up in minutes
One URL. Then ask API-Football to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use API-Football from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_cApB7DmNDlCmEXnUzeh5d2paO78DlqsZ8W8iXnYR/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it API-Football, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable API-Football for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_cApB7DmNDlCmEXnUzeh5d2paO78DlqsZ8W8iXnYR/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the API-Football URL.
- Step 03
Save and start
Save the connection and enable API-Football in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"api-football": {
"url": "https://edge.vinkius.com/vk_preview_cApB7DmNDlCmEXnUzeh5d2paO78DlqsZ8W8iXnYR/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using API-Football
Open Agent mode in chat and ask: "Using API-Football, help me...". 8 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"api-football": {
"url": "https://edge.vinkius.com/vk_preview_cApB7DmNDlCmEXnUzeh5d2paO78DlqsZ8W8iXnYR/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using API-Football
Ask Copilot: "Using API-Football, help me...". 8 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"api-football": {
"url": "https://edge.vinkius.com/vk_preview_cApB7DmNDlCmEXnUzeh5d2paO78DlqsZ8W8iXnYR/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using API-Football
Open Cascade and ask: "Using API-Football, help me...". 8 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"api-football": {
"url": "https://edge.vinkius.com/vk_preview_cApB7DmNDlCmEXnUzeh5d2paO78DlqsZ8W8iXnYR/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using API-Football
Ask Cline: "Using API-Football, help me...". 8 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add api-football --transport http "https://edge.vinkius.com/vk_preview_cApB7DmNDlCmEXnUzeh5d2paO78DlqsZ8W8iXnYR/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using API-Football
Ask Claude: "Using API-Football, show me...". 8 tools are ready
Where the request belongs
Work API-Football can move forward.
This is for the person who lives and breathes football stats but hates the friction of manual data entry. It's for the analyst who needs to move faster and the fan who wants deeper insights than a standard news site provides.
Fantasy League Manager
Tracks player performance and team stats to make winning lineup decisions every week.
Sports Content Creator
Pulls live scores and league trends to keep their audience updated in real-time.
Data Analyst
Automates the collection of historical H2H data and seasonal performance metrics.
Software Developer
Builds custom sports apps using a reliable, professional-grade football data source.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsGameScorekeeper
Access live sports scores, fixtures, lineups, team form, and player statistics via AI. covering major football competitions worldwide.
SportDB
Access live scores, standings, fixtures, and player data across football, basketball, hockey, and tennis from any AI agent.
Football-Data.org
Access real-time football scores, standings, and player statistics from major global leagues via Football-Data.org.
SportsDB
Access global sports data via AI. search teams, players, and events, track scores, league tables, and match history across 200+ leagues.
Broadage Sports
Access real-time sports data via Broadage. track scores, matches, and lineups directly from any AI agent.
OpenLigaDB
Manage football results. audit match data, standings, and leagues via AI.
Bring your own AI
Change the model, client or framework. Keep API-Football connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about API-Football.
The practical details behind the request, access and result.
What leagues does the API-Football MCP cover?
It covers over 1,000 leagues globally, from major European divisions to smaller regional competitions. You can get data for almost any major football league in the world.
Can I use API-Football to track live scores?
Yes, you can get real-time updates for thousands of matches currently in progress. It's a great way to keep up with the action as it happens.
Does the API-Football MCP include player stats?
It provides detailed performance data for players, including goals and other key metrics. You can use it to track specific athletes across different seasons.
How do I get league standings with API-Football?
You can request the current table for any league, showing points, wins, and rankings. It's updated as matches finish to keep your data accurate.
Can I find specific team info using API-Football?
Yes, you can search for clubs to get their profiles, IDs, and basic team details. This makes it easy to gather info on any team in the world.
Is API-Football good for fantasy football?
It's perfect for tracking player stats and league trends to help you make better roster decisions. You can get the data you need to build a winning team.
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 capability 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 capability and provide the country parameter (e.g., 'Brazil', 'England') to see only the competitions available in that specific region.
One connection away
Give your agent a direct line to API-Football.
Connect API-Football once. Keep it beside 6,100+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available