cito-mcp 0.5.2 → 0.5.4

package/dist/tools/meta.js

@@ -476,7 +476,7 @@ const TOOL_CATALOG = [
         name: 'list_routes',
         outcome: 'Index of raw REST routes from the live OpenAPI spec (method, path, summary)',
         parallelSafe: true,
-        games: [...PRIMARY_GAMES, 'fortnite'],
+        games: [...PRIMARY_GAMES, 'fortnite', 'apex'],
         jobs: ['app_scaffold'],
         exampleArgs: { game: 'ufc', q: 'rankings' },
         preferOver: ['guessing a REST path for call_api', 'fetching the full 90KB spec by hand'],
@@ -486,7 +486,7 @@ const TOOL_CATALOG = [
         name: 'call_api',
         outcome: 'Allowlisted raw REST escape hatch (unshaped data.raw)',
         parallelSafe: true,
-        games: [...PRIMARY_GAMES, 'fortnite'],
+        games: [...PRIMARY_GAMES, 'fortnite', 'apex'],
         jobs: ['app_scaffold'],
         exampleArgs: { method: 'GET', path: '/cs2/rankings/teams', queryJson: '{"limit":20}' },
         preferOver: [],
@@ -558,6 +558,14 @@ const GAMES_META = [
     { id: 'cs2', label: 'Counter-Strike 2', depth: 'deep', notes: 'Prefixed ids; live path /cs2/live; trends/rankings' },
     { id: 'dota2', label: 'Dota 2', depth: 'thin', notes: 'Numeric ids; radar; no standings/roster endpoints' },
     { id: 'cod', label: 'Call of Duty (CDL)', depth: 'medium', notes: 'Org slugs; CDL standings; UUID match ids' },
+    {
+        id: 'apex',
+        label: 'Apex Legends (ALGS)',
+        depth: 'thin',
+        notes: 'call_api only (no curated tools): /apex/algs/events, /apex/algs/events/{seriesId} (+ /scores, /bans), ' +
+            '/apex/algs/matches, /apex/algs/players (+ /search), /apex/algs/global-stats/{eventId} (+ /players, /legends), ' +
+            '/apex/algs/transactions, /apex/algs/regions, /apex/algs/maps. Not in the OpenAPI spec yet (list_routes { game: "apex" } returns this path list as a note).',
+    },
     {
         id: 'ufc',
         label: 'UFC / MMA',
@@ -776,20 +784,38 @@ Example: { "includeGameProbes": true }`,
         else if (keyValid) {
             includedGames.push(...PRIMARY_GAMES);
         }
+        const healthBody = health.ok && health.data && typeof health.data === 'object' && !Array.isArray(health.data)
+            ? health.data
+            : null;
+        const limits = healthBody?.rateLimit && typeof healthBody.rateLimit === 'object'
+            ? healthBody.rateLimit
+            : null;
+        const perMinute = limits?.perMinute && typeof limits.perMinute === 'object'
+            ? limits.perMinute
+            : null;
+        const headerRate = rateLimit;
+        const tier = headerRate.tier ?? (typeof healthBody?.tier === 'string' ? healthBody.tier : null);
+        const mergedRateLimit = {
+            ...headerRate,
+            tier,
+            limit: headerRate.limit ?? (typeof perMinute?.limit === 'number' ? perMinute.limit : null),
+        };
         return successEnvelope({
             source: 'api_health',
             game: null,
             requestId,
             tookMs: Date.now() - started,
             upstreamCalls,
-            rateLimit,
+            rateLimit: mergedRateLimit,
             data: {
                 reachable,
                 keyValid,
                 answeredBy,
                 httpStatus: authedStatus,
-                tier: rateLimit.tier ?? null,
-                rateLimit,
+                tier,
+                plan: typeof healthBody?.plan === 'string' ? healthBody.plan : null,
+                rateLimit: mergedRateLimit,
+                ...(limits ? { limits } : {}),
                 includedGames,
                 ...(probes.length ? { probes } : {}),
             },
@@ -804,6 +830,7 @@ const ALLOWLIST_PREFIXES = [
     '/cod',
     '/ufc',
     '/fortnite',
+    '/apex',
     '/tennis',
     '/raf',
     '/bkfc',
@@ -840,7 +867,7 @@ Prefer curated tools for all standard jobs (live, schedule, profiles, standings,
 
 Do not use when: a curated tool covers the outcome. Avoid parallel storms; same plan rate limits apply.
 
-Path must start with / and match allowlisted prefixes: /health, /lol, /cs2, /dota2, /cod, /ufc, /fortnite, /tennis, /raf, /bkfc, /bellator, /pride, /strikeforce, /wec, /dream, /elitexc, /affliction, /pfl, /oktagon, /mma.
+Path must start with / and match allowlisted prefixes: /health, /lol, /cs2, /dota2, /cod, /ufc, /fortnite, /apex, /tennis, /raf, /bkfc, /bellator, /pride, /strikeforce, /wec, /dream, /elitexc, /affliction, /pfl, /oktagon, /mma.
 Rejects absolute URLs and path traversal → PATH_NOT_ALLOWED.
 
 Parallel-safe: yes but discouraged in bulk. Upstream cost: 1.
@@ -901,7 +928,7 @@ Example: { "method": "GET", "path": "/cs2/rankings/teams", "queryJson": "{\\"pag
                 source: 'call_api',
                 requestId,
                 tookMs: Date.now() - started,
-                hint: 'Use prefixes /health /lol /cs2 /dota2 /cod /ufc /fortnite /tennis /raf /bkfc /bellator /pride /strikeforce /wec /dream /elitexc /affliction /pfl /oktagon /mma',
+                hint: 'Use prefixes /health /lol /cs2 /dota2 /cod /ufc /fortnite /apex /tennis /raf /bkfc /bellator /pride /strikeforce /wec /dream /elitexc /affliction /pfl /oktagon /mma',
             });
         }
         let query = {};
@@ -962,6 +989,10 @@ Example: { "method": "GET", "path": "/cs2/rankings/teams", "queryJson": "{\\"pag
 const SPEC_OMITS = {
     tennis: 'The published OpenAPI spec documents no /tennis paths, but tennis routes exist and work (players, matches, h2h, rankings, tournaments, live). Use the curated tools with game tennis, or call_api with /tennis/* paths.',
     lol: 'The published OpenAPI spec documents no /lol paths, but LoL routes exist and work. Use the curated LoL tools (live_matches, upcoming_schedule, team_profile, standings, player_profile); for raw access, /lol/* is allowlisted for call_api even though it is undocumented.',
+    apex: 'The published OpenAPI spec documents no /apex paths, but the Apex Legends ALGS routes exist and work through call_api: '
+        + 'GET /apex/algs/events, /apex/algs/events/{seriesId} (+ /scores, /bans), /apex/algs/matches, /apex/algs/players (+ /search?q=), '
+        + '/apex/algs/global-stats (+ /{eventId}, /{eventId}/players, /{eventId}/legends), /apex/algs/transactions, /apex/algs/tournaments, '
+        + '/apex/algs/regions, /apex/algs/maps.',
 };
 export const listRoutes = {
     name: 'list_routes',
@@ -1002,10 +1033,10 @@ Example: { "game": "ufc", "q": "rankings" }`,
         const started = Date.now();
         const requestId = newRequestId();
         const gameRaw = typeof args.game === 'string' ? args.game.toLowerCase().trim() : '';
-        if (gameRaw && !gameRaw.match(/^(lol|cs2|dota2|cod|ufc|fortnite|tennis|raf|bkfc|bellator|pride|strikeforce|wec|dream|elitexc|affliction|pfl|oktagon|mma)$/)) {
+        if (gameRaw && !gameRaw.match(/^(lol|cs2|dota2|cod|ufc|fortnite|apex|tennis|raf|bkfc|bellator|pride|strikeforce|wec|dream|elitexc|affliction|pfl|oktagon|mma)$/)) {
             return errorEnvelope({
                 code: 'UNSUPPORTED_GAME',
-                message: `unsupported game "${gameRaw}"; use lol|cs2|dota2|cod|ufc|fortnite|tennis|raf|bkfc|bellator|pride|strikeforce|wec|dream|elitexc|affliction|pfl|oktagon|mma`,
+                message: `unsupported game "${gameRaw}"; use lol|cs2|dota2|cod|ufc|fortnite|apex|tennis|raf|bkfc|bellator|pride|strikeforce|wec|dream|elitexc|affliction|pfl|oktagon|mma`,
                 game: null,
                 source: 'list_routes',
                 requestId,
@@ -1028,7 +1059,7 @@ Example: { "game": "ufc", "q": "rankings" }`,
                 httpStatus: res.status,
                 recover: [
                     'Call list_capabilities for curated tools that need no route knowledge',
-                    'call_api accepts /health, /lol, /cs2, /dota2, /cod, /ufc, /fortnite, /tennis, /raf, /bkfc, /bellator, /pride, /strikeforce, /wec, /dream, /elitexc, /affliction, /pfl, /oktagon, /mma',
+                    'call_api accepts /health, /lol, /cs2, /dota2, /cod, /ufc, /fortnite, /apex, /tennis, /raf, /bkfc, /bellator, /pride, /strikeforce, /wec, /dream, /elitexc, /affliction, /pfl, /oktagon, /mma',
                 ],
             });
         }

package/dist/tools/types.js

@@ -1,4 +1,5 @@
-import { ENVELOPE_OUTPUT_SCHEMA, toMcpResult } from '../envelope.js';
+import { ENVELOPE_OUTPUT_SCHEMA, applyRateLimitContext, toMcpResult } from '../envelope.js';
+import { newCallBudget } from '../pacing.js';
 export const READ_TOOL_ANNOTATIONS = {
     readOnlyHint: true,
     destructiveHint: false,
@@ -138,11 +139,19 @@ export async function runTool(def, args, ctx) {
                 ],
             }));
         }
-        const result = await def.handler(args ?? {}, ctx);
+        const budget = ctx.budget ?? newCallBudget();
+        const result = await def.handler(args ?? {}, { ...ctx, budget });
         if (result && typeof result === 'object' && 'content' in result) {
-            return result;
+            const mcp = result;
+            const structured = mcp.structuredContent;
+            if (budget.rateLimit && structured && typeof structured === 'object' && 'ok' in structured) {
+                const enriched = applyRateLimitContext(structured, budget.rateLimit, budget.retries);
+                if (enriched !== structured)
+                    return toMcpResult(enriched);
+            }
+            return mcp;
         }
-        return toMcpResult(result);
+        return toMcpResult(applyRateLimitContext(result, budget.rateLimit, budget.retries));
     }
     catch (error) {
         const { errorEnvelope, toMcpResult: toResult } = await import('../envelope.js');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cito-mcp",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "Standalone MCP server for the Cito esports and sports API — curated outcome tools for agents (live scoreboards, round economy, opening duels, clutches, vetoes, rosters, tennis, mma).",
   "type": "module",
   "homepage": "https://cito.gg",