cito-mcp 0.5.8 → 0.6.1

package/dist/tools/team.js

@@ -31,18 +31,18 @@ function numberOrNull(value) {
 }
 export const teamProfile = {
     name: 'team_profile',
-    description: `Team/org card: identity, roster, recent matches, and form/trends/radar when available.
-
-When to use:
-- Team page / "who is on this roster?"
-- Builder team screen sample
-
-Prefer over: separate roster + matches + detail via call_api.
-
-Do not use when: UFC fighters → player_profile; unknown name → resolve_entity first.
-Dota may return partial roster (API gap). Prefer slug for lol/cod; teamId for cs2.
-
-Parallel-safe: yes. Upstream cost: 2–4.
+    description: `Team/org card: identity, roster, recent matches, and form/trends/radar when available.
+
+When to use:
+- Team page / "who is on this roster?"
+- Builder team screen sample
+
+Prefer over: separate roster + matches + detail via call_api.
+
+Do not use when: UFC fighters → player_profile; unknown name → resolve_entity first.
+Dota may return partial roster (API gap). Prefer slug for lol/cod; teamId for cs2.
+
+Parallel-safe: yes. API calls: 2–4.
 Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
     inputSchema: {
         type: 'object',
@@ -128,12 +128,12 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
         const idOrSlug = teamId || slug;
         const recentLimit = clampInt(args.recentLimit, 10, 1, 25);
         const partial = [];
-        let upstreamCalls = 0;
+        let apiCalls = 0;
         let rateLimit = {};
         let teamRaw = null;
         if (game === 'lol') {
             const res = await fetchJson(ctx, `/lol/teams/${encodeURIComponent(slug || idOrSlug)}`);
-            upstreamCalls += 1;
+            apiCalls += 1;
             rateLimit = res.headers;
             if (!res.ok) {
                 return errorEnvelope({
@@ -143,7 +143,7 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
                     source: 'team_profile',
                     requestId,
                     tookMs: Date.now() - started,
-                    upstreamCalls,
+                    apiCalls,
                     httpStatus: res.status,
                     rateLimit: res.headers,
                 });
@@ -155,7 +155,7 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
             const res = directId
                 ? await fetchJson(ctx, `/cs2/teams/${encodeURIComponent(idOrSlug)}`)
                 : await fetchJson(ctx, '/cs2/teams', { query: { search: idOrSlug, limit: 5 } });
-            upstreamCalls += 1;
+            apiCalls += 1;
             rateLimit = res.headers;
             if (!res.ok) {
                 return errorEnvelope({
@@ -165,7 +165,7 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
                     source: 'team_profile',
                     requestId,
                     tookMs: Date.now() - started,
-                    upstreamCalls,
+                    apiCalls,
                     httpStatus: res.status,
                     rateLimit: res.headers,
                     recover: [
@@ -192,7 +192,7 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
                         source: 'team_profile',
                         requestId,
                         tookMs: Date.now() - started,
-                        upstreamCalls,
+                        apiCalls,
                         rateLimit: res.headers,
                         recover: [
                             'Call resolve_entity with the team name and type=team',
@@ -204,7 +204,7 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
         }
         else if (game === 'dota2') {
             const res = await fetchJson(ctx, '/dota2/teams', { query: { search: idOrSlug, limit: 5 } });
-            upstreamCalls += 1;
+            apiCalls += 1;
             rateLimit = res.headers;
             if (!res.ok) {
                 return errorEnvelope({
@@ -214,7 +214,7 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
                     source: 'team_profile',
                     requestId,
                     tookMs: Date.now() - started,
-                    upstreamCalls,
+                    apiCalls,
                     httpStatus: res.status,
                     rateLimit: res.headers,
                     recover: [
@@ -238,7 +238,7 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
                         source: 'team_profile',
                         requestId,
                         tookMs: Date.now() - started,
-                        upstreamCalls,
+                        apiCalls,
                         rateLimit: res.headers,
                         recover: [
                             'Call resolve_entity with the team name and type=team',
@@ -250,7 +250,7 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
         }
         else if (game === 'cod') {
             const res = await fetchJson(ctx, `/cod/orgs/${encodeURIComponent(slug || idOrSlug)}`);
-            upstreamCalls += 1;
+            apiCalls += 1;
             rateLimit = res.headers;
             if (!res.ok) {
                 return errorEnvelope({
@@ -260,7 +260,7 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
                     source: 'team_profile',
                     requestId,
                     tookMs: Date.now() - started,
-                    upstreamCalls,
+                    apiCalls,
                     httpStatus: res.status,
                     rateLimit: res.headers,
                 });
@@ -279,7 +279,7 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
         if (game === 'lol') {
             tasks.push((async () => {
                 const res = await fetchJson(ctx, `/lol/teams/${encodeURIComponent(team.slug || idOrSlug)}/roster`);
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...res.headers };
                 if (res.ok) {
                     roster = {
@@ -301,7 +301,7 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
                 const res = await fetchJson(ctx, `/lol/teams/${encodeURIComponent(slug)}/matches`, {
                     query: { limit: String(recentLimit) },
                 });
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...res.headers };
                 if (res.ok) {
                     const startMs = (row) => {
@@ -340,7 +340,7 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
             const tid = team.id !== 'unknown' ? team.id : idOrSlug;
             tasks.push((async () => {
                 const res = await fetchJson(ctx, `/cs2/teams/${encodeURIComponent(tid)}/roster`);
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...res.headers };
                 if (res.ok) {
                     roster = {
@@ -359,7 +359,7 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
             })());
             tasks.push((async () => {
                 const res = await fetchJson(ctx, `/cs2/teams/${encodeURIComponent(tid)}/trends`);
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...res.headers };
                 if (res.ok)
                     form = unwrapPayload(res.data) ?? res.data;
@@ -375,7 +375,7 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
                 const res = await fetchJson(ctx, '/cs2/matches', {
                     query: { team: tid, limit: recentLimit, status: 'completed' },
                 });
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...res.headers };
                 if (res.ok) {
                     recentMatches = extractRows(res.data)
@@ -400,7 +400,7 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
             }));
             tasks.push((async () => {
                 const res = await fetchJson(ctx, `/dota2/teams/${encodeURIComponent(idOrSlug)}/radar`);
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...res.headers };
                 if (res.ok)
                     form = { radar: res.data };
@@ -414,7 +414,7 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
             })());
             tasks.push((async () => {
                 const res = await fetchJson(ctx, '/dota2/matches/recent', { query: { limit: recentLimit } });
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...res.headers };
                 if (res.ok) {
                     const t = idOrSlug.toLowerCase();
@@ -443,7 +443,7 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
                 const res = await fetchJson(ctx, `/cod/orgs/${encodeURIComponent(team.slug || idOrSlug)}/roster`, {
                     query: { includeFormer: args.includeFormer === true },
                 });
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...res.headers };
                 if (res.ok) {
                     roster = {
@@ -464,7 +464,7 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
                 const res = await fetchJson(ctx, '/cod/matches', {
                     query: { team: team.slug || idOrSlug, limit: recentLimit },
                 });
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...res.headers };
                 if (res.ok) {
                     recentMatches = extractRows(res.data)
@@ -486,7 +486,7 @@ Example: { "game": "lol", "slug": "t1", "recentLimit": 10 }`,
             game,
             requestId,
             tookMs: Date.now() - started,
-            upstreamCalls,
+            apiCalls,
             rateLimit,
             partial: partial.length ? partial : undefined,
             entities: {
@@ -532,19 +532,21 @@ function winnerSide(match, a) {
 }
 export const headToHead = {
     name: 'head_to_head',
-    description: `Composed head-to-head record between two teams, two UFC fighters, or two tennis players. No first-class REST H2H exists — this tool filters match history server-side.
-
-When to use:
-- Rivalry / series record questions
-- Supporting context for previews
-
-Prefer over: agent-side double match-list filtering.
-
-Do not use when: single-side form only → team_profile or player_profile.
-
-Caveat: Dota filters are weaker; expect meta.warnings when data is sparse.
-
-Parallel-safe: yes. Upstream cost: 2–4.
+    description: `Head-to-head record between two teams, two UFC fighters, or two tennis players. Tennis reads the tennis head-to-head route; other games filter match history server-side.
+
+When to use:
+- Rivalry / series record questions
+- Supporting context for previews
+
+Prefer over: agent-side double match-list filtering.
+
+Do not use when: single-side form only → team_profile or player_profile.
+
+Caveat: Dota filters are weaker; expect meta.warnings when data is sparse.
+
+Tennis: pass entityType "player" with sideA and sideB (ids like atp_207989, or names). This tool has no players param; for three or more players use h2h_matrix, which does. limit pages the meetings list only (max 50); every tally covers all meetings. In the payload current_rank is null when a player is not on the tour's latest list: read last_rank. The tiebreak and level_breakdown keys are in data.h2h.
+
+Parallel-safe: yes. API calls: 2–4.
 Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
     inputSchema: {
         type: 'object',
@@ -558,8 +560,8 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
                 default: 'team',
                 description: 'team (default), fighter (UFC), or player (tennis).',
             },
-            sideA: stringSchema('Id or slug for side A.', 'faze'),
-            sideB: stringSchema('Id or slug for side B.', 'navi'),
+            sideA: stringSchema('Id or slug for side A (tennis: atp_207989 or a player name).', 'faze'),
+            sideB: stringSchema('Id or slug for side B (tennis: atp_206173 or a player name).', 'navi'),
             limit: limitSchema({ default: 20, max: 50, description: 'Max meetings returned.' }),
             from: stringSchema('ISO-8601 lower bound on meeting startTime (client filter).'),
             to: stringSchema('ISO-8601 upper bound on meeting startTime (client filter).'),
@@ -598,7 +600,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
         const fromMs = fromIso ? Date.parse(fromIso) : NaN;
         const toMs = toIso ? Date.parse(toIso) : NaN;
         const warnings = [];
-        let upstreamCalls = 0;
+        let apiCalls = 0;
         let rateLimit = {};
         let rows = [];
         let matchA = sideA;
@@ -606,7 +608,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
         if (game === 'cs2') {
             const resolveCs2Side = async (side) => {
                 const res = await fetchJson(ctx, '/cs2/teams', { query: { search: side, limit: 5 } });
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...res.headers };
                 if (!res.ok)
                     return null;
@@ -625,7 +627,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
                 const res = await fetchJson(ctx, `/cs2/teams/${encodeURIComponent(cs2SideA.id)}/vs/${encodeURIComponent(cs2SideB.id)}`, {
                     query: { limit: 50 },
                 });
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...res.headers };
                 if (res.ok) {
                     rows = extractRows(res.data).map((row) => {
@@ -652,7 +654,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
             }
             if (!restH2hOk) {
                 const res = await fetchJson(ctx, '/cs2/matches', { query: { team: sideA, limit: 50 } });
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...res.headers };
                 if (!res.ok) {
                     return errorEnvelope({
@@ -662,7 +664,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
                         source: 'head_to_head',
                         requestId,
                         tookMs: Date.now() - started,
-                        upstreamCalls,
+                        apiCalls,
                         httpStatus: res.status,
                         rateLimit: res.headers,
                     });
@@ -672,7 +674,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
         }
         else if (game === 'cod') {
             const res = await fetchJson(ctx, '/cod/matches', { query: { team: sideA, limit: 50 } });
-            upstreamCalls += 1;
+            apiCalls += 1;
             rateLimit = res.headers;
             if (!res.ok) {
                 return errorEnvelope({
@@ -682,7 +684,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
                     source: 'head_to_head',
                     requestId,
                     tookMs: Date.now() - started,
-                    upstreamCalls,
+                    apiCalls,
                     httpStatus: res.status,
                     rateLimit: res.headers,
                 });
@@ -691,7 +693,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
         }
         else if (game === 'lol') {
             const h2hRes = await fetchJson(ctx, `/lol/teams/${encodeURIComponent(sideA)}/h2h/${encodeURIComponent(sideB)}`, { query: { limit: String(limit) } });
-            upstreamCalls += 1;
+            apiCalls += 1;
             rateLimit = { ...rateLimit, ...h2hRes.headers };
             if (h2hRes.ok) {
                 const env = asRecord(h2hRes.data) ?? {};
@@ -725,7 +727,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
                     game,
                     requestId,
                     tookMs: Date.now() - started,
-                    upstreamCalls,
+                    apiCalls,
                     rateLimit,
                     data: {
                         sideA: { idOrSlug: sideA },
@@ -747,7 +749,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
             const res = await fetchJson(ctx, '/lol/schedule', {
                 query: { teamSlug: sideA, completed: 'true', limit: '50' },
             });
-            upstreamCalls += 1;
+            apiCalls += 1;
             rateLimit = res.headers;
             if (!res.ok) {
                 return errorEnvelope({
@@ -757,7 +759,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
                     source: 'head_to_head',
                     requestId,
                     tookMs: Date.now() - started,
-                    upstreamCalls,
+                    apiCalls,
                     httpStatus: res.status,
                     rateLimit: res.headers,
                 });
@@ -767,7 +769,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
         else if (game === 'dota2') {
             warnings.push('Dota H2H uses recent matches with weak filters; record may be incomplete');
             const res = await fetchJson(ctx, '/dota2/matches/recent', { query: { limit: 50 } });
-            upstreamCalls += 1;
+            apiCalls += 1;
             rateLimit = res.headers;
             if (!res.ok) {
                 return errorEnvelope({
@@ -777,7 +779,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
                     source: 'head_to_head',
                     requestId,
                     tookMs: Date.now() - started,
-                    upstreamCalls,
+                    apiCalls,
                     httpStatus: res.status,
                     rateLimit: res.headers,
                 });
@@ -791,7 +793,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
                 fetchJson(ctx, `/ufc/fighters/${encodeURIComponent(sideA)}/fights`, { query: { limit: 50 } }),
                 fetchJson(ctx, `/ufc/fighters/${encodeURIComponent(sideB)}/fights`, { query: { limit: 50 } }),
             ]);
-            upstreamCalls += 4;
+            apiCalls += 4;
             rateLimit = { ...aRes.headers, ...bRes.headers, ...histA.headers, ...histB.headers };
             if (!aRes.ok || !bRes.ok) {
                 return errorEnvelope({
@@ -801,7 +803,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
                     source: 'head_to_head',
                     requestId,
                     tookMs: Date.now() - started,
-                    upstreamCalls,
+                    apiCalls,
                     recover: [
                         'resolve_entity { game: "ufc", type: "fighter", q } for each name',
                         'Retry head_to_head with returned slugs as sideA/sideB',
@@ -831,7 +833,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
                 if (/^(atp|wta)_\d+$/i.test(side))
                     return { id: side, name: side };
                 const res = await fetchJson(ctx, '/tennis/players/search', { query: { q: side, limit: 3 } });
-                upstreamCalls += 1;
+                apiCalls += 1;
                 rateLimit = { ...rateLimit, ...res.headers };
                 if (!res.ok)
                     return null;
@@ -850,7 +852,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
                     source: 'head_to_head',
                     requestId,
                     tookMs: Date.now() - started,
-                    upstreamCalls,
+                    apiCalls,
                     rateLimit,
                     recover: [
                         'resolve_entity { game: "tennis", type: "player", q } for each name',
@@ -862,7 +864,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
             if (args.limit !== undefined && args.limit !== null)
                 tennisQuery.limit = limit;
             const res = await fetchJson(ctx, '/tennis/h2h', { query: tennisQuery });
-            upstreamCalls += 1;
+            apiCalls += 1;
             rateLimit = { ...rateLimit, ...res.headers };
             if (!res.ok) {
                 return errorEnvelope({
@@ -872,7 +874,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
                     source: 'head_to_head',
                     requestId,
                     tookMs: Date.now() - started,
-                    upstreamCalls,
+                    apiCalls,
                     httpStatus: res.status,
                     rateLimit,
                 });
@@ -888,7 +890,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
                 game,
                 requestId,
                 tookMs: Date.now() - started,
-                upstreamCalls,
+                apiCalls,
                 rateLimit,
                 data: {
                     sideA: { idOrSlug: tA.id, name: sideAName },
@@ -950,7 +952,7 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
             game,
             requestId,
             tookMs: Date.now() - started,
-            upstreamCalls,
+            apiCalls,
             rateLimit,
             warnings: warnings.length ? warnings : undefined,
             data: {
@@ -970,19 +972,19 @@ Example: { "game": "cs2", "sideA": "faze", "sideB": "navi", "limit": 20 }`,
 };
 export const h2hMatrix = {
     name: 'h2h_matrix',
-    description: `Multi-player tennis head-to-head grid: every pair's series record in one comparison matrix.
-
-When to use:
-- Draw/field analysis: how each contender fares against every other (e.g. Alcaraz vs Zverev vs Sinner round-robin records)
-- Group-stage or semifinal-field comparisons
-
-Prefer over: N head_to_head calls for an N-player field; raw matrix via call_api.
-
-Do not use when: a two-player rivalry deep-dive with tiebreak/decider splits → head_to_head; season stat leaders → leaderboard_*; rankings → standings.
-
-Tennis-only. players takes 2-16 ids or names (names resolve via player search). Each matrix cell is "W-L" from the row player's perspective, "-" on the diagonal.
-
-Parallel-safe: yes. Upstream cost: 1 + one search per unresolved name.`,
+    description: `Multi-player tennis head-to-head grid: every pair's series record in one comparison matrix.
+
+When to use:
+- Draw/field analysis: how each contender fares against every other (e.g. Alcaraz vs Zverev vs Sinner round-robin records)
+- Group-stage or semifinal-field comparisons
+
+Prefer over: N head_to_head calls for an N-player field; raw matrix via call_api.
+
+Do not use when: a two-player rivalry deep-dive with tiebreak/decider splits → head_to_head; season stat leaders → leaderboard_*; rankings → standings.
+
+Tennis-only. players takes 2-16 ids or names (names resolve via player search). Each matrix cell is "W-L" from the row player's perspective, "-" on the diagonal.
+
+Parallel-safe: yes. API calls: 1 + one search per unresolved name.`,
     inputSchema: {
         type: 'object',
         additionalProperties: false,
@@ -1042,13 +1044,13 @@ Parallel-safe: yes. Upstream cost: 1 + one search per unresolved name.`,
                 recover: ['Pass 2-16 player ids (atp_207989) or names ("Carlos Alcaraz")'],
             });
         }
-        let upstreamCalls = 0;
+        let apiCalls = 0;
         let rateLimit = {};
         const resolveTennisSide = async (side) => {
             if (/^(atp|wta)_\d+$/i.test(side))
                 return { id: side, name: side };
             const res = await fetchJson(ctx, '/tennis/players/search', { query: { q: side, limit: 3 } });
-            upstreamCalls += 1;
+            apiCalls += 1;
             rateLimit = { ...rateLimit, ...res.headers };
             if (!res.ok)
                 return null;
@@ -1068,7 +1070,7 @@ Parallel-safe: yes. Upstream cost: 1 + one search per unresolved name.`,
                 source: 'h2h_matrix',
                 requestId,
                 tookMs: Date.now() - started,
-                upstreamCalls,
+                apiCalls,
                 rateLimit,
                 recover: [
                     'resolve_entity { game: "tennis", type: "player", q } for each missing name',
@@ -1085,14 +1087,14 @@ Parallel-safe: yes. Upstream cost: 1 + one search per unresolved name.`,
                 source: 'h2h_matrix',
                 requestId,
                 tookMs: Date.now() - started,
-                upstreamCalls,
+                apiCalls,
                 rateLimit,
             });
         }
         const res = await fetchJson(ctx, '/tennis/h2h/matrix', {
             query: { player_ids: ids.join(',') },
         });
-        upstreamCalls += 1;
+        apiCalls += 1;
         rateLimit = { ...rateLimit, ...res.headers };
         if (!res.ok) {
             return errorEnvelope({
@@ -1102,7 +1104,7 @@ Parallel-safe: yes. Upstream cost: 1 + one search per unresolved name.`,
                 source: 'h2h_matrix',
                 requestId,
                 tookMs: Date.now() - started,
-                upstreamCalls,
+                apiCalls,
                 httpStatus: res.status,
                 rateLimit,
             });
@@ -1123,7 +1125,7 @@ Parallel-safe: yes. Upstream cost: 1 + one search per unresolved name.`,
             game,
             requestId,
             tookMs: Date.now() - started,
-            upstreamCalls,
+            apiCalls,
             rateLimit,
             data: {
                 players,

package/dist/tools/tournaments.js

@@ -54,10 +54,10 @@ Tennis-only. Levels accept names (Grand Slam, WTA 1000, ATP 500, Challenger,
 ITF World Tennis Tour, Davis Cup, ...) or raw tier codes (G, M, A, C, D).
 A level name that starts with ATP or WTA also fixes the tour (and conflicts with
 a contradicting tour= argument are rejected), so "WTA 1000" cannot return ATP
-Masters events even though the upstream filter is not tour-aware.
-Note the source does not separate ATP 500 from ATP 250 — both are ATP Tour.
+Masters events.
+The category field reports ATP 500 and ATP 250 both as atp_tour (read tier to tell them apart), and WTA 1000 events as wta_1000.
 
-Parallel-safe: yes. Upstream cost: 1.`,
+Parallel-safe: yes. API calls: 1.`,
     inputSchema: {
         type: 'object',
         additionalProperties: false,
@@ -202,7 +202,7 @@ Parallel-safe: yes. Upstream cost: 1.`,
                 source: 'tournaments',
                 requestId,
                 tookMs: Date.now() - started,
-                upstreamCalls: 1,
+                apiCalls: 1,
                 httpStatus: res.status,
                 rateLimit: res.headers,
             });
@@ -232,10 +232,8 @@ Parallel-safe: yes. Upstream cost: 1.`,
                 .slice(0, 5)
                 .map((t) => `${t.id} (${t.tour})`)
                 .join(', ');
-            warnings.push(`The upstream level filter returned ${contradictions.length} tournament(s) that contradict level="${levelRaw}": ` +
-                `${sample}. They were dropped. The API's level reverse-map is not tour-aware (WTA 1000 resolves to tier codes ` +
-                `PM and M), which is a server-side defect; this tool sends tour=${levelTourPrefix} as well, so a repeat of this ` +
-                `warning means the upstream filter is widening again.`);
+            warnings.push(`The level filter returned ${contradictions.length} tournament(s) that contradict level="${levelRaw}": ` +
+                `${sample}. They were dropped; this tool also sends tour=${levelTourPrefix}.`);
         }
         return successEnvelope({
             pagination: {
@@ -250,7 +248,7 @@ Parallel-safe: yes. Upstream cost: 1.`,
             game,
             requestId,
             tookMs: Date.now() - started,
-            upstreamCalls: 1,
+            apiCalls: 1,
             rateLimit: res.headers,
             warnings: warnings.length ? warnings : undefined,
             data: {

package/dist/tools/types.js

@@ -156,7 +156,7 @@ export async function runTool(def, args, ctx) {
     catch (error) {
         const { errorEnvelope, toMcpResult: toResult } = await import('../envelope.js');
         return toResult(errorEnvelope({
-            code: 'UPSTREAM',
+            code: 'SERVICE_ERROR',
             message: error.message || 'Unhandled tool error',
             game: null,
             source: def.name,