Live football datayour assistant can read

Point Claude, ChatGPT, Cursor or any MCP client at one URL. Fourteen read-only tools, answers shaped for a model, and a link back to the match page for every result.

01

Connect

Endpoint https://livescoremcp.com/mcp (Streamable HTTP). Clients that only speak the older SSE transport use https://livescoremcp.com/sse.

Claude Code
claude mcp add --transport http livescore https://livescoremcp.com/mcp
Claude Desktop

Settings → Connectors → Add custom connector, then paste:

https://livescoremcp.com/mcp
ChatGPT

Settings → Apps & Connectors → Create (developer mode), endpoint https://livescoremcp.com/mcp, no authentication. The search and fetch tools follow the shape ChatGPT connectors and deep research expect.

Cursor / VS Code
{
  "mcpServers": {
    "livescore": { "url": "https://livescoremcp.com/mcp" }
  }
}
02

Fourteen tools, all read-only

Answers are compact text written for a model: IDs for follow-up calls, and a football-mania.com link for every match, team, player and competition.

Tools exposed by the LiveScore MCP server
ToolReturns
get_live_scoresMatches in play right now, with score and minute; filter by country or competition.
get_day_fixturesAll matches on a date — results, live matches and kick-off times.
get_league_fixturesA competition's latest results, live matches and upcoming fixtures, or one round.
get_standingsLeague table with points, goal difference, form, qualification and relegation zones.
get_top_scorersTop scorers of a competition.
get_head_to_headAll-time record between two teams, recent meetings and their next fixture.
get_matchEvents, line-ups, substitutions, statistics, injuries, form, report and head-to-head.
get_teamResults, fixtures, squad, injuries, transfers, coach, stadium and honours.
get_playerStatistics per season and competition, market value, injuries and transfers.
searchFind teams, players and competitions; returns typed IDs such as team:9002.
fetchFull details for an ID returned by search.
get_team_imageTeam logo URL.
get_fixturesAlias of get_league_fixtures, kept for 1.0 clients.
healthConnectivity check.
Names or IDsPass "Arsenal" or "La Liga" directly; the best search match is used, so the model need not look up an ID first.
Time zonesPass an IANA timezone such as Europe/London and kick-off times and the meaning of "today" follow it. Default UTC.
LanguagesSet language (en, es, de, fr, pt, pt-BR, ar and more) to localise names and links.
Raw dataformat: "json" returns the underlying feed instead of prose.
03

Things it can answer

All of these resolve against live data rather than a training cut-off.

“What’s the score in the Arsenal match right now, and who scored?”
“Show me the Eredivisie table and who they play next weekend.”
“How do Real Madrid and Bayern compare head-to-head in the Champions League?”
“Which matches are on today in Brazil, and what time in my time zone?”
“Give me Haaland’s goals per competition this season.”
“Who are the top scorers in Serie A, and is anyone injured?”
04

Build and policy

LanguageGo, using mcp-go. One small stateless binary.
TransportsStreamable HTTP (/mcp, stateless) and SSE (/sse).
Data sourcefootball-mania.com's own API — the pipeline behind the apps.
LicenceMIT, public at github.com/holoduke/livescore-mcp.
Rate limit30 tool calls per minute per IP.
UsageFree for personal and non-commercial use. No bulk scraping. Commercial use requires permission.
05

Questions

Do I need an API key or an account?

No. Point your client at https://livescoremcp.com/mcp and it works.

Which clients work with it?

Anything speaking Model Context Protocol: Claude Code, Claude Desktop, claude.ai, ChatGPT developer-mode connectors, Cursor, Windsurf, VS Code, Cline and others.

Is it open source?

Yes — Go, MIT licence. You can self-host a copy, though the hosted instance at livescoremcp.com is the one backed by the live feed.

Can it write or change anything?

No. Every tool is read-only; the server holds no user state.