Claudinho icon

Claudinho

Claudinho shows 2026 World Cup live scores, fixtures, standings, and match data in the terminal, Claude Code, and MCP clients—no API key or signup.

Claudinho

Overview

Claudinho is an open-source fan project for following the 2026 men's football tournament from the terminal, Claude Code, and MCP clients. It focuses on factual match data — scores, fixtures, standings, and selected market signals — and uses emoji flags rather than logos, kits, or player photos.

The project is built around low-friction access: the README says there is no API key or signup required, the schedule is bundled so it can work offline for those parts, and the CLI can be launched directly with `npx @claudinho/cli today`. It also publishes packaged releases and notes that the project is independent and not affiliated with FIFA or Anthropic.

Beyond live score viewing, Claudinho is meant to fit into coding workflows. It can update Claude Code's statusline, pass score context into Claude during matches, and connect to other MCP clients through a standard stdio configuration. The README also mentions that live data is attributed to ESPN and that market signals, when shown, come from Polymarket public data.

The project includes share commands for plain-text cards, supports multiple languages, and offers a small set of opt-in controls such as disabling market lines or dialing down commentary flair. A few planned features are mentioned in the README, but they are explicitly marked as not shipped yet.

What it does

Terminal match views

Shows live World Cup scores in the terminal and can print today's fixtures, next matchups, group tables, and individual match details from the CLI.

Claude Code statusline

Adds live score output to Claude Code's statusline, with a local micro-cache so the display stays responsive and does not block on the network.

Score-aware hook

Provides a score-aware UserPromptSubmit hook so Claude can receive the current match state during games, while staying silent off-match.

MCP support

Exposes a read-only MCP server with tools such as `get_today`, `get_live`, `get_match`, `get_next_fixture`, `get_standings`, `get_market_signal`, and `get_share_snippet`.

Shareable cards

Supports shareable text cards for match summaries and group standings, designed for clipboard use and group-chat sharing.

Localized output

Includes language options for English, Spanish, Portuguese, and French, plus a configurable commentary style.

Common use cases

  • Follow the tournament in a terminal

    Check live scores, fixtures, and standings from the command line without signing in or creating an account.

  • Keep Claude Code aware of the score

    Surface live match context in Claude Code while you work, using the statusline and score-aware hook during matches.

  • Use it with an MCP client

    Connect a read-only sports feed to another MCP client through standard stdio settings when you want match data inside an AI workflow.

  • Share match updates with others

    Copy plain-text match cards or group tables for chat threads, status updates, or quick team summaries.

  • Localize the output

    Switch output language or commentary style when you need the same data in a different language or a quieter presentation.

Pros and Cons

Pros

  • No API key or account is required to start using it.
  • The bundled schedule covers 104 fixtures, so core fixture browsing works offline.
  • It supports multiple surfaces: terminal, Claude Code, and MCP clients.
  • Live data sources are attributed in the output, with ESPN for scores and Polymarket for market signals.
  • It offers shareable summaries and localized output in four languages.

Cons

  • Live scores still require network access even though some schedule data is bundled locally.
  • Flag emoji rendering can vary on Windows terminals.
  • Planned features like a desktop notifier and AI pundit are mentioned but not yet shipped.

FAQ

Do I need an API key or account?

No. The README says there is no API key or signup required, and `npx @claudinho/cli today` is meant to work immediately.

Does it work offline?

Partly. The schedule, `next`, and group skeletons are bundled with the project, but live scores still use the network.

Where does the data come from?

Live scores come from ESPN's public scoreboard, and market signals use Polymarket public data when a reliable market exists.

Can I use it with MCP clients other than Claude Code?

Yes. The README says it works with other MCP clients, including Cursor, Codex, Claude Desktop, Windsurf, Zed, and VS Code.

Does it work on Windows?

The project notes that Windows is supported, but flag emoji rendering depends on the terminal and is described as best on macOS and Linux.

Quick Facts

Category
Developer Tool
Primary surfaces
Terminal, Claude Code, MCP clients
Source domain
github.com
License
MIT
Open source
Yes
Data sources
ESPN public scoreboard; Polymarket public data