@claudinho/mcp 0.8.16 → 0.8.18

package/README.md

@@ -51,9 +51,11 @@ Then just ask your agent naturally — it picks the right tool and answers with
 | `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 |
+| `get_team` | resolve a nation name or code to its FIFA 3-letter code, flag, and group — fuzzy (`Mexico`, `mex`, `DR Congo`, `Türkiye`); call it first to turn a user's team name into the code the other tools need. Offline (no network) |
 
-All tools are **read-only** (`readOnlyHint`) and accept optional `tz`, `lang`
-(`en`/`es`/`pt`/`fr`), and `flavor` (`off`/`subtle`/`full`). Every response carries
+Most tools are **read-only** (`readOnlyHint`) and accept optional `tz`, `lang`
+(`en`/`es`/`pt`/`fr`), and `flavor` (`off`/`subtle`/`full`); `get_team` is read-only
+**and** offline. Every response carries
 human-readable text **and** structured content, validated against each tool's
 declared `outputSchema`.
 

package/dist/index.js

@@ -2802,6 +2802,60 @@ function groups(fixtures = SCHEDULE) {
   for (const m of fixtures) if (m.group) set.add(m.group);
   return [...set].sort();
 }
+function norm2(s) {
+  return s.toLowerCase().normalize("NFD").replace(/[̀-ͯ]/g, "").replace(/[^a-z]/g, "");
+}
+function allTeams(fixtures = allFixtures()) {
+  const seen = /* @__PURE__ */ new Map();
+  for (const m of fixtures) {
+    if (m.stage !== "GROUP") continue;
+    for (const t2 of [m.home, m.away]) {
+      if (!/^[A-Z]{3}$/.test(t2.code) || t2.flag === "\u{1F3F3}\uFE0F") continue;
+      if (!seen.has(t2.code)) seen.set(t2.code, { ...t2, group: m.group ?? void 0 });
+    }
+  }
+  return [...seen.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+var TEAM_ALIASES = {
+  turkey: "TUR",
+  holland: "NED",
+  korea: "KOR",
+  skorea: "KOR",
+  korearepublic: "KOR",
+  republicofkorea: "KOR",
+  czechrepublic: "CZE",
+  congo: "COD",
+  drcongo: "COD",
+  drc: "COD",
+  democraticrepublicofcongo: "COD",
+  democraticrepublicofthecongo: "COD",
+  cotedivoire: "CIV",
+  caboverde: "CPV",
+  bosnia: "BIH",
+  bosniaandherzegovina: "BIH",
+  us: "USA",
+  america: "USA",
+  unitedstatesofamerica: "USA"
+};
+function lookupTeam(query, fixtures = allFixtures()) {
+  const roster = allTeams(fixtures);
+  const q = norm2(query);
+  if (!q) return { query, team: null, matches: [] };
+  const byCode = roster.find((t2) => norm2(t2.code) === q);
+  if (byCode) return { query, team: byCode, matches: [byCode] };
+  const byName = roster.find((t2) => norm2(t2.name) === q);
+  if (byName) return { query, team: byName, matches: [byName] };
+  const aliasCode = TEAM_ALIASES[q];
+  if (aliasCode) {
+    const t2 = roster.find((r) => r.code === aliasCode);
+    if (t2) return { query, team: t2, matches: [t2] };
+  }
+  if (q.length < 3) return { query, team: null, matches: [] };
+  const prefix = roster.filter((t2) => norm2(t2.name).startsWith(q));
+  const substr = roster.filter((t2) => norm2(t2.name).includes(q) && !prefix.includes(t2));
+  const matches = [...prefix, ...substr];
+  return { query, team: matches.length === 1 ? matches[0] : null, matches };
+}
 function blankRow(team) {
   return {
     team,
@@ -4129,7 +4183,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();
@@ -4137,7 +4192,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);
     }
@@ -4149,13 +4204,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 };
       }
@@ -4235,6 +4293,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();
@@ -4242,10 +4321,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() ?? "";
@@ -4254,10 +4341,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);
 }
@@ -4851,6 +4938,19 @@ ${matchLine(fixture, opts)}`, source, args.lang),
     data: { team: code, fixture, degraded }
   };
 }
+function toolGetTeam(args) {
+  const { team, matches } = lookupTeam(args.query ?? "");
+  const data = { query: args.query ?? "", team: team ?? null, matches, count: matches.length };
+  let text;
+  if (team) {
+    text = `${team.code} \u2014 ${team.flag} ${team.name}${team.group ? ` \xB7 Group ${team.group}` : ""}`;
+  } else if (matches.length > 0) {
+    text = `"${args.query}" is ambiguous. Did you mean: ${matches.map((t2) => `${t2.name} (${t2.code})`).join(", ")}?`;
+  } else {
+    text = `No team found for "${args.query}". Use a nation name or 3-letter code (e.g. Mexico, MEX).`;
+  }
+  return { text: withDisclaimer(text), data };
+}
 async function toolGetMarketSignal(args) {
   const provider = resolveMarketProvider(args);
   const now = args.now ?? /* @__PURE__ */ new Date();
@@ -5119,11 +5219,12 @@ async function toolGetShareSnippet(args) {
 
 // src/server.ts
 var SERVER_NAME = "claudinho";
-var SERVER_VERSION = "0.8.16";
+var SERVER_VERSION = "0.8.18";
 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), get_standings for group tables, and get_bracket for the knockout tree.
+The team-taking tools (get_next_fixture, get_market_signal, get_share_snippet) expect a 3-letter code (e.g. MEX). When the user gives a nation NAME, call get_team FIRST to resolve it \u2014 get_team is fuzzy ("Mexico", "DR Congo", "T\xFCrkiye"), offline, and returns candidates when the name is ambiguous.
+Use get_live during matches, get_today for a day's schedule, get_next_fixture for a specific team, get_standings for group tables, and get_bracket for the knockout tree.
 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}`;
@@ -5207,6 +5308,13 @@ var shareOut = {
   matches: z.array(matchOut).optional(),
   marketSignals: z.record(anyObj).optional()
 };
+var teamInfo = z.object({ code: z.string(), name: z.string(), flag: z.string(), group: z.string() }).partial().passthrough();
+var teamOut = {
+  query: z.string(),
+  team: teamInfo.nullable(),
+  matches: z.array(teamInfo),
+  count: z.number()
+};
 function toContent(r) {
   return {
     content: [
@@ -5342,6 +5450,20 @@ function buildServer() {
     },
     async (args) => toContent(await toolGetShareSnippet(args))
   );
+  server.registerTool(
+    "get_team",
+    {
+      title: "Resolve a team",
+      description: `Resolve a nation name or 3-letter code to its FIFA code, flag, and group. Fuzzy and forgiving: accepts "Mexico", "mex", "USA", "DR Congo", "T\xFCrkiye"/"Turkey", "Holland", etc. Use this FIRST to turn a user's team name into the code the other tools need (get_next_fixture, get_standings, get_market_signal, get_share_snippet). Returns the single confident match (team), plus candidates (matches) when the query is ambiguous (e.g. "south" \u2192 South Africa, South Korea). Offline \u2014 reads the bundled roster, never the network.`,
+      inputSchema: {
+        query: z.string().describe('Team name or 3-letter code, e.g. "Mexico", "MEX", "DR Congo"')
+      },
+      // Read-only AND offline — resolves against the bundled roster, no provider call.
+      annotations: { readOnlyHint: true, openWorldHint: false },
+      outputSchema: teamOut
+    },
+    async (args) => toContent(toolGetTeam(args))
+  );
   server.registerResource(
     "standings",
     new ResourceTemplate("standings://{group}", { list: void 0 }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudinho/mcp",
-  "version": "0.8.16",
+  "version": "0.8.18",
   "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.16"
+    "@claudinho/core": "0.8.18"
   },
   "scripts": {
     "build": "tsup",