feat(cli): add region filter to the MCP list_runs tool

Adds a region input to list_runs that filters by the worker instance
group masterQueue identifier, and surfaces each run's executing region
in the formatted output line (e.g. region:us-east-1). Pairs with the
matching region filter on the public runs list API.

Author: ericallam

.changeset/mcp-list-runs-region.md

@@ -0,0 +1,5 @@
+---
+"trigger.dev": patch
+---
+
+MCP `list_runs` tool: add a `region` filter input and surface each run's executing region in the formatted summary.

packages/cli-v3/src/mcp/formatters.ts

@@ -427,6 +427,11 @@ function formatRunSummary(run: ListRunResponseItem): string {
     parts.push(`v${run.version}`);
   }
 
+  // Region if available
+  if (run.region) {
+    parts.push(`region:${run.region}`);
+  }
+
   return parts.join(" | ");
 }
 

packages/cli-v3/src/mcp/schemas.ts

@@ -183,6 +183,12 @@ export const ListRunsInput = CommonProjectsInput.extend({
     .describe("Filter for runs created in the last N time period. e.g. 7d, 30d, 365d")
     .optional(),
   machine: MachinePresetName.describe("Filter for runs that match this machine preset").optional(),
+  region: z
+    .string()
+    .describe(
+      "Filter for runs that executed in this region (the worker instance group masterQueue identifier, e.g. 'us-east-1' or 'main')"
+    )
+    .optional(),
 });
 
 export type ListRunsInput = z.output<typeof ListRunsInput>;

packages/cli-v3/src/mcp/tools/runs.ts

@@ -374,6 +374,7 @@ export const listRunsTool = {
       to: $to,
       period: input.period,
       machine: input.machine,
+      region: input.region,
     });
 
     const formattedRuns = formatRunList(result);