@claudinho/mcp 0.8.15 → 0.8.17

package/README.md

@@ -54,7 +54,8 @@ Then just ask your agent naturally — it picks the right tool and answers with
 
 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.
+human-readable text **and** structured content, validated against each tool's
+declared `outputSchema`.
 
 Resources: `standings://{group}`, `fixtures://{date}`. Prompts: `tournament_today`,
 and `my_team` (give it a 3-letter team code; combines next fixture, standings, and

package/dist/index.js

@@ -3116,7 +3116,7 @@ function winnerLabel(ctx, stage, index) {
     n: String(index)
   });
 }
-function resolveSlot(ref, ctx, liveTeam) {
+function resolveSlot(ref, ctx, liveTeam, fixtureInMergedSet = false) {
   const liveParticipant = confirmedLiveParticipant(liveTeam);
   switch (ref.kind) {
     case "seed":
@@ -3138,23 +3138,27 @@ function resolveSlot(ref, ctx, liveTeam) {
       if (liveParticipant) return liveParticipant;
       return tbd(t(ctx.lang, "bracket.slot.third", { groups: ref.groups.join("/") }));
     case "winner": {
-      const node = ctx.nodesByKey.get(matchKey(ref.stage, ref.index));
-      const match = node ? ctx.matchesById.get(node.matchId) : void 0;
-      if (match) {
-        const winner = resolveWinner(match);
-        if (winner) return participant(winner, "confirmed");
-      }
       if (liveParticipant) return liveParticipant;
+      if (!fixtureInMergedSet) {
+        const node = ctx.nodesByKey.get(matchKey(ref.stage, ref.index));
+        const match = node ? ctx.matchesById.get(node.matchId) : void 0;
+        if (match) {
+          const winner = resolveWinner(match);
+          if (winner) return participant(winner, "confirmed");
+        }
+      }
       return tbd(winnerLabel(ctx, ref.stage, ref.index));
     }
     case "loser": {
-      const node = ctx.nodesByKey.get(matchKey(ref.stage, ref.index));
-      const match = node ? ctx.matchesById.get(node.matchId) : void 0;
-      if (match) {
-        const loser = resolveLoser(match);
-        if (loser) return participant(loser, "confirmed");
-      }
       if (liveParticipant) return liveParticipant;
+      if (!fixtureInMergedSet) {
+        const node = ctx.nodesByKey.get(matchKey(ref.stage, ref.index));
+        const match = node ? ctx.matchesById.get(node.matchId) : void 0;
+        if (match) {
+          const loser = resolveLoser(match);
+          if (loser) return participant(loser, "confirmed");
+        }
+      }
       return tbd(
         t(ctx.lang, "bracket.slot.loser", {
           stage: stageLabelI18n(ctx.lang, ref.stage),
@@ -3177,6 +3181,7 @@ function buildBracketView(topology, matches, tables, standingsDegraded, liveDegr
     if (want && stage !== want) continue;
     const nodes = topology.matches.filter((n) => n.stage === stage);
     const matchViews = nodes.map((node) => {
+      const fixtureInMergedSet = matchesById.has(node.matchId);
       const match = matchesById.get(node.matchId) ?? {
         id: node.matchId,
         stage: node.stage,
@@ -3192,8 +3197,8 @@ function buildBracketView(topology, matches, tables, standingsDegraded, liveDegr
         stage: node.stage,
         index: node.index,
         kickoff: match.kickoff,
-        home: resolveSlot(node.home, ctx, match.home),
-        away: resolveSlot(node.away, ctx, match.away),
+        home: resolveSlot(node.home, ctx, match.home, fixtureInMergedSet),
+        away: resolveSlot(node.away, ctx, match.away, fixtureInMergedSet),
         match
       };
     });
@@ -4035,8 +4040,8 @@ function marketProbabilityText(signal, match) {
 }
 function marketAttributionText(signal) {
   const time = utcHhmm(signal.asOf);
-  const src = `Source: ${marketSourceLabel(signal.source)}`;
-  return time ? `${src} \xB7 updated ${time}` : src;
+  const src2 = `Source: ${marketSourceLabel(signal.source)}`;
+  return time ? `${src2} \xB7 updated ${time}` : src2;
 }
 function marketLine(signal, match) {
   return `Market: ${marketProbabilityText(signal, match)} \xB7 ${marketSourceLabel(
@@ -4124,7 +4129,8 @@ var PolymarketProvider = class {
   opts;
   name = "polymarket";
   async findSignal(match, options) {
-    return (await this.resolveOne(match, options)).signal;
+    const deadline = options?.deadlineMs != null ? Date.now() + options.deadlineMs : Number.POSITIVE_INFINITY;
+    return (await this.resolveOne(match, options, deadline)).signal;
   }
   async findSignals(matches, options) {
     const signals = /* @__PURE__ */ new Map();
@@ -4132,7 +4138,7 @@ var PolymarketProvider = class {
     const deadline = options?.deadlineMs != null ? Date.now() + options.deadlineMs : Number.POSITIVE_INFINITY;
     for (const m of matches) {
       if (Date.now() >= deadline) break;
-      const r = await this.resolveOne(m, options);
+      const r = await this.resolveOne(m, options, deadline);
       if (r.checked) checked.add(m.id);
       if (r.signal) signals.set(m.id, r.signal);
     }
@@ -4144,13 +4150,16 @@ var PolymarketProvider = class {
    * provider/network error — so transient failures are retried, not
    * negative-cached.
    */
-  async resolveOne(match, options) {
+  async resolveOne(match, options, deadline = Number.POSITIVE_INFINITY) {
     const entry = (this.opts.mapping ?? BUNDLED_MAPPING)[match.id];
     const slugs = entry?.eventSlug ? [entry.eventSlug] : deriveEventSlugs(match);
     if (slugs.length === 0) return { checked: true };
+    const configured = options?.timeoutMs ?? this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
     try {
       for (const slug of slugs) {
-        const event = await this.fetchEvent(slug, options?.timeoutMs);
+        const remaining = deadline - Date.now();
+        if (remaining <= 0) return { checked: false };
+        const event = await this.fetchEvent(slug, Math.min(configured, remaining));
         const signal = event ? this.toSignal(match, slug, event, options) : void 0;
         if (signal) return { signal, checked: true };
       }
@@ -4230,6 +4239,27 @@ var PolymarketProvider = class {
     return signal.ambiguous ? void 0 : signal;
   }
 };
+var POLYMARKET_TOKEN = {
+  SUI: "che",
+  // Switzerland
+  NED: "nld",
+  // Netherlands
+  URU: "ury",
+  // Uruguay
+  POR: "prt",
+  // Portugal
+  CRO: "hrv",
+  // Croatia
+  COD: "cdr",
+  // DR Congo
+  CPV: "cvi"
+  // Cabo Verde
+};
+function pmTokens(code) {
+  const c = code.toLowerCase();
+  const alias = POLYMARKET_TOKEN[code.toUpperCase()];
+  return alias && alias !== c ? [alias, c] : [c];
+}
 function deriveEventSlugs(match) {
   const home = match.home.code.toLowerCase();
   const away = match.away.code.toLowerCase();
@@ -4237,10 +4267,18 @@ function deriveEventSlugs(match) {
   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)}`
-  ];
+  const dates = [utcDate, shiftUtcDate(utcDate, -1)];
+  const homeToks = pmTokens(match.home.code);
+  const awayToks = pmTokens(match.away.code);
+  const slugs = [];
+  for (const d of dates) {
+    for (const h of homeToks) {
+      for (const a of awayToks) {
+        slugs.push(`fifwc-${h}-${a}-${d}`);
+      }
+    }
+  }
+  return [...new Set(slugs)];
 }
 function slugToken(m) {
   return (m.slug ?? "").toLowerCase().split("-").pop() ?? "";
@@ -4249,10 +4287,10 @@ function isDrawMarket(m) {
   return slugToken(m) === "draw" || (m.groupItemTitle ?? "").trim().toLowerCase().startsWith("draw");
 }
 function pickMarket(markets, teamCode, teamName) {
-  const code = teamCode.toLowerCase();
+  const tokens = pmTokens(teamCode);
   const name = teamName.trim().toLowerCase();
   const teamMarkets = markets.filter((m) => !isDrawMarket(m));
-  const bySlug = teamMarkets.find((m) => slugToken(m) === code);
+  const bySlug = teamMarkets.find((m) => tokens.includes(slugToken(m)));
   if (bySlug) return bySlug;
   return teamMarkets.find((m) => (m.groupItemTitle ?? "").trim().toLowerCase() === name);
 }
@@ -4534,8 +4572,8 @@ function formatShareBracket(input, options = {}) {
     }
   }
   const footer = [];
-  const src = input.source ?? input.view.source;
-  if (src) footer.push(t(locale, "live.data", { source: liveSourceLabel(src) }));
+  const src2 = input.source ?? input.view.source;
+  if (src2) footer.push(t(locale, "live.data", { source: liveSourceLabel(src2) }));
   footer.push(
     [includeHashtag ? SHARE_HASHTAG : "", SHARE_DISCLAIMER].filter(Boolean).join(" \xB7 ")
   );
@@ -5114,7 +5152,7 @@ async function toolGetShareSnippet(args) {
 
 // src/server.ts
 var SERVER_NAME = "claudinho";
-var SERVER_VERSION = "0.8.15";
+var SERVER_VERSION = "0.8.17";
 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.
@@ -5131,12 +5169,84 @@ var commonArgs = {
   lang: z.string().optional().describe("Locale for formatting: en, es, pt, fr (other locales fall back to en)"),
   flavor: flavorArg.optional().describe("Commentary flair: off, subtle, full (default: full)")
 };
+var teamRef = z.object({ code: z.string(), name: z.string(), flag: z.string() }).partial().passthrough();
+var scorePair = z.object({ home: z.number(), away: z.number() }).partial().passthrough();
+var matchOut = z.object({
+  id: z.string(),
+  stage: z.string().optional(),
+  group: z.string().nullable().optional(),
+  kickoff: z.string().optional(),
+  venue: z.string().optional(),
+  home: teamRef.optional(),
+  away: teamRef.optional(),
+  score: scorePair.nullable().optional(),
+  shootout: scorePair.optional(),
+  status: z.string().optional(),
+  minute: z.number().nullable().optional(),
+  winnerCode: z.string().optional()
+}).passthrough();
+var anyObj = z.object({}).passthrough();
+var src = z.string().nullable();
+var todayOut = {
+  date: z.string(),
+  degraded: z.boolean(),
+  source: src,
+  count: z.number(),
+  matches: z.array(matchOut),
+  marketSignals: z.record(anyObj).optional()
+};
+var liveOut = { degraded: z.boolean(), source: src, count: z.number(), matches: z.array(matchOut) };
+var matchDetailOut = {
+  match: matchOut.nullable(),
+  degraded: z.boolean().optional(),
+  source: src.optional(),
+  marketSignal: anyObj.nullable().optional()
+};
+var standingsOut = {
+  degraded: z.boolean(),
+  source: src,
+  tables: z.union([anyObj, z.array(anyObj), z.null()])
+};
+var bracketOut = {
+  view: anyObj.nullable(),
+  degraded: z.boolean().optional(),
+  standingsDegraded: z.boolean().optional(),
+  source: src.optional()
+};
+var nextOut = { team: z.string(), fixture: matchOut.nullable(), degraded: z.boolean() };
+var marketOut = {
+  matchId: z.string().nullable().optional(),
+  team: z.string().optional(),
+  date: z.string().optional(),
+  degraded: z.boolean().optional(),
+  informationalOnly: z.boolean(),
+  signal: anyObj.nullable().optional(),
+  signals: z.array(anyObj).optional()
+};
+var shareOut = {
+  kind: z.string(),
+  target: z.string().optional(),
+  snippet: z.string().optional(),
+  // absent on the bracket "unknown stage" error branch
+  source: src.optional(),
+  informationalOnly: z.boolean().optional(),
+  degraded: z.boolean().optional(),
+  style: z.string().optional(),
+  team: z.string().optional(),
+  group: z.string().optional(),
+  stage: z.string().optional(),
+  tables: z.union([anyObj, z.array(anyObj), z.null()]).optional(),
+  view: anyObj.nullable().optional(),
+  matches: z.array(matchOut).optional(),
+  marketSignals: z.record(anyObj).optional()
+};
 function toContent(r) {
   return {
     content: [
       { type: "text", text: r.text },
       { type: "text", text: "```json\n" + JSON.stringify(r.data, null, 2) + "\n```" }
-    ]
+    ],
+    structuredContent: r.data
   };
 }
 function buildServer() {
@@ -5154,7 +5264,8 @@ function buildServer() {
         ...commonArgs
       },
       // Read-only; reaches an external data provider for the live overlay.
-      annotations: { readOnlyHint: true, openWorldHint: true }
+      annotations: { readOnlyHint: true, openWorldHint: true },
+      outputSchema: todayOut
     },
     async (args) => toContent(await toolGetToday(args))
   );
@@ -5164,7 +5275,8 @@ function buildServer() {
       title: "Live matches",
       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 }
+      annotations: { readOnlyHint: true, openWorldHint: true },
+      outputSchema: liveOut
     },
     async (args) => toContent(await toolGetLive(args))
   );
@@ -5174,7 +5286,8 @@ function buildServer() {
       title: "Match detail",
       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 }
+      annotations: { readOnlyHint: true, openWorldHint: true },
+      outputSchema: matchDetailOut
     },
     async (args) => toContent(await toolGetMatch(args))
   );
@@ -5187,7 +5300,8 @@ function buildServer() {
         group: groupArg.optional().describe("Group letter A\u2013L (omit for all)"),
         ...commonArgs
       },
-      annotations: { readOnlyHint: true, openWorldHint: true }
+      annotations: { readOnlyHint: true, openWorldHint: true },
+      outputSchema: standingsOut
     },
     async (args) => toContent(await toolGetStandings(args))
   );
@@ -5200,7 +5314,8 @@ function buildServer() {
         stage: z.enum(["R32", "R16", "QF", "SF", "3P", "F"]).optional().describe("Knockout round to show (omit for the full bracket)"),
         ...commonArgs
       },
-      annotations: { readOnlyHint: true, openWorldHint: true }
+      annotations: { readOnlyHint: true, openWorldHint: true },
+      outputSchema: bracketOut
     },
     async (args) => toContent(await toolGetBracket(args))
   );
@@ -5211,7 +5326,8 @@ function buildServer() {
       description: "A team's next match, live-resolved: a confirmed knockout tie (Round of 32 onward) is read from the live overlay, group fixtures from the bundled schedule. Use a 3-letter code, e.g. MEX, BRA, USA. Falls back to the bundled schedule if the provider is unreachable.",
       inputSchema: { team: teamArg.describe("3-letter team code, e.g. MEX"), ...commonArgs },
       // Read-only; overlays live provider data for knockout pairings, so open-world.
-      annotations: { readOnlyHint: true, openWorldHint: true }
+      annotations: { readOnlyHint: true, openWorldHint: true },
+      outputSchema: nextOut
     },
     async (args) => toContent(await toolGetNextFixture(args))
   );
@@ -5229,7 +5345,8 @@ function buildServer() {
         ...commonArgs
       },
       // Read-only; reaches an external prediction-market data provider.
-      annotations: { readOnlyHint: true, openWorldHint: true }
+      annotations: { readOnlyHint: true, openWorldHint: true },
+      outputSchema: marketOut
     },
     async (args) => toContent(await toolGetMarketSignal(args))
   );
@@ -5253,7 +5370,8 @@ function buildServer() {
         ...commonArgs
       },
       // Read-only; may reach the live/market data providers (live/today/match).
-      annotations: { readOnlyHint: true, openWorldHint: true }
+      annotations: { readOnlyHint: true, openWorldHint: true },
+      outputSchema: shareOut
     },
     async (args) => toContent(await toolGetShareSnippet(args))
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudinho/mcp",
-  "version": "0.8.15",
+  "version": "0.8.17",
   "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,10 +57,11 @@
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",
     "vitest": "^4.1.9",
-    "@claudinho/core": "0.8.15"
+    "@claudinho/core": "0.8.17"
   },
   "scripts": {
     "build": "tsup",
+    "build:mcpb": "pnpm run build && node scripts/build-mcpb.mjs",
     "dev": "tsup --watch",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",