@claudinho/mcp 0.3.0 → 0.4.1

package/README.md

@@ -49,6 +49,7 @@ any other MCP client with no changes.
 | `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`
@@ -64,6 +65,12 @@ 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`)

package/dist/index.js

@@ -315,6 +315,25 @@ function formatKickoff(iso, opts = {}) {
     timeZone: tz
   }).format(new Date(iso));
 }
+function formatDate(iso, opts = {}) {
+  const tz = resolveTz(opts.tz);
+  const locale = safeLocale(opts.locale);
+  return new Intl.DateTimeFormat(locale, {
+    month: "short",
+    day: "numeric",
+    timeZone: tz
+  }).format(new Date(iso));
+}
+function formatTime(iso, opts = {}) {
+  const tz = resolveTz(opts.tz);
+  const locale = safeLocale(opts.locale);
+  return new Intl.DateTimeFormat(locale, {
+    hour: "2-digit",
+    minute: "2-digit",
+    hour12: false,
+    timeZone: tz
+  }).format(new Date(iso));
+}
 function countdown(iso, from = /* @__PURE__ */ new Date()) {
   const ms = new Date(iso).getTime() - from.getTime();
   if (ms <= 0) return "now";
@@ -335,6 +354,9 @@ function localDate(iso, tz) {
     timeZone: zone
   }).format(new Date(iso));
 }
+function isLive(status) {
+  return status === "LIVE" || status === "HT";
+}
 function isFinished(status) {
   return status === "FT";
 }
@@ -2989,6 +3011,11 @@ function marketAttributionText(signal) {
   const src = `Source: ${marketSourceLabel(signal.source)}`;
   return time ? `${src} \xB7 updated ${time}` : src;
 }
+function marketLine(signal, match) {
+  return `Market: ${marketProbabilityText(signal, match)} \xB7 ${marketSourceLabel(
+    signal.source
+  )} \xB7 informational only`;
+}
 function marketBlock(signal, match) {
   const lines = [];
   if (signal.stale) lines.push("Market signal is stale; the reading may be out of date.");
@@ -3272,6 +3299,87 @@ async function getMarketSignals(provider, matches, options) {
     return { signals: /* @__PURE__ */ new Map(), checked: /* @__PURE__ */ new Set() };
   }
 }
+var SHARE_HASHTAG = "#VibingLaVidaLoca";
+var SHARE_DISCLAIMER = "Independent fan project \xB7 not affiliated with FIFA or Anthropic.";
+function mid(m) {
+  return isLive(m.status) || m.status === "FT" ? scoreline(m) : "vs";
+}
+function statusTail(m) {
+  switch (m.status) {
+    case "LIVE":
+      return m.minute ? `${m.minute}'` : "LIVE";
+    case "HT":
+      return "HT";
+    case "FT":
+      return "FT";
+    case "POSTPONED":
+      return "postponed";
+    case "CANCELLED":
+      return "cancelled";
+    default:
+      return "";
+  }
+}
+function compactLine(m, input, single) {
+  const home = `${m.home.flag} ${m.home.code}`;
+  const away = `${m.away.code} ${m.away.flag}`;
+  const opts = { tz: input.tz, locale: input.locale };
+  let tail;
+  if (m.status === "SCHEDULED") {
+    const time = formatTime(m.kickoff, opts);
+    tail = single ? `${formatDate(m.kickoff, opts)} ${time}` : time;
+  } else {
+    tail = statusTail(m);
+  }
+  return `${home} ${mid(m)} ${away}${tail ? ` \xB7 ${tail}` : ""}`;
+}
+function socialCard(m, input) {
+  const lines = [];
+  const head = `${m.home.flag} ${m.home.name} ${mid(m)} ${m.away.name} ${m.away.flag}`;
+  if (m.status === "SCHEDULED") {
+    lines.push(head);
+    const date = formatDate(m.kickoff, { tz: input.tz, locale: input.locale });
+    const time = formatTime(m.kickoff, { tz: input.tz, locale: input.locale });
+    const zone = input.tz ? ` ${input.tz}` : "";
+    lines.push(`${date} \xB7 ${time}${zone}`);
+  } else {
+    const tail = statusTail(m);
+    lines.push(tail ? `${head} \xB7 ${tail}` : head);
+  }
+  const loc = matchLocation(m);
+  if (loc) lines.push(loc);
+  return lines;
+}
+function formatShareSnippet(input, options = {}) {
+  const style = options.style ?? "social";
+  const includeMarkets = options.includeMarkets !== false;
+  const includeHashtag = options.includeHashtag !== false;
+  const includeInstall = options.includeInstallLine !== false;
+  const signals = input.marketSignals ?? /* @__PURE__ */ new Map();
+  const single = input.matches.length === 1;
+  const blocks = [input.title];
+  if (input.matches.length === 0) {
+    if (input.emptyNote) blocks.push(input.emptyNote);
+  } else if (style === "compact") {
+    blocks.push(input.matches.map((m) => compactLine(m, input, single)).join("\n"));
+  } else {
+    for (const m of input.matches) {
+      const card = socialCard(m, input);
+      const sig = includeMarkets ? signals.get(m.id) : void 0;
+      if (sig) {
+        if (single) card.push("", ...marketBlock(sig, m));
+        else card.push(marketLine(sig, m));
+      }
+      blocks.push(card.join("\n"));
+    }
+  }
+  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"));
+  return blocks.join("\n\n");
+}
 
 // src/format.ts
 var STATUS_LABEL = {
@@ -3596,15 +3704,154 @@ ${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 out = /* @__PURE__ */ new Map();
+  for (const m of matches) {
+    const s = signals.get(m.id);
+    if (s && isReliableMarketSignal(s, { now }) && marketDisplayable(s)) out.set(m.id, s);
+  }
+  return out;
+}
+function shareOptions(args) {
+  return {
+    style: args.style === "compact" ? "compact" : "social",
+    includeMarkets: marketsEnabled() && args.includeMarkets !== false,
+    includeHashtag: args.includeHashtag !== false,
+    includeInstallLine: args.includeInstallLine !== false
+  };
+}
+function shareResult(kind, target, team, input, options) {
+  const snippet = formatShareSnippet(input, options);
+  return {
+    // The snippet is self-contained: it carries its own non-affiliation
+    // disclaimer (and, for any market line, the "informational only" caveat +
+    // attribution), so it is deliberately NOT wrapped with withDisclaimer —
+    // that would duplicate the disclaimer inside a paste-ready artifact.
+    text: snippet,
+    data: {
+      kind,
+      target,
+      ...team ? { team } : {},
+      source: input.source ?? null,
+      informationalOnly: true,
+      style: options.style ?? "social",
+      snippet,
+      matches: input.matches,
+      marketSignals: Object.fromEntries(
+        [...input.marketSignals ?? /* @__PURE__ */ new Map()].map(([id, s]) => [
+          id,
+          marketData(s)
+        ])
+      )
+    }
+  };
+}
+async function toolGetShareSnippet(args) {
+  const options = shareOptions(args);
+  const signalsFor = (ms) => args.includeMarkets === false ? Promise.resolve(/* @__PURE__ */ new Map()) : reliableSignalMap(args, ms);
+  if (args.live) {
+    const { matches, source: source2 } = await getLiveMatches(resolveAdapter(args));
+    return shareResult(
+      "live",
+      "live",
+      void 0,
+      {
+        title: "Live match pulse",
+        matches,
+        source: source2,
+        emptyNote: "No matches in play right now.",
+        installLine: "npx @claudinho/cli live",
+        tz: args.tz,
+        locale: args.lang
+      },
+      { ...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 {
+      }
+    }
+    const matches = match ? [match] : [];
+    return shareResult(
+      "match",
+      args.matchId,
+      void 0,
+      {
+        title: "Match pulse",
+        matches,
+        marketSignals: await signalsFor(matches),
+        source: source2,
+        emptyNote: `No match found with id ${args.matchId}.`,
+        installLine: `npx @claudinho/cli match ${args.matchId}`,
+        tz: args.tz,
+        locale: args.lang
+      },
+      options
+    );
+  }
+  if (args.team) {
+    const code = args.team.toUpperCase();
+    const fixture = nextFixtureForTeam(code);
+    const matches = fixture ? [fixture] : [];
+    const teamName = fixture ? fixture.home.code === code ? fixture.home.name : fixture.away.name : code;
+    return shareResult(
+      "next",
+      "next",
+      code,
+      {
+        title: `Next up for ${teamName}`,
+        matches,
+        marketSignals: await signalsFor(matches),
+        emptyNote: `No upcoming fixture found for ${code}.`,
+        installLine: `npx @claudinho/cli next ${code}`,
+        tz: args.tz,
+        locale: args.lang
+      },
+      options
+    );
+  }
+  const date = args.date ?? localDate((/* @__PURE__ */ new Date()).toISOString(), args.tz);
+  const { matches: all, source } = await getMatchesForDate(resolveAdapter(args), date);
+  const todays = fixturesByDate(date, all, args.tz);
+  const human = formatDate(`${date}T12:00:00.000Z`, { tz: args.tz, locale: args.lang });
+  return shareResult(
+    "today",
+    date,
+    void 0,
+    {
+      title: args.date ? `Matches \xB7 ${human}` : `Today's matches \xB7 ${human}`,
+      matches: todays,
+      marketSignals: await signalsFor(todays),
+      source,
+      emptyNote: `No matches scheduled for ${human}.`,
+      installLine: "npx @claudinho/cli today",
+      tz: args.tz,
+      locale: args.lang
+    },
+    options
+  );
+}
 
 // src/server.ts
 var SERVER_NAME = "claudinho";
-var SERVER_VERSION = "0.3.0";
+var SERVER_VERSION = "0.4.1";
 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.${VOICE}
+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_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");
 var groupArg = z.string().regex(/^[A-La-l]$/, "a group letter A\u2013L");
@@ -3702,6 +3949,27 @@ function buildServer() {
     },
     async (args) => toContent(await toolGetMarketSignal(args))
   );
+  server.registerTool(
+    "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.",
+      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"),
+        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)"),
+        includeHashtag: z.boolean().optional().describe("Include the #VibingLaVidaLoca tag (default true)"),
+        includeInstallLine: z.boolean().optional().describe('Include the "Try it: \u2026" run cue (default true)'),
+        includeMarkets: z.boolean().optional().describe("Include the reliable market line when available (default true)"),
+        ...commonArgs
+      },
+      // Read-only; may reach the live/market data providers (live/today/match).
+      annotations: { readOnlyHint: true, openWorldHint: true }
+    },
+    async (args) => toContent(await toolGetShareSnippet(args))
+  );
   server.registerResource(
     "standings",
     new ResourceTemplate("standings://{group}", { list: void 0 }),
@@ -3755,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 }) => ({
@@ -3764,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,6 +1,6 @@
 {
   "name": "@claudinho/mcp",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "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.",
   "type": "module",
   "license": "MIT",
@@ -47,7 +47,7 @@
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",
     "vitest": "^4.1.0",
-    "@claudinho/core": "0.3.0"
+    "@claudinho/core": "0.4.1"
   },
   "scripts": {
     "build": "tsup",