cito-mcp 0.5.4 → 0.5.5

package/README.md

@@ -550,6 +550,13 @@ claude mcp add cito -e CITO_API_KEY=cito_… "--" npx -y cito-mcp
 
 ## Changelog (summary)
 
+### 0.5.5
+
+- **`cs2_veto_sequence` returns the veto.** It called the match head-to-head route and answered with the two teams' head-to-head record (`cs2_team_h2h`) instead of the veto (0.5.1 to 0.5.4). It now calls `/cs2/matches/{matchId}/veto`: `vetoOrder` (every ban, pick and the decider, in order), `vetoStatus` (`complete`, `pending`, `forfeit_no_veto`, `unavailable`), `bestOf` and the maps.
+- **`cs2_opening_duels` with `playerId` works.** It called a route the API does not have (every call was a 404). A player's opening duels now come from the career totals: `openingKills` / `openingDeaths` (null when fewer than 90% of the player's maps record them), the recorded sums, coverage and success rate.
+- **`cs2_team_map_stats` takes `opponentId`** for a map-by-map comparison of two teams (`/cs2/teams/{team}/map-pool/vs/{opponent}`: win rates, round difference, pick/ban/decider rates, their meetings per map, edge). Map rows carry `inPool` / `poolStatus`.
+- `cs2_round_economy` points to `/cs2/maps/{mapId}/economy` for per-player money each round.
+
 ### 0.5.4
 
 - **Apex Legends through `call_api`.** `/apex/...` paths (ALGS events, standings, scores) were refused with `PATH_NOT_ALLOWED` although they are a live REST product. They are allowed now and listed in `list_capabilities`.

package/dist/tools/cs2.js

@@ -59,7 +59,8 @@ export const cs2LiveScoreboard = {
 };
 export const cs2RoundEconomy = {
     name: 'cs2_round_economy',
-    description: 'Round-by-round tactical economy for a CS2 map. Classifies every round buy type (Full Buy, Force Buy, Semi-Eco, Full Eco), team equipment spend, freeze-time equipment values, and loss bonus counter.',
+    description: 'Round-by-round tactical economy for a CS2 map. Classifies every round buy type (Full Buy, Force Buy, Semi-Eco, Full Eco), team equipment spend, freeze-time equipment values, and loss bonus counter. '
+        + 'For money per PLAYER each round (startMoney, moneySpent, moneyLeft, equipmentValue, buyType, purchases) use call_api GET /cs2/maps/{mapId}/economy (by=player|team|round; paid plans).',
     inputSchema: {
         type: 'object',
         properties: {
@@ -123,9 +124,9 @@ export const cs2OpeningDuels = {
         const rawPlayer = typeof args.playerId === 'string' ? args.playerId.trim() : '';
         const limit = clampInt(args.limit, 20, 1, 100);
         const path = rawPlayer
-            ? `/cs2/players/${encodeURIComponent(rawPlayer)}/opening-duels`
+            ? `/cs2/players/${encodeURIComponent(rawPlayer)}/career`
             : `/cs2/stats/opening-duels`;
-        const res = await fetchJson(ctx, path, { query: { limit } });
+        const res = await fetchJson(ctx, path, rawPlayer ? {} : { query: { limit } });
         if (!res.ok) {
             return errorEnvelope({
                 code: mapHttpToCode(res.status),
@@ -137,8 +138,29 @@ export const cs2OpeningDuels = {
             });
         }
         const payload = unwrap(res.data);
+        let data = payload;
+        if (rawPlayer) {
+            const p = asRecord(payload) ?? {};
+            const t = asRecord(p.totals) ?? {};
+            const fk = typeof t.openingKillsRecorded === 'number' ? t.openingKillsRecorded : null;
+            const fd = typeof t.openingDeathsRecorded === 'number' ? t.openingDeathsRecorded : null;
+            data = {
+                entityType: 'cs2_player_opening_duels',
+                playerId: p.playerId ?? null,
+                playerNickname: p.playerNickname ?? null,
+                maps: t.maps ?? null,
+                openingKills: t.openingKills ?? null,
+                openingDeaths: t.openingDeaths ?? null,
+                openingKillsRecorded: fk,
+                openingDeathsRecorded: fd,
+                openingDuelMaps: t.openingDuelMaps ?? null,
+                openingDuelCoverage: t.openingDuelCoverage ?? null,
+                openingDuelSuccessRate: fk !== null && fd !== null && fk + fd > 0 ? Math.round((fk / (fk + fd)) * 10000) / 10000 : null,
+                source: `/cs2/players/${rawPlayer}/career`,
+            };
+        }
         return successEnvelope({
-            data: payload,
+            data,
             game: 'cs2',
             source: 'cs2_opening_duels',
             requestId: reqId,
@@ -188,16 +210,18 @@ export const cs2Clutches = {
 };
 export const cs2TeamMapStats = {
     name: 'cs2_team_map_stats',
-    description: 'Team win rates, round win rates, and CT/T side win splits across the competitive map pool (Mirage, Inferno, Nuke, Dust2, Ancient, Anubis, Vertigo) over the last 30 or 90 days.',
+    description: 'Team win rates, round win rates, and CT/T side win splits per map over the last N days. Each map carries inPool / poolStatus (current Active Duty pool) and removedAt. '
+        + 'Pass opponentId to compare two teams map by map instead (GET /cs2/teams/{team}/map-pool/vs/{opponent}): win rates, round difference, pick/ban/decider rates, their meetings on each map and an edge per map.',
     inputSchema: {
         type: 'object',
         properties: {
             teamId: stringSchema('Team ID or slug (e.g. "cs2-team-4608" or "natus-vincere"). Required.', 'cs2-team-4608'),
             days: {
                 type: 'integer',
-                description: 'Timeframe in days: 30, 90, 180, or 365 (default 90).',
+                description: 'Timeframe in days: 30, 90, 180, or 365 (default 90; with opponentId the API default is 180).',
                 default: 90,
             },
+            opponentId: stringSchema('Optional opponent team ID or slug (e.g. "mouz"): returns the map-pool head-to-head of the two teams.', 'mouz'),
         },
         required: ['teamId'],
         additionalProperties: false,
@@ -215,9 +239,12 @@ export const cs2TeamMapStats = {
                 requestId: reqId,
             });
         }
-        const days = typeof args.days === 'number' ? args.days : 90;
-        const path = `/cs2/teams/${encodeURIComponent(rawTeam)}/map-stats`;
-        const res = await fetchJson(ctx, path, { query: { days } });
+        const rawOpponent = typeof args.opponentId === 'string' ? args.opponentId.trim() : '';
+        const days = typeof args.days === 'number' ? args.days : rawOpponent ? undefined : 90;
+        const path = rawOpponent
+            ? `/cs2/teams/${encodeURIComponent(rawTeam)}/map-pool/vs/${encodeURIComponent(rawOpponent)}`
+            : `/cs2/teams/${encodeURIComponent(rawTeam)}/map-stats`;
+        const res = await fetchJson(ctx, path, days === undefined ? {} : { query: { days } });
         if (!res.ok) {
             return errorEnvelope({
                 code: mapHttpToCode(res.status),
@@ -276,7 +303,8 @@ export const cs2UtilityLeaderboard = {
 };
 export const cs2VetoSequence = {
     name: 'cs2_veto_sequence',
-    description: 'Map pick/ban veto sequence for a CS2 match. Shows which team banned which map, map picks, and decider map in chronological order.',
+    description: 'Map pick/ban veto sequence for a CS2 match (GET /cs2/matches/{matchId}/veto). Returns vetoOrder (each ban, pick and the decider in order, with the team), '
+        + 'vetoStatus (complete | pending | forfeit_no_veto | unavailable; vetoOrder is [] unless complete), bestOf and the maps.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -298,8 +326,7 @@ export const cs2VetoSequence = {
                 requestId: reqId,
             });
         }
-        const cleanId = rawId.replace(/^cs2-match-/, '');
-        const path = `/cs2/matches/${encodeURIComponent(cleanId)}/head-to-head`;
+        const path = `/cs2/matches/${encodeURIComponent(rawId)}/veto`;
         const res = await fetchJson(ctx, path);
         if (!res.ok) {
             return errorEnvelope({
@@ -312,10 +339,8 @@ export const cs2VetoSequence = {
             });
         }
         const payload = unwrap(res.data);
-        const r = asRecord(payload);
-        const veto = r?.veto ?? r?.vetoSequence ?? payload;
         return successEnvelope({
-            data: veto,
+            data: payload,
             game: 'cs2',
             source: 'cs2_veto_sequence',
             requestId: reqId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cito-mcp",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "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",