@claudinho/mcp 0.8.11 → 0.8.12

package/README.md

@@ -3,10 +3,7 @@
 **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
-> emoji flags only — no logos, crests, kits, footage, or player likenesses.
+No API key, no signup — all 104 fixtures ship bundled; only live scores (and optional, read-only Polymarket signals) hit the network.
 
 ## Install
 
@@ -31,6 +28,11 @@ codex mcp add claudinho -- npx -y @claudinho/mcp
 Claude Desktop: Settings → Developer → Edit Config, then restart. Codex config file:
 `~/.codex/config.toml` (`[mcp_servers.claudinho]`, `command = "npx"`, `args = ["-y", "@claudinho/mcp"]`).
 
+Then just ask your agent naturally — it picks the right tool and answers with live data:
+
+> "What matches are on today?" · "Show me the live scores" · "What's Mexico's next game?"
+> "Group A standings" · "Show the knockout bracket" · "Make me a shareable card for today"
+
 ## Tools
 
 | Tool | What it does |
@@ -40,7 +42,7 @@ Claude Desktop: Settings → Developer → Edit Config, then restart. Codex conf
 | `get_match` | a single match by id |
 | `get_standings` | live cumulative group table(s) — one group `A`–`L`, or all |
 | `get_bracket` | knockout bracket from the Round of 32 through the final — optional `stage` filter (`R32`, `R16`, `QF`, `SF`, `3P`, `F`) |
-| `get_next_fixture` | a team's next match (3-letter code, e.g. `MEX`) — fully offline |
+| `get_next_fixture` | a team's next match (3-letter code, e.g. `MEX`) — live-resolves a confirmed knockout tie from the feed; group fixtures offline, fails back to the bundled schedule if the feed is down |
 | `get_market_signal` | read-only prediction-market signal for a match, a team's current-or-next fixture (in-play preferred while live), or a date — informational only |
 | `get_share_snippet` | a copy-pasteable plain-text card — for a match, a team's next fixture, a group's standings table (`group`), the knockout bracket (`bracket: true`, optional `knockoutStage`), a date, or live — hand the returned snippet to the user as-is |
 
@@ -80,6 +82,10 @@ diagnostics go to stderr.
 
 MIT © 2026 Arturo Garrido · [source & issues](https://github.com/arturogarrido/claudinho)
 
+> **Not affiliated with, endorsed by, or connected to FIFA or Anthropic.** An independent,
+> open-source fan project showing factual match data with emoji flags only — no logos, crests,
+> kits, broadcast footage, or player likenesses.
+
 ---
 
 _Built while watching the games._ **#VibingLaVidaLoca** ⚽

package/dist/index.js

@@ -500,6 +500,10 @@ function localDate(iso, tz) {
     timeZone: zone
   }).format(new Date(iso));
 }
+function shiftUtcDate(dateISO, days) {
+  const [y, m, d] = dateISO.slice(0, 10).split("-").map(Number);
+  return new Date(Date.UTC(y ?? 1970, (m ?? 1) - 1, (d ?? 1) + days)).toISOString().slice(0, 10);
+}
 function outcomeFromScore(home, away) {
   if (home > away) return "H";
   if (home < away) return "A";
@@ -3829,14 +3833,19 @@ async function getBracket(adapter, opts = {}) {
     source
   };
 }
-function shiftUtcDate(dateISO, days) {
-  const [y, m, d] = dateISO.slice(0, 10).split("-").map(Number);
-  return new Date(Date.UTC(y ?? 1970, (m ?? 1) - 1, (d ?? 1) + days)).toISOString().slice(0, 10);
-}
 var EXTRA_TIME_SLACK_MS = 60 * 6e4;
 async function marketFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Date()) {
   const nowMs = now.getTime();
-  const candidate = fixturesByTeam(code).find((m) => {
+  let fixtures = allFixtures();
+  let overlayFailed = false;
+  try {
+    if (adapter.fetchWindow) {
+      fixtures = mergeLive(fixtures, await adapter.fetchWindow(KNOCKOUT_WINDOW_START, KNOCKOUT_WINDOW_END));
+    }
+  } catch {
+    overlayFailed = true;
+  }
+  const candidate = fixturesByTeam(code, fixtures).find((m) => {
     const k = Date.parse(m.kickoff);
     return nowMs >= k && nowMs <= k + LIVE_WINDOW_MS + EXTRA_TIME_SLACK_MS;
   });
@@ -3845,8 +3854,8 @@ async function marketFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Dat
     const m = r.match ?? candidate;
     if (!isFinished(m.status)) return { ...r, match: m };
   }
-  const next = nextFixtureForTeam(code, { from: now });
-  return { match: next, degraded: false };
+  const next = nextFixtureForTeam(code, { from: now, fixtures });
+  return { match: next, degraded: overlayFailed };
 }
 async function getNextFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Date()) {
   const base = allFixtures();
@@ -3939,6 +3948,9 @@ function mapsCleanly(match, outcomes) {
   if (match.stage === "GROUP" && !draw) return false;
   return true;
 }
+function marketSignalRendersFor(match, signal) {
+  return signal.matchId === match.id && mapsCleanly(match, signal.outcomes);
+}
 function hasSaneDistribution(outcomes) {
   const priced = outcomes.filter((o) => Number.isFinite(o.probability) && o.probability > 0);
   if (priced.length < 2) return false;
@@ -4134,12 +4146,15 @@ var PolymarketProvider = class {
    */
   async resolveOne(match, options) {
     const entry = (this.opts.mapping ?? BUNDLED_MAPPING)[match.id];
-    const eventSlug = entry?.eventSlug ?? deriveEventSlug(match);
-    if (!eventSlug) return { checked: true };
+    const slugs = entry?.eventSlug ? [entry.eventSlug] : deriveEventSlugs(match);
+    if (slugs.length === 0) return { checked: true };
     try {
-      const event = await this.fetchEvent(eventSlug, options?.timeoutMs);
-      const signal = event ? this.toSignal(match, eventSlug, event, options) : void 0;
-      return { signal, checked: true };
+      for (const slug of slugs) {
+        const event = await this.fetchEvent(slug, options?.timeoutMs);
+        const signal = event ? this.toSignal(match, slug, event, options) : void 0;
+        if (signal) return { signal, checked: true };
+      }
+      return { checked: true };
     } catch {
       return { checked: false };
     }
@@ -4215,14 +4230,17 @@ var PolymarketProvider = class {
     return signal.ambiguous ? void 0 : signal;
   }
 };
-function deriveEventSlug(match) {
+function deriveEventSlugs(match) {
   const home = match.home.code.toLowerCase();
   const away = match.away.code.toLowerCase();
-  if (home === away || home === "tbd" || away === "tbd") return void 0;
-  if (!/^[a-z]{3}$/.test(home) || !/^[a-z]{3}$/.test(away)) return void 0;
-  const date = match.kickoff.slice(0, 10);
-  if (!/^\d{4}-\d{2}-\d{2}$/.test(date)) return void 0;
-  return `fifwc-${home}-${away}-${date}`;
+  if (home === away || home === "tbd" || away === "tbd") return [];
+  if (!/^[a-z]{3}$/.test(home) || !/^[a-z]{3}$/.test(away)) return [];
+  const utcDate = match.kickoff.slice(0, 10);
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(utcDate)) return [];
+  return [
+    `fifwc-${home}-${away}-${utcDate}`,
+    `fifwc-${home}-${away}-${shiftUtcDate(utcDate, -1)}`
+  ];
 }
 function slugToken(m) {
   return (m.slug ?? "").toLowerCase().split("-").pop() ?? "";
@@ -4587,8 +4605,8 @@ function resolveAdapter(args) {
 function resolveMarketProvider(args) {
   return args.marketProvider ?? makeMarketProvider();
 }
-function marketDisplayable(sig) {
-  return !sig.ambiguous && sig.favorite != null && hasSaneDistribution(sig.outcomes);
+function marketDisplayable(match, sig) {
+  return marketSignalRendersFor(match, sig) && !sig.ambiguous && sig.favorite != null && hasSaneDistribution(sig.outcomes);
 }
 function marketHeader(m, args) {
   const when = formatDate(m.kickoff, { tz: args.tz, locale: args.lang });
@@ -4670,7 +4688,9 @@ async function reliableMarketData(args, matches) {
   const out = {};
   for (const m of relevant) {
     const s = signals.get(m.id);
-    if (s && isReliableMarketSignal(s, { now })) out[m.id] = marketData(s);
+    if (s && isReliableMarketSignal(s, { now }) && marketSignalRendersFor(m, s)) {
+      out[m.id] = marketData(s);
+    }
   }
   return Object.keys(out).length > 0 ? out : void 0;
 }
@@ -4731,7 +4751,7 @@ async function toolGetMatch(args) {
   let marketSignal;
   if (marketsEnabled() && marketRelevant(match, now)) {
     const s = (await cachedMarketSignals(args, [match])).get(match.id);
-    if (s && isReliableMarketSignal(s, { now })) marketSignal = s;
+    if (s && isReliableMarketSignal(s, { now }) && marketSignalRendersFor(match, s)) marketSignal = s;
   }
   const base = matchLine(match, opts);
   let text = marketSignal ? `${base}
@@ -4833,7 +4853,7 @@ async function toolGetMarketSignal(args) {
     const { match } = await getMatchById(resolveAdapter(args), args.matchId);
     const relevant = match ? marketRelevant(match, now) : false;
     const sig = match && relevant ? await getMarketSignal(provider, match) : void 0;
-    const shown2 = match && sig && marketDisplayable(sig) ? sig : void 0;
+    const shown2 = match && sig && marketDisplayable(match, sig) ? sig : void 0;
     const text2 = !match ? `No match found with id ${args.matchId}.` : shown2 ? marketText(match, shown2, args) : noSignalText(match, args, now);
     return {
       text: withDisclaimer(text2),
@@ -4846,16 +4866,17 @@ async function toolGetMarketSignal(args) {
   }
   if (args.team) {
     const code = args.team.toUpperCase();
-    const { match: fixture } = await marketFixtureForTeam(resolveAdapter(args), code, now);
+    const { match: fixture, degraded } = await marketFixtureForTeam(resolveAdapter(args), code, now);
     const relevant = fixture ? marketRelevant(fixture, now) : false;
     const sig = fixture && relevant ? await getMarketSignal(provider, fixture) : void 0;
-    const shown2 = fixture && sig && marketDisplayable(sig) ? sig : void 0;
-    const text2 = !fixture ? `No upcoming fixture found for ${code}.` : shown2 ? marketText(fixture, shown2, args) : noSignalText(fixture, args, now);
+    const shown2 = fixture && sig && marketDisplayable(fixture, sig) ? sig : void 0;
+    const text2 = !fixture ? degraded ? `Live feed unavailable \u2014 can't resolve ${code}'s next fixture right now.` : `No upcoming fixture found for ${code}.` : shown2 ? marketText(fixture, shown2, args) : noSignalText(fixture, args, now);
     return {
       text: withDisclaimer(text2),
       data: {
         team: code,
         matchId: fixture?.id ?? null,
+        degraded,
         informationalOnly: true,
         signal: shown2 ? marketData(shown2) : null
       }
@@ -4866,7 +4887,7 @@ async function toolGetMarketSignal(args) {
   const todays = fixturesByDate(date, matches, args.tz).filter((m) => marketRelevant(m, now));
   const { signals } = await getMarketSignals(provider, todays, MARKETS_TOOL_OPTS);
   const shown = todays.map((m) => ({ match: m, signal: signals.get(m.id) })).filter(
-    (r) => !!r.signal && marketDisplayable(r.signal)
+    (r) => !!r.signal && marketDisplayable(r.match, r.signal)
   );
   const text = shown.length ? `Market signals on ${date}:
 ${shown.map(({ match, signal }) => marketText(match, signal, args)).join("\n\n")}` : `No reliable market signals on ${date}.`;
@@ -4888,7 +4909,7 @@ async function reliableSignalMap(args, matches) {
   const out = /* @__PURE__ */ new Map();
   for (const m of relevant) {
     const s = signals.get(m.id);
-    if (s && isReliableMarketSignal(s, { now }) && marketDisplayable(s)) out.set(m.id, s);
+    if (s && isReliableMarketSignal(s, { now }) && marketDisplayable(m, s)) out.set(m.id, s);
   }
   return out;
 }
@@ -5093,7 +5114,7 @@ async function toolGetShareSnippet(args) {
 
 // src/server.ts
 var SERVER_NAME = "claudinho";
-var SERVER_VERSION = "0.8.11";
+var SERVER_VERSION = "0.8.12";
 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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudinho/mcp",
-  "version": "0.8.11",
+  "version": "0.8.12",
   "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",
@@ -57,7 +57,7 @@
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",
     "vitest": "^4.1.9",
-    "@claudinho/core": "0.8.11"
+    "@claudinho/core": "0.8.12"
   },
   "scripts": {
     "build": "tsup",