How to Use the API-Football MCP in Cursor

Build sports apps and analyze match data with real-time API-Football stats injected straight into Cursor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect API-Football MCP to Cursor

Create your Vinkius account to connect API-Football to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup API-Football with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Generate Code with Live API-Football Data in Cursor

The `list_leagues` tool fetches active league IDs so your Cursor agent can write code against real database identifiers using this MCP server. You write your application logic using actual league structures instead of guessing schema shapes. Instead of mocking API responses, Cursor calls `get_fixtures` to populate your local UI components with live match schedules. This speeds up your frontend debugging because you see real match dates and times in your editor.

Build Dynamic Player Profiles in Your Editor

The `get_player_info` tool retrieves precise player metrics directly into your Cursor composer window. You can ask the editor to generate TypeScript interfaces based on the exact JSON structure returned by the player database. When building stats dashboards, `get_league_topscorers` provides the raw data needed to test your sorting algorithms. Your agent writes the component and populates it with current top-tier scorers in one step.

Search Teams and Fetch Standings on the Fly

The `search_football_teams` tool finds club details and returns exact team IDs directly inside your development environment via the MCP protocol. This keeps you focused on writing code without needing to run curl commands in an external terminal. To verify how your app handles complex tables, `get_standings` grabs live league rankings. You can instantly test how your CSS grid renders real-world football standings under different screen sizes.

Setup guide

Set up API-Football MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the API-Football MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent API-Football transactions." If the MCP tools are loaded correctly, Cursor will call the API-Football tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "api-football-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect API-Football now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about API-Football MCP in Cursor

Yes. Your Cursor agent calls the server to fetch actual JSON payloads, then automatically writes matching type definitions for your project.

It eliminates the need for mock data. The editor uses live tools to fetch real match stats, allowing you to test code with actual API responses.

The server exposes tools that Cursor understands natively. When you ask the agent for football stats, it invokes the correct tool and writes the code.

You can use the live fixtures tool to feed real-time score data into your code blocks while Cursor builds the widget UI.

Your authentication keys are managed safely within the Vinkius platform. Cursor connects to the secure endpoint, keeping your sensitive football API tokens out of your local git repositories.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript