cito-mcp 0.3.13 → 0.3.14

package/dist/tools/insight.js

@@ -210,6 +210,10 @@ export function composeH2H(game, sideA, sideB, rows, limit) {
     const bl = sideB.toLowerCase();
     const meetings = rows
         .map((row) => normalizeMatch(game, row))
+        // A meeting is a fight that happened. The upcoming bout between the two
+        // sides sits in the same history list and must not count as a prior
+        // meeting, or every preview reports the fight it is previewing as H2H.
+        .filter((m) => m.status === 'completed')
         .filter((m) => {
         const s1 = [m.team1?.id, m.team1?.slug, m.team1?.name].filter(Boolean).map((x) => String(x).toLowerCase());
         const s2 = [m.team2?.id, m.team2?.slug, m.team2?.name].filter(Boolean).map((x) => String(x).toLowerCase());
@@ -223,7 +227,7 @@ export function composeH2H(game, sideA, sideB, rows, limit) {
     return {
         meetings: meetings.length,
         lastMeetings: meetings.slice(0, 5),
-        recordNote: meetings.length ? `${meetings.length} meetings found in window` : 'No H2H meetings in window',
+        recordNote: meetings.length ? `${meetings.length} past meetings found in window` : 'No past H2H meetings in window',
     };
 }
 export const matchPreview = {
@@ -434,6 +438,31 @@ Example: { "game": "lol", "teamA": "t1", "teamB": "gen-g", "includeH2H": true, "
             }
         }
         // Factual briefing lines only — never structural meta like "roster loaded".
+        // Called with teamA + teamB and no matchId, context stayed empty
+        // ({ matchId:null, event:null, startTime:null }) for a headliner whose
+        // own form list had all three. Side A's history carries the booked bout
+        // against side B; that IS the context.
+        if (!matchId && context.matchId == null) {
+            const bl = String(teamB ?? '').toLowerCase();
+            const booked = sideARes.recentForm.find((m) => {
+                if (!m || (m.status !== 'upcoming' && m.status !== 'live'))
+                    return false;
+                const sides = [m.team1?.slug, m.team1?.id, m.team1?.name, m.team2?.slug, m.team2?.id, m.team2?.name]
+                    .filter(Boolean).map((x) => String(x).toLowerCase());
+                return sides.some((x) => x === bl || x.includes(bl) || bl.includes(x));
+            });
+            if (booked) {
+                context = {
+                    ...context,
+                    matchId: booked.matchId !== 'unknown' ? booked.matchId : null,
+                    startTime: booked.startTime,
+                    event: booked.event,
+                    eventName: booked.event?.name ?? null,
+                    status: booked.status,
+                    label: booked.label,
+                };
+            }
+        }
         const talkingPoints = [];
         const sideAName = pickString(asRecord(sideARes.entity)?.name, teamA) ?? teamA;
         const sideBName = pickString(asRecord(sideBRes.entity)?.name, teamB) ?? teamB;

package/dist/tools/live.js

@@ -323,12 +323,37 @@ Example: { "game": "all", "limitPerGame": 10 }`,
                     : undefined;
                 const supervisor = normalized.length === 0 && events.length ? slimUfcSupervisorEvents(events) : undefined;
                 const nextCard = normalized.length === 0 ? slimUfcNextCard(payload) : undefined;
+                // A one-word answer to "is anything wrong?". health{} is the worker's
+                // raw view and on an idle day it reads ok:false / workerAlive:false,
+                // which looks broken. state says what the board means: idle (nothing
+                // on, nothing due), live, stale (a hot card with a dead feed), or
+                // degraded. nextEvent tells an idle board what comes next, fetched
+                // only when the board is empty so a live night pays nothing for it.
+                const state = normalized.length > 0 ? 'live'
+                    : emptyReason === 'worker_stale' || emptyReason === 'worker_down_inferred' ? 'stale'
+                        : emptyReason === 'event_degraded' ? 'degraded'
+                            : 'idle';
+                let nextEvent;
+                if (state === 'idle') {
+                    const up = await fetchJson(ctx, '/ufc/events/upcoming', { query: { limit: 1 } });
+                    upstreamCalls += 1;
+                    const first = asRecord(extractRows(up.ok ? up.data : null)[0]);
+                    if (first) {
+                        nextEvent = {
+                            slug: pickString(first.slug) ?? null,
+                            name: pickString(first.title, first.name) ?? null,
+                            startsAt: pickString(first.startsAt, first.date, first.startTime) ?? null,
+                        };
+                    }
+                }
                 sections.push({
                     game,
                     count: normalized.length,
                     ok: true,
+                    state,
                     note,
                     emptyReason,
+                    nextEvent,
                     health: healthStrip,
                     supervisor,
                     nextCard,

package/dist/tools/match.js

@@ -3,7 +3,7 @@
  */
 import { extractRows, fetchJson, gameNotIncludedHint, asRecord, pickString, unwrapPayload, } from '../client.js';
 import { errorEnvelope, mapHttpToCode, newRequestId, partialFromRejection, successEnvelope, } from '../envelope.js';
-import { normalizeMatch } from './normalize.js';
+import { normalizeMatch, normalizeUfcMethod } from './normalize.js';
 import { boolSchema, gameSchema, isPrimaryGame, parseGame, stringSchema, } from './types.js';
 async function getSection(ctx, path, query) {
     return fetchJson(ctx, path, { query });
@@ -78,7 +78,10 @@ function matchCore(game, matchId, raw) {
         team2: m.team2,
         event: m.event,
         league: m.league,
-        method: pickString(r.method, r.resultMethod) ?? null,
+        // One enum on every surface. match_summary carried the source spelling
+        // here while the profile carried the enum, so consumers normalised anyway.
+        method: (game === 'ufc' ? normalizeUfcMethod(pickString(r.method, r.resultMethod)) : pickString(r.method, r.resultMethod)) ?? null,
+        methodRaw: pickString(r.method, r.resultMethod) ?? null,
         winner: (() => {
             // Never name a winner while play is in progress: the score fallback
             // below reads "who is ahead", which mid-match is a lead, not a result.

package/dist/tools/player.js

@@ -457,7 +457,9 @@ Example: { "game": "cs2", "playerId": "cs2-player-1", "recentLimit": 10, "includ
                 if (res.ok) {
                     const metrics = unwrapPayload(res.data);
                     form = { summary: 'UFC fighter stats', trend: null, window: null, metrics };
-                    seasonStats = metrics;
+                    // form.metrics and seasonStats were the same object twice, byte
+                    // for byte. One copy. seasonStats stays for the games that have
+                    // seasons; a fighter has a career, not a season.
                 }
                 else {
                     partial.push(partialFromRejection('form', {
@@ -551,15 +553,25 @@ Example: { "game": "cs2", "playerId": "cs2-player-1", "recentLimit": 10, "includ
                     ...(player.slug ? { slug: player.slug } : {}),
                 },
             },
-            data: {
-                player,
-                currentTeam,
-                recentMatches,
-                form,
-                career,
-                radar,
-                seasonStats,
-            },
+            // Two rules, so a consumer can tell the difference. A field that can
+            // never apply to this game is OMITTED (a fighter has no team, no radar,
+            // no season). A field that applies but is unknown is NULL (division,
+            // flag). Sending team:null on every UFC profile forever said nothing.
+            data: game === 'ufc'
+                ? {
+                    player: (({ team, role, nationality, ...rest }) => { void team; void role; void nationality; return rest; })(player),
+                    recentMatches,
+                    form,
+                }
+                : {
+                    player,
+                    currentTeam,
+                    recentMatches,
+                    form,
+                    career,
+                    radar,
+                    seasonStats,
+                },
         });
     },
 };

package/dist/tools/standings.js

@@ -125,6 +125,7 @@ Example: { "game": "cod", "season": "2026", "limit": 50 }`,
             stage: stringSchema('Stage key (COD / LoL).'),
             division: stringSchema('UFC division key.'),
             limit: limitSchema({ default: 50, max: 100 }),
+            cursor: stringSchema('Opaque cursor from pagination.nextCursor. UFC world scope spans every division; page with it rather than raising limit.'),
         },
     },
     handler: async (args, ctx) => {
@@ -143,6 +144,9 @@ Example: { "game": "cod", "season": "2026", "limit": 50 }`,
         }
         const game = gameParse.game;
         const limit = clampInt(args.limit, 50, 1, 100);
+        // Cursor is a plain offset. The whole table is in memory (UFC world scope
+        // is 176 rows), so nothing fancier is needed to walk every division.
+        const offset = Math.max(0, Number.parseInt(String(args.cursor ?? '0'), 10) || 0);
         const scope = typeof args.scope === 'string' ? args.scope : undefined;
         const leagueId = typeof args.leagueId === 'string' ? args.leagueId : undefined;
         const tournamentId = typeof args.tournamentId === 'string' ? args.tournamentId : undefined;
@@ -321,7 +325,7 @@ Example: { "game": "cod", "season": "2026", "limit": 50 }`,
         // so limit=50 stops a third of the way through flyweight; a consumer needs
         // to know that happened rather than receive total:null and guess.
         let allRows = extractRows(res.data).map((row, i) => normalizeStandingRow(row, i));
-        let rows = allRows.slice(0, limit);
+        let rows = allRows.slice(offset, offset + limit);
         // UFC rankings may be nested by division
         if (game === 'ufc' && rows.length === 0) {
             const obj = asRecord(res.data) ?? {};
@@ -334,8 +338,29 @@ Example: { "game": "cod", "season": "2026", "limit": 50 }`,
                 }
             }
             allRows = nested.map((row, i) => normalizeStandingRow(row, i));
-            rows = allRows.slice(0, limit);
+            rows = allRows.slice(offset, offset + limit);
         }
+        if (game === 'ufc') {
+            rows = rows.map((row) => {
+                const { played, wins, losses, draws, points, mapDiff, streak, ...rest } = row;
+                void played;
+                void wins;
+                void losses;
+                void draws;
+                void points;
+                void mapDiff;
+                void streak;
+                return rest;
+            });
+        }
+        const standingsPagination = {
+            limit,
+            offset,
+            total: allRows.length,
+            hasMore: offset + rows.length < allRows.length,
+            nextCursor: offset + rows.length < allRows.length ? String(offset + rows.length) : null,
+            prevCursor: offset > 0 ? String(Math.max(0, offset - limit)) : null,
+        };
         const obj = asRecord(res.data);
         const upstreamMeta = asRecord(obj?.meta) ?? {};
         const dataQuality = asRecord(upstreamMeta.dataQuality) ?? {};
@@ -364,6 +389,7 @@ Example: { "game": "cod", "season": "2026", "limit": 50 }`,
                 : 'Rankings dataFreshness=cached or stale.');
         }
         return successEnvelope({
+            pagination: standingsPagination,
             source: 'standings',
             game,
             requestId,

package/dist/tools/team.js

@@ -920,6 +920,9 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
         }
         const meetings = rows
             .map((row) => normalizeMatch(game, row))
+            // Past fights only. The booked bout between the two sides is in the
+            // same list and is not a meeting yet.
+            .filter((m) => m.status === 'completed')
             .filter((m) => sidesMatch(m, matchA, matchB))
             .filter((m) => {
             if (!fromIso && !toIso)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cito-mcp",
-  "version": "0.3.13",
+  "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).",
   "type": "module",
   "bin": {