MODEL CONTEXT PROTOCOL · Native AI Integration

Football Intelligence for Claude & Cursor

Official Model Context Protocol (MCP) server for OpenFootAPI. Connect your local LLM agents to live fixtures, standings, lineups, and shot-coordinate Expected Goals (xG) with zero configuration.

claude_desktop_config.json

npx openfoot-mcp

{
  "mcpServers": {
    "openfoot": {
      "command": "npx",
      "args": ["-y", "openfoot-mcp"],
      "env": { "OPENFOOT_API_KEY": "fs_live_..." }
    }
  }
}

🔑

API Key Provisioning

Replace fs_live_... with your OpenFoot API key. Claim your instant Developer key on the Pricing page (includes 25,000 monthly requests and full shot-level xG).

⚡

Zero Cold Starts

Runs over standard I/O (stdio) via Node ≥ 20. The server maintains active cache channels to Cloudflare Workers for sub-50ms data resolution.

TOOL MATRIX

12 Native MCP Tools

stdio JSON-RPC 2.0

openfoot_competitionsList supported leagues, sources and licenses

openfoot_searchSearch teams and competitions by name

openfoot_matchesQuery matches filtered by date, competition, status

openfoot_standingsFetch full league tables and recent 5-match form

openfoot_match_lineupsLineups, starting XI, bench, formations

openfoot_match_eventsMatch timeline, cards, goals, substitutions

openfoot_match_xgShot-by-shot coordinates (X,Y) and xG values

openfoot_match_contextElo ratings, rest days, form, momentum signals

openfoot_league_xgLeague-wide xG and expected points tables

openfoot_oddsModel fair odds benchmarks and probabilities

openfoot_quotaLive request quota and plan limits check

openfoot_healthReachability check without requiring API key

← API Documentation Claim Developer API Key →