@claudinho/mcp 0.8.17 → 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,
@@ -4884,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();
@@ -5152,11 +5219,12 @@ async function toolGetShareSnippet(args) {
 
 // src/server.ts
 var SERVER_NAME = "claudinho";
-var SERVER_VERSION = "0.8.17";
+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}`;
@@ -5240,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: [
@@ -5375,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.17",
+  "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.17"
+    "@claudinho/core": "0.8.18"
   },
   "scripts": {
     "build": "tsup",