cito-mcp 0.5.1 → 0.5.2

package/dist/tools/cs2.js

@@ -362,6 +362,79 @@ export const cs2RosterTransfers = {
         });
     },
 };
+const POSITION_VIEWS = ['grenades', 'positions', 'heatmap'];
+const POSITION_FILTERS = ['type', 'side', 'round', 'player', 'team', 'kind', 'grid', 'map', 'days', 'limit'];
+export const cs2Positions = {
+    name: 'cs2_positions',
+    description: 'CS2 positional data from parsed demos. With mapId: view=grenades (every grenade with landing spot, thrower, round, duration), '
+        + 'view=positions (grenades, bomb plants/defuses and kills with attacker/victim spots in one timeline) or view=heatmap (counts per radar cell; '
+        + 'kind=utility|smoke|flash|he|molotov|decoy|bomb_plant|bomb_defuse|kill|death). With playerId instead: that player\'s grenades across recent maps '
+        + '(pass map for a heatmap). Every point has game coordinates and a 0..1 radar point. Read the response notes and null fields for what is not recorded.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            mapId: stringSchema('Map/game id from match maps, e.g. "cs2-match-2399437-map-1".', 'cs2-match-2399437-map-1'),
+            playerId: stringSchema('Player id or slug (e.g. "ropz"). Use instead of mapId for one player across maps.', 'ropz'),
+            view: { type: 'string', enum: [...POSITION_VIEWS], description: 'For mapId: grenades (default), positions or heatmap.' },
+            type: stringSchema('Grenade type: smoke, flash, he, molotov or decoy.'),
+            side: stringSchema('T or CT.'),
+            round: { type: 'integer', minimum: 1, description: 'Only this round.' },
+            player: stringSchema('With mapId: only this player (id or nickname).'),
+            team: stringSchema('With mapId + view=grenades: only this team (id or name).'),
+            kind: stringSchema('view=heatmap: utility, smoke, flash, he, molotov, decoy, bomb_plant, bomb_defuse, kill or death. view=positions: grenade,bomb,kill.'),
+            grid: { type: 'integer', minimum: 4, maximum: 128, description: 'Heatmap cells per side (default 32).' },
+            map: stringSchema('With playerId: map name (Mirage, Inferno...) to get a heatmap.'),
+            days: { type: 'integer', minimum: 1, maximum: 3650, description: 'With playerId: look-back window in days (default 180).' },
+            limit: limitSchema({ default: 200, max: 5000 }),
+        },
+        additionalProperties: false,
+    },
+    annotations: READ_TOOL_ANNOTATIONS,
+    handler: async (args, ctx) => {
+        const reqId = newRequestId();
+        const mapId = typeof args.mapId === 'string' ? args.mapId.trim() : '';
+        const playerId = typeof args.playerId === 'string' ? args.playerId.trim() : '';
+        if (!mapId && !playerId) {
+            return errorEnvelope({
+                code: 'VALIDATION',
+                message: 'mapId or playerId is required',
+                game: 'cs2',
+                source: 'cs2_positions',
+                requestId: reqId,
+            });
+        }
+        const view = POSITION_VIEWS.includes(args.view) ? String(args.view) : 'grenades';
+        const path = playerId
+            ? `/cs2/players/${encodeURIComponent(playerId)}/utility`
+            : `/cs2/maps/${encodeURIComponent(mapId)}/${view === 'grenades' ? 'utility' : view}`;
+        const query = {};
+        for (const key of POSITION_FILTERS) {
+            const value = args[key];
+            if (typeof value === 'string' && value.trim())
+                query[key] = value.trim();
+            else if (typeof value === 'number' && Number.isFinite(value))
+                query[key] = value;
+        }
+        const res = await fetchJson(ctx, path, { query });
+        if (!res.ok) {
+            return errorEnvelope({
+                code: mapHttpToCode(res.status),
+                message: `CS2 positions fetch failed: ${res.status} on ${path}`,
+                game: 'cs2',
+                source: 'cs2_positions',
+                requestId: reqId,
+                httpStatus: res.status,
+            });
+        }
+        return successEnvelope({
+            data: unwrapPayload(res.data),
+            game: 'cs2',
+            source: 'cs2_positions',
+            requestId: reqId,
+            rateLimit: res.headers,
+        });
+    },
+};
 export const cs2Tools = [
     cs2LiveScoreboard,
     cs2RoundEconomy,
@@ -371,4 +444,5 @@ export const cs2Tools = [
     cs2UtilityLeaderboard,
     cs2VetoSequence,
     cs2RosterTransfers,
+    cs2Positions,
 ];

package/dist/tools/meta.js

@@ -442,6 +442,16 @@ const TOOL_CATALOG = [
         preferOver: ['unindexed round event aggregation'],
         doNotUse: 'For standard weapon ratings',
     },
+    {
+        name: 'cs2_positions',
+        outcome: 'CS2 grenade landing spots, bomb plants, kill/death spots and radar heatmaps for a map or a player',
+        parallelSafe: true,
+        games: ['cs2'],
+        jobs: ['match_page', 'player_form'],
+        exampleArgs: { mapId: 'cs2-match-2399437-map-1', view: 'heatmap', kind: 'smoke' },
+        preferOver: ['call_api /cs2/maps/{mapId}/utility|positions|heatmap', 'parsing /cs2/games/{id}/rounds events for coordinates'],
+        doNotUse: 'For live matches (positions come from the demo, after the map ends)',
+    },
     {
         name: 'cs2_veto_sequence',
         outcome: 'Map pick/ban sequence and veto history for a CS2 match',

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "cito-mcp",
-  "version": "0.5.1",
-  "description": "Standalone MCP server for the Cito esports and sports API \u2014 curated outcome tools for agents (live scoreboards, round economy, opening duels, clutches, vetoes, rosters, tennis, mma).",
+  "version": "0.5.2",
+  "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",
-  "//REPOSITORY": "Intentionally NOT set. cito-api-scraper and cito.gg are PRIVATE repos and must stay that way, so a repository URL pointing at them would render as a broken 404 link on the public npm page and would not satisfy MCP Registry npm ownership validation. Set this only if a PUBLIC repo for this package is ever created (e.g. achillesscriptsvip/cito-mcp with this directory as root) \u2014 then use `git+https://github.com/OWNER/REPO.git` and mirror it in the `mcpName`/server.json `name` pair. Do not point it at the private monorepo.",
+  "//REPOSITORY": "Intentionally NOT set. cito-api-scraper and cito.gg are PRIVATE repos and must stay that way, so a repository URL pointing at them would render as a broken 404 link on the public npm page and would not satisfy MCP Registry npm ownership validation. Set this only if a PUBLIC repo for this package is ever created (e.g. achillesscriptsvip/cito-mcp with this directory as root) — then use `git+https://github.com/OWNER/REPO.git` and mirror it in the `mcpName`/server.json `name` pair. Do not point it at the private monorepo.",
   "keywords": [
     "mcp",
     "model-context-protocol",