cito-mcp 0.5.8 → 0.6.1

package/dist/tools/combat.js

@@ -82,7 +82,7 @@ function payload(res) {
     const body = asRecord(res.data);
     return body && 'data' in body ? body.data : res.data;
 }
-function upstreamNotes(res) {
+function responseNotes(res) {
     const meta = asRecord(asRecord(res.data)?.meta);
     const out = {};
     if (typeof meta?.note === 'string')
@@ -114,7 +114,7 @@ function archiveGap(d, league, message, recover, calls = 0) {
         source: d.source,
         requestId: d.requestId,
         tookMs: Date.now() - d.started,
-        upstreamCalls: calls,
+        apiCalls: calls,
         retryable: false,
         recover,
     });
@@ -178,21 +178,21 @@ function begin(source) {
 }
 export const combatEvents = {
     name: 'combat_events',
-    description: `RAF wrestling, BKFC bare-knuckle or MMA archive (Bellator, PRIDE, Strikeforce, WEC, DREAM, EliteXC, Affliction) events.
-
-When to use:
-- "When is the next RAF / BKFC card?", "recent BKFC results", "PRIDE results", "Bellator cards from 2015", schedule pages
-- Getting an event slug for combat_card
-
-Each event carries slug, name, date, local start time + timezone, venue/location, status and bout counts.
-The MMA archives (bellator, pride, strikeforce, wec, dream, elitexc, affliction, and mma = all of them, each
-event tagged with its real promotion) are closed: "when" defaults to "recent" (newest card first), and "upcoming"
-returns an empty list with data.note instead of failing.
-
-Prefer over: call_api /{league}/events.
-Do not use when: you already have the event slug and want its bouts (combat_card).
-
-Parallel-safe: yes. Upstream cost: 1.
+    description: `RAF wrestling, BKFC bare-knuckle or MMA archive (Bellator, PRIDE, Strikeforce, WEC, DREAM, EliteXC, Affliction) events.
+
+When to use:
+- "When is the next RAF / BKFC card?", "recent BKFC results", "PRIDE results", "Bellator cards from 2015", schedule pages
+- Getting an event slug for combat_card
+
+Each event carries slug, name, date, local start time + timezone, venue/location, status and bout counts.
+The MMA archives (bellator, pride, strikeforce, wec, dream, elitexc, affliction, and mma = all of them, each
+event tagged with its real promotion) are closed: "when" defaults to "recent" (newest card first), and "upcoming"
+returns an empty list with data.note instead of failing.
+
+Prefer over: call_api /{league}/events.
+Do not use when: you already have the event slug and want its bouts (combat_card).
+
+Parallel-safe: yes. API calls: 1.
 Example: { "league": "bkfc", "when": "upcoming", "limit": 5 }`,
     inputSchema: {
         type: 'object',
@@ -228,7 +228,7 @@ Example: { "league": "bkfc", "when": "upcoming", "limit": 5 }`,
                 source: d.source,
                 requestId: d.requestId,
                 tookMs: Date.now() - d.started,
-                upstreamCalls: 0,
+                apiCalls: 0,
             });
         }
         const res = await fetchJson(ctx, `/${league}/events/${when}`, { query: { limit } });
@@ -236,35 +236,35 @@ Example: { "league": "bkfc", "when": "upcoming", "limit": 5 }`,
             return httpError(d, league, res, `${league} ${when} events`);
         const events = extractRows(res.data).slice(0, limit);
         return successEnvelope({
-            data: { league, leagueName: LEAGUE_NAMES[league], when, count: events.length, events, ...upstreamNotes(res) },
+            data: { league, leagueName: LEAGUE_NAMES[league], when, count: events.length, events, ...responseNotes(res) },
             game: league,
             source: d.source,
             requestId: d.requestId,
             tookMs: Date.now() - d.started,
-            upstreamCalls: 1,
+            apiCalls: 1,
             rateLimit: res.headers,
         });
     },
 };
 export const combatCard = {
     name: 'combat_card',
-    description: `COMPOSITE fight card for one RAF, BKFC or MMA archive event: event identity + bouts in running order with results.
-
-When to use:
-- "RAF 14 card", "BKFC 95 results", "Bellator 142 card", "PRIDE 34", "who won the main event at the last BKFC?"
-- Event pages and results pages
-
-event accepts a slug (e.g. "raf13", "bkfc-95-newark", "bellator-142", "pride-34", "wec-48") or "next" / "last".
-Bouts come main event first; each carries weight class, title stakes, both sides (athletes for RAF, red/blue fighters for BKFC with
-punch totals, red/blue fighters for the MMA archives with UFC-format totals and ufcFighterSlug), and once finished
-the winner and result (RAF: score, takedowns, method; BKFC/MMA archives: method, round, time).
-MMA archives are closed: event defaults to "last" (the most recent card; for mma, across every promotion), and
-"next" is a non-retryable NOT_IMPLEMENTED (there are no upcoming cards).
-
-Prefer over: combat_events + call_api per bout.
-Do not use when: you need one bout's period/round breakdown (combat_bout).
-
-Parallel-safe: yes. Upstream cost: 2–3.
+    description: `COMPOSITE fight card for one RAF, BKFC or MMA archive event: event identity + bouts in running order with results.
+
+When to use:
+- "RAF 14 card", "BKFC 95 results", "Bellator 142 card", "PRIDE 34", "who won the main event at the last BKFC?"
+- Event pages and results pages
+
+event accepts a slug (e.g. "raf13", "bkfc-95-newark", "bellator-142", "pride-34", "wec-48") or "next" / "last".
+Bouts come main event first; each carries weight class, title stakes, both sides (athletes for RAF, red/blue fighters for BKFC with
+punch totals, red/blue fighters for the MMA archives with UFC-format totals and ufcFighterSlug), and once finished
+the winner and result (RAF: score, takedowns, method; BKFC/MMA archives: method, round, time).
+MMA archives are closed: event defaults to "last" (the most recent card; for mma, across every promotion), and
+"next" is a non-retryable NOT_IMPLEMENTED (there are no upcoming cards).
+
+Prefer over: combat_events + call_api per bout.
+Do not use when: you need one bout's period/round breakdown (combat_bout).
+
+Parallel-safe: yes. API calls: 2–3.
 Example: { "league": "raf", "event": "last" }`,
     inputSchema: {
         type: 'object',
@@ -298,7 +298,7 @@ Example: { "league": "raf", "event": "last" }`,
                 return httpError(d, league, list, `${league} ${which} events`);
             const first = asRecord(extractRows(list.data)[0]);
             if (!first?.slug) {
-                const windowed = !!upstreamNotes(list).historyWindow;
+                const windowed = !!responseNotes(list).historyWindow;
                 return errorEnvelope({
                     code: 'NOT_FOUND',
                     message: windowed
@@ -308,8 +308,8 @@ Example: { "league": "raf", "event": "last" }`,
                     source: d.source,
                     requestId: d.requestId,
                     tookMs: Date.now() - d.started,
-                    upstreamCalls: calls,
-                    ...(windowed ? { retryable: false, details: { historyWindow: upstreamNotes(list).historyWindow } } : {}),
+                    apiCalls: calls,
+                    ...(windowed ? { retryable: false, details: { historyWindow: responseNotes(list).historyWindow } } : {}),
                 });
             }
             slug = String(first.slug);
@@ -338,7 +338,7 @@ Example: { "league": "raf", "event": "last" }`,
             source: d.source,
             requestId: d.requestId,
             tookMs: Date.now() - d.started,
-            upstreamCalls: calls,
+            apiCalls: calls,
             rateLimit: bouts.headers ?? ev.headers,
             partial,
             truncated: rows.length > limit
@@ -349,22 +349,22 @@ Example: { "league": "raf", "event": "last" }`,
 };
 export const combatBout = {
     name: 'combat_bout',
-    description: `One RAF, BKFC or MMA archive bout in full, with its scoring breakdown.
-
-RAF: winner, method (decision / tech fall / pin / injury), final score, takedowns, and per-PERIOD scores.
-BKFC: winner, method, round, time, and per-ROUND punch stats for red and blue (landed/thrown, head/body,
-distance/clinch, knockdowns). BKFC round stats need the Starter plan; on Free they come back as a partial note.
-MMA archives (Bellator, PRIDE, Strikeforce, WEC, DREAM, EliteXC, Affliction, mma): winner, method, round, time,
-finish (position / submission), referee, judges' scores, each corner's whole-fight totals, and per-ROUND official
-stats in UFC's format (significantStrikes "13 of 18", totalStrikes, takedowns, head/body/leg, distance/clinch/ground,
-knockdowns, submissionAttempts, reversals, controlTime "1:42"). PRIDE's first round is 10 minutes. The archives are
-older than the Free/Starter history window: on those plans rounds come back as a HISTORY_WINDOW_EXCEEDED partial
-note while the result still returns.
-
-Get boutId from combat_card or combat_athlete (e.g. "raf13--belal-muhammad--colby-covington", "bellator-5600").
-MMA archive bout ids are "<promotion>-<fightId>"; a bare fight id resolves in any MMA archive league.
-
-Parallel-safe: yes. Upstream cost: 1–2.
+    description: `One RAF, BKFC or MMA archive bout in full, with its scoring breakdown.
+
+RAF: winner, method (decision / tech fall / pin / injury), final score, takedowns, and per-PERIOD scores.
+BKFC: winner, method, round, time, and per-ROUND punch stats for red and blue (landed/thrown, head/body,
+distance/clinch, knockdowns). BKFC round stats need the Starter plan; on Free they come back as a partial note.
+MMA archives (Bellator, PRIDE, Strikeforce, WEC, DREAM, EliteXC, Affliction, mma): winner, method, round, time,
+finish (position / submission), referee, judges' scores, each corner's whole-fight totals, and per-ROUND official
+stats in UFC's format (significantStrikes "13 of 18", totalStrikes, takedowns, head/body/leg, distance/clinch/ground,
+knockdowns, submissionAttempts, reversals, controlTime "1:42"). PRIDE's first round is 10 minutes. The archives are
+older than the Free/Starter history window: on those plans rounds come back as a HISTORY_WINDOW_EXCEEDED partial
+note while the result still returns.
+
+Get boutId from combat_card or combat_athlete (e.g. "raf13--belal-muhammad--colby-covington", "bellator-5600").
+MMA archive bout ids are "<promotion>-<fightId>"; a bare fight id resolves in any MMA archive league.
+
+Parallel-safe: yes. API calls: 1–2.
 Example: { "league": "bkfc", "boutId": "bkfc-fight-night-bethlehem--gregoris-cisneros--ryan-petersen" }`,
     inputSchema: {
         type: 'object',
@@ -414,7 +414,7 @@ Example: { "league": "bkfc", "boutId": "bkfc-fight-night-bethlehem--gregoris-cis
             source: d.source,
             requestId: d.requestId,
             tookMs: Date.now() - d.started,
-            upstreamCalls: parts ? 2 : 1,
+            apiCalls: parts ? 2 : 1,
             rateLimit: bout.headers,
             partial,
         });
@@ -422,24 +422,24 @@ Example: { "league": "bkfc", "boutId": "bkfc-fight-night-bethlehem--gregoris-cis
 };
 export const combatAthlete = {
     name: 'combat_athlete',
-    description: `COMPOSITE RAF athlete / BKFC or MMA archive fighter page: profile + recent bouts + career stats.
-
-When to use:
-- "Kyle Snyder's RAF record", "Arlovski BKFC stats", "Tito Ortiz in Bellator", "Fedor's PRIDE record", athlete/fighter profile pages
-
-athlete accepts a slug ("kyle-snyder") or a name ("Andrei Arlovski"); names are resolved through the league's
-search, and several matches return AMBIGUOUS_ENTITY with candidates. Profile carries record, division, nickname,
-country, official headshot (+ its credit — show it with the image). Career stats need the Starter plan; on Free
-they come back as a partial note while profile and history still return.
-MMA archives: profile is bio (DOB, height, reach, stance, hometown) + the record in that promotion's archive (not the
-whole career); stats are career totals in UFC's format. league "mma" covers every archived promotion at once, and
-data.recordByPromotion splits the record ({ pride: {...}, strikeforce: {...} }). A fighter we also hold a UFC record
-for keeps the SAME slug as /ufc/fighters/{slug}: data.ufcFighterSlug is set then (a UFC slug is accepted here too).
-Keep the records apart: archive fights never belong in a UFC answer.
-
-Prefer over: call_api profile + history + stats separately.
-
-Parallel-safe: yes. Upstream cost: 2–4.
+    description: `COMPOSITE RAF athlete / BKFC or MMA archive fighter page: profile + recent bouts + career stats.
+
+When to use:
+- "Kyle Snyder's RAF record", "Arlovski BKFC stats", "Tito Ortiz in Bellator", "Fedor's PRIDE record", athlete/fighter profile pages
+
+athlete accepts a slug ("kyle-snyder") or a name ("Andrei Arlovski"); names are resolved through the league's
+search, and several matches return AMBIGUOUS_ENTITY with candidates. Profile carries record, division, nickname,
+country, official headshot (+ its credit — show it with the image). Career stats need the Starter plan; on Free
+they come back as a partial note while profile and history still return.
+MMA archives: profile is bio (DOB, height, reach, stance, hometown) + the record in that promotion's archive (not the
+whole career); stats are career totals in UFC's format. league "mma" covers every archived promotion at once, and
+data.recordByPromotion splits the record ({ pride: {...}, strikeforce: {...} }). A fighter we also hold a UFC record
+for keeps the SAME slug as /ufc/fighters/{slug}: data.ufcFighterSlug is set then (a UFC slug is accepted here too).
+Keep the records apart: archive fights never belong in a UFC answer.
+
+Prefer over: call_api profile + history + stats separately.
+
+Parallel-safe: yes. API calls: 2–4.
 Example: { "league": "raf", "athlete": "Kyle Snyder", "historyLimit": 5 }`,
     inputSchema: {
         type: 'object',
@@ -502,7 +502,7 @@ Example: { "league": "raf", "athlete": "Kyle Snyder", "historyLimit": 5 }`,
             source: d.source,
             requestId: d.requestId,
             tookMs: Date.now() - d.started,
-            upstreamCalls: 1 + (history ? 1 : 0) + (stats ? 1 : 0),
+            apiCalls: 1 + (history ? 1 : 0) + (stats ? 1 : 0),
             rateLimit: profile.headers,
             partial,
         });
@@ -510,13 +510,13 @@ Example: { "league": "raf", "athlete": "Kyle Snyder", "historyLimit": 5 }`,
 };
 export const combatH2h = {
     name: 'combat_h2h',
-    description: `Head-to-head between two RAF athletes, two BKFC fighters or two MMA archive fighters: record and every meeting.
-
-Accepts slugs or names for both sides (names resolve through the league's search). MMA archive meetings are only
-the ones on that promotion's cards (league "mma": every archived promotion); UFC meetings are a UFC question
-(head_to_head).
-
-Parallel-safe: yes. Upstream cost: 1–3.
+    description: `Head-to-head between two RAF athletes, two BKFC fighters or two MMA archive fighters: record and every meeting.
+
+Accepts slugs or names for both sides (names resolve through the league's search). MMA archive meetings are only
+the ones on that promotion's cards (league "mma": every archived promotion); UFC meetings are a UFC question
+(head_to_head).
+
+Parallel-safe: yes. API calls: 1–3.
 Example: { "league": "bkfc", "athleteA": "ryan-petersen", "athleteB": "gregoris-cisneros" }`,
     inputSchema: {
         type: 'object',
@@ -557,23 +557,23 @@ Example: { "league": "bkfc", "athleteA": "ryan-petersen", "athleteB": "gregoris-
             source: d.source,
             requestId: d.requestId,
             tookMs: Date.now() - d.started,
-            upstreamCalls: 1,
+            apiCalls: 1,
             rateLimit: res.headers,
         });
     },
 };
 export const combatRankings = {
     name: 'combat_rankings',
-    description: `Champions and rankings: RAF title holders per division, BKFC official rankings + champions.
-
-BKFC: omit division for every division's ranked list (champion, interim champion, ranked fighters), or pass one
-(e.g. "heavyweight", "womens-flyweight"). RAF has no ranked lists; it returns every title and its holder, or one
-division's detail when division is given (e.g. "men-heavyweight").
-The MMA archives (bellator, pride, strikeforce, wec, dream, elitexc, affliction, mma) have no rankings: they return a
-non-retryable NOT_IMPLEMENTED.
-Never answer with UFC rankings instead.
-
-Parallel-safe: yes. Upstream cost: 1.
+    description: `Champions and rankings: RAF title holders per division, BKFC official rankings + champions.
+
+BKFC: omit division for every division's ranked list (champion, interim champion, ranked fighters), or pass one
+(e.g. "heavyweight", "womens-flyweight"). RAF has no ranked lists; it returns every title and its holder, or one
+division's detail when division is given (e.g. "men-heavyweight").
+The MMA archives (bellator, pride, strikeforce, wec, dream, elitexc, affliction, mma) have no rankings: they return a
+non-retryable NOT_IMPLEMENTED.
+Never answer with UFC rankings instead.
+
+Parallel-safe: yes. API calls: 1.
 Example: { "league": "bkfc", "division": "heavyweight" }`,
     inputSchema: {
         type: 'object',
@@ -610,7 +610,7 @@ Example: { "league": "bkfc", "division": "heavyweight" }`,
             source: d.source,
             requestId: d.requestId,
             tookMs: Date.now() - d.started,
-            upstreamCalls: 1,
+            apiCalls: 1,
             rateLimit: res.headers,
         });
     },

package/dist/tools/index.js

@@ -12,6 +12,7 @@ import { cs2Tools } from './cs2.js';
 import { tournamentTools } from './tournaments.js';
 import { scheduleTools } from './schedule.js';
 import { combatTools } from './combat.js';
+import { webhookTools } from './webhooks.js';
 export const allTools = [
     ...metaTools.filter((t) => t.name === 'list_capabilities' || t.name === 'api_health'),
     ...resolveTools,
@@ -27,6 +28,7 @@ export const allTools = [
     ...insightTools,
     ...cs2Tools,
     ...combatTools,
+    ...webhookTools,
     ...metaTools.filter((t) => t.name === 'list_routes' || t.name === 'call_api'),
 ];
 export function getTool(name) {