@claudinho/mcp 0.8.14 → 0.8.16

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(
@@ -4534,8 +4539,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 +5119,7 @@ async function toolGetShareSnippet(args) {
 
 // src/server.ts
 var SERVER_NAME = "claudinho";
-var SERVER_VERSION = "0.8.14";
+var SERVER_VERSION = "0.8.16";
 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 +5136,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 +5231,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 +5242,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 +5253,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 +5267,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 +5281,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 +5293,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 +5312,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 +5337,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.14",
+  "version": "0.8.16",
   "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.14"
+    "@claudinho/core": "0.8.16"
   },
   "scripts": {
     "build": "tsup",
+    "build:mcpb": "pnpm run build && node scripts/build-mcpb.mjs",
     "dev": "tsup --watch",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",