Best for
- Developers working in the terminal during matches who want scores at a glance
- Claude Code or Cursor CLI users wanting a football statusline
- MCP users who want key-free, zero-signup sports data
C
Claudinho MCP Server
Community
Live 2026 World Cup scores in your terminal and AI agent
GitHub source repository ↗
70FMRS · B
Claudinho is a thoughtfully built unofficial World Cup scores MCP server: key-free, offline schedules, multilingual, with multiple surfaces (CLI/statusline/hook/MCP). Privacy-wise it collects no personal data, and security-wise it's stdio-only with two read-only outbound hosts. Great for fan-developers during the 2026 tournament; it relies on third-party live data, and its value fades after the event.
Claudinho is an independent, open-source fan project (MIT, not affiliated with FIFA or Anthropic) delivering live 2026 men's World Cup scores, fixtures, and standings through an MCP server, a CLI, and Claude Code / Cursor CLI statuslines. No API key or signup required; all 104 fixtures ship bundled for offline schedules. Live data comes from ESPN's public scoreboard with attribution, and market signals from Polymarket (informational only). The MCP server runs over stdio with 9 read-only tools plus my_team / tournament_today prompts, supports en/es/pt/fr, and offers optional timezone and commentary-flavor settings.
Tools
get_today
Get today's matches and scores
get_live
Get matches currently in play
get_match
Query a single match by ID
get_next_fixture
Get a team's next fixture (e.g. MEX)
get_standings
Get group standings
get_bracket
Get the knockout bracket
get_market_signal
Read-only prediction-market favored line (Polymarket, informational only)
get_share_snippet
Generate a shareable plain-text score/standings card
get_team
Resolve a team name to its code (e.g. "DR Congo" → COD)
Setup
Distributed via npm (@claudinho/mcp). Claude Code: install @claudinho/cli and run claudinho init claude (backs up ~/.claude/settings. first), or run claude mcp add claudinho -- npx -y @claudinho/mcp. Cursor: claudinho init cursor, or add {"mcpServers":{"claudinho":{"command":"npx","args":["-y","@claudinho/mcp"]}}} to ~/.cursor/mcp. or a project .cursor/mcp.. Codex CLI: codex mcp add claudinho -- npx -y @claudinho/mcp. Other MCP clients use the same stdio config. Restart your agent session. Optional env: CLAUDINHO_LANG (en/es/pt/fr), CLAUDINHO_TZ (IANA timezone), CLAUDINHO_FLAVOR (off/subtle/full), CLAUDINHO_MARKETS (off to hide market signals).
claude_desktop_config.json
{"mcpServers":{"claudinho":{"command":"npx","args":["-y","@claudinho/mcp"]}}}
Fit and risk
Not for
- Users needing official or licensed tournament data (unofficial fan project)
- Workflows requiring write operations or auth (read-only only)
- Anyone seeking betting advice (market signals are informational only)
Required permissions
- Read/write access to the local cache directory ~/.cache/claudinho
- Read-only network requests to ESPN's public scoreboard during matches
- Read-only requests to Polymarket public data when market signals are enabled
- Modifying Claude Code / Cursor config files when installing the statusline and hook
Risks and side effects
- Unofficial fan project; accuracy depends on third parties (ESPN, Polymarket) availability and quality
- Live scores require network; offline you only get the bundled schedule and bracket structure
- Prediction-market signals are informational only and must not be treated as betting advice
- Solo-maintained $0 project; long-term maintenance after the tournament is uncertain
Troubleshooting
- Flags render as boxed letters (e.g. CH)? Your terminal (notably Warp) can't compose regional-indicator pairs; use CLAUDINHO_FLAGS=off for 3-letter codes
- Statusline not updating? Restart the agent session; for local builds use granular init commands with --command
- Cursor's beforeSubmitPrompt hook can't reliably inject context yet — the score-aware hook is Claude Code-only
- Set CLAUDINHO_DEBUG=1 to print data-provider failure diagnostics to stderr
Use cases
Asking your AI agent mid-task 'did Germany get through?' and getting the live result
Inline live scores in your Claude Code or Cursor CLI statusline
Checking group standings, the knockout bracket, and next fixtures with timezone support
Copying plain-text match/standings cards to your clipboard for group chats
Supported clients
Claude CodeFull support
Cursor CLIPartial support
Codex CLIFull support
Claude DesktopFull support
WindsurfFull support
ZedFull support
VS CodeFull support