Claudinho — live 2026 World Cup scores for your AI agent (stdio, npm)

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, or markets from 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.