claudinho — Claude Code MCP server: what it does, how to install
Connects live football scores, standings, and match calendars to your coding assistant. Helpful when tracking your favorite club while writing code.
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/mcpWhat claudinho 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.
What it helps with
- 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 for the agent
- 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?
How to install claudinho
Platform CLI
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/mcpReplace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
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/mcpReplace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"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
Config file
{
"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
Platform CLI
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/mcpReplace <…> with your own values. 1 more environment variable is in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about claudinho
How to install claudinho in Claude Code?
Run claude mcp add claudinho -- npx -y @claudinho/mcp in your terminal.
What does the claudinho MCP server do?
It provides football scores, tournament standings, and fixture schedules for 16 major soccer competitions to local coding agents.
What system dependencies does claudinho need?
The package runs via npx and demands Node.js 22 or 24. No third-party API tokens or registrations are needed.
