SportAPI MCP server

sportapi-mcp

An MCP server that lets AI assistants (Claude Desktop, Claude Code, Cursor, VS Code, Windsurf and other MCP clients) look up Live and Prematch matches, scores, live statistics and betting odds from SportAPI. It runs on demo data out of the box, without an API key.

<!-- mcp-name: io.github.SportApi-net/sportapi-mcp -->

claude mcp add sportapi -- uvx sportapi-mcp

Then ask: "Which football matches are live right now, and who is favoured?"

This MCP server is free and MIT-licensed. The SportAPI data service behind it is a commercial

product: live data needs a personal API key (how to get one). Without a key,

every tool answers with the example responses from the SportAPI documentation, and every result

says so.

Features

tournaments, Live and Prematch match lists, the match calendar, full match details with every market, team search, top matches, top championships and the key's account status.

• 11 read-only tools covering the Sport Line API: sports, the navigation menu, countries,

per market ("W1 1.525 | X 5.08 | W2 6.15"). A detailed match can carry 200+ markets, so get_match returns 15 by default and accepts a markets filter (["1X2", "Total"]).

• Token-efficient output: compact JSON with empty fields dropped and odds rendered as one line

documented minimum update intervals and never sends overlapping requests for the same data. No tool polls or fans out over matches, however often the assistant calls it.

• Polite by design: every request goes through a snapshot cache that enforces the

presents a snapshot as live data.

• Demo mode with no setup, clearly labelled ("source": "demo") so that an assistant never

game_id from the wrong line type come back as short explanations the assistant can act on.

• Actionable errors: an expired key, a sport outside the subscription, a finished match or a

probabilities, bookmaker margin, fair odds) for one match.

• Two prompts: a live betting overview for a sport and a market comparison (implied

and the official MCP Python SDK. stdio by default, Streamable HTTP optional.

• Built on the official SportAPI Python client

What you can ask

Example conversations in demo mode (answers abridged). The assistant picks the tools itself.

"What's happening in live football right now?" → listlivematches(sport_id=1)

Demo data from the SportAPI documentation, not live. 39 football matches are in play.

Garuda Darwin 0:1 Darwin Olympic (76', NPL Northern Territory): Darwin Olympic are near-certain

winners at 1.064. Ikonnect FA U19 0:1 Obosa U19 (33'): Obosa favoured at 1.40, the draw at 4.65.

Caucaia U20 — Floresta EC U20 is goalless at 2', with Floresta slight favourites at 2.112.

"Arsenal against Coventry: how are the goal lines priced?" → getmatch(gameid=746146992, line_type="live", markets=["Total"])

Arsenal lead 3:0 at 56' (xG 1.45 vs 0.03, shots on target 4:0). Total goals: Over 3.5 at 1.23,

Over 4.5 at 2.09 / Under 4.5 at 1.81, Over 5.5 at 4.41. The market expects a fourth goal but

leans against a fifth.

Shortened. The full README is on GitHub.