# claudinho

Connects live football scores, standings, and match calendars to your coding assistant. Helpful when tracking your favorite club while writing code.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 33
- Author: arturogarrido
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/arturogarrido/claudinho/tree/HEAD/packages/mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/claudinho

## What it does

The server feeds match data across 16 soccer competitions to your agent, covering tournaments like the Champions League, Premier League, and LALIGA. Tools fetch live scores, knockout brackets, goals, disciplinary cards, and next fixtures up to 14 days ahead. No account or external API credential is required.

Running this server requires Node.js 22 or newer on your machine. All tools operate in read-only mode, while team lookups and competition lists run locally offline. Through environment settings, you can pick a preferred language between English, Spanish, Portuguese, or French, configure the timezone, and tune cheer comments. When an agent query omits the tournament name, the server prompts you to define one.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `CLAUDINHO_LANG`, `CLAUDINHO_TZ`, `CLAUDINHO_FLAVOR`, `CLAUDINHO_MARKETS`, `CLAUDINHO_COMPETITION`, `CLAUDINHO_TEAM` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env CLAUDINHO_LANG=<CLAUDINHO_LANG> --env CLAUDINHO_TZ=<CLAUDINHO_TZ> --env CLAUDINHO_FLAVOR=<CLAUDINHO_FLAVOR> --env CLAUDINHO_MARKETS=<CLAUDINHO_MARKETS> --env CLAUDINHO_COMPETITION=<CLAUDINHO_COMPETITION> --transport stdio mcp -- npx -y @claudinho/mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Codex

**Platform CLI**
```bash
codex mcp add mcp --env CLAUDINHO_LANG=<CLAUDINHO_LANG> --env CLAUDINHO_TZ=<CLAUDINHO_TZ> --env CLAUDINHO_FLAVOR=<CLAUDINHO_FLAVOR> --env CLAUDINHO_MARKETS=<CLAUDINHO_MARKETS> --env CLAUDINHO_COMPETITION=<CLAUDINHO_COMPETITION> -- npx -y @claudinho/mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@claudinho/mcp"
            ],
            "env": {
                "CLAUDINHO_LANG": "<CLAUDINHO_LANG>",
                "CLAUDINHO_TZ": "<CLAUDINHO_TZ>",
                "CLAUDINHO_FLAVOR": "<CLAUDINHO_FLAVOR>",
                "CLAUDINHO_MARKETS": "<CLAUDINHO_MARKETS>",
                "CLAUDINHO_COMPETITION": "<CLAUDINHO_COMPETITION>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@claudinho/mcp"
            ],
            "env": {
                "CLAUDINHO_LANG": "<CLAUDINHO_LANG>",
                "CLAUDINHO_TZ": "<CLAUDINHO_TZ>",
                "CLAUDINHO_FLAVOR": "<CLAUDINHO_FLAVOR>",
                "CLAUDINHO_MARKETS": "<CLAUDINHO_MARKETS>",
                "CLAUDINHO_COMPETITION": "<CLAUDINHO_COMPETITION>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e CLAUDINHO_LANG=<CLAUDINHO_LANG> -e CLAUDINHO_TZ=<CLAUDINHO_TZ> -e CLAUDINHO_FLAVOR=<CLAUDINHO_FLAVOR> -e CLAUDINHO_MARKETS=<CLAUDINHO_MARKETS> -e CLAUDINHO_COMPETITION=<CLAUDINHO_COMPETITION> mcp npx -y @claudinho/mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

## When to use it
- Fetch live match scores directly inside your coding workflow
- Check upcoming club fixtures within a two-week window
- Inspect tournament standings and tournament knockout brackets
- Generate ready-to-share plain-text summary cards for today's games

## Example prompts
- What Champions League matches are happening right now?
- Show me the current Premier League standings
- When does Arsenal play their next game in the Champions League?

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md