@agentistics/mcp 1.3.3 → 1.7.6

package/README.md

@@ -4,7 +4,7 @@ MCP server that exposes your [Claude Code](https://claude.ai/code) analytics as
 
 ## What it does
 
-Reads data from `~/.claude/` (the same data [agentistics](https://github.com/blpsoares/agentistics) visualizes) and exposes it as 12 structured MCP tools.
+Reads data from `~/.claude/` (the same data [agentistics](https://github.com/blpsoares/agentistics) visualizes) and exposes it as 13 structured MCP tools.
 
 ## Usage
 
@@ -36,10 +36,11 @@ The `AGENTISTICS_API` env var must point to a running agentistics server.
 
 | Tool | Returns |
 |------|---------|
-| `agentistics_summary` | All-time totals: tokens, cost, sessions, streak, cache hit rate |
-| `agentistics_projects` | Per-project token and cost breakdown |
-| `agentistics_sessions` | Recent sessions with duration, model, cost |
-| `agentistics_costs` | Model pricing breakdown and cache savings |
+| `agentistics_summary` | All-time totals: tokens, cost, sessions, streak — unified or per-harness |
+| `agentistics_harnesses` | Side-by-side comparison of every tracked harness |
+| `agentistics_projects` | Per-project token and cost breakdown (optionally per-harness) |
+| `agentistics_sessions` | Recent sessions with harness, duration, model, cost |
+| `agentistics_costs` | Model pricing breakdown and cache savings (optionally per-harness) |
 | `agentistics_component_catalog` | Available dashboard components |
 | `agentistics_get_layouts` | Current custom page layouts |
 | `agentistics_build_layout` | Create a full layout from a component list |
@@ -48,6 +49,7 @@ The `AGENTISTICS_API` env var must point to a running agentistics server.
 | `agentistics_create_layout` | Create a new empty layout |
 | `agentistics_set_active_layout` | Switch the active /custom layout |
 | `agentistics_delete_layout` | Delete a layout permanently |
+| `agentistics_export_pdf` | Generate a PDF report download link for a date range |
 
 ## Requirements
 

package/dist/agentistics-mcp.js

@@ -8,9 +8,38 @@ import {
   ListToolsRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
 
+// ../core/src/local-models.ts
+var LOCAL_RUNTIME_PREFIXES = [
+  "ollama",
+  "lmstudio",
+  "llamacpp",
+  "llama.cpp",
+  "local/",
+  "localhost"
+];
+function isLocalModelId(modelId) {
+  const id = String(modelId ?? "").toLowerCase();
+  return LOCAL_RUNTIME_PREFIXES.some((p) => id.startsWith(p));
+}
+var LOCAL_MODEL_PRICE = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
+
 // ../core/src/types.ts
+var HARNESS_SORT = {
+  claude: 0,
+  codex: 1,
+  gemini: 2,
+  copilot: 3,
+  antigravity: 4,
+  kimi: 5
+};
+var HARNESS_ORDER = Object.keys(HARNESS_SORT).sort((a, b) => HARNESS_SORT[a] - HARNESS_SORT[b]);
 var MODEL_PRICING = {
+  "claude-fable-5": { input: 10, output: 50, cacheRead: 1, cacheWrite: 12.5 },
+  "claude-mythos-5": { input: 10, output: 50, cacheRead: 1, cacheWrite: 12.5 },
+  "claude-opus-5": { input: 5, output: 25, cacheRead: 0.5, cacheWrite: 6.25 },
+  "claude-opus-4-8": { input: 5, output: 25, cacheRead: 0.5, cacheWrite: 6.25 },
   "claude-opus-4-7": { input: 5, output: 25, cacheRead: 0.5, cacheWrite: 6.25 },
+  "claude-sonnet-5": { input: 2, output: 10, cacheRead: 0.2, cacheWrite: 2.5 },
   "claude-opus-4-6": { input: 5, output: 25, cacheRead: 0.5, cacheWrite: 6.25 },
   "claude-sonnet-4-6": { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
   "claude-haiku-4-5-20251001": { input: 1, output: 5, cacheRead: 0.1, cacheWrite: 1.25 },
@@ -20,21 +49,57 @@ var MODEL_PRICING = {
   "claude-sonnet-4-5-20250929": { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
   "claude-sonnet-4-20250514": { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
   "claude-haiku-3-5-20241022": { input: 0.8, output: 4, cacheRead: 0.08, cacheWrite: 1 },
-  "claude-3-haiku-20240307": { input: 0.25, output: 1.25, cacheRead: 0.03, cacheWrite: 0.3 }
+  "claude-3-haiku-20240307": { input: 0.25, output: 1.25, cacheRead: 0.03, cacheWrite: 0.3 },
+  "gemini-3.6-flash": { input: 1.5, output: 7.5, cacheRead: 0.15, cacheWrite: 1.5 },
+  "gemini-3.5-flash-lite": { input: 0.3, output: 2.5, cacheRead: 0.03, cacheWrite: 0.3 },
+  "gemini-3.5-flash": { input: 1.5, output: 9, cacheRead: 0.15, cacheWrite: 1.5 },
+  "gemini-3.1-flash-lite": { input: 0.25, output: 1.5, cacheRead: 0.025, cacheWrite: 0.25 },
+  "gemini-3.1-pro": { input: 2, output: 12, cacheRead: 0.2, cacheWrite: 2 },
+  "gemini-3-flash-preview": { input: 0.5, output: 3, cacheRead: 0.05, cacheWrite: 0.5 },
+  "gemini-3-flash": { input: 0.5, output: 3, cacheRead: 0.05, cacheWrite: 0.5 },
+  "gemini-2.5-flash": { input: 0.3, output: 2.5, cacheRead: 0.03, cacheWrite: 0.3 },
+  "gpt-5.6-sol": { input: 5, output: 30, cacheRead: 0.5, cacheWrite: 5 },
+  "gpt-5.6-terra": { input: 2.5, output: 15, cacheRead: 0.25, cacheWrite: 2.5 },
+  "gpt-5.6-luna": { input: 1, output: 6, cacheRead: 0.1, cacheWrite: 1 },
+  "gpt-5.5": { input: 5, output: 30, cacheRead: 0.5, cacheWrite: 5 },
+  "gpt-5.4-mini": { input: 0.75, output: 4.5, cacheRead: 0.075, cacheWrite: 0.75 },
+  "gpt-5.4": { input: 2.5, output: 15, cacheRead: 0.25, cacheWrite: 2.5 },
+  "gpt-5-mini": { input: 0.25, output: 2, cacheRead: 0.025, cacheWrite: 0.25 },
+  "gpt-5": { input: 1.25, output: 10, cacheRead: 0.125, cacheWrite: 1.25 }
 };
 function getModelPrice(modelId) {
   if (MODEL_PRICING[modelId])
     return MODEL_PRICING[modelId];
-  for (const [key, price] of Object.entries(MODEL_PRICING)) {
-    if (modelId.startsWith(key) || key.startsWith(modelId))
-      return price;
+  if (isLocalModelId(modelId))
+    return LOCAL_MODEL_PRICE;
+  const id = String(modelId ?? "");
+  let forwardKey = "";
+  let reverseKey = "";
+  for (const key of Object.keys(MODEL_PRICING)) {
+    if (id.startsWith(key)) {
+      if (key.length > forwardKey.length)
+        forwardKey = key;
+    } else if (id && key.startsWith(id) && key[id.length] === "-") {
+      if (!reverseKey || key.length < reverseKey.length)
+        reverseKey = key;
+    }
   }
+  const hit = forwardKey || reverseKey;
+  if (hit)
+    return MODEL_PRICING[hit];
   return { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 };
 }
 function calcCost(usage, modelId) {
   const price = getModelPrice(modelId);
   return usage.inputTokens / 1e6 * price.input + usage.outputTokens / 1e6 * price.output + usage.cacheReadInputTokens / 1e6 * price.cacheRead + usage.cacheCreationInputTokens / 1e6 * price.cacheWrite;
 }
+// ../core/src/team.ts
+var DEFAULT_TEAM = Object.freeze({
+  schema: 2,
+  mode: "solo",
+  connections: Object.freeze([])
+});
+var SHARE_SOURCE_TYPES = new Set(["repo", "project", "none"]);
 // agentistics-mcp.ts
 var API = process.env.AGENTISTICS_API ?? "http://localhost:47291";
 function calcCostUSD(input, output, cacheRead, cacheWrite, model) {
@@ -47,6 +112,30 @@ function calcCostUSD(input, output, cacheRead, cacheWrite, model) {
     costUSD: 0
   }, model);
 }
+var HARNESS_IDS = ["claude", "codex", "gemini", "copilot", "antigravity"];
+var HARNESS_PARAM = {
+  type: "string",
+  enum: ["all", ...HARNESS_IDS],
+  description: "Scope to one harness (claude | codex | gemini | copilot | antigravity), or 'all' (default) for the unified view across every harness."
+};
+function sessionHarness(s) {
+  return s.harness ?? "claude";
+}
+function filterSessions(sessions, harness) {
+  if (!harness || harness === "all")
+    return sessions;
+  return sessions.filter((s) => sessionHarness(s) === harness);
+}
+function sessionTokens(s) {
+  const input = s.input_tokens ?? 0;
+  const output = s.output_tokens ?? 0;
+  const cacheRead = s.cache_read_input_tokens ?? 0;
+  const cacheWrite = s.cache_creation_input_tokens ?? 0;
+  return { input, output, cacheRead, cacheWrite, cost: calcCostUSD(input, output, cacheRead, cacheWrite, s.model ?? "") };
+}
+function sessionMessages(s) {
+  return (s.user_message_count ?? 0) + (s.assistant_message_count ?? 0);
+}
 var CATALOG = [
   { id: "kpi.messages", label: "Messages", category: "kpi", defaultW: 3, defaultH: 3, minW: 2, minH: 2, description: "Total message count in selected period" },
   { id: "kpi.sessions", label: "Sessions", category: "kpi", defaultW: 3, defaultH: 3, minW: 2, minH: 2, description: "Session count + avg msgs/session" },
@@ -138,31 +227,37 @@ var server = new Server({ name: "agentistics", version: "1.0.0" }, { capabilitie
 var TOOLS = [
   {
     name: "agentistics_summary",
-    description: "Get an overview of Claude Code usage metrics: total tokens, estimated cost, sessions, streak, most used model, and top project. Good starting point for any metrics question.",
+    description: "Get an overview of AI coding usage metrics (across all tracked harnesses — Claude Code, Codex, Gemini, Copilot, Antigravity — or scoped to one): total tokens, estimated cost, sessions, streak, most used model, and top project. Good starting point for any metrics question.",
+    inputSchema: { type: "object", properties: { harness: HARNESS_PARAM }, required: [] }
+  },
+  {
+    name: "agentistics_harnesses",
+    description: "Compare the tracked AI coding harnesses side by side. Lists every harness present in the data with its sessions, messages, token usage, estimated cost, and last-active date. Use this to answer 'which harness do I use most / costs most' questions.",
     inputSchema: { type: "object", properties: {}, required: [] }
   },
   {
     name: "agentistics_projects",
-    description: "List all Claude Code projects with session counts, message counts, token usage, estimated cost, and last active date.",
-    inputSchema: { type: "object", properties: {}, required: [] }
+    description: "List projects with session counts, message counts, token usage, estimated cost, and last active date. Optionally scope to a single harness.",
+    inputSchema: { type: "object", properties: { harness: HARNESS_PARAM }, required: [] }
   },
   {
     name: "agentistics_sessions",
-    description: "Get the most recent Claude Code sessions with project path, duration, message count, token usage, and model.",
+    description: "Get the most recent sessions with harness, project path, duration, message count, token usage, and model. Optionally scope to a single harness.",
     inputSchema: {
       type: "object",
       properties: {
         limit: {
           type: "number",
           description: "Max sessions to return (default 20, max 50)"
-        }
+        },
+        harness: HARNESS_PARAM
       }
     }
   },
   {
     name: "agentistics_costs",
-    description: "Get cost breakdown by model: token counts (input/output/cache read/write) and estimated USD cost per model.",
-    inputSchema: { type: "object", properties: {}, required: [] }
+    description: "Get cost breakdown by model: token counts (input/output/cache read/write) and estimated USD cost per model. Scope to a single harness, or 'all' (default) for the unified breakdown.",
+    inputSchema: { type: "object", properties: { harness: HARNESS_PARAM }, required: [] }
   },
   {
     name: "agentistics_component_catalog",
@@ -300,6 +395,37 @@ var TOOLS = [
       },
       required: ["name", "componentIds"]
     }
+  },
+  {
+    name: "agentistics_tags",
+    description: "List all tags — saved cross-cutting filters over repos/projects/machines/teams/accounts — with their aggregate sessions, cost, and tokens. Use for 'what tags exist' or 'how much did tag X cost' questions.",
+    inputSchema: { type: "object", properties: {}, required: [] }
+  },
+  {
+    name: "agentistics_tag_detail",
+    description: "Get full detail for one tag by name or id: aggregate totals plus per-source breakdown and distributions (top projects, models, harnesses, repos, members/users), daily activity series, and the active date window. Call agentistics_tags first to find the id/name.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        tag: { type: "string", description: "Tag name or id, from agentistics_tags" }
+      },
+      required: ["tag"]
+    }
+  },
+  {
+    name: "agentistics_repos",
+    description: "List repositories, grouped by normalized git remote (independent of local path or which machine produced the session), with session/message/token/cost totals and last-active date. Sessions with no linked repository are grouped under 'unlinked'. Optionally scope to a single harness.",
+    inputSchema: { type: "object", properties: { harness: HARNESS_PARAM }, required: [] }
+  },
+  {
+    name: "agentistics_team_status",
+    description: "Get this machine's team-mode status: solo, central, or member. In member mode, lists its central connections (label, endpoint, connected/error state, last push). Use for 'am I connected to a team' or 'what central do I push to' questions.",
+    inputSchema: { type: "object", properties: {}, required: [] }
+  },
+  {
+    name: "agentistics_team_members",
+    description: "List members of this team, central only: display name, online/presence status, latency, and last-seen timestamp. For usage/cost per member use agentistics_summary or agentistics_sessions against this central's own /api/data. Returns an explanatory message when this machine is not running as a central (solo/member mode).",
+    inputSchema: { type: "object", properties: {}, required: [] }
   }
 ];
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
@@ -308,71 +434,106 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
   try {
     switch (name) {
       case "agentistics_summary": {
+        const harness = args?.harness;
+        const unified = !harness || harness === "all";
         const data = await apiGet("/api/data");
         const sc = data.statsCache ?? {};
         const totals = sc.allTimeTotals ?? {};
-        const models = sc.modelUsage ?? {};
-        const topModel = Object.entries(models).sort(([, a], [, b]) => (b.totalTokens ?? 0) - (a.totalTokens ?? 0))[0]?.[0] ?? "—";
-        const projects = data.projects ?? [];
-        const topProject = [...projects].sort((a, b) => (b.sessions?.length ?? 0) - (a.sessions?.length ?? 0))[0]?.name ?? "—";
-        const allSessions = data.sessions ?? [];
+        const allSessions = filterSessions(data.sessions ?? [], harness);
         let totalCostUSD = 0;
         let totalInput = 0, totalOutput = 0, totalCacheRead = 0, totalCacheWrite = 0;
+        const modelTokens = {};
+        const projectSessions = {};
+        const activeDates = new Set;
         for (const s of allSessions) {
-          const inp = s.input_tokens ?? 0;
-          const out = s.output_tokens ?? 0;
-          const cr = s.cache_read_input_tokens ?? 0;
-          const cw = s.cache_creation_input_tokens ?? 0;
-          totalInput += inp;
-          totalOutput += out;
-          totalCacheRead += cr;
-          totalCacheWrite += cw;
-          totalCostUSD += calcCostUSD(inp, out, cr, cw, s.model ?? "");
+          const { input, output, cacheRead, cacheWrite, cost } = sessionTokens(s);
+          totalInput += input;
+          totalOutput += output;
+          totalCacheRead += cacheRead;
+          totalCacheWrite += cacheWrite;
+          totalCostUSD += cost;
+          if (s.model)
+            modelTokens[s.model] = (modelTokens[s.model] ?? 0) + input + output;
+          if (s.project_path)
+            projectSessions[s.project_path] = (projectSessions[s.project_path] ?? 0) + 1;
+          if (s.start_time)
+            activeDates.add(String(s.start_time).slice(0, 10));
         }
-        const finalInput = totalInput || (totals.inputTokens ?? 0);
-        const finalOutput = totalOutput || (totals.outputTokens ?? 0);
-        const finalCacheRead = totalCacheRead || (totals.cacheReadTokens ?? 0);
-        const finalCacheWrite = totalCacheWrite || (totals.cacheWriteTokens ?? 0);
+        const claudeFallback = unified || harness === "claude";
+        const topModel = Object.entries(modelTokens).sort(([, a], [, b]) => b - a)[0]?.[0] ?? (claudeFallback ? Object.entries(sc.modelUsage ?? {}).sort(([, a], [, b]) => (b.totalTokens ?? 0) - (a.totalTokens ?? 0))[0]?.[0] ?? "—" : "—");
+        const topProject = Object.entries(projectSessions).sort(([, a], [, b]) => b - a)[0]?.[0] ?? "—";
         return {
           content: [{
             type: "text",
             text: JSON.stringify({
-              totalInputTokens: finalInput,
-              totalOutputTokens: finalOutput,
-              totalCacheReadTokens: finalCacheRead,
-              totalCacheWriteTokens: finalCacheWrite,
+              harness: unified ? "all" : harness,
+              totalInputTokens: totalInput || (claudeFallback ? totals.inputTokens ?? 0 : 0),
+              totalOutputTokens: totalOutput || (claudeFallback ? totals.outputTokens ?? 0 : 0),
+              totalCacheReadTokens: totalCacheRead || (claudeFallback ? totals.cacheReadTokens ?? 0 : 0),
+              totalCacheWriteTokens: totalCacheWrite || (claudeFallback ? totals.cacheWriteTokens ?? 0 : 0),
               estimatedCostUSD: Math.round(totalCostUSD * 100) / 100,
               totalSessions: allSessions.length,
-              totalProjects: projects.length,
               topModel,
               topProject,
-              activeDays: sc.activeDays ?? 0,
-              currentStreak: sc.currentStreak ?? 0
+              activeDays: activeDates.size || (claudeFallback ? sc.activeDays ?? 0 : 0),
+              currentStreak: claudeFallback ? sc.currentStreak ?? 0 : null
             }, null, 2)
           }]
         };
       }
+      case "agentistics_harnesses": {
+        const data = await apiGet("/api/data");
+        const present = data.harnesses ?? ["claude"];
+        const sessions = data.sessions ?? [];
+        const rows = present.map((h) => {
+          const hs = sessions.filter((s) => sessionHarness(s) === h);
+          let input = 0, output = 0, cacheRead = 0, cacheWrite = 0, cost = 0, messages = 0, lastActive = "";
+          for (const s of hs) {
+            const t = sessionTokens(s);
+            input += t.input;
+            output += t.output;
+            cacheRead += t.cacheRead;
+            cacheWrite += t.cacheWrite;
+            cost += t.cost;
+            messages += sessionMessages(s);
+            if (s.start_time && String(s.start_time) > lastActive)
+              lastActive = String(s.start_time);
+          }
+          return {
+            harness: h,
+            sessions: hs.length,
+            messages,
+            inputTokens: input,
+            outputTokens: output,
+            cacheReadTokens: cacheRead,
+            cacheWriteTokens: cacheWrite,
+            totalTokens: input + output + cacheRead + cacheWrite,
+            estimatedCostUSD: Math.round(cost * 100) / 100,
+            lastActive: lastActive || null
+          };
+        }).sort((a, b) => b.totalTokens - a.totalTokens);
+        return { content: [{ type: "text", text: JSON.stringify(rows, null, 2) }] };
+      }
       case "agentistics_projects": {
+        const harness = args?.harness;
         const data = await apiGet("/api/data");
-        const allSessions = data.sessions ?? [];
+        const allSessions = filterSessions(data.sessions ?? [], harness);
         const byPath = {};
         for (const s of allSessions) {
           const key = s.project_path;
           if (!key)
             continue;
           if (!byPath[key])
-            byPath[key] = { inputTokens: 0, outputTokens: 0, cacheRead: 0, cacheWrite: 0, costUSD: 0, messages: 0, lastActive: "", languages: [] };
+            byPath[key] = { sessions: 0, inputTokens: 0, outputTokens: 0, cacheRead: 0, cacheWrite: 0, costUSD: 0, messages: 0, lastActive: "", languages: [] };
           const agg = byPath[key];
-          const inp = s.input_tokens ?? 0;
-          const out = s.output_tokens ?? 0;
-          const cr = s.cache_read_input_tokens ?? 0;
-          const cw = s.cache_creation_input_tokens ?? 0;
-          agg.inputTokens += inp;
-          agg.outputTokens += out;
-          agg.cacheRead += cr;
-          agg.cacheWrite += cw;
-          agg.costUSD += calcCostUSD(inp, out, cr, cw, s.model ?? "");
-          agg.messages += (s.user_message_count ?? 0) + (s.assistant_message_count ?? 0);
+          const { input, output, cacheRead, cacheWrite, cost } = sessionTokens(s);
+          agg.sessions += 1;
+          agg.inputTokens += input;
+          agg.outputTokens += output;
+          agg.cacheRead += cacheRead;
+          agg.cacheWrite += cacheWrite;
+          agg.costUSD += cost;
+          agg.messages += sessionMessages(s);
           if (!agg.lastActive || (s.start_time ?? "") > agg.lastActive)
             agg.lastActive = s.start_time ?? "";
           for (const lang of s.languages ?? [])
@@ -380,12 +541,12 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
               agg.languages.push(lang);
         }
         const projects = data.projects ?? [];
-        const summary = projects.map((p) => {
-          const agg = byPath[p.path] ?? { inputTokens: 0, outputTokens: 0, cacheRead: 0, cacheWrite: 0, costUSD: 0, messages: 0, lastActive: "", languages: [] };
+        const summary = projects.filter((p) => !harness || harness === "all" || byPath[p.path]).map((p) => {
+          const agg = byPath[p.path] ?? { sessions: 0, inputTokens: 0, outputTokens: 0, cacheRead: 0, cacheWrite: 0, costUSD: 0, messages: 0, lastActive: "", languages: [] };
           return {
             name: p.name,
             path: p.path,
-            sessions: (p.sessions ?? []).length,
+            sessions: !harness || harness === "all" ? (p.sessions ?? []).length : agg.sessions,
             messages: agg.messages,
             inputTokens: agg.inputTokens,
             outputTokens: agg.outputTokens,
@@ -399,40 +560,65 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
       }
       case "agentistics_sessions": {
         const limit = Math.min(args?.limit ?? 20, 50);
+        const harness = args?.harness;
         const data = await apiGet("/api/data");
-        const rows = (data.sessions ?? []).slice(0, limit).map((s) => {
-          const inp = s.input_tokens ?? 0;
-          const out = s.output_tokens ?? 0;
-          const cr = s.cache_read_input_tokens ?? 0;
-          const cw = s.cache_creation_input_tokens ?? 0;
+        const rows = filterSessions(data.sessions ?? [], harness).slice(0, limit).map((s) => {
+          const { input, output, cacheRead, cacheWrite, cost } = sessionTokens(s);
           return {
             id: s.session_id,
+            harness: sessionHarness(s),
             project: s.project_path,
             startedAt: s.start_time,
             durationMinutes: s.duration_minutes,
-            messages: (s.user_message_count ?? 0) + (s.assistant_message_count ?? 0),
-            inputTokens: inp,
-            outputTokens: out,
-            cacheReadTokens: cr,
-            cacheWriteTokens: cw,
-            totalTokens: inp + out + cr + cw,
-            estimatedCostUSD: Math.round(calcCostUSD(inp, out, cr, cw, s.model ?? "") * 1e4) / 1e4,
+            messages: sessionMessages(s),
+            inputTokens: input,
+            outputTokens: output,
+            cacheReadTokens: cacheRead,
+            cacheWriteTokens: cacheWrite,
+            totalTokens: input + output + cacheRead + cacheWrite,
+            estimatedCostUSD: Math.round(cost * 1e4) / 1e4,
             model: s.model ?? null
           };
         });
         return { content: [{ type: "text", text: JSON.stringify(rows, null, 2) }] };
       }
       case "agentistics_costs": {
+        const harness = args?.harness;
         const data = await apiGet("/api/data");
-        const usage = data.statsCache?.modelUsage ?? {};
-        const breakdown = Object.entries(usage).map(([model, u]) => ({
+        if (!harness || harness === "all" || harness === "claude") {
+          const usage = data.statsCache?.modelUsage ?? {};
+          const breakdown2 = Object.entries(usage).map(([model, u]) => ({
+            model,
+            inputTokens: u.inputTokens ?? 0,
+            outputTokens: u.outputTokens ?? 0,
+            cacheReadTokens: u.cacheReadTokens ?? 0,
+            cacheWriteTokens: u.cacheWriteTokens ?? 0,
+            totalTokens: u.totalTokens ?? 0,
+            estimatedCostUSD: u.costUSD ?? 0
+          })).sort((a, b) => b.totalTokens - a.totalTokens);
+          return { content: [{ type: "text", text: JSON.stringify(breakdown2, null, 2) }] };
+        }
+        const byModel = {};
+        for (const s of filterSessions(data.sessions ?? [], harness)) {
+          const model = s.model || "unknown";
+          if (!byModel[model])
+            byModel[model] = { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0, estimatedCostUSD: 0 };
+          const agg = byModel[model];
+          const { input, output, cacheRead, cacheWrite, cost } = sessionTokens(s);
+          agg.inputTokens += input;
+          agg.outputTokens += output;
+          agg.cacheReadTokens += cacheRead;
+          agg.cacheWriteTokens += cacheWrite;
+          agg.estimatedCostUSD += cost;
+        }
+        const breakdown = Object.entries(byModel).map(([model, u]) => ({
           model,
-          inputTokens: u.inputTokens ?? 0,
-          outputTokens: u.outputTokens ?? 0,
-          cacheReadTokens: u.cacheReadTokens ?? 0,
-          cacheWriteTokens: u.cacheWriteTokens ?? 0,
-          totalTokens: u.totalTokens ?? 0,
-          estimatedCostUSD: u.costUSD ?? 0
+          inputTokens: u.inputTokens,
+          outputTokens: u.outputTokens,
+          cacheReadTokens: u.cacheReadTokens,
+          cacheWriteTokens: u.cacheWriteTokens,
+          totalTokens: u.inputTokens + u.outputTokens + u.cacheReadTokens + u.cacheWriteTokens,
+          estimatedCostUSD: Math.round(u.estimatedCostUSD * 1e4) / 1e4
         })).sort((a, b) => b.totalTokens - a.totalTokens);
         return { content: [{ type: "text", text: JSON.stringify(breakdown, null, 2) }] };
       }
@@ -610,6 +796,133 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
           }]
         };
       }
+      case "agentistics_tags": {
+        const data = await apiGet("/api/tags");
+        const tags = data.tags ?? [];
+        const rows = tags.map((t) => ({
+          id: t._id,
+          name: t.name,
+          color: t.color ?? null,
+          sessions: t.aggregate?.sessions ?? 0,
+          estimatedCostUSD: Math.round((t.aggregate?.costUSD ?? 0) * 1e4) / 1e4,
+          inputTokens: t.aggregate?.inputTokens ?? 0,
+          outputTokens: t.aggregate?.outputTokens ?? 0,
+          topProject: t.aggregate?.topProject ?? null,
+          topModel: t.aggregate?.topModel ?? null,
+          topHarness: t.aggregate?.topHarness ?? null,
+          window: t.window ?? null
+        }));
+        return { content: [{ type: "text", text: JSON.stringify(rows, null, 2) }] };
+      }
+      case "agentistics_tag_detail": {
+        const wanted = (args?.tag ?? "").trim();
+        if (!wanted)
+          throw new Error("tag is required — pass a name or id from agentistics_tags.");
+        const list = await apiGet("/api/tags");
+        const tags = list.tags ?? [];
+        const match = tags.find((t) => t._id === wanted) ?? tags.find((t) => t.name?.toLowerCase() === wanted.toLowerCase());
+        if (!match)
+          throw new Error(`No tag matching "${wanted}". Available: ${tags.map((t) => t.name).join(", ") || "(none)"}`);
+        const detail = await apiGet(`/api/tags/${encodeURIComponent(match._id)}`);
+        const d = detail;
+        const bucketTop = (b, n = 5) => (b ?? []).slice(0, n).map((x) => ({ key: x.key, sessions: x.sessions, estimatedCostUSD: Math.round((x.costUSD ?? 0) * 1e4) / 1e4 }));
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              id: d.tag?._id,
+              name: d.tag?.name,
+              color: d.tag?.color ?? null,
+              window: d.tag?.window ?? null,
+              sources: d.tag?.sources ?? [],
+              aggregate: {
+                sessions: d.tag?.aggregate?.sessions ?? 0,
+                estimatedCostUSD: Math.round((d.tag?.aggregate?.costUSD ?? 0) * 1e4) / 1e4,
+                inputTokens: d.tag?.aggregate?.inputTokens ?? 0,
+                outputTokens: d.tag?.aggregate?.outputTokens ?? 0
+              },
+              topProjects: bucketTop(d.stats?.projects),
+              topModels: bucketTop(d.stats?.models),
+              topHarnesses: bucketTop(d.stats?.harnesses),
+              topRepos: bucketTop(d.stats?.repos),
+              topMembers: bucketTop(d.stats?.members),
+              distinctMembers: d.stats?.distinctMembers ?? 0,
+              distinctMachines: d.stats?.distinctMachines ?? 0,
+              firstSessionDate: d.stats?.firstSessionDate ?? null,
+              lastSessionDate: d.stats?.lastSessionDate ?? null
+            }, null, 2)
+          }]
+        };
+      }
+      case "agentistics_repos": {
+        const harness = args?.harness;
+        const data = await apiGet("/api/data");
+        const allSessions = filterSessions(data.sessions ?? [], harness);
+        const byRemote = {};
+        for (const s of allSessions) {
+          const key = s.git_remote || "";
+          if (!byRemote[key])
+            byRemote[key] = { sessions: 0, messages: 0, inputTokens: 0, outputTokens: 0, cacheRead: 0, cacheWrite: 0, costUSD: 0, lastActive: "" };
+          const agg = byRemote[key];
+          const { input, output, cacheRead, cacheWrite, cost } = sessionTokens(s);
+          agg.sessions += 1;
+          agg.messages += sessionMessages(s);
+          agg.inputTokens += input;
+          agg.outputTokens += output;
+          agg.cacheRead += cacheRead;
+          agg.cacheWrite += cacheWrite;
+          agg.costUSD += cost;
+          if (s.start_time && String(s.start_time) > agg.lastActive)
+            agg.lastActive = String(s.start_time);
+        }
+        const rows = Object.entries(byRemote).map(([remote, agg]) => ({
+          repo: remote || "unlinked",
+          remote: remote || null,
+          sessions: agg.sessions,
+          messages: agg.messages,
+          inputTokens: agg.inputTokens,
+          outputTokens: agg.outputTokens,
+          totalTokens: agg.inputTokens + agg.outputTokens + agg.cacheRead + agg.cacheWrite,
+          estimatedCostUSD: Math.round(agg.costUSD * 1e4) / 1e4,
+          lastActive: agg.lastActive || null
+        })).sort((a, b) => b.totalTokens - a.totalTokens);
+        return { content: [{ type: "text", text: JSON.stringify(rows, null, 2) }] };
+      }
+      case "agentistics_team_status": {
+        const prefs = await getPrefs();
+        const team2 = prefs.team;
+        const mode = team2?.mode ?? "solo";
+        const connections = (team2?.connections ?? []).map((c) => ({
+          id: c.id,
+          label: c.label ?? null,
+          endpoint: c.endpoint
+        }));
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({ mode, connections }, null, 2)
+          }]
+        };
+      }
+      case "agentistics_team_members": {
+        const res = await fetch(`${API}/api/team/members`);
+        if (res.status === 404) {
+          return { content: [{ type: "text", text: "This machine is not running as a central (solo or member mode) — there is no member roster here. Use agentistics_team_status to see the current mode." }] };
+        }
+        if (!res.ok)
+          throw new Error(`GET /api/team/members → HTTP ${res.status}`);
+        const data = await res.json();
+        const members = data.members ?? [];
+        const rows = members.map((m) => ({
+          id: m.id,
+          name: m.user,
+          label: m.label,
+          online: m.online ?? false,
+          latencyMs: m.latencyMs ?? null,
+          lastSeenAt: m.lastSeenAt ?? null
+        }));
+        return { content: [{ type: "text", text: JSON.stringify(rows, null, 2) }] };
+      }
       default:
         throw new Error(`Unknown tool: ${name}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentistics/mcp",
-  "version": "1.3.3",
+  "version": "1.7.6",
   "description": "Agentistics MCP server — Claude Code analytics for Claude Desktop and Claude Code",
   "type": "module",
   "main": "./dist/agentistics-mcp.js",