# arturogarrido/claudinho [Health: Active]
**Category:** ๐ Sports
**Repository:** https://github.com/arturogarrido/claudinho
**GitHub Stars:** 28
**npm Downloads (last month):** 259
**Views:** 1
**Installs:** 0
**Upvotes:** 0
**Directory Page:** https://allmcps.com/mcp/arturogarrido-claudinho
## Description
Live scores, fixtures, standings, and read-only prediction-market signals for the 2026 World Cup. No API keys.
## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):
```json
"mcpServers": {
"claudinho": {
"command": "npx",
"args": ["-y","@claudinho/cli"]
}
}
```
## Documentation & README
# Claudinho โฝ
[](https://github.com/arturogarrido/claudinho/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/@claudinho/cli)
[](https://www.npmjs.com/package/@claudinho/mcp)
[](https://www.npmjs.com/package/@claudinho/cli)
[](https://cursor.directory/plugins/claudinho)
[](https://smithery.ai/servers/arturogarrido/claudinho)
[](https://glama.ai/mcp/servers/arturogarrido/claudinho)
[](https://nodejs.org)
[](LICENSE)
[](https://github.com/arturogarrido/claudinho)
[](https://github.com/arturogarrido/claudinho)
**Live scores for the 2026 men's football tournament โ in your terminal, your Claude Code / Cursor CLI statusline, and any MCP client.** No API key, no signup; all 104 fixtures ship bundled, so the schedule works offline.
```bash
npx @claudinho/cli today # try it in 10 seconds โ no install, no key
npx @claudinho/cli live # what's on right now (during match windows)
```
> โญ **Like it?** [Star the repo](https://github.com/arturogarrido/claudinho) โ a fan project's only scoreboard is its stars. (`claudinho star` shows you how anytime.)
While matches are live, your Claude Code or Cursor CLI statusline reads:
```text
โฝ ๐ณ๐ด 1โ1 ๐ซ๐ท 87' ยท ๐ธ๐ณ 1โ2 ๐ฎ๐ถ 86'
```
And `claudinho share` prints a card made for the group chat:
```text
Group A ยท standings
1. ๐ฒ๐ฝ MEX 9 pts ยท 3-0-0 ยท +6
2. ๐ฟ๐ฆ RSA 4 pts ยท 1-1-1 ยท -1
3. ๐ฐ๐ท KOR 3 pts ยท 1-0-2 ยท -1
4. ๐จ๐ฟ CZE 1 pts ยท 0-1-2 ยท -4
Live data: ESPN
#VibingLaVidaLoca ยท Independent fan project ยท not affiliated with FIFA or Anthropic.
Try it: npx @claudinho/cli table A
```
> โ ๏ธ **Not affiliated with, endorsed by, or connected to FIFA or Anthropic.**
> Claudinho is an independent, open-source fan project. It displays factual match data
> (scores, fixtures, standings) and uses emoji flags only โ no logos, emblems, kits,
> broadcast footage, or player likenesses.
## Install
### Just the CLI
```bash
npm i -g @claudinho/cli
claudinho today
claudinho next MEX --tz America/Mexico_City --lang es
```
### Cursor CLI โ statusline + MCP
One command wires the live-score statusline and prints the MCP config to paste:
```bash
npm i -g @claudinho/cli
claudinho init cursor # statusline โ ~/.cursor/cli-config.json (+ the MCP paste)
```
Restart your agent session to see it. Prefer to paste it yourself? `claudinho init cursor --print`
emits the snippets, or copy them straight from here:
**Statusline** โ `~/.cursor/cli-config.json`:
```json
{
"statusLine": {
"type": "command",
"command": "claudinho prompt",
"padding": 0,
"updateIntervalMs": 1000,
"timeoutMs": 1500
}
}
```
**MCP tools** โ `~/.cursor/mcp.json` (global) or a project `.cursor/mcp.json`:
```json
{ "mcpServers": { "claudinho": { "command": "npx", "args": ["-y", "@claudinho/mcp"] } } }
```
**Optional env** โ a model + context line below the score, or scope to your team:
```bash
export CLAUDINHO_CURSOR_META=auto # model + context % line under the score (recommended)
export CLAUDINHO_TEAM=MEX # show only your team's match
export CLAUDINHO_FLAGS=off # 3-letter codes instead of flag emoji (already automatic in Warp)
export CLAUDINHO_DEBUG=1 # print data-provider failure diagnostics to stderr
export CLAUDINHO_NO_STAR=1 # suppress the occasional "star the repo" nudge
```
> **Note:** Cursor's `beforeSubmitPrompt` hook doesn't yet reliably inject context into the
> model, so the score-aware *hook* stays Claude Code-only for now โ the statusline and MCP
> server work great in Cursor.
### Claude Code โ statusline, score-aware hook, MCP
```bash
npm i -g @claudinho/cli
claudinho init claude # statusline + live-score hook, then the MCP one-liner
```
`init claude` backs up `~/.claude/settings.json` first and is idempotent. Prefer the pieces
ร la carte? Run `init-statusline`, `init-hook`, and:
```bash
claude mcp add claudinho -- npx -y @claudinho/mcp
```
Restart Claude Code to activate.
> **Monorepo / local dev?** The `init cursor` / `init claude` aliases wire the global
> `claudinho`. To point a statusline or hook at a local build, use the granular commands
> with `--command`, e.g. `claudinho init-cursor-statusline --command "node ./packages/cli/dist/index.js prompt"`
> (and `init-statusline` / `init-hook` for Claude Code).
### Other MCP clients โ Codex, Claude Desktop, Windsurf, Zed, VS Code
```bash
codex mcp add claudinho -- npx -y @claudinho/mcp # Codex CLI
```
Everything else takes the standard stdio config:
```json
{ "mcpServers": { "claudinho": { "command": "npx", "args": ["-y", "@claudinho/mcp"] } } }
```
Then just ask, mid-task โ the agent calls the MCP server and answers with the score:
## Surfaces
- **CLI** โ `today`, `live`, `next MEX`, `table`, `match `, `bracket`, `markets`, `share`, `team` (name โ code, e.g. `team "DR Congo"`) (plus `vibe` ๐ and `star` โญ). `--json` on everything; TZ-aware via `--tz`.
- **Live statusline โ Claude Code & Cursor CLI** โ every live score inline; reads a local micro-cache, never blocks on the network. One command per agent: `claudinho init claude` / `claudinho init cursor` (also tmux & Starship via `claudinho prompt`).
- **Score-aware hook (Claude Code)** โ a `UserPromptSubmit` hook that drops the live score into the model's context during matches; zero tokens off-match. (Cursor parity pending โ its hook can't reliably inject context yet.)
- **MCP server** โ 9 read-only tools (`get_today`, `get_live`, `get_match`, `get_next_fixture`, `get_standings`, `get_bracket`, `get_market_signal`, `get_share_snippet`, `get_team`) plus `my_team` / `tournament_today` prompts.
- **Prediction-market signals** โ a read-only "who's favored" line (market-implied percentages, Source: Polymarket), shown only when a reliable market exists. **Informational only โ not betting advice.** Opt out: `--no-markets` / `CLAUDINHO_MARKETS=off`.
- **Shareable cards** โ `claudinho share next MEX --copy` puts a plain-text match card on your clipboard; `claudinho share table A` does the same for a group's live standings; `claudinho share bracket` for the knockout tree.
Speaks `en` / `es` / `pt` / `fr`, with optional localized commentary flair (`ยกGOOOOL!`) โ dial it down with `--flavor subtle|off`.
_Planned (not shipped yet):_ a desktop notifier and an AI pundit with a public accuracy scorecard.
## Around the web
Independent coverage and organic attribution include
[LinuxLinks](https://www.linuxlinks.com/claudinho-follow-world-cup-terminal/) and
[SuperIsland's Live Football extension](https://github.com/shobhit99/SuperIsland/tree/main/Extensions/live-football).
Claudinho is also listed in the
[Official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.arturogarrido/claudinho&version=latest),
[Smithery](https://smithery.ai/servers/arturogarrido/claudinho),
[Glama](https://glama.ai/mcp/servers/arturogarrido/claudinho),
[MCP.so](https://mcp.so/servers/claudinho),
[cursor.directory](https://cursor.directory/plugins/claudinho),
[awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code#status-lines), and
[awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers#-sports). The Cursor integration
was also discussed in the
[Cursor Community](https://forum.cursor.com/t/claudinho-live-world-cup-scores-in-your-cursor-cli-statusline-a-read-only-mcp-server/163557).
See **[PUBLIC_FOOTPRINT.md](https://github.com/arturogarrido/claudinho/blob/HEAD/PUBLIC_FOOTPRINT.md)** for the full dated record, including community
posts, historical listings, automated mirrors, and events.
## FAQ
**Do I need an API key or account?** No. Nothing to sign up for; `npx` and done.
**Does it work offline?** The bundled data does โ the full schedule, group fixtures, and the knockout bracket *structure* (all 104 fixtures ship bundled, no key). Anything *live* hits the network: scores, group standings, and a team's resolved knockout opponent (`next` once the draw fills in).
**Where does the data come from?** Live scores from ESPN's public scoreboard (attributed in output as `Live data: ESPN`); market signals from Polymarket public data. Rate limits respected.
**Is the market line betting advice?** No. It's read-only, informational-only market data with attribution โ no trading, no links โ and it never appears on the statusline or hook.
**Why no crests, kits, or player photos?** Legal-clean by design: facts and emoji flags only.
**Flags show as boxed letters (`CH`, `BA`)?** Some terminals โ notably Warp โ don't compose
the regional-indicator pairs into flag glyphs, so ๐จ๐ญ renders as a boxed `CH`. claudinho
auto-detects Warp and drops the flags: **3-letter codes on the statusline** (`MEX 1โ0 RSA 67'`)
and **plain team names in the hook**, `today` / `live` / `table`, and `next`. Force it anywhere with `CLAUDINHO_FLAGS=off`, or keep flags
with `CLAUDINHO_FLAGS=on`.
**Windows?** Works, but flag emoji rendering varies by terminal โ best on macOS/Linux. See the
flags note above; `CLAUDINHO_FLAGS=off` gives clean codes on any terminal that can't render them.
## Why star?
Claudinho is a solo, $0, organic fan project โ a GitHub star is the only signal that it's worth maintaining, and the nudge to keep shipping through the final. A star also:
- surfaces it for other devs hunting live scores during the tournament,
- puts new releases in your feed โ a desktop **notifier**, an AI pundit, and **other tournaments** are on the roadmap,
- takes one click โ **[โญ star Claudinho](https://github.com/arturogarrido/claudinho)**.
New here? [`CONTRIBUTING.md`](https://github.com/arturogarrido/claudinho/blob/HEAD/CONTRIBUTING.md) has the layout, the dev loop, and good first issues.
## Privacy Policy
Claudinho collects **no personal data** โ no accounts, no telemetry, no analytics, no tracking. There is no Claudinho server. To show live results it makes read-only requests to public sports-data services (ESPN for scores/standings; Polymarket for informational-only market signals) with no account or personal data attached, and keeps a small cache in your local cache directory (`~/.cache/claudinho`). Full details: **[PRIVACY.md](https://github.com/arturogarrido/claudinho/blob/HEAD/PRIVACY.md)**.
## Security
Found a vulnerability? Please report it **privately** via [GitHub's report form](https://github.com/arturogarrido/claudinho/security/advisories/new) rather than a public issue. **[SECURITY.md](https://github.com/arturogarrido/claudinho/blob/HEAD/SECURITY.md)** has the disclosure process and the threat model (stdio only, no listener, no credentials, two read-only outbound hosts).
## License
MIT ยฉ 2026 Arturo Garrido. All three packages publish with npm provenance via OIDC trusted publishing.
---
_Built while watching the games._ **#VibingLaVidaLoca** โฝ