cito-mcp 0.3.0 → 0.3.2

package/dist/tools/match.js

@@ -167,9 +167,26 @@ Example: { "game": "cs2", "matchId": "cs2-match-123", "view": "summary", "includ
         const partial = [];
         let upstreamCalls = 0;
         let rateLimit = {};
-        const primary = await getSection(ctx, primaryPath(game, matchId));
+        let primary = await getSection(ctx, primaryPath(game, matchId));
         upstreamCalls += 1;
         rateLimit = primary.headers;
+        // Tennis live board hands out s365_* ids that live at /matches/live/{id}
+        // until the match finishes and lands in the archive. Without this fallback
+        // the board gives out ids that match_summary immediately 404s on.
+        if (!primary.ok && game === 'tennis' && primary.status === 404) {
+            primary = await getSection(ctx, `/tennis/matches/live/${encodeURIComponent(matchId)}`);
+            upstreamCalls += 1;
+            rateLimit = { ...rateLimit, ...primary.headers };
+            // Finished live matches archive under s365_{year}_{gid} while the live
+            // board handed out s365_{gid} — insert the year before giving up.
+            const gid = matchId.match(/^s365_(\d+)$/)?.[1];
+            if (!primary.ok && gid) {
+                const year = new Date().getUTCFullYear();
+                primary = await getSection(ctx, `/tennis/matches/${encodeURIComponent(`s365_${year}_${gid}`)}`);
+                upstreamCalls += 1;
+                rateLimit = { ...rateLimit, ...primary.headers };
+            }
+        }
         if (!primary.ok) {
             return errorEnvelope({
                 code: mapHttpToCode(primary.status, { gameNotIncluded: gameNotIncludedHint(primary.data) }),

package/dist/tools/meta.js

@@ -430,6 +430,7 @@ Example: { "includeGameProbes": true }`,
                 { game: 'dota2', path: '/dota2' },
                 { game: 'cod', path: '/cod' },
                 { game: 'ufc', path: '/ufc/live/health' },
+                { game: 'tennis', path: '/tennis/rankings/top?tour=ATP&top_n=1' },
             ];
             const results = await Promise.all(paths.map(async ({ game, path }) => {
                 const res = await fetchJson(ctx, path);
@@ -528,6 +529,10 @@ Example: { "method": "GET", "path": "/cs2/rankings/teams", "queryJson": "{\\"pag
                 default: '{}',
                 description: 'Stringified JSON object of query params. Example: "{\\"page\\":1,\\"limit\\":20}".',
             },
+            query: {
+                type: 'object',
+                description: 'Query params as a plain object (alternative to queryJson). Example: {"year":2026}.',
+            },
             bodyJson: {
                 type: 'string',
                 description: 'Stringified JSON body for POST only (rare).',
@@ -571,6 +576,11 @@ Example: { "method": "GET", "path": "/cs2/rankings/teams", "queryJson": "{\\"pag
             });
         }
         let query = {};
+        // Agents pass query as a plain object at least as often as the stringified
+        // queryJson form; silently dropping it produced confusing upstream 422s.
+        if (args.query && typeof args.query === 'object' && !Array.isArray(args.query)) {
+            query = { ...args.query };
+        }
         if (typeof args.queryJson === 'string' && args.queryJson.trim()) {
             try {
                 const parsed = JSON.parse(args.queryJson);
@@ -692,10 +702,10 @@ Example: { "game": "ufc", "q": "rankings" }`,
         // documented paths and no curated tools, so it is exactly what call_api
         // callers come looking for.
         const gameRaw = typeof args.game === 'string' ? args.game.toLowerCase().trim() : '';
-        if (gameRaw && !gameRaw.match(/^(lol|cs2|dota2|cod|ufc|fortnite)$/)) {
+        if (gameRaw && !gameRaw.match(/^(lol|cs2|dota2|cod|ufc|fortnite|tennis)$/)) {
             return errorEnvelope({
                 code: 'UNSUPPORTED_GAME',
-                message: `unsupported game "${gameRaw}"; use lol|cs2|dota2|cod|ufc|fortnite`,
+                message: `unsupported game "${gameRaw}"; use lol|cs2|dota2|cod|ufc|fortnite|tennis`,
                 game: null,
                 source: 'list_routes',
                 requestId,

package/dist/tools/normalize.js

@@ -171,21 +171,33 @@ export function normalizeMatch(game, row, forcedStatus) {
         if (s != null)
             team2 = { ...team2, score: s };
     }
-    // Tennis: live rows carry player1_name/player2_name; archive rows only carry
-    // winner_id/loser_id (ids, no names). Map both onto sides so labels are never "? vs ?".
+    // Tennis: the live board nests player1/player2 objects ({id,name,sets_won});
+    // raw live rows carry player1_name/player2_name; archive rows only carry
+    // winner_id/loser_id (ids, no names). Map all three onto sides so labels are
+    // never "? vs ?" and live scores surface as sets won.
     if (game === 'tennis' && !team1 && !team2) {
-        const p1 = pickString(r.player1_name);
-        const p2 = pickString(r.player2_name);
+        const p1obj = asRecord(r.player1);
+        const p2obj = asRecord(r.player2);
+        const p1 = pickString(p1obj?.name, r.player1_name);
+        const p2 = pickString(p2obj?.name, r.player2_name);
         if (p1 || p2) {
-            team1 = sideFrom(p1, pickString(r.player1_id), undefined, undefined);
-            team2 = sideFrom(p2, pickString(r.player2_id), undefined, undefined);
+            const score1 = typeof p1obj?.sets_won === 'number' ? p1obj.sets_won : undefined;
+            const score2 = typeof p2obj?.sets_won === 'number' ? p2obj.sets_won : undefined;
+            team1 = sideFrom(p1, pickString(p1obj?.id, r.player1_id), undefined, score1);
+            team2 = sideFrom(p2, pickString(p2obj?.id, r.player2_id), undefined, score2);
         }
         else {
-            const w = pickString(r.winner_id);
-            const l = pickString(r.loser_id);
-            if (w || l) {
-                team1 = sideFrom(w, w, undefined, undefined);
-                team2 = sideFrom(l, l, undefined, undefined);
+            // Archive detail nests winner/loser objects with real names; list rows
+            // may only carry winner_id/loser_id (ids double as last-resort labels).
+            const wObj = asRecord(r.winner);
+            const lObj = asRecord(r.loser);
+            const wName = pickString(wObj?.name, r.winner_name);
+            const lName = pickString(lObj?.name, r.loser_name);
+            const wId = pickString(wObj?.id, r.winner_id);
+            const lId = pickString(lObj?.id, r.loser_id);
+            if (wName || lName || wId || lId) {
+                team1 = sideFrom(wName ?? wId, wId, undefined, undefined);
+                team2 = sideFrom(lName ?? lId, lId, undefined, undefined);
             }
         }
     }
@@ -286,7 +298,7 @@ export function normalizeMatch(game, row, forcedStatus) {
         }
     }
     const ev = asRecord(r.event);
-    const eventName = pickString(ev?.name, ev?.title, r.eventName, typeof r.event === 'string' ? r.event : undefined, asRecord(r.tournament)?.name, asRecord(r.tournament)?.title, r.tournamentName);
+    const eventName = pickString(ev?.name, ev?.title, r.eventName, typeof r.event === 'string' ? r.event : undefined, asRecord(r.tournament)?.name, asRecord(r.tournament)?.title, r.tournamentName, r.tournament_name);
     const eventId = pickString(ev?.id, r.eventId, asRecord(r.tournament)?.id, r.tournamentId);
     const eventSlug = pickString(ev?.slug, r.eventSlug, asRecord(r.tournament)?.slug);
     const leagueName = pickString(asRecord(r.league)?.name, r.leagueName, r.league, r.leagueSlug);

package/dist/tools/resolve.js

@@ -10,7 +10,14 @@ function pushCandidates(out, game, type, rows, q, limit) {
         const ref = entityRef(row, type, game);
         const r = asRecord(row) ?? {};
         const nickname = pickString(r.nickname, asRecord(r.profile)?.nickname, ref.meta?.nickname);
-        const score = rankScore(q, ref.name, ref.id, ref.slug, nickname);
+        let score = rankScore(q, ref.name, ref.id, ref.slug, nickname);
+        // Ranked-player tiebreaker: a surname query like "Alcaraz" fuzzy-ties the
+        // world #2 with a 1991 journeyman; the row's current_rank breaks the tie
+        // toward whoever is actually active/ranked (tennis search supplies it).
+        const currentRank = Number(r.current_rank);
+        if (score > 0 && Number.isFinite(currentRank) && currentRank > 0) {
+            score += currentRank <= 100 ? 8 : currentRank <= 1000 ? 4 : 2;
+        }
         // Prefer positive fuzzy hits; keep weak API hits at floor 1 so real search results are not wiped.
         if (q && score <= 0) {
             // still allow through at floor so dedicated search endpoints aren't empty on odd nicknames

package/dist/tools/standings.js

@@ -62,7 +62,7 @@ export function normalizeStandingRow(row, index) {
                     : null),
         championStatus: resolvedChampionStatus,
         teamOrFighter: {
-            id: pickString(asRecord(entity)?.id, r.teamId, r.fighterId, r.orgId, r.id),
+            id: pickString(asRecord(entity)?.id, r.teamId, r.fighterId, r.orgId, r.id, r.player_id),
             slug: pickString(asRecord(entity)?.slug, r.orgSlug, r.teamSlug, r.slug, r.fighterSlug),
             name,
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cito-mcp",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Standalone MCP server for the Cito esports API — 15 curated outcome tools for agents (live, schedule, profiles, standings, previews, event cards).",
   "type": "module",
   "bin": {