Added Network endpoints to the MCP server

README.md

@@ -126,6 +126,8 @@ After saving the server, restart the app before testing `who_am_i` or `list_apps
 - `search_logs`
 - `count_logs`
 - `count_devices_with_logs`
+- `get_network_aggregates`
+- `get_network_details`
 - `search_devices`
 - `count_devices`
 - `list_issues`

src/tools/index.ts

@@ -6,12 +6,14 @@ import { registerCrashTools } from "./crashes.js";
 import { registerDeviceTools } from "./devices.js";
 import { registerIssueTools } from "./issues.js";
 import { registerLogTools } from "./logs.js";
+import { registerNetworkTools } from "./network.js";
 
 export function registerTools(server: McpServer, context: ServerContext): void {
   registerAuthTools(server, context);
   registerAppTools(server, context);
   registerCrashTools(server, context);
   registerLogTools(server, context);
+  registerNetworkTools(server, context);
   registerDeviceTools(server, context);
   registerIssueTools(server, context);
 }

src/tools/network.ts

@@ -0,0 +1,69 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { handleTool, ok } from "../envelope.js";
+import type { ServerContext } from "../server-context.js";
+import { normalizeEndDate, normalizeStartDate } from "../utils/date.js";
+
+function clampSamplePageSize(value?: number): number | undefined {
+  if (typeof value !== "number") {
+    return undefined;
+  }
+  if (value <= 0) {
+    return undefined;
+  }
+  return Math.min(value, 100);
+}
+
+export function registerNetworkTools(server: McpServer, context: ServerContext): void {
+  server.tool(
+    "get_network_aggregates",
+    {
+      app_id: z.string().describe("The public app ID (e.g. 5X3c4veRGV) from list_apps"),
+      date_range_start: z.string().optional().describe("ISO 8601 datetime string (e.g. 2026-04-28T00:00:00Z)."),
+      date_range_end: z.string().optional().describe("ISO 8601 datetime string (e.g. 2026-04-28T23:59:59Z)."),
+      device_udid: z.string().optional().describe("Filter network requests to a specific device UDID."),
+      app_version: z.string().optional().describe("Filter by app version string."),
+      os: z.string().optional().describe("Filter by operating system name (e.g. iOS, Android)."),
+      os_version: z.string().optional().describe("Filter by operating system version."),
+      domain_search: z.string().optional().describe("Filter by domain text. Partial matches are supported."),
+    },
+    ({ app_id, date_range_start, date_range_end, ...filters }) =>
+      handleTool(context, async () =>
+        ok(
+          await context.client.get(`/app/${app_id}/network/aggregates`, {
+            ...filters,
+            date_range_start: normalizeStartDate(date_range_start),
+            date_range_end: normalizeEndDate(date_range_end),
+          }),
+        ),
+      ),
+  );
+
+  server.tool(
+    "get_network_details",
+    {
+      app_id: z.string().describe("The public app ID (e.g. 5X3c4veRGV) from list_apps"),
+      domain: z.string().describe("Domain to inspect (e.g. api.example.com)."),
+      endpoint: z.string().optional().describe("Endpoint path to inspect. Defaults to '/' when omitted."),
+      date_range_start: z.string().optional().describe("ISO 8601 datetime string (e.g. 2026-04-28T00:00:00Z)."),
+      date_range_end: z.string().optional().describe("ISO 8601 datetime string (e.g. 2026-04-28T23:59:59Z)."),
+      device_udid: z.string().optional().describe("Filter network requests to a specific device UDID."),
+      app_version: z.string().optional().describe("Filter by app version string."),
+      os: z.string().optional().describe("Filter by operating system name (e.g. iOS, Android)."),
+      os_version: z.string().optional().describe("Filter by operating system version."),
+      sample_page: z.number().int().positive().optional().describe("1-based page number for sample requests."),
+      sample_page_size: z.number().int().positive().optional().describe("Page size for sample requests. Max 100."),
+    },
+    ({ app_id, date_range_start, date_range_end, sample_page_size, ...filters }) =>
+      handleTool(context, async () =>
+        ok(
+          await context.client.get(`/app/${app_id}/network/details`, {
+            ...filters,
+            date_range_start: normalizeStartDate(date_range_start),
+            date_range_end: normalizeEndDate(date_range_end),
+            sample_page_size: clampSamplePageSize(sample_page_size),
+          }),
+        ),
+      ),
+  );
+}