cito-mcp 0.5.8 → 0.6.1

package/dist/tools/insight.js

@@ -26,6 +26,9 @@ async function loadSide(ctx, game, side, recentLimit, includeRosters) {
                 hand: pickString(data.hand) ?? null,
                 age: typeof data.age === 'number' ? data.age : null,
                 currentRank: typeof data.current_rank === 'number' ? data.current_rank : null,
+                lastRank: typeof data.last_rank === 'number' ? data.last_rank : null,
+                lastRankDate: pickString(data.last_rank_date) ?? null,
+                status: pickString(data.status) ?? 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}`
@@ -272,7 +275,7 @@ Prefer match_summary when match is completed; match_details for live in-game.
 
 Do not use when: user wants final score/recap of a finished match.
 
-Parallel-safe: yes. Upstream cost: 4–8.
+Parallel-safe: yes. API calls: 4–8.
 Tennis H2H accepts an optional surface filter (Hard, Clay, Grass).
 Example: { "game": "lol", "teamA": "t1", "teamB": "gen-g", "includeH2H": true, "recentLimit": 5 }`,
     inputSchema: {
@@ -340,7 +343,7 @@ Example: { "game": "lol", "teamA": "t1", "teamB": "gen-g", "includeH2H": true, "
             });
         }
         const partial = [];
-        let upstreamCalls = 0;
+        let apiCalls = 0;
         let rateLimit = {};
         let context = {
             matchId: matchId || null,
@@ -364,7 +367,7 @@ Example: { "game": "lol", "teamA": "t1", "teamB": "gen-g", "includeH2H": true, "
             else if (game === 'tennis')
                 path = `/tennis/matches/${encodeURIComponent(matchId)}`;
             const res = await fetchJson(ctx, path);
-            upstreamCalls += 1;
+            apiCalls += 1;
             rateLimit = res.headers;
             if (res.ok) {
                 const entity = unwrapPayload(res.data);
@@ -408,14 +411,14 @@ Example: { "game": "lol", "teamA": "t1", "teamB": "gen-g", "includeH2H": true, "
                 source: 'match_preview',
                 requestId,
                 tookMs: Date.now() - started,
-                upstreamCalls,
+                apiCalls,
             });
         }
         const [sideARes, sideBRes] = await Promise.all([
             loadSide(ctx, game, teamA, recentLimit, includeRosters),
             loadSide(ctx, game, teamB, recentLimit, includeRosters),
         ]);
-        upstreamCalls += sideARes.calls + sideBRes.calls;
+        apiCalls += sideARes.calls + sideBRes.calls;
         rateLimit = { ...rateLimit, ...sideARes.rateLimit, ...sideBRes.rateLimit };
         partial.push(...sideARes.partial.map((p) => ({ ...p, section: `sideA.${p.section}` })));
         partial.push(...sideBRes.partial.map((p) => ({ ...p, section: `sideB.${p.section}` })));
@@ -425,7 +428,7 @@ Example: { "game": "lol", "teamA": "t1", "teamB": "gen-g", "includeH2H": true, "
                 let rows = [];
                 if (game === 'cs2') {
                     const res = await fetchJson(ctx, '/cs2/matches', { query: { team: teamA, limit: 40 } });
-                    upstreamCalls += 1;
+                    apiCalls += 1;
                     rateLimit = { ...rateLimit, ...res.headers };
                     if (res.ok)
                         rows = extractRows(res.data);
@@ -441,21 +444,21 @@ Example: { "game": "lol", "teamA": "t1", "teamB": "gen-g", "includeH2H": true, "
                     const res = await fetchJson(ctx, '/lol/schedule', {
                         query: { teamSlug: teamA, completed: 'true', limit: '40' },
                     });
-                    upstreamCalls += 1;
+                    apiCalls += 1;
                     rateLimit = { ...rateLimit, ...res.headers };
                     if (res.ok)
                         rows = extractRows(res.data);
                 }
                 else if (game === 'cod') {
                     const res = await fetchJson(ctx, '/cod/matches', { query: { team: teamA, limit: 40 } });
-                    upstreamCalls += 1;
+                    apiCalls += 1;
                     rateLimit = { ...rateLimit, ...res.headers };
                     if (res.ok)
                         rows = extractRows(res.data);
                 }
                 else if (game === 'dota2') {
                     const res = await fetchJson(ctx, '/dota2/matches/recent', { query: { limit: 40 } });
-                    upstreamCalls += 1;
+                    apiCalls += 1;
                     rateLimit = { ...rateLimit, ...res.headers };
                     if (res.ok)
                         rows = extractRows(res.data);
@@ -465,7 +468,7 @@ Example: { "game": "lol", "teamA": "t1", "teamB": "gen-g", "includeH2H": true, "
                     if (game === 'tennis' && surface)
                         h2hQuery.surface = surface;
                     const h2hRes = await fetchJson(ctx, '/tennis/h2h', { query: h2hQuery });
-                    upstreamCalls += 1;
+                    apiCalls += 1;
                     rateLimit = { ...rateLimit, ...h2hRes.headers };
                     if (h2hRes.ok) {
                         const rec = asRecord(unwrapPayload(h2hRes.data)) ?? {};
@@ -500,7 +503,7 @@ Example: { "game": "lol", "teamA": "t1", "teamB": "gen-g", "includeH2H": true, "
                     const hist = await fetchJson(ctx, `/ufc/fighters/${encodeURIComponent(teamA)}/fights`, {
                         query: { limit: 50 },
                     });
-                    upstreamCalls += 1;
+                    apiCalls += 1;
                     rateLimit = { ...rateLimit, ...hist.headers };
                     if (hist.ok) {
                         rows = extractRows(unwrapPayload(hist.data) ?? hist.data).map((row) => {
@@ -520,7 +523,7 @@ Example: { "game": "lol", "teamA": "t1", "teamB": "gen-g", "includeH2H": true, "
             }
             catch (e) {
                 partial.push(partialFromRejection('h2h', {
-                    code: 'UPSTREAM',
+                    code: 'SERVICE_ERROR',
                     message: e.message,
                 }));
             }
@@ -593,7 +596,7 @@ Example: { "game": "lol", "teamA": "t1", "teamB": "gen-g", "includeH2H": true, "
             game,
             requestId,
             tookMs: Date.now() - started,
-            upstreamCalls,
+            apiCalls,
             rateLimit,
             partial: partial.length ? partial : undefined,
             entities: {
@@ -718,7 +721,7 @@ Bouts come back in card order — main event first, then prelims, then early pre
 Each bout carries weightClass, titleBout, card placement, and (once fought) result
 { method, round, time, referee, winnerSlug }. Each corner carries images
 { headshotUrl, bodyImageUrl, imageUrl, proxiedImageUrl }, record, nickname, rank,
-championStatus, country and flag when upstream supplies them. Use proxiedImageUrl in
+championStatus, country and flag when available. Use proxiedImageUrl in
 browsers — the image host sends no CORS header. You do not need call_api per fighter for faces.
 
 Prefer over: agent-side resolve + call_api /ufc/events + bout expansion; N+1 match_summary for the card list only; per-fighter call_api just to fetch headshots.
@@ -730,14 +733,14 @@ Do not use when: you only need live scores (live_matches); single finished match
 Tennis: pass a tournament id/slug to get the draw bracket — every main round from
 the first to the Final (status completed / in_progress / not_started), then
 qualifying (Q1..Q3). Each result carries winnerId/loserId/outcome (retirements
-included), startTime (null with startTimeUnavailableReason when the source has no
+included), startTime (null with startTimeUnavailableReason when no start time is
 clock), nextMatchId (the bracket edge) and bracketPosition; scheduled and live
 matches sit in rounds[].pending. draw carries drawSize (real field size, byes
 excluded, e.g. 56), byes, matchesExpected (main draw) and complete (true only
 when every main round to the Final is played). This is the primary tennis path
 here; there is no separate draw tool.
 
-Parallel-safe: yes. Upstream cost: 1–4.
+Parallel-safe: yes. API calls: 1–4.
 Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "includeStandings": false }`,
     inputSchema: {
         type: 'object',
@@ -751,7 +754,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
             includeMatches: boolSchema('Include the bout/match list, or the tennis draw bracket (default true).', true),
             includeStandings: boolSchema('Include standings/rankings snippet when API supports event/tournament/division scope (default false). ' +
                 'For UFC this also joins divisional rank and movement onto each bout corner as team.rank / team.rankMovement — ' +
-                'bout rows themselves carry no rank. Costs one extra upstream call.', false),
+                'bout rows themselves carry no rank. Costs one extra API call.', false),
             limit: limitSchema({
                 default: 20,
                 max: 50,
@@ -799,12 +802,12 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
             });
         }
         const partial = [];
-        let upstreamCalls = 0;
+        let apiCalls = 0;
         let rateLimit = {};
         const warnings = [];
         if (!eventKey && q) {
             const resolved = await resolveEventKey(ctx, game, q);
-            upstreamCalls += resolved.calls;
+            apiCalls += resolved.calls;
             rateLimit = { ...rateLimit, ...resolved.rateLimit };
             if (resolved.key) {
                 eventKey = resolved.key;
@@ -817,7 +820,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
                     source: 'event_card',
                     requestId,
                     tookMs: Date.now() - started,
-                    upstreamCalls,
+                    apiCalls,
                     rateLimit,
                     recover: [
                         'Call resolve_entity { type: "event", game, q } or search_entities, then retry with eventIdOrSlug',
@@ -856,7 +859,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
         };
         if (game === 'ufc') {
             const detail = await fetchJson(ctx, `/ufc/events/${encodeURIComponent(eventKey)}`);
-            upstreamCalls += 1;
+            apiCalls += 1;
             rateLimit = { ...rateLimit, ...detail.headers };
             if (detail.ok) {
                 const data = asRecord(detail.data) ?? {};
@@ -891,7 +894,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
                     source: 'event_card',
                     requestId,
                     tookMs: Date.now() - started,
-                    upstreamCalls,
+                    apiCalls,
                     rateLimit,
                     httpStatus: 404,
                     recover: [
@@ -908,14 +911,14 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
                     source: 'event_card',
                     requestId,
                     tookMs: Date.now() - started,
-                    upstreamCalls,
+                    apiCalls,
                     rateLimit,
                     httpStatus: detail.status,
                 });
             }
             if (includeBouts && bouts.length === 0) {
                 const boutsRes = await fetchJson(ctx, `/ufc/events/${encodeURIComponent(String(event.slug ?? eventKey))}/bouts`);
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...boutsRes.headers };
                 if (boutsRes.ok) {
                     bouts = sortByCardOrder(extractRows(boutsRes.data).map((row) => normalizeMatch('ufc', {
@@ -937,7 +940,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
             bouts = bouts.map((b) => ({ ...b, startTime: b.startTime ?? cardStart }));
             if (includeStandings) {
                 const ranks = await fetchJson(ctx, '/ufc/rankings');
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...ranks.headers };
                 if (ranks.ok) {
                     const rankRows = extractRows(ranks.data)
@@ -1006,7 +1009,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
         }
         else if (game === 'cs2') {
             const detail = await fetchJson(ctx, `/cs2/events/${encodeURIComponent(eventKey)}`);
-            upstreamCalls += 1;
+            apiCalls += 1;
             rateLimit = { ...rateLimit, ...detail.headers };
             if (detail.ok) {
                 const data = asRecord(detail.data) ?? {};
@@ -1028,7 +1031,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
                     source: 'event_card',
                     requestId,
                     tookMs: Date.now() - started,
-                    upstreamCalls,
+                    apiCalls,
                     rateLimit,
                     httpStatus: 404,
                 });
@@ -1045,7 +1048,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
                 const matchesRes = await fetchJson(ctx, '/cs2/matches', {
                     query: { event: eventKey, limit, page: 1 },
                 });
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...matchesRes.headers };
                 if (matchesRes.ok) {
                     bouts = extractRows(matchesRes.data)
@@ -1062,7 +1065,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
             }
             if (includeStandings) {
                 const st = await fetchJson(ctx, `/cs2/events/${encodeURIComponent(eventKey)}/standings`);
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...st.headers };
                 if (st.ok)
                     standingsSnippet = { scope: 'event', raw: st.data };
@@ -1077,7 +1080,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
         }
         else if (game === 'lol') {
             const detail = await fetchJson(ctx, `/lol/tournaments/${encodeURIComponent(eventKey)}`);
-            upstreamCalls += 1;
+            apiCalls += 1;
             rateLimit = { ...rateLimit, ...detail.headers };
             if (detail.ok) {
                 const data = asRecord(detail.data) ?? {};
@@ -1105,7 +1108,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
                         source: 'event_card',
                         requestId,
                         tookMs: Date.now() - started,
-                        upstreamCalls,
+                        apiCalls,
                         rateLimit,
                         httpStatus: 404,
                     });
@@ -1115,7 +1118,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
                 const sched = await fetchJson(ctx, '/lol/schedule', {
                     query: { tournamentId: eventKey, limit: String(limit) },
                 });
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...sched.headers };
                 if (sched.ok) {
                     bouts = extractRows(sched.data)
@@ -1132,7 +1135,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
             }
             if (includeStandings) {
                 const st = await fetchJson(ctx, `/lol/tournaments/${encodeURIComponent(eventKey)}/standings`);
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...st.headers };
                 if (st.ok)
                     standingsSnippet = { scope: 'tournament', raw: st.data };
@@ -1147,7 +1150,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
         }
         else if (game === 'cod') {
             const detail = await fetchJson(ctx, `/cod/tournaments/${encodeURIComponent(eventKey)}`);
-            upstreamCalls += 1;
+            apiCalls += 1;
             rateLimit = { ...rateLimit, ...detail.headers };
             if (detail.ok) {
                 const data = asRecord(detail.data) ?? {};
@@ -1167,7 +1170,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
                     source: 'event_card',
                     requestId,
                     tookMs: Date.now() - started,
-                    upstreamCalls,
+                    apiCalls,
                     rateLimit,
                     httpStatus: 404,
                 });
@@ -1183,7 +1186,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
                 const matchesRes = await fetchJson(ctx, '/cod/matches', {
                     query: { tournamentId: eventKey, limit },
                 });
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...matchesRes.headers };
                 if (matchesRes.ok) {
                     bouts = extractRows(matchesRes.data)
@@ -1200,7 +1203,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
             }
             if (includeStandings) {
                 const st = await fetchJson(ctx, '/cod/standings', { query: { tournamentId: eventKey } });
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...st.headers };
                 if (st.ok)
                     standingsSnippet = { scope: 'tournament', raw: st.data };
@@ -1215,7 +1218,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
         }
         else if (game === 'tennis') {
             const detail = await fetchJson(ctx, `/tennis/tournaments/${encodeURIComponent(eventKey)}`);
-            upstreamCalls += 1;
+            apiCalls += 1;
             rateLimit = { ...rateLimit, ...detail.headers };
             if (detail.ok) {
                 const d = asRecord(unwrapPayload(detail.data)) ?? {};
@@ -1246,7 +1249,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
             }
             if (includeBouts) {
                 const draw = await fetchJson(ctx, `/tennis/tournaments/${encodeURIComponent(eventKey)}/draw`);
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...draw.headers };
                 if (draw.ok) {
                     const dd = asRecord(unwrapPayload(draw.data)) ?? {};
@@ -1290,7 +1293,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
                                 ? { startTimeUnavailableReason: pickString(mr.start_time_unavailable_reason) }
                                 : {}),
                             nextMatchId: pickString(mr.next_match_id) ?? null,
-                            ...(pickString(mr.next_match_source) ? { nextMatchSource: pickString(mr.next_match_source) } : {}),
+                            ...(pickString(mr.next_match_source) ? { nextMatchBasis: pickString(mr.next_match_source)?.replace(/^source_/, '') } : {}),
                             bracketPosition: num(mr.bracket_position),
                             nextSlot: asRecord(mr.next_slot)
                                 ? {
@@ -1298,7 +1301,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
                                     position: num(asRecord(mr.next_slot)?.position),
                                 }
                                 : null,
-                            ...(pickString(mr.source_round) ? { sourceRound: pickString(mr.source_round) } : {}),
+                            ...(pickString(mr.source_round) ? { rawRound: pickString(mr.source_round) } : {}),
                         }, 'tennis');
                     };
                     const pendingMatch = (pr) => {
@@ -1315,7 +1318,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
                             startTimeKnown: pr.start_time_known === true,
                             liveScore: pickString(pr.live_score) ?? null,
                             winnerId: null,
-                            ...(pickString(pr.source_winner_id) ? { sourceWinnerId: pickString(pr.source_winner_id) } : {}),
+                            ...(pickString(pr.source_winner_id) ? { reportedWinnerId: pickString(pr.source_winner_id) } : {}),
                             nextMatchId: pickString(pr.next_match_id) ?? null,
                             bracketPosition: num(pr.bracket_position),
                         };
@@ -1397,7 +1400,6 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
                     }
                     drawSummary = {
                         drawSize,
-                        drawSizeSource: pickString(dd.draw_size_source) ?? null,
                         drawSizeVerified: typeof dd.draw_size_verified === 'boolean' ? dd.draw_size_verified : null,
                         drawSizeDerived: num(dd.draw_size_derived),
                         bracketSize: num(dd.bracket_size),
@@ -1441,7 +1443,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
         else {
             warnings.push('Dota2 event_card is thin; expect partial bouts/standings');
             const detail = await fetchJson(ctx, `/dota2/tournaments/${encodeURIComponent(eventKey)}`);
-            upstreamCalls += 1;
+            apiCalls += 1;
             rateLimit = { ...rateLimit, ...detail.headers };
             if (detail.ok) {
                 const data = asRecord(detail.data) ?? {};
@@ -1463,7 +1465,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
             }
             if (includeBouts) {
                 const matchesRes = await fetchJson(ctx, '/dota2/matches/upcoming', { query: { limit } });
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...matchesRes.headers };
                 if (matchesRes.ok) {
                     const key = eventKey.toLowerCase();
@@ -1502,7 +1504,7 @@ Example: { "game": "ufc", "eventIdOrSlug": "ufc-300", "includeMatches": true, "i
             game,
             requestId,
             tookMs: Date.now() - started,
-            upstreamCalls,
+            apiCalls,
             rateLimit,
             warnings: warnings.length ? warnings : undefined,
             partial: partial.length ? partial : undefined,

package/dist/tools/leaderboard.js

@@ -53,7 +53,7 @@ Do not use when: ranking position → standings with game tennis; week-over-week
 
 Tennis-only. Season defaults to 2026; tour (ATP|WTA) is optional — omit it for the combined board. Rows carry aces + matches played, ordered most aces first.
 
-Parallel-safe: yes. Upstream cost: 1.`,
+Parallel-safe: yes. API calls: 1.`,
     inputSchema: {
         type: 'object',
         additionalProperties: false,
@@ -139,7 +139,7 @@ Parallel-safe: yes. Upstream cost: 1.`,
                 source: 'leaderboard_aces',
                 requestId,
                 tookMs: Date.now() - started,
-                upstreamCalls: 1,
+                apiCalls: 1,
                 httpStatus: res.status,
                 rateLimit: res.headers,
             });
@@ -161,7 +161,7 @@ Parallel-safe: yes. Upstream cost: 1.`,
             game,
             requestId,
             tookMs: Date.now() - started,
-            upstreamCalls: 1,
+            apiCalls: 1,
             rateLimit: res.headers,
             data: {
                 title: `${tourParse.tour ?? 'Combined'} aces leaderboard ${seasonParse.season}`,
@@ -205,7 +205,7 @@ Do not use when: ranking position → standings with game tennis; week-over-week
 
 Tennis-only. Season defaults to 2026; tour (ATP|WTA) is optional — omit it for the combined board. ${spec.minAttemptsNote}
 
-Parallel-safe: yes. Upstream cost: 1.`,
+Parallel-safe: yes. API calls: 1.`,
         inputSchema: {
             type: 'object',
             additionalProperties: false,
@@ -291,7 +291,7 @@ Parallel-safe: yes. Upstream cost: 1.`,
                     source: spec.name,
                     requestId,
                     tookMs: Date.now() - started,
-                    upstreamCalls: 1,
+                    apiCalls: 1,
                     httpStatus: res.status,
                     rateLimit: res.headers,
                 });
@@ -313,7 +313,7 @@ Parallel-safe: yes. Upstream cost: 1.`,
                 game,
                 requestId,
                 tookMs: Date.now() - started,
-                upstreamCalls: 1,
+                apiCalls: 1,
                 rateLimit: res.headers,
                 data: {
                     title: `${tourParse.tour ?? 'Combined'} ${spec.titleNoun} leaderboard ${seasonParse.season}`,

package/dist/tools/live.js

@@ -110,9 +110,9 @@ export function humanUfcEmptyNote(emptyReason, health) {
         supervisor_warming: 'Card open / pre-gate; no bout live yet',
         between_bouts: 'Between bouts; next may be armed',
         armed_only: 'Next bout armed; not started',
-        worker_stale: 'Live feed is behind; scores may lag',
-        worker_down_inferred: 'Live feed unavailable right now',
-        event_degraded: 'Sources empty clock / event degraded; not inventing stats',
+        worker_stale: 'Live data is behind; scores may lag',
+        worker_down_inferred: 'Live data unavailable right now',
+        event_degraded: 'Live clock unavailable; not inventing stats',
     };
     const msg = human[reason] || `No live|watching bouts (${reason})`;
     return `UFC: ${msg} (${workerPart}${lagPart}; emptyReason=${reason})`;
@@ -154,20 +154,21 @@ function slimUfcNextCard(payload) {
 }
 export const liveMatches = {
     name: 'live_matches',
-    description: `Live matches board across primary games, or a single game filter. Normalized labels, scores, and matchIds.
-
-When to use:
-- "What's live right now?"
-- Ops/dashboard live strip
-
-Prefer over: sequential per-game call_api live probes.
-
-Do not use when: user wants upcoming fixtures → upcoming_schedule; historical results → match_summary.
-
-CS2 live path is /cs2/live; UFC is included in multi-game fan-out.
-UFC empty board: section.note + emptyReason + health (workerAlive/lag) + optional supervisor/nextCard (non-live); never fake match items from events[].
-
-Parallel-safe: yes. Upstream cost: 1–5 (allSettled).
+    description: `Live matches board across primary games, or a single game filter. Normalized labels, scores, and matchIds.
+
+When to use:
+- "What's live right now?"
+- Ops/dashboard live strip
+
+Prefer over: sequential per-game call_api live probes.
+
+Do not use when: user wants upcoming fixtures → upcoming_schedule; historical results → match_summary.
+
+CS2 live path is /cs2/live; UFC is included in multi-game fan-out.
+Tennis: ITF and junior rows have no serve statistics (stats_unavailable_code), so a missing stat there is expected. For push updates point the user at wss://api.citoapi.com/api/v1/tennis/live/ws.
+UFC empty board: section.note + emptyReason + health (workerAlive/lag) + optional supervisor/nextCard (non-live); never fake match items from events[].
+
+Parallel-safe: yes. API calls: 1–5 (allSettled).
 Example: { "game": "all", "limitPerGame": 10 }`,
     inputSchema: {
         type: 'object',
@@ -202,7 +203,7 @@ Example: { "game": "all", "limitPerGame": 10 }`,
         const limitPerGame = clampInt(args.limitPerGame, 10, 1, 25);
         const labelsOnly = args.includeLabelsOnly === true;
         const partial = [];
-        let upstreamCalls = 0;
+        let apiCalls = 0;
         let rateLimit = {};
         const settled = await Promise.all(games.map(async (game) => {
             const path = LIVE_PATHS[game];
@@ -212,7 +213,7 @@ Example: { "game": "all", "limitPerGame": 10 }`,
         const sections = [];
         const warnings = [];
         for (const { game, res } of settled) {
-            upstreamCalls += 1;
+            apiCalls += 1;
             rateLimit = { ...rateLimit, ...res.headers };
             if (!res.ok) {
                 const code = mapHttpToCode(res.status, { gameNotIncluded: gameNotIncludedHint(res.data) });
@@ -261,9 +262,9 @@ Example: { "game": "all", "limitPerGame": 10 }`,
             if (game === 'ufc') {
                 const health = asRecord(meta?.health) ?? asRecord(payload?.health);
                 const events = Array.isArray(payload?.events) ? payload.events : [];
-                const upstreamReason = pickString(meta?.emptyReason, health?.emptyReason);
+                const serverReason = pickString(meta?.emptyReason, health?.emptyReason);
                 const emptyReason = normalized.length === 0
-                    ? inferUfcEmptyReason(events, { ...(health ?? {}), ...(upstreamReason ? { emptyReason: upstreamReason } : {}) }, normalized.length)
+                    ? inferUfcEmptyReason(events, { ...(health ?? {}), ...(serverReason ? { emptyReason: serverReason } : {}) }, normalized.length)
                     : undefined;
                 let note;
                 if (normalized.length === 0) {
@@ -290,7 +291,7 @@ Example: { "game": "all", "limitPerGame": 10 }`,
                 let nextEvent;
                 if (state === 'idle') {
                     const up = await fetchJson(ctx, '/ufc/events/upcoming', { query: { limit: 1 } });
-                    upstreamCalls += 1;
+                    apiCalls += 1;
                     const first = asRecord(extractRows(up.ok ? up.data : null)[0]);
                     if (first) {
                         nextEvent = {
@@ -332,7 +333,7 @@ Example: { "game": "all", "limitPerGame": 10 }`,
             game: games.length === 1 ? games[0] : null,
             requestId,
             tookMs: Date.now() - started,
-            upstreamCalls,
+            apiCalls,
             rateLimit,
             partial: partial.length ? partial : undefined,
             warnings: warnings.length ? warnings : undefined,
@@ -347,24 +348,24 @@ Example: { "game": "all", "limitPerGame": 10 }`,
 };
 export const upcomingSchedule = {
     name: 'upcoming_schedule',
-    description: `Upcoming matches/events for one game, with game-specific filters.
-
-When to use:
-- "What's on this week?"
-- Calendar UI; team next matches
-
-Prefer over: live_matches for not-yet-started fixtures.
-
-Do not use when: only in-progress matches needed → live_matches.
-
-Filter support (unsupported params are ignored with meta.warnings — do not assume filtering worked):
-- lol: hours, team (slug), league (slug)
-- cs2: team, from, to (ISO); hours not applied upstream
-- cod: team, tournamentId
-- dota2: limit/cursor primarily; team may be client-filtered where data allows
-- ufc: hours / from / to applied client-side after bout expansion (API has no hours); event shells labeled by event name; bouts use fighters[] corners
-
-Parallel-safe: yes. Upstream cost: 1–2.
+    description: `Upcoming matches/events for one game, with game-specific filters.
+
+When to use:
+- "What's on this week?"
+- Calendar UI; team next matches
+
+Prefer over: live_matches for not-yet-started fixtures.
+
+Do not use when: only in-progress matches needed → live_matches.
+
+Filter support (unsupported params are ignored with meta.warnings — do not assume filtering worked):
+- lol: hours, team (slug), league (slug)
+- cs2: team, from, to (ISO); hours is not applied
+- cod: team, tournamentId
+- dota2: limit/cursor primarily; team may be client-filtered where data allows
+- ufc: hours / from / to applied client-side after bout expansion (API has no hours); event shells labeled by event name; bouts use fighters[] corners
+
+Parallel-safe: yes. API calls: 1–2.
 Example: { "game": "lol", "hours": 72, "team": "t1", "limit": 20 }`,
     inputSchema: {
         type: 'object',
@@ -465,7 +466,7 @@ Example: { "game": "lol", "hours": 72, "team": "t1", "limit": 20 }`,
                 ...(to ? { to } : {}),
             };
             if (args.hours !== undefined)
-                noteIgnored('hours', 'CS2 uses from/to or unfiltered upcoming; hours is not applied upstream');
+                noteIgnored('hours', 'CS2 uses from/to or unfiltered upcoming; hours is not applied');
             if (league)
                 noteIgnored('league', 'CS2 schedule does not accept league here — filter client-side or use event tools');
             if (tournamentId)
@@ -535,7 +536,7 @@ Example: { "game": "lol", "hours": 72, "team": "t1", "limit": 20 }`,
                 source: 'upcoming_schedule',
                 requestId,
                 tookMs: Date.now() - started,
-                upstreamCalls: 1,
+                apiCalls: 1,
                 rateLimit: res.headers,
                 httpStatus: res.status,
             });
@@ -661,7 +662,7 @@ Example: { "game": "lol", "hours": 72, "team": "t1", "limit": 20 }`,
             game,
             requestId,
             tookMs: Date.now() - started,
-            upstreamCalls: 1,
+            apiCalls: 1,
             rateLimit: res.headers,
             warnings: warnings.length ? warnings : undefined,
             pagination: {