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": "of_live_..." }
    }
  }
}

Published on npm as openfoot-mcp. Nothing to install — npx -y openfoot-mcp fetches and runs it. Node ≥ 20.

API Key Provisioning

Replace of_live_... with your OpenFoot API key. A free Starter key (5,000 requests/month) runs 10 of the 15 tools and takes a minute to get on the Pricing page. Developer ($14/mo, 250,000 requests) unlocks the 5 marked below.

Nothing to Keep Running

No daemon, no build step. Your client spawns it over stdio and it exits with your session. Requests hit the API's Cloudflare edge cache, so repeated queries never re-fetch from upstream sources.

TOOL MATRIX

15 Native MCP Tools

stdio JSON-RPC 2.0

10 run on a free Starter key. The 5 marked DEVELOPER return an explicitplan_upgrade_requireduntil you upgrade — never an empty result you have to guess about.

openfoot_competitions

List supported leagues, sources and licenses

openfoot_search

Search teams and competitions by name

openfoot_matches

Query matches filtered by date, competition, status

openfoot_standings

Fetch full league tables and recent 5-match form

openfoot_scorers

Top scorers, assists and player statistics for a competition

openfoot_match_lineupsDEVELOPER

Lineups, starting XI, bench, formations

openfoot_match_eventsDEVELOPER

Match timeline, cards, goals, substitutions

openfoot_match_xgDEVELOPER

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

openfoot_match_context

Elo ratings, rest days, form, momentum signals

openfoot_team_squad

Full squad rosters, shirt numbers and coach

openfoot_team_h2h

Head-to-head match records and historical outcomes

openfoot_league_xgDEVELOPER

League-wide xG, xG conceded and xG difference tables

openfoot_oddsDEVELOPER

Model fair odds benchmarks and probabilities

openfoot_quota

Live request quota and plan limits check

openfoot_health

Reachability check without requiring API key

← API Documentation Get your API key →