claude mcp add --transport http livescore https://livescoremcp.com/mcp
Free · no API key · MIT licensed · Go
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.
Connect
Endpoint https://livescoremcp.com/mcp (Streamable HTTP). Clients that only speak the older SSE transport use https://livescoremcp.com/sse.
Settings → Connectors → Add custom connector, then paste:
https://livescoremcp.com/mcpSettings → 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.
{
"mcpServers": {
"livescore": { "url": "https://livescoremcp.com/mcp" }
}
}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.
| Tool | Returns |
|---|---|
get_live_scores | Matches in play right now, with score and minute; filter by country or competition. |
get_day_fixtures | All matches on a date — results, live matches and kick-off times. |
get_league_fixtures | A competition's latest results, live matches and upcoming fixtures, or one round. |
get_standings | League table with points, goal difference, form, qualification and relegation zones. |
get_top_scorers | Top scorers of a competition. |
get_head_to_head | All-time record between two teams, recent meetings and their next fixture. |
get_match | Events, line-ups, substitutions, statistics, injuries, form, report and head-to-head. |
get_team | Results, fixtures, squad, injuries, transfers, coach, stadium and honours. |
get_player | Statistics per season and competition, market value, injuries and transfers. |
search | Find teams, players and competitions; returns typed IDs such as team:9002. |
fetch | Full details for an ID returned by search. |
get_team_image | Team logo URL. |
get_fixtures | Alias of get_league_fixtures, kept for 1.0 clients. |
health | Connectivity check. |
| Names or IDs | Pass "Arsenal" or "La Liga" directly; the best search match is used, so the model need not look up an ID first. |
| Time zones | Pass an IANA timezone such as Europe/London and kick-off times and the meaning of "today" follow it. Default UTC. |
| Languages | Set language (en, es, de, fr, pt, pt-BR, ar and more) to localise names and links. |
| Raw data | format: "json" returns the underlying feed instead of prose. |
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?” |
Build and policy
| Language | Go, using mcp-go. One small stateless binary. |
| Transports | Streamable HTTP (/mcp, stateless) and SSE (/sse). |
| Data source | football-mania.com's own API — the pipeline behind the apps. |
| Licence | MIT, public at github.com/holoduke/livescore-mcp. |
| Rate limit | 30 tool calls per minute per IP. |
| Usage | Free for personal and non-commercial use. No bulk scraping. Commercial use requires permission. |
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.