Openfoot Mcp

io.github.bartokulusPublished by GitHub account bartokulusv0.1.2Updated Oct 24, 2026

Football fixtures, standings, lineups, live events and shot-level xG across 75 competitions.

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

A local MCP server that gives an assistant real football data from the OpenFootAPI: fixtures, standings, lineups, live events, shot-level xG and fair odds.

What you can do
Look up competitions, seasons and data sources, and resolve team or competition names to stable IDs by free-text search. Retrieve fixtures and results filtered by date, competition, team, status, season or round, plus standings tables. Read match detail: starting lineups and formations, goals, cards, substitutions and commentary timelines. Get shot-level xG with pitch coordinates, league xG tables, and derived context such as form and head-to-head. Check bookmaker benchmarks with implied fair probabilities, remaining monthly quota, and API reachability.
When to use it
Useful when an assistant should answer football questions from real data rather than guessed scorelines, especially for the deepest-covered leagues (Bundesliga, 2. Bundesliga, DFB Pokal, Superliga României) and expanded European competitions. Also handy for xG-based team form analysis via the included scout prompt.
Requirements
Runs locally over stdio via npx, so Node.js 20 or newer is needed. Requires an OpenFootAPI key supplied in the OPENFOOT_API_KEY environment variable; a free tier of 5,000 requests per month exists. Network access to the OpenFootAPI service is required.
Before you install
The API key is a secret passed in the environment. Every request is metered, including 404s and empty results, so guessing IDs wastes quota; the server reports quota or rate-limit errors rather than empty results. Paid tiers exist, and quota resets monthly. Odds data is informational, not betting advice. Coverage depth varies by competition, so check the league before relying on it.

Installation

In SourceWeft

  1. Open Openfoot Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

openfoot-mcp

MCP server for the OpenFootAPI football intelligence API. Gives an LLM client real football data — fixtures, standings, lineups, live events, shot-level xG with pitch coordinates, and model-derived fair odds — instead of a hallucinated scoreline.

15 tools, 1 prompt. Node ≥ 20, no build step.

Install

bash
npx openfoot-mcp

Set your API key in the environment. Free tier: 5,000 requests/month. Get a key at openfootapi.com/pricing.

Claude Desktop / Claude Code

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

Cursor / Windsurf / any stdio MCP client

Same block, in that client's MCP config file.

Tools

ToolWhat it returns
openfoot_competitionsSupported competitions, season metadata, data source and licence per competition
openfoot_searchFree-text team/competition name → stable IDs
openfoot_matchesFixtures and results, filtered by date / competition / team / status / season / round, cursor-paginated
openfoot_standingsStandings table for a competition and season
openfoot_match_lineupsStarting XI, bench, formation
openfoot_match_eventsGoals, cards, substitutions, commentary timeline
openfoot_match_xgOne entry per shot: pitch coordinates + xG value
openfoot_match_contextDerived context — form, head-to-head, pre-computed signals
openfoot_league_xgLeague xG table: xG for, xG against, over/under-performance vs actual goals
openfoot_oddsBookmaker benchmark + implied fair probabilities. Informational, not betting advice
openfoot_quotaRemaining monthly quota — this call does not consume quota
openfoot_healthReachability check. Works without an API key

Prompt: scout_team_form — resolve a team, pull its last 5 matches, read the xG behind the results.

Start with openfoot_search to resolve IDs. Guessing IDs wastes quota: 404s and empty results are metered like any other request.

Coverage, stated honestly

The catalogue lists 120 competitions. Depth is not uniform, and the catalogue is wider than the deep coverage.

  • Deepest: Bundesliga, 2. Bundesliga, DFB Pokal, Superliga României
  • Expanded European: Eredivisie, Primeira Liga, Süper Lig, Pro League, Scottish Premiership
  • Historical / analytics only: Premier League, La Liga, Serie A, Ligue 1 (xG is Understat-derived)

Call openfoot_competitions and check your league before you build on it.

Quota behaviour

  • Free: 5,000 requests/month, 60 req/min. Developer $14/month: 250,000 requests/month, 100 req/min, includes xG, shot maps, lineups, live events and fair odds. Pro $39/month: 2,000,000/month, 250 req/min.
  • No overage billing. When the quota is spent the API returns 429; this server surfaces that as a quota_or_rate_limit error rather than an empty result.
  • Quota resets on the 1st of the month, UTC.
  • Every request is metered, including 404s and empty results.

When this is the wrong tool

  • High-frequency live polling across many competitions. A monthly quota is the wrong shape for it — a per-day or per-second plan elsewhere will cost you less.
  • Leagues outside the deep-coverage list above.
  • You need a contractual SLA, uptime credits or a named support contact. Not offered at these prices.

Development

bash
npm installnpm run smoke   # boots the server over stdio, lists tools, calls health

npm run smoke works without an API key: openfoot_health returns live status, and a key-gated tool returns a readable missing_api_key error so you can tell "not configured" from "broken".

MIT.

Source: README.md at commit 2b70ef1

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts