@claudinho/mcp 0.4.2 → 0.5.0

package/README.md

@@ -35,10 +35,10 @@ Developer → Edit Config, then restart. Codex config file: `~/.codex/config.tom
 | `get_today` | fixtures for a date (default: today), grouped in the caller's `tz`, live scores overlaid |
 | `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_standings` | live cumulative group table(s) — one group `A`–`L`, or all |
 | `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 |
+| `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`), a date, or live — hand the returned snippet to the user as-is |
 
 All tools are **read-only** (`readOnlyHint`) and accept optional `tz`, `lang`
 (`en`/`es`/`pt`/`fr`), and `flavor` (`off`/`subtle`/`full`). Every response carries
@@ -50,6 +50,7 @@ the prediction-market read).
 
 ## Market signals
 
+Market signals are pre-match and in-play reads — finished matches never show one.
 `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

package/dist/index.js

@@ -2614,6 +2614,7 @@ function nextFixtureForTeam(code, opts = {}) {
     (m) => new Date(m.kickoff).getTime() >= from.getTime()
   );
 }
+var LIVE_WINDOW_MS = 140 * 6e4;
 function groups(fixtures = SCHEDULE) {
   const set = /* @__PURE__ */ new Set();
   for (const m of fixtures) if (m.group) set.add(m.group);
@@ -2759,6 +2760,43 @@ function mapEspnEvent(ev, ctx = {}) {
 function toEspnDate(d) {
   return d.replace(/\D/g, "").slice(0, 8);
 }
+function statVal(stats, name) {
+  const v = stats?.find((s) => s.name === name)?.value;
+  return typeof v === "number" && Number.isFinite(v) ? Math.round(v) : 0;
+}
+function entryToRow(e) {
+  return {
+    team: toTeam(e.team),
+    played: statVal(e.stats, "gamesPlayed"),
+    won: statVal(e.stats, "wins"),
+    drawn: statVal(e.stats, "ties"),
+    lost: statVal(e.stats, "losses"),
+    goalsFor: statVal(e.stats, "pointsFor"),
+    goalsAgainst: statVal(e.stats, "pointsAgainst"),
+    goalDiff: statVal(e.stats, "pointDifferential"),
+    points: statVal(e.stats, "points")
+  };
+}
+function parseStandings(data) {
+  const out = [];
+  for (const child of data.children ?? []) {
+    const letter = (child.name ?? child.abbreviation ?? "").match(/Group\s+([A-L])/i)?.[1]?.toUpperCase();
+    if (!letter) continue;
+    const ranked = (child.standings?.entries ?? []).map((e) => ({
+      row: entryToRow(e),
+      rank: statVal(e.stats, "rank")
+    }));
+    ranked.sort((a, b) => {
+      if (a.rank && b.rank && a.rank !== b.rank) return a.rank - b.rank;
+      const r = a.row;
+      const s = b.row;
+      return s.points - r.points || s.goalDiff - r.goalDiff || s.goalsFor - r.goalsFor || r.team.code.localeCompare(s.team.code);
+    });
+    out.push({ group: letter, rows: ranked.map((x) => x.row) });
+  }
+  out.sort((a, b) => a.group.localeCompare(b.group));
+  return out;
+}
 var EspnAdapter = class {
   constructor(opts = {}) {
     this.opts = opts;
@@ -2778,25 +2816,30 @@ var EspnAdapter = class {
     const today = await this.fetchScoreboard();
     return today.filter((m) => m.status === "LIVE" || m.status === "HT");
   }
+  /** Standings endpoint URL (lives under apis/v2, not site/v2; derived from base). */
+  standingsUrl() {
+    const base = this.opts.baseUrl ?? DEFAULT_BASE;
+    return `${base.replace("/apis/site/v2/", "/apis/v2/")}/standings`;
+  }
+  /**
+   * Authoritative, cumulative group tables from the standings endpoint. Throws
+   * on fetch/parse failure (the caller decides the fallback). Group-stage only:
+   * non-group `children` are filtered out by {@link parseStandings}.
+   */
+  async fetchStandings() {
+    return parseStandings(await this.get(this.standingsUrl()));
+  }
   /**
    * Build (and cache) a team-code -> group-letter map from the standings
-   * endpoint. Best-effort: returns {} if standings are unavailable.
+   * endpoint. Best-effort: returns {} if standings are unavailable. Reuses the
+   * same parse as {@link fetchStandings}, so the two never drift.
    */
   async fetchGroupMap(force = false) {
     if (this.groupMap && !force) return this.groupMap;
-    const base = this.opts.baseUrl ?? DEFAULT_BASE;
-    const standingsUrl = `${base.replace("/apis/site/v2/", "/apis/v2/")}/standings`;
     const map = {};
     try {
-      const data = await this.get(standingsUrl);
-      for (const child of data.children ?? []) {
-        const letter = (child.name ?? child.abbreviation ?? "").match(/Group\s+([A-L])/i)?.[1]?.toUpperCase();
-        if (!letter) continue;
-        for (const e of child.standings?.entries ?? []) {
-          const code = e.team?.abbreviation?.toUpperCase();
-          if (code) map[code] = letter;
-        }
-      }
+      const tables = parseStandings(await this.get(this.standingsUrl()));
+      for (const t of tables) for (const r of t.rows) map[r.team.code] = t.group;
     } catch {
     }
     this.groupMap = map;
@@ -2867,10 +2910,53 @@ async function getMatchesForDate(adapter, dateISO) {
     return { matches: base, degraded: true };
   }
 }
+async function getStandings(adapter, group) {
+  const want = group?.toUpperCase();
+  if (adapter.fetchStandings) {
+    try {
+      const all = await adapter.fetchStandings();
+      const tables2 = (want ? all.filter((t) => t.group === want) : all).sort(
+        (a, b) => a.group.localeCompare(b.group)
+      );
+      return { tables: tables2, degraded: false, source: adapter.name };
+    } catch {
+    }
+  }
+  const letters = want ? [want] : groups();
+  const tables = letters.map((g) => ({ group: g, rows: computeStandings(fixturesByGroup(g)) })).filter((t) => t.rows.length > 0);
+  return { tables, degraded: true };
+}
 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) => {
+    const k = Date.parse(m.kickoff);
+    return nowMs >= k && nowMs <= k + LIVE_WINDOW_MS + EXTRA_TIME_SLACK_MS;
+  });
+  if (candidate) {
+    const r = await getMatchById(adapter, candidate.id);
+    const m = r.match ?? candidate;
+    if (!isFinished(m.status)) return { ...r, match: m };
+  }
+  const next = nextFixtureForTeam(code, { from: now });
+  return { match: next, degraded: false };
+}
+async function getMatchById(adapter, id) {
+  const base = allFixtures().find((m) => m.id === id);
+  if (!base) return { match: void 0, degraded: false };
+  const day = base.kickoff.slice(0, 10);
+  try {
+    const live = adapter.fetchWindow ? await adapter.fetchWindow(shiftUtcDate(day, -1), shiftUtcDate(day, 1)) : await adapter.fetchByDate(day);
+    const hit = live.find((m) => m.id === id);
+    return { match: hit ?? base, degraded: false, source: hit ? adapter.name : void 0 };
+  } catch {
+    return { match: base, degraded: true };
+  }
+}
 async function getLiveMatches(adapter) {
   try {
     return { matches: await adapter.fetchLive(), degraded: false, source: adapter.name };
@@ -2879,6 +2965,12 @@ async function getLiveMatches(adapter) {
   }
 }
 var DEFAULT_MAX_AGE_MS = 15 * 6e4;
+function marketRelevant(match, now = /* @__PURE__ */ new Date()) {
+  if (isLive(match.status)) return true;
+  if (isFinished(match.status)) return false;
+  const k = Date.parse(match.kickoff);
+  return !Number.isFinite(k) || now.getTime() <= k + LIVE_WINDOW_MS;
+}
 function normalizeOutcomes(outcomes) {
   const sum = outcomes.reduce(
     (s, o) => s + (Number.isFinite(o.probability) && o.probability > 0 ? o.probability : 0),
@@ -3373,11 +3465,50 @@ function formatShareSnippet(input, options = {}) {
       blocks.push(card.join("\n"));
     }
   }
+  blocks.push(
+    shareFooter({
+      source: input.source,
+      installLine: input.installLine,
+      includeHashtag,
+      includeInstall
+    })
+  );
+  return blocks.join("\n\n");
+}
+function shareFooter(opts) {
   const footer = [];
-  if (input.source) footer.push(`Live data: ${liveSourceLabel(input.source)}`);
-  footer.push([includeHashtag ? SHARE_HASHTAG : "", SHARE_DISCLAIMER].filter(Boolean).join(" \xB7 "));
-  if (includeInstall && input.installLine) footer.push(`Try it: ${input.installLine}`);
-  blocks.push(footer.join("\n"));
+  if (opts.source) footer.push(`Live data: ${liveSourceLabel(opts.source)}`);
+  footer.push(
+    [opts.includeHashtag ? SHARE_HASHTAG : "", SHARE_DISCLAIMER].filter(Boolean).join(" \xB7 ")
+  );
+  if (opts.includeInstall && opts.installLine) footer.push(`Try it: ${opts.installLine}`);
+  return footer.join("\n");
+}
+function gd(n) {
+  return n > 0 ? `+${n}` : `${n}`;
+}
+function tableRow(r, rank) {
+  return `${rank}. ${r.team.flag} ${r.team.code}  ${r.points} pts \xB7 ${r.won}-${r.drawn}-${r.lost} \xB7 ${gd(r.goalDiff)}`;
+}
+function formatShareTable(input, options = {}) {
+  const includeHashtag = options.includeHashtag !== false;
+  const includeInstall = options.includeInstallLine !== false;
+  const blocks = [];
+  if (input.tables.length === 0) {
+    blocks.push(input.emptyNote ?? "No standings available.");
+  } else {
+    for (const { group, rows } of input.tables) {
+      blocks.push(
+        [`Group ${group} \xB7 standings`, "", ...rows.map((r, i) => tableRow(r, i + 1))].join("\n")
+      );
+    }
+    if (input.degraded) {
+      blocks.push("(Live standings unavailable \u2014 group roster, not live results.)");
+    }
+  }
+  blocks.push(
+    shareFooter({ source: input.source, installLine: input.installLine, includeHashtag, includeInstall })
+  );
   return blocks.join("\n\n");
 }
 
@@ -3434,8 +3565,8 @@ function standingsTable(group, rows) {
   const cols = "Team                     P  W  D  L   GD  Pts";
   const lines = rows.map((r) => {
     const name = `${r.team.flag} ${r.team.name}`.padEnd(24).slice(0, 24);
-    const gd = (r.goalDiff > 0 ? `+${r.goalDiff}` : `${r.goalDiff}`).padStart(3);
-    return `${name} ${pad(r.played)} ${pad(r.won)} ${pad(r.drawn)} ${pad(r.lost)} ${gd}  ${pad(r.points)}`;
+    const gd2 = (r.goalDiff > 0 ? `+${r.goalDiff}` : `${r.goalDiff}`).padStart(3);
+    return `${name} ${pad(r.played)} ${pad(r.won)} ${pad(r.drawn)} ${pad(r.lost)} ${gd2}  ${pad(r.points)}`;
   });
   return [header, cols, ...lines].join("\n");
 }
@@ -3454,13 +3585,19 @@ function resolveMarketProvider(args) {
 function marketDisplayable(sig) {
   return !sig.ambiguous && sig.favorite != null && hasSaneDistribution(sig.outcomes);
 }
-function marketHeader(m) {
-  return `${m.home.flag} ${m.home.name} vs ${m.away.name} ${m.away.flag}`;
+function marketHeader(m, args) {
+  const when = formatDate(m.kickoff, { tz: args.tz, locale: args.lang });
+  return `${m.home.flag} ${m.home.name} vs ${m.away.name} ${m.away.flag} (${when})`;
 }
-function marketText(m, sig) {
-  return `${marketHeader(m)}
+function marketText(m, sig, args) {
+  return `${marketHeader(m, args)}
 ${marketBlock(sig, m).join("\n")}`;
 }
+function noSignalText(m, args, now) {
+  if (marketRelevant(m, now)) return `No reliable market signal for ${marketHeader(m, args)}.`;
+  const verb = isFinished(m.status) ? "has finished" : "appears to have finished";
+  return `${marketHeader(m, args)} ${verb} \u2014 market signals are pre-match and in-play reads.`;
+}
 function marketData(sig) {
   return {
     matchId: sig.matchId,
@@ -3521,10 +3658,12 @@ async function cachedMarketSignals(args, matches) {
 }
 async function reliableMarketData(args, matches) {
   if (!marketsEnabled()) return void 0;
-  const signals = await cachedMarketSignals(args, matches);
-  const now = /* @__PURE__ */ new Date();
+  const now = args.now ?? /* @__PURE__ */ new Date();
+  const relevant = matches.filter((m) => marketRelevant(m, now));
+  if (relevant.length === 0) return void 0;
+  const signals = await cachedMarketSignals(args, relevant);
   const out = {};
-  for (const m of matches) {
+  for (const m of relevant) {
     const s = signals.get(m.id);
     if (s && isReliableMarketSignal(s, { now })) out[m.id] = marketData(s);
   }
@@ -3577,27 +3716,16 @@ ${matchList(matches, "No matches in play right now.", opts)}`;
   };
 }
 async function toolGetMatch(args) {
-  let match = allFixtures().find((m) => m.id === args.id);
-  let degraded = false;
-  let liveSource;
-  if (match) {
-    try {
-      const adapter = resolveAdapter(args);
-      const live = await adapter.fetchByDate(match.kickoff.slice(0, 10));
-      match = live.find((m) => m.id === args.id) ?? match;
-      liveSource = adapter.name;
-    } catch {
-      degraded = true;
-    }
-  }
+  const { match, degraded, source: liveSource } = await getMatchById(resolveAdapter(args), args.id);
   if (!match) {
     return { text: withDisclaimer(`No match found with id ${args.id}.`), data: { match: null } };
   }
   const opts = fmtOpts(args);
+  const now = args.now ?? /* @__PURE__ */ new Date();
   let marketSignal;
-  if (marketsEnabled()) {
+  if (marketsEnabled() && marketRelevant(match, now)) {
     const s = (await cachedMarketSignals(args, [match])).get(match.id);
-    if (s && isReliableMarketSignal(s, { now: /* @__PURE__ */ new Date() })) marketSignal = s;
+    if (s && isReliableMarketSignal(s, { now })) marketSignal = s;
   }
   const base = matchLine(match, opts);
   const text = marketSignal ? `${base}
@@ -3613,34 +3741,34 @@ ${marketBlock(marketSignal, match).join("\n")}` : base;
   };
 }
 async function toolGetStandings(args) {
-  const { matches, degraded, source } = await getMatchesForDate(
-    resolveAdapter(args),
-    localDate((/* @__PURE__ */ new Date()).toISOString(), args.tz)
-  );
-  const known = groups(matches);
-  if (args.group) {
-    const g = args.group.toUpperCase();
-    if (!known.includes(g)) {
-      return {
-        text: withDisclaimer(`No group "${g}". Groups are ${known.join(", ")}.`, source),
-        data: { degraded, source: source ?? null, tables: null }
-      };
-    }
+  const { tables, degraded, source } = await getStandings(resolveAdapter(args), args.group);
+  const shaped = tables.map((tb) => ({ group: tb.group, standings: tb.rows }));
+  if (shaped.length === 0) {
+    const g = args.group?.toUpperCase();
+    const msg = g ? `No group "${g}". Groups are A\u2013L.` : "No standings available.";
+    return {
+      text: withDisclaimer(degraded ? `${msg} (Live standings unavailable.)` : msg, source),
+      data: { degraded, source: source ?? null, tables: args.group ? null : [] }
+    };
   }
-  const wanted = args.group ? [args.group.toUpperCase()] : known;
-  const tables = wanted.map((g) => ({
-    group: g,
-    standings: computeStandings(fixturesByGroup(g, matches))
-  }));
-  const text = tables.map((t) => standingsTable(t.group, t.standings)).join("\n\n");
+  let text = shaped.map((t) => standingsTable(t.group, t.standings)).join("\n\n");
+  if (degraded) text += "\n\n(Live standings unavailable \u2014 showing the group roster.)";
   return {
-    text: withDisclaimer(text || `No group found.`, source),
-    data: { degraded, source: source ?? null, tables: args.group ? tables[0] ?? null : tables }
+    text: withDisclaimer(text, source),
+    data: { degraded, source: source ?? null, tables: args.group ? shaped[0] ?? null : shaped }
   };
 }
+async function standingsResourceText(group, adapter) {
+  const g = group.toUpperCase();
+  const { tables, degraded, source } = await getStandings(adapter, g);
+  const tb = tables[0];
+  let text = tb ? standingsTable(tb.group, tb.rows) : `No group ${g}.`;
+  if (degraded && tb) text += "\n\n(Live standings unavailable \u2014 showing the group roster.)";
+  return withDisclaimer(text, source);
+}
 async function toolGetNextFixture(args) {
   const code = args.team.toUpperCase();
-  const fixture = nextFixtureForTeam(code);
+  const fixture = nextFixtureForTeam(code, { from: args.now ?? /* @__PURE__ */ new Date() });
   if (!fixture) {
     return {
       text: withDisclaimer(`No upcoming fixture found for ${code}.`),
@@ -3656,11 +3784,13 @@ ${matchLine(fixture, opts)}`),
 }
 async function toolGetMarketSignal(args) {
   const provider = resolveMarketProvider(args);
+  const now = args.now ?? /* @__PURE__ */ new Date();
   if (args.matchId) {
-    const match = allFixtures().find((m) => m.id === args.matchId);
-    const sig = match ? await getMarketSignal(provider, match) : void 0;
+    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 text2 = !match ? `No match found with id ${args.matchId}.` : shown2 ? marketText(match, shown2) : `No reliable market signal for ${marketHeader(match)}.`;
+    const text2 = !match ? `No match found with id ${args.matchId}.` : shown2 ? marketText(match, shown2, args) : noSignalText(match, args, now);
     return {
       text: withDisclaimer(text2),
       data: {
@@ -3672,10 +3802,11 @@ async function toolGetMarketSignal(args) {
   }
   if (args.team) {
     const code = args.team.toUpperCase();
-    const fixture = nextFixtureForTeam(code);
-    const sig = fixture ? await getMarketSignal(provider, fixture) : void 0;
+    const { match: fixture } = 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) : `No reliable market signal for ${code}'s next fixture.`;
+    const text2 = !fixture ? `No upcoming fixture found for ${code}.` : shown2 ? marketText(fixture, shown2, args) : noSignalText(fixture, args, now);
     return {
       text: withDisclaimer(text2),
       data: {
@@ -3686,15 +3817,15 @@ async function toolGetMarketSignal(args) {
       }
     };
   }
-  const date = args.date ?? localDate((/* @__PURE__ */ new Date()).toISOString(), args.tz);
+  const date = args.date ?? localDate(now.toISOString(), args.tz);
   const { matches } = await getMatchesForDate(resolveAdapter(args), date);
-  const todays = fixturesByDate(date, matches, args.tz);
+  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)
   );
   const text = shown.length ? `Market signals on ${date}:
-${shown.map(({ match, signal }) => marketText(match, signal)).join("\n\n")}` : `No reliable market signals on ${date}.`;
+${shown.map(({ match, signal }) => marketText(match, signal, args)).join("\n\n")}` : `No reliable market signals on ${date}.`;
   return {
     text: withDisclaimer(text),
     data: {
@@ -3706,10 +3837,12 @@ ${shown.map(({ match, signal }) => marketText(match, signal)).join("\n\n")}` : `
 }
 async function reliableSignalMap(args, matches) {
   if (!marketsEnabled()) return /* @__PURE__ */ new Map();
-  const signals = await cachedMarketSignals(args, matches);
-  const now = /* @__PURE__ */ new Date();
+  const now = args.now ?? /* @__PURE__ */ new Date();
+  const relevant = matches.filter((m) => marketRelevant(m, now));
+  if (relevant.length === 0) return /* @__PURE__ */ new Map();
+  const signals = await cachedMarketSignals(args, relevant);
   const out = /* @__PURE__ */ new Map();
-  for (const m of matches) {
+  for (const m of relevant) {
     const s = signals.get(m.id);
     if (s && isReliableMarketSignal(s, { now }) && marketDisplayable(s)) out.set(m.id, s);
   }
@@ -3770,18 +3903,37 @@ async function toolGetShareSnippet(args) {
       { ...options, includeMarkets: false }
     );
   }
-  if (args.matchId) {
-    let match = allFixtures().find((m) => m.id === args.matchId);
-    let source2;
-    if (match) {
-      try {
-        const adapter = resolveAdapter(args);
-        const live = await adapter.fetchByDate(match.kickoff.slice(0, 10));
-        match = live.find((m) => m.id === args.matchId) ?? match;
-        source2 = adapter.name;
-      } catch {
+  if (args.group) {
+    const group = args.group.toUpperCase();
+    const { tables, degraded, source: source2 } = await getStandings(resolveAdapter(args), group);
+    const snippet = formatShareTable(
+      {
+        tables,
+        // Degraded ⇒ static roster, no live provider: don't attribute one, and
+        // surface the not-live notice (the card gets pasted publicly).
+        source: degraded ? void 0 : source2,
+        installLine: `npx @claudinho/cli table ${group}`,
+        emptyNote: `No group ${group}.`,
+        degraded
+      },
+      options
+    );
+    return {
+      text: snippet,
+      data: {
+        kind: "table",
+        target: "table",
+        group,
+        source: degraded ? null : source2 ?? null,
+        degraded,
+        informationalOnly: true,
+        snippet,
+        tables: tables.map((tb) => ({ group: tb.group, standings: tb.rows }))
       }
-    }
+    };
+  }
+  if (args.matchId) {
+    const { match, source: source2 } = await getMatchById(resolveAdapter(args), args.matchId);
     const matches = match ? [match] : [];
     return shareResult(
       "match",
@@ -3802,7 +3954,7 @@ async function toolGetShareSnippet(args) {
   }
   if (args.team) {
     const code = args.team.toUpperCase();
-    const fixture = nextFixtureForTeam(code);
+    const fixture = nextFixtureForTeam(code, { from: args.now ?? /* @__PURE__ */ new Date() });
     const matches = fixture ? [fixture] : [];
     const teamName = fixture ? fixture.home.code === code ? fixture.home.name : fixture.away.name : code;
     return shareResult(
@@ -3845,12 +3997,12 @@ async function toolGetShareSnippet(args) {
 
 // src/server.ts
 var SERVER_NAME = "claudinho";
-var SERVER_VERSION = "0.4.2";
+var SERVER_VERSION = "0.5.0";
 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.
 Use get_live during matches, get_today for a day's schedule, get_next_fixture for a specific team (3-letter code, e.g. MEX), and get_standings for group tables.
-Use get_market_signal for read-only prediction-market odds (a match, a team's next fixture, or a date). Market data is informational only \u2014 relay the percentages factually and never frame it as betting or trading advice.
+Use get_market_signal for read-only prediction-market signals (a match, a team's current-or-next fixture, or a date). Market data is informational only \u2014 relay the percentages factually and never frame it as betting or trading advice.
 Use get_share_snippet to produce a ready-to-paste match card (for a match, a team's next fixture, a date, or live matches) \u2014 hand the user the returned snippet text verbatim.${VOICE}
 ${DISCLAIMER}`;
 var dateArg = z.string().refine(isValidDate, "must be a real calendar date in YYYY-MM-DD form");
@@ -3879,7 +4031,7 @@ function buildServer() {
     "get_today",
     {
       title: "Today's matches",
-      description: "Fixtures for a given date (default: today), with live scores overlaid.",
+      description: "All fixtures for a date (default: today), with live score and minute overlaid on any match in play. Use this for a whole day's card; for only in-play matches use get_live, for one team's match use get_next_fixture, for a single match's detail use get_match. Kickoffs render in tz; lang localizes text (en/es/pt/fr); flavor sets commentary tone.",
       inputSchema: {
         date: dateArg.optional().describe("Date as YYYY-MM-DD (default: today)"),
         ...commonArgs
@@ -3893,7 +4045,7 @@ function buildServer() {
     "get_live",
     {
       title: "Live matches",
-      description: "Matches currently in play, with score and minute.",
+      description: "Only matches in play right now \u2014 each with current score and minute (empty when nothing is live). Use during matches for in-play state; for a full day's schedule including upcoming and finished, use get_today. tz/lang/flavor affect formatting only.",
       inputSchema: { ...commonArgs },
       annotations: { readOnlyHint: true, openWorldHint: true }
     },
@@ -3903,7 +4055,7 @@ function buildServer() {
     "get_match",
     {
       title: "Match detail",
-      description: "A single match by its id, with live state if available.",
+      description: "One match by its id, with live score/minute overlaid when it's in play. Get the id from get_today or get_live; to find a team's match without an id, use get_next_fixture. tz/lang/flavor affect formatting.",
       inputSchema: { id: z.string().describe("Match id"), ...commonArgs },
       annotations: { readOnlyHint: true, openWorldHint: true }
     },
@@ -3913,7 +4065,7 @@ function buildServer() {
     "get_standings",
     {
       title: "Group standings",
-      description: "Group table(s). Pass a group letter A\u2013L, or omit for all groups.",
+      description: "Live cumulative group standings \u2014 pass a group letter A\u2013L, or omit for all 12. Returns ranked rows (team, played, W/D/L, goal difference, points). Use get_today for fixtures/scores and get_next_fixture for one team. Falls back to a roster at zero (flagged degraded) if live standings are unavailable.",
       inputSchema: {
         group: groupArg.optional().describe("Group letter A\u2013L (omit for all)"),
         ...commonArgs
@@ -3926,7 +4078,7 @@ function buildServer() {
     "get_next_fixture",
     {
       title: "Next fixture for a team",
-      description: "A team's next scheduled match. Use a 3-letter code, e.g. MEX, BRA, USA.",
+      description: "A team's next scheduled match. Use a 3-letter code, e.g. MEX, BRA, USA. Instant and offline \u2014 answered from the bundled schedule, no network.",
       inputSchema: { team: teamArg.describe("3-letter team code, e.g. MEX"), ...commonArgs },
       // Read-only and served entirely from the bundled static schedule.
       annotations: { readOnlyHint: true, openWorldHint: false }
@@ -3937,10 +4089,12 @@ function buildServer() {
     "get_market_signal",
     {
       title: "Prediction-market signal",
-      description: "Read-only prediction-market odds for a match (by id), a team's next fixture, or a date (default: today). Returns market-implied percentages with attribution. Informational only \u2014 relay the numbers factually; do not add betting, trading, or 'value' advice, and do not invent links.",
+      description: "Read-only prediction-market signals for a match (by id), a team's current-or-next fixture, or a date (default: today). Returns market-implied percentages with attribution. Shown only before and during a match \u2014 finished matches have no market read. Informational only \u2014 relay the numbers factually; do not add betting, trading, or 'value' advice, and do not invent links.",
       inputSchema: {
         matchId: z.string().optional().describe("Match id (most specific)"),
-        team: teamArg.optional().describe("3-letter team code for that team's next fixture, e.g. MEX"),
+        team: teamArg.optional().describe(
+          "3-letter team code, e.g. MEX \u2014 resolves to the team's in-play match when one is live, else their next fixture"
+        ),
         date: dateArg.optional().describe("Date as YYYY-MM-DD (default: today) for all that day's signals"),
         ...commonArgs
       },
@@ -3953,10 +4107,11 @@ function buildServer() {
     "get_share_snippet",
     {
       title: "Shareable match snippet",
-      description: "A polished, copy-pasteable match card (plain text) for a match (matchId), a team's next fixture (team), a date (default: today), or live matches (live: true). Returns the ready-to-paste snippet plus structured data \u2014 hand the snippet text to the user verbatim. No links; it carries a non-affiliation disclaimer, and any market line stays informational only.",
+      description: `A polished, copy-pasteable card (plain text) for a match (matchId), a team's next fixture (team), a group's standings table (group, e.g. "A"), a date (default: today), or live matches (live: true). Returns the ready-to-paste snippet plus structured data \u2014 hand the snippet text to the user verbatim. No links; it carries a non-affiliation disclaimer, and any market line stays informational only.`,
       inputSchema: {
         matchId: z.string().optional().describe("Match id (most specific)"),
         team: teamArg.optional().describe("3-letter team code for that team's next fixture, e.g. MEX"),
+        group: groupArg.optional().describe("Group letter A\u2013L for a standings card, e.g. A"),
         date: dateArg.optional().describe("Date as YYYY-MM-DD (default: today)"),
         live: z.boolean().optional().describe("Snapshot of matches in play right now"),
         style: z.enum(["social", "compact"]).optional().describe("social (default, full card) or compact (one line per match)"),
@@ -3975,13 +4130,12 @@ function buildServer() {
     new ResourceTemplate("standings://{group}", { list: void 0 }),
     {
       title: "Group standings",
-      description: "Static group table for a group letter A\u2013L.",
+      description: "Live group table for a group letter A\u2013L.",
       mimeType: "text/plain"
     },
     async (uri, variables) => {
-      const group = String(variables.group ?? "").toUpperCase();
-      const rows = computeStandings(fixturesByGroup(group));
-      const text = rows.length ? standingsTable(group, rows) : `No group ${group}.`;
+      const group = String(variables.group ?? "");
+      const text = await standingsResourceText(group, makeAdapter());
       return { contents: [{ uri: uri.href, mimeType: "text/plain", text }] };
     }
   );
@@ -4032,7 +4186,7 @@ function buildServer() {
           role: "user",
           content: {
             type: "text",
-            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.`
+            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. Always state each fixture's date so a market read is never mistaken for a different match. Treat the market percentages as informational context only \u2014 relay them factually, never as betting or trading advice.`
           }
         }
       ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudinho/mcp",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "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",
@@ -54,7 +54,7 @@
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",
     "vitest": "^4.1.0",
-    "@claudinho/core": "0.4.2"
+    "@claudinho/core": "0.5.0"
   },
   "scripts": {
     "build": "tsup",