cito-mcp 0.3.14 → 0.3.16

package/dist/envelope.js

@@ -64,7 +64,9 @@ export function mapHttpToCode(status, hints) {
     }
     if (status === 400 && hints?.ambiguous)
         return 'AMBIGUOUS_ENTITY';
-    if (status === 400)
+    // 422 is FastAPI's validation status (tennis). It was falling through to
+    // UPSTREAM, which is marked retryable, so an agent retried a bad argument.
+    if (status === 400 || status === 422)
         return 'VALIDATION';
     if (status >= 500 || status === 0)
         return 'UPSTREAM';

package/dist/tools/insight.js

@@ -13,6 +13,50 @@ async function loadSide(ctx, game, side, recentLimit, includeRosters) {
     let roster = [];
     let recentForm = [];
     let keyPlayers = [];
+    if (game === 'tennis') {
+        // Profile + match log. Without this branch the preview fell to the generic
+        // fallback and presented player ids where names belong.
+        const res = await fetchJson(ctx, `/tennis/players/${encodeURIComponent(side)}`);
+        calls += 1;
+        rateLimit = res.headers;
+        if (res.ok) {
+            const data = asRecord(unwrapPayload(res.data)) ?? {};
+            const career = asRecord(data.career_summary) ?? {};
+            entity = {
+                id: pickString(data.player_id, data.id, side),
+                slug: pickString(data.player_id, data.id, side),
+                name: pickString(data.full_name, data.name, side) ?? side,
+                tour: pickString(data.tour) ?? null,
+                country: pickString(data.ioc, data.country_code) ?? null,
+                hand: pickString(data.hand) ?? null,
+                age: typeof data.age === 'number' ? data.age : null,
+                currentRank: typeof data.current_rank === 'number' ? data.current_rank : null,
+                careerHighRank: typeof data.career_high_rank === 'number' ? data.career_high_rank : null,
+                careerRecord: career.matches_won != null && career.matches_lost != null
+                    ? `${career.matches_won}-${career.matches_lost}`
+                    : null,
+                game,
+            };
+        }
+        else {
+            partial.push(partialFromRejection('entity', {
+                code: mapHttpToCode(res.status),
+                message: `player HTTP ${res.status}`,
+                httpStatus: res.status,
+            }));
+        }
+        const log = await fetchJson(ctx, `/tennis/players/${encodeURIComponent(side)}/matches`, {
+            query: { page_size: recentLimit },
+        });
+        calls += 1;
+        rateLimit = { ...rateLimit, ...log.headers };
+        if (log.ok) {
+            recentForm = extractRows(unwrapPayload(log.data) ?? log.data)
+                .slice(0, recentLimit)
+                .map((row) => normalizeMatch('tennis', row));
+        }
+        return { entity, roster, recentForm, keyPlayers, calls, partial, rateLimit };
+    }
     if (game === 'ufc') {
         const res = await fetchJson(ctx, `/ufc/fighters/${encodeURIComponent(side)}`);
         calls += 1;
@@ -315,6 +359,8 @@ Example: { "game": "lol", "teamA": "t1", "teamB": "gen-g", "includeH2H": true, "
                 path = `/cod/matches/${encodeURIComponent(matchId)}`;
             else if (game === 'ufc')
                 path = `/ufc/bouts/${encodeURIComponent(matchId)}`;
+            else if (game === 'tennis')
+                path = `/tennis/matches/${encodeURIComponent(matchId)}`;
             const res = await fetchJson(ctx, path);
             upstreamCalls += 1;
             rateLimit = res.headers;
@@ -336,6 +382,18 @@ Example: { "game": "lol", "teamA": "t1", "teamB": "gen-g", "includeH2H": true, "
                     teamA = m.team1?.slug || m.team1?.id || m.team1?.name || '';
                 if (!teamB)
                     teamB = m.team2?.slug || m.team2?.id || m.team2?.name || '';
+                // Tennis archive detail carries winner/loser objects; if normalisation
+                // did not surface them as sides, read the ids straight off the record
+                // rather than failing the whole preview.
+                if (game === 'tennis') {
+                    const rec = asRecord(entity) ?? {};
+                    const w = asRecord(rec.winner) ?? asRecord(rec.player1) ?? {};
+                    const l = asRecord(rec.loser) ?? asRecord(rec.player2) ?? {};
+                    if (!teamA)
+                        teamA = pickString(w.id, rec.winner_id, rec.player1_id) ?? '';
+                    if (!teamB)
+                        teamB = pickString(l.id, rec.loser_id, rec.player2_id) ?? '';
+                }
             }
             else {
                 partial.push(partialFromRejection('context', {
@@ -405,6 +463,45 @@ Example: { "game": "lol", "teamA": "t1", "teamB": "gen-g", "includeH2H": true, "
                     if (res.ok)
                         rows = extractRows(res.data);
                 }
+                else if (game === 'tennis') {
+                    // Tennis has a first-class H2H endpoint with the full rivalry; use it
+                    // rather than composing from a short form window, which reported
+                    // Sinner vs Alcaraz as never having met.
+                    const h2hRes = await fetchJson(ctx, '/tennis/h2h', { query: { player1_id: teamA, player2_id: teamB } });
+                    upstreamCalls += 1;
+                    rateLimit = { ...rateLimit, ...h2hRes.headers };
+                    if (h2hRes.ok) {
+                        const rec = asRecord(unwrapPayload(h2hRes.data)) ?? {};
+                        // The payload names both players once at the top; rows name only
+                        // the winner. Resolve the loser's name from the top-level blocks
+                        // so a meeting reads "Sinner vs Alcaraz", not "Sinner vs atp_207989".
+                        const p1 = asRecord(rec.player1) ?? {};
+                        const p2 = asRecord(rec.player2) ?? {};
+                        const nameOf = {
+                            [String(pickString(p1.id) ?? '')]: pickString(p1.name),
+                            [String(pickString(p2.id) ?? '')]: pickString(p2.name),
+                        };
+                        rows = (Array.isArray(rec.matches) ? rec.matches : []).map((row) => {
+                            const r = asRecord(row) ?? {};
+                            const winnerId = pickString(r.winner_id) ?? '';
+                            const loserId = winnerId === pickString(p1.id) ? String(pickString(p2.id) ?? teamB) : String(pickString(p1.id) ?? teamA);
+                            return {
+                                ...r,
+                                outcome: 'COMPLETED',
+                                winner: { id: winnerId, name: pickString(r.winner_name) ?? nameOf[winnerId] },
+                                loser: { id: loserId, name: nameOf[loserId] },
+                                startTime: pickString(r.date),
+                            };
+                        });
+                    }
+                    else {
+                        partial.push(partialFromRejection('h2h', {
+                            code: mapHttpToCode(h2hRes.status),
+                            message: `tennis h2h HTTP ${h2hRes.status}`,
+                            httpStatus: h2hRes.status,
+                        }));
+                    }
+                }
                 else if (game === 'ufc') {
                     // Fighter fight history is the H2H source of truth (not global /bouts page 1).
                     const hist = await fetchJson(ctx, `/ufc/fighters/${encodeURIComponent(teamA)}/fights`, {
@@ -548,6 +645,32 @@ async function resolveEventKey(ctx, game, q) {
     const needle = q.toLowerCase().trim();
     if (!needle)
         return { key: null, name: null, calls, rateLimit };
+    if (game === 'tennis') {
+        // No free-text search on tournaments upstream; the season calendar is the
+        // complete list and is small enough to match locally.
+        // This year's calendar first, then the two before it: the archive lags
+        // the live season, so the current edition of an event may not exist yet
+        // (no 2026 Wimbledon row while 2025 does).
+        const thisYear = new Date().getUTCFullYear();
+        let hit;
+        for (const year of [thisYear, thisYear - 1, thisYear - 2]) {
+            const res = await fetchJson(ctx, '/tennis/tournaments/calendar', { query: { year } });
+            calls += 1;
+            rateLimit = res.headers;
+            const rows = extractRows(unwrapPayload(res.data) ?? res.data).map((r) => asRecord(r) ?? {});
+            hit =
+                rows.find((r) => String(pickString(r.name) ?? '').toLowerCase() === needle) ??
+                    rows.find((r) => String(pickString(r.name) ?? '').toLowerCase().includes(needle));
+            if (hit)
+                break;
+        }
+        return {
+            key: hit ? (pickString(hit.id, hit.tournament_id) ?? null) : null,
+            name: hit ? (pickString(hit.name) ?? null) : null,
+            calls,
+            rateLimit,
+        };
+    }
     let path = '';
     let query = { limit: 25, page: 1 };
     if (game === 'ufc') {
@@ -1085,6 +1208,67 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeBouts": true, "inc
                 }
             }
         }
+        else if (game === 'tennis') {
+            // Tournament detail plus the bracket. The draw is only populated once a
+            // tournament has results, so an event still in the future comes back
+            // with the detail and an empty bouts list, and says so.
+            const detail = await fetchJson(ctx, `/tennis/tournaments/${encodeURIComponent(eventKey)}`);
+            upstreamCalls += 1;
+            rateLimit = { ...rateLimit, ...detail.headers };
+            if (detail.ok) {
+                const d = asRecord(unwrapPayload(detail.data)) ?? {};
+                event = {
+                    ...event,
+                    id: pickString(d.id) ?? eventKey,
+                    slug: pickString(d.id) ?? eventKey,
+                    name: pickString(d.name) ?? event.name,
+                    tour: pickString(d.tour) ?? null,
+                    level: pickString(d.level) ?? null,
+                    tier: pickString(d.tier) ?? null,
+                    surface: pickString(d.surface) ?? null,
+                    drawSize: typeof d.draw_size === 'number' ? d.draw_size : null,
+                    city: pickString(d.city) ?? null,
+                    country: pickString(d.country_code) ?? null,
+                    editions: { first: d.first_edition_year ?? null, mostRecent: d.most_recent_edition_year ?? null },
+                    allTimeTitleLeader: d.all_time_title_leader ?? null,
+                };
+            }
+            else {
+                partial.push(partialFromRejection('event', {
+                    code: mapHttpToCode(detail.status),
+                    message: `tournament HTTP ${detail.status}`,
+                    httpStatus: detail.status,
+                }));
+            }
+            if (includeBouts) {
+                const draw = await fetchJson(ctx, `/tennis/tournaments/${encodeURIComponent(eventKey)}/draw`);
+                upstreamCalls += 1;
+                rateLimit = { ...rateLimit, ...draw.headers };
+                if (draw.ok) {
+                    const dd = asRecord(unwrapPayload(draw.data)) ?? {};
+                    const rounds = Array.isArray(dd.rounds) ? dd.rounds : [];
+                    const flat = [];
+                    for (const rr of rounds) {
+                        const rec = asRecord(rr) ?? {};
+                        const roundName = pickString(rec.round_name, rec.name, rec.round) ?? null;
+                        for (const mm of (Array.isArray(rec.matches) ? rec.matches : [])) {
+                            const mr = asRecord(mm) ?? {};
+                            flat.push({ ...mr, id: mr.match_id, round: roundName, tournament_name: event.name, status: 'completed' });
+                        }
+                    }
+                    bouts = flat.slice(0, limit).map((row) => normalizeMatch('tennis', row));
+                    if (!bouts.length)
+                        warnings.push('No draw yet: the tournament has no archived results');
+                }
+                else {
+                    partial.push(partialFromRejection('bouts', {
+                        code: mapHttpToCode(draw.status),
+                        message: `tournament draw HTTP ${draw.status}`,
+                        httpStatus: draw.status,
+                    }));
+                }
+            }
+        }
         else {
             // dota2 — thin: tournament list + recent matches only
             warnings.push('Dota2 event_card is thin; expect partial bouts/standings');

package/dist/tools/normalize.js

@@ -323,11 +323,18 @@ export function normalizeMatch(game, row, forcedStatus) {
         team1 = team1 ?? nestedSide(r.teams[0], game);
         team2 = team2 ?? nestedSide(r.teams[1], game);
     }
-    const startTime = pickString(r.startTime, r.scheduledAt, r.startsAt, r.date, r.startDate, r.beginAt, asRecord(r.event)?.startsAt, asRecord(r.event)?.startTime, asRecord(r.event)?.date) ?? null;
-    const statusRaw = pickString(r.status, r.state, r.matchStatus, r.boutStatus)?.toLowerCase() ?? '';
+    const startTime = pickString(r.startTime, r.scheduledAt, 
+    // Tennis emits scheduled_at; startTime was the API's only camelCase key
+    // and was removed. Without this the upcoming board loses its clock.
+    r.scheduled_at, 
+    // A live row reports when it went in-play, not when it was scheduled.
+    r.started_at, r.startsAt, r.date, r.startDate, r.beginAt, asRecord(r.event)?.startsAt, asRecord(r.event)?.startTime, asRecord(r.event)?.date) ?? null;
+    // Tennis archive rows carry the state as outcome (COMPLETED / RETIREMENT /
+    // WALKOVER); read it, or every finished match reported status unknown.
+    const statusRaw = pickString(r.status, r.state, r.matchStatus, r.boutStatus, r.outcome)?.toLowerCase() ?? '';
     let status = forcedStatus ?? 'unknown';
     if (!forcedStatus) {
-        const hasResult = Boolean(pickString(r.winnerFighterSlug, r.winnerSlug, r.winner, r.method, r.result)) ||
+        const hasResult = Boolean(pickString(r.winnerFighterSlug, r.winnerSlug, r.winner, r.winner_id, r.method, r.result)) ||
             r.resultRound != null ||
             r.isComplete === true ||
             r.completed === true;
@@ -348,7 +355,7 @@ export function normalizeMatch(game, row, forcedStatus) {
             status = 'live';
         else if (looksLive && !kickoffPassed)
             status = 'upcoming';
-        else if (/complete|finished|ended|final|closed|done|official|result/.test(statusRaw) || hasResult) {
+        else if (/complete|finished|ended|final|closed|done|official|result|retire|walkover|default/.test(statusRaw) || hasResult) {
             status = 'completed';
         }
         else if (/upcoming|scheduled|not_?started|unstarted|pending|soon|booked|confirmed|announced|tbd/.test(statusRaw) ||
@@ -374,7 +381,9 @@ export function normalizeMatch(game, row, forcedStatus) {
     // as a win in head_to_head's tally, which reads the scores.
     const historyOutcome = pickString(r.outcome)?.toLowerCase();
     const historyOpponent = pickString(asRecord(r.opponent)?.slug);
-    const resolvedWinnerSlug = pickString(r.winnerFighterSlug, r.winnerSlug, r.winner) ??
+    const resolvedWinnerSlug = 
+    // winner_id is the tennis archive's spelling; winner there is an object.
+    pickString(r.winnerFighterSlug, r.winnerSlug, r.winner, r.winner_id) ??
         (historyOutcome === 'win' && typeof r.fighterSlug === 'string' ? r.fighterSlug
             : historyOutcome === 'loss' && historyOpponent ? historyOpponent
                 : undefined);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cito-mcp",
-  "version": "0.3.14",
-  "description": "Standalone MCP server for the Cito esports API \u2014 15 curated outcome tools for agents (live, schedule, profiles, standings, previews, event cards).",
+  "version": "0.3.16",
+  "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": {
     "cito-mcp": "dist/index.js"