API-Football MCP Server

A universal Model Context Protocol (MCP) server providing access to football/soccer data via API-Football. Built with TypeScript for maximum compatibility.

Features

• ✅ Universal: Works on any platform with Node.js (no Python required)
• ✅ 21 Football Tools: Comprehensive API-Football data access
• ✅ MCP Compatible: Works with Claude Desktop, Cline, and any MCP client
• ✅ TypeScript: Fully typed for better reliability
• ✅ Easy Installation: npx api-football-mcp@latest

Quick Start

1. Get Your API Key

Sign up at API-Football for your API key.

2. Use with npx

# Set your API key
export API_FOOTBALL_KEY="your_api_key_here"

# Run the server  
npx api-football-mcp@latest

3. Configure with MCP Clients

Claude Desktop / Cline

{
  "mcpServers": {
    "api-football": {
      "command": "npx",
      "args": ["-y", "api-football-mcp@latest"],
      "env": {
        "API_FOOTBALL_KEY": "your_key_here"
      }
    }
  }
}

Available Tools (21 total)

See full tool documentation at API-Football Docs

Development

npm install
npm run build
npm start

License

MIT