@claudinho/mcp 0.4.0 → 0.4.2

package/README.md

@@ -1,8 +1,8 @@
 # @claudinho/mcp ⚽
 
-**An MCP server for the 2026 men's football tournament.** Ask your agent about
-live scores, fixtures, group standings, and prediction-market odds — in Claude
-Code, Cursor, Codex, and any other MCP client.
+**An MCP server for the 2026 men's football tournament.** Ask your agent about live
+scores, fixtures, group standings, and the prediction-market read — in Claude Code,
+Cursor, Codex, Claude Desktop, Windsurf, Zed, VS Code, or any MCP client (stdio).
 
 > ⚠️ **Not affiliated with, endorsed by, or connected to FIFA or Anthropic.**
 > Claudinho is an independent, open-source fan project. Factual match data with
@@ -15,29 +15,18 @@ Code, Cursor, Codex, and any other MCP client.
 claude mcp add claudinho -- npx -y @claudinho/mcp
 ```
 
-**Cursor** — add to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):
-```json
-{ "mcpServers": { "claudinho": { "command": "npx", "args": ["-y", "@claudinho/mcp"] } } }
-```
-
-**Codex CLI** — add to `~/.codex/config.toml`:
-```toml
-[mcp_servers.claudinho]
-command = "npx"
-args = ["-y", "@claudinho/mcp"]
+**Codex CLI**
+```bash
+codex mcp add claudinho -- npx -y @claudinho/mcp
 ```
-(or `codex mcp add claudinho -- npx -y @claudinho/mcp`)
 
-**Claude Desktop** — edit `claude_desktop_config.json` (Settings → Developer →
-Edit Config), then restart Claude Desktop:
+**Cursor / Claude Desktop / Windsurf / Zed / VS Code** — standard stdio config:
 ```json
 { "mcpServers": { "claudinho": { "command": "npx", "args": ["-y", "@claudinho/mcp"] } } }
 ```
-Config location: macOS `~/Library/Application Support/Claude/claude_desktop_config.json`,
-Windows `%APPDATA%\Claude\claude_desktop_config.json`.
-
-Transport is stdio, so the same package works in Windsurf, Zed, VS Code, and
-any other MCP client with no changes.
+Cursor: `.cursor/mcp.json` (or `~/.cursor/mcp.json`). Claude Desktop: Settings →
+Developer → Edit Config, then restart. Codex config file: `~/.codex/config.toml`
+(`[mcp_servers.claudinho]`, `command = "npx"`, `args = ["-y", "@claudinho/mcp"]`).
 
 ## Tools
 
@@ -47,67 +36,40 @@ any other MCP client with no changes.
 | `get_live` | matches in play right now |
 | `get_match` | a single match by id |
 | `get_standings` | group table(s) — one group `A`–`L`, or all |
-| `get_next_fixture` | a team's next match (3-letter code, e.g. `MEX`) |
-| `get_market_signal` | read-only prediction-market odds for a match, a team's next fixture, or a date — informational only |
-| `get_share_snippet` | a copy-pasteable match-card snippet for a match, a team's next fixture, a date, or live — plain text, ready to paste |
-
-All tools are **read-only** (annotated `readOnlyHint`) and accept optional
-`tz` (IANA timezone), `lang` (`en`/`es`/`pt`/`fr`), and `flavor`
-(`off`/`subtle`/`full`) arguments. Each response includes both human-readable
-text and structured JSON.
-
-`get_today` and `get_match` also include reliable prediction-market context when a
-market is available. Match→market event slugs are derived automatically, so no
-mapping is needed. Market data is **read-only and informational only — not betting
-advice** (market-implied percentages with attribution, never links or trade
-calls), sourced from Polymarket public data and shown only when a market maps
-cleanly to the result. Disable it with `CLAUDINHO_MARKETS=off`; set
-`CLAUDINHO_MARKETS_SOURCE=fake` (in the server `env`) for a network-free synthetic
-preview.
-
-`get_share_snippet` returns a polished, **copy-pasteable** match card (the same
-artifact as the CLI's `claudinho share`) for a match, a team's next fixture, a
-date, or live matches — plain text, no links, with the non-affiliation disclaimer
-baked in. Hand the returned `snippet` to the user as-is. `style` picks `social`
-(default) or `compact`; market lines (when reliable) stay **informational only**.
-
-## Resources & prompts
-
-- Resources: `standings://{group}` (e.g. `standings://A`), `fixtures://{date}` (UTC date, e.g. `fixtures://2026-06-11`)
-- Prompts: `tournament_today`, `my_team`
+| `get_next_fixture` | a team's next match (3-letter code, e.g. `MEX`) — fully offline |
+| `get_market_signal` | read-only prediction-market signal for a match, a team's next fixture, or a date — informational only |
+| `get_share_snippet` | a copy-pasteable plain-text match card — hand the returned snippet to the user as-is |
 
-## Commentary flair
+All tools are **read-only** (`readOnlyHint`) and accept optional `tz`, `lang`
+(`en`/`es`/`pt`/`fr`), and `flavor` (`off`/`subtle`/`full`). Every response carries
+human-readable text **and** structured JSON.
 
-By default the server adds a light, localized football-commentary voice: each
-match line in the text ends with a short genre-style exclamation (`— ¡GOOOOL!`),
-and the server instructions nudge the model to narrate scores with matching
-energy. The phrases are generic — no real commentator is quoted or impersonated —
-and they never touch the structured JSON, so the facts stay clean.
+Resources: `standings://{group}`, `fixtures://{date}`. Prompts: `tournament_today`,
+and `my_team` (give it a 3-letter team code; combines next fixture, standings, and
+the prediction-market read).
 
-Control it with `CLAUDINHO_FLAVOR` (`off` | `subtle` | `full`, default `full`),
-or per call via the `flavor` tool argument. In Claude Code, add it to the `env`
-block of your server entry:
+## Market signals
 
-```json
-{ "mcpServers": { "claudinho": {
-  "command": "npx", "args": ["-y", "@claudinho/mcp"],
-  "env": { "CLAUDINHO_FLAVOR": "subtle" }
-} } }
-```
+`get_today` / `get_match` include a short market line when a reliable market exists
+(slugs are auto-derived per fixture; matching fails closed). **Read-only and
+informational only — not betting advice:** market-implied percentages with Polymarket
+attribution, never links or trade calls. Disable with `CLAUDINHO_MARKETS=off`; set
+`CLAUDINHO_MARKETS_SOURCE=fake` in the server `env` for a network-free, clearly
+labeled synthetic preview.
 
-## Other competitions
+## Commentary flair
 
-By default the server follows the 2026 World Cup. Set the `CLAUDINHO_COMPETITION`
-env var (e.g. `fifa.friendly`) to point the live tools at another
-competition — useful for testing before the tournament. In Claude Code, add it
-to the `env` block of your MCP server entry.
+Match lines in the text end with a short, localized, genre-style exclamation
+(`— ¡GOOOOL!`) — generic energy, no real commentator quoted or impersonated, never
+in the structured JSON. Control with `CLAUDINHO_FLAVOR` (`off`|`subtle`|`full`,
+default `full`) in the server `env`, or per call via the `flavor` argument.
 
 ## How it works
 
-The fixture list ships bundled in the package; only live state hits the network —
-live scores from **ESPN's** public scoreboard (a swappable provider, attributed
-in the `source` field and text) and market odds from Polymarket. The server writes
-nothing to stdout except the MCP protocol; diagnostics go to stderr.
+All 104 fixtures ship bundled in the package; only live state hits the network —
+live scores from **ESPN's** public scoreboard (swappable provider, attributed in
+output), market signals from Polymarket. Stdout carries only the MCP protocol;
+diagnostics go to stderr.
 
 ## License
 

package/dist/index.js

@@ -3845,7 +3845,7 @@ async function toolGetShareSnippet(args) {
 
 // src/server.ts
 var SERVER_NAME = "claudinho";
-var SERVER_VERSION = "0.4.0";
+var SERVER_VERSION = "0.4.2";
 var VOICE = asFlavorLevel(process.env.CLAUDINHO_FLAVOR) === "off" ? "" : `
 Voice: when relaying scores, narrate with lively, regionally-appropriate football-commentary energy in the user's language. Each match line may end with a short exclamation ("\u2014 \xA1GOOOOL!") \u2014 use it as a tone cue. Keep every fact exact; never invent details and never impersonate or name a real commentator.`;
 var INSTRUCTIONS = `Claudinho serves live scores, fixtures, and group standings for the 2026 men's football tournament.
@@ -4023,7 +4023,7 @@ function buildServer() {
     "my_team",
     {
       title: "My team",
-      description: "Focus on one team's next match and group situation.",
+      description: "Focus on one team's next match, group situation, and the prediction-market read.",
       argsSchema: { team: teamArg.describe("3-letter team code, e.g. MEX") }
     },
     ({ team }) => ({
@@ -4032,7 +4032,7 @@ function buildServer() {
           role: "user",
           content: {
             type: "text",
-            text: `Using get_next_fixture and get_standings, tell me about ${team}'s next match in the 2026 tournament and their current group standing.`
+            text: `Using get_next_fixture, get_standings, and get_market_signal, tell me about ${team}'s next match in the 2026 tournament, their current group standing, and what prediction markets currently say about that match. Treat the market percentages as informational context only \u2014 relay them factually, never as betting or trading advice.`
           }
         }
       ]

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@claudinho/mcp",
-  "version": "0.4.0",
-  "description": "Claudinho MCP server — ask your agent about the 2026 men's football tournament: live scores, fixtures, standings, prediction-market odds. Not affiliated with FIFA or Anthropic.",
+  "version": "0.4.2",
+  "mcpName": "io.github.arturogarrido/claudinho",
+  "description": "MCP server for the 2026 men's football tournament — live scores, fixtures, standings, read-only prediction-market signals, and paste-ready match cards. Works with Claude Code, Cursor, Codex, Windsurf, Zed. Not affiliated with FIFA or Anthropic.",
   "type": "module",
   "license": "MIT",
   "author": "Arturo Garrido",
@@ -30,12 +31,18 @@
   ],
   "keywords": [
     "mcp",
+    "mcp-server",
     "model-context-protocol",
+    "claude-code",
+    "cursor",
+    "world-cup",
+    "world-cup-2026",
     "football",
     "soccer",
-    "world-cup",
-    "2026",
     "live-scores",
+    "fixtures",
+    "standings",
+    "2026",
     "vibinglavidaloca"
   ],
   "dependencies": {
@@ -47,7 +54,7 @@
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",
     "vitest": "^4.1.0",
-    "@claudinho/core": "0.4.0"
+    "@claudinho/core": "0.4.2"
   },
   "scripts": {
     "build": "tsup",