Claudinho — live 2026 World Cup scores for your AI agent (stdio,…
@arturogarrido
About Claudinho — live 2026 World Cup scores for your AI agent (stdio,…
⚽ 2026 World Cup live scores in your terminal, Claude Code and Cursor CLI statusline & MCP. No API keys. Not affiliated with FIFA or Anthropic.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"claudinho": {
"command": "npx",
"args": [
"-y",
"@claudinho/mcp"
]
}
}
}Tools
9All fixtures for a date (default: today), with live score and minute overlaid on any match in play. Optional prediction-market enrichment carries marketComplete; false means the read was incomplete, not that no signal exists. Use this for a whole day's card; for only in-play matches use get_live, for one team's match use get_next_fixture, for a single match's detail use get_match. Kickoffs render in tz; lang localizes dates, attribution, and commentary (en/es/pt/fr); flavor sets commentary tone.
Only matches in play right now — each with current score and minute (empty when nothing is live). Use during matches for in-play state; for a full day's schedule including upcoming and finished, use get_today. tz/lang/flavor affect formatting only.
One match by its id, with live score/minute overlaid when it's in play. Optional prediction-market enrichment carries marketComplete; false means the read was incomplete, not that no signal exists. Get the id from get_today or get_live; to find a team's match without an id, use get_next_fixture. tz/lang/flavor affect formatting.
Live cumulative group standings — pass a group letter A–L, or omit for all 12. Returns ranked rows (team, played, W/D/L, goal difference, points). Use get_today for fixtures/scores and get_next_fixture for one team. If unavailable, the default World Cup scope returns a roster at zero; competitions without a compatible bundled roster return no tables. Both are flagged degraded.
Knockout bracket from the Round of 32 through the final, with live scores overlaid. Group slots project from live standings once a group has started; winner slots need a confirmed FT result. Pass an optional stage (R32, R16, QF, SF, 3P, F) to filter one round. Falls back to structure-only when live data is unavailable.
A team's next match, live-resolved: a confirmed knockout tie (Round of 32 onward) is read from the live overlay, group fixtures from the bundled schedule. Use a 3-letter code, e.g. MEX, BRA, USA. Falls back to the bundled schedule if the provider is unreachable.
Read-only prediction-market signals for a match (by id), a team's current-or-next fixture, or a date (default: today). Returns market-implied percentages with attribution; complete:false means the provider read was incomplete, not that no signal exists. Shown only before and during a match — finished matches have no market read. Informational only — relay the numbers factually; do not add betting, trading, or 'value' advice, and do not invent links.
A polished, copy-pasteable card (plain text) for a match (matchId), a team's next fixture (team), a group's standings table (group, e.g. "A"), the knockout bracket (bracket: true), a date (default: today), or live matches (live: true). Returns the ready-to-paste snippet plus structured data — hand the snippet text to the user verbatim. marketComplete:false is stated inside the card as an incomplete optional read. No links; it carries a non-affiliation disclaimer, and any market line stays informational only.
Resolve a nation name or 3-letter code to its FIFA code, flag, and group. Fuzzy and forgiving: accepts "Mexico", "mex", "USA", "DR Congo", "Türkiye"/"Turkey", "Holland", etc. Use this FIRST to turn a user's team name into the code the other tools need (get_next_fixture, get_standings, get_market_signal, get_share_snippet). Returns the single confident match (team), plus candidates (matches) when the query is ambiguous (e.g. "south" → South Africa, South Korea). Offline — reads the bundled roster, never the network.
Overview
What is Claudinho?
Claudinho is an open-source Model Context Protocol (MCP) server and CLI that delivers live 2026 men’s World Cup scores, fixtures, and standings to AI coding agents (Claude Code, Cursor), terminal statuslines, and any MCP client. No API key or signup required; all 104 fixtures ship bundled for offline schedule access. It is a fan project not affiliated with FIFA or Anthropic.
How to use Claudinho?
Install the CLI globally (npm i -g @claudinho/cli) and run commands like claudinho today or claudinho live. For Cursor CLI, run claudinho init cursor to wire the live-score statusline and MCP config. For Claude Code, run claudinho init claude to add statusline and a score-aware hook. Other MCP clients use the stdio config: { "mcpServers": { "claudinho": { "command": "npx", "args": ["-y", "@claudinho/mcp"] } } }. Then ask your agent mid-task—it calls the MCP server and answers with scores.
Key features of Claudinho
- Live scores in Claude Code and Cursor CLI statuslines
- 9 read-only MCP tools (scores, standings, bracket, etc.)
- Bundled offline schedule for all 104 fixtures
- No API key, no signup needed
- Shareable text cards for standings, matches, and brackets
- Read-only prediction-market signals (source: Polymarket)
Use cases of Claudinho
- Check live World Cup scores without leaving your coding terminal
- Ask your AI agent “did Germany get through?” and get the answer with match details
- Share a group’s live standings or a match card in a chat with
claudinho share - Show your team’s next match time (with timezone-aware
next MEX --tz America/Mexico_City) - Run
table,bracket, ormarketsfrom the command line as an independent fan reference
FAQ from Claudinho
Do I need an API key or account?
No. Nothing to sign up for; just run npx @claudinho/cli today and it works.
Does it work offline?
Yes for the schedule—the full fixture list and bracket structure ship bundled. Live scores, standings, and resolved knockout opponents require network access.
Where does the data come from?
Live scores from ESPN’s public scoreboard (attributed as “Live data: ESPN”); market signals from Polymarket public data. Rate limits are respected.
Is the market line betting advice?
No. It is read-only, informational-only market data with attribution—no trading, no links—and never appears on the statusline or hook.
Flags show as boxed letters (e.g., CH, BA) in my terminal?
Some terminals (notably Warp) don’t render flag emoji. Claudinho auto-detects Warp and drops flags, showing 3-letter codes or team names instead. Force this with CLAUDINHO_FLAGS=off.
Frequently asked questions
Do I need an API key or account?
No. Nothing to sign up for; just run `npx @claudinho/cli today` and it works.
Does it work offline?
Yes for the schedule—the full fixture list and bracket structure ship bundled. Live scores, standings, and resolved knockout opponents require network access.
Where does the data come from?
Live scores from ESPN’s public scoreboard (attributed as “Live data: ESPN”); market signals from Polymarket public data. Rate limits are respected.
Is the market line betting advice?
No. It is read-only, informational-only market data with attribution—no trading, no links—and never appears on the statusline or hook.
Flags show as boxed letters (e.g., `CH`, `BA`) in my terminal?
Some terminals (notably Warp) don’t render flag emoji. Claudinho auto-detects Warp and drops flags, showing 3-letter codes or team names instead. Force this with `CLAUDINHO_FLAGS=off`.
Basic information
More Other MCP servers
Activepieces
activepiecesAI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
ghidraMCP
LaurieWiredMCP Server for Ghidra
🪟 Windows-MCP
CursorTouchMCP Server for Computer Use in Windows
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
Production-ready MCP integrations for AI applications
Klavis-AIKlavis AI: MCP integration platforms that let AI agents use tools reliably at any scale
Comments