{
  "name": "list_runs",
  "description": "List all runs for a project. Use this tool when you need to search for a run or list all runs for a project.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "projectRef": {
        "type": "string",
        "description": "The trigger.dev project ref, starts with proj_. We will attempt to automatically detect the project ref if running inside a directory that includes a trigger.config.ts file, or if you pass the --project-ref option to the MCP server."
      },
      "configPath": {
        "type": "string",
        "description": "The path to the trigger.config.ts file. Only used when the trigger.config.ts file is not at the root dir (like in a monorepo setup). If not provided, we will try to find the config file in the current working directory"
      },
      "environment": {
        "type": "string",
        "enum": [
          "dev",
          "staging",
          "prod",
          "preview"
        ],
        "description": "The environment to get tasks for",
        "default": "dev"
      },
      "branch": {
        "type": "string",
        "description": "The branch to get tasks for, only used for preview environments"
      },
      "cursor": {
        "type": "string",
        "description": "The cursor to use for pagination, starts with run_"
      },
      "limit": {
        "type": "integer",
        "description": "The number of runs to list in a single page. Up to 100"
      },
      "status": {
        "type": "string",
        "enum": [
          "PENDING_VERSION",
          "QUEUED",
          "DEQUEUED",
          "EXECUTING",
          "WAITING",
          "COMPLETED",
          "CANCELED",
          "FAILED",
          "CRASHED",
          "SYSTEM_FAILURE",
          "DELAYED",
          "EXPIRED",
          "TIMED_OUT"
        ],
        "description": "Filter for runs with this run status"
      },
      "taskIdentifier": {
        "type": "string",
        "description": "Filter for runs that match this task identifier"
      },
      "version": {
        "type": "string",
        "description": "Filter for runs that match this version, e.g. 20250808.3"
      },
      "tag": {
        "type": "string",
        "description": "Filter for runs that include this tag"
      },
      "from": {
        "type": "string",
        "description": "Filter for runs created after this ISO 8601 timestamp"
      },
      "to": {
        "type": "string",
        "description": "Filter for runs created before this ISO 8601 timestamp"
      },
      "period": {
        "type": "string",
        "description": "Filter for runs created in the last N time period. e.g. 7d, 30d, 365d"
      },
      "machine": {
        "type": "string",
        "enum": [
          "micro",
          "small-1x",
          "small-2x",
          "medium-1x",
          "medium-2x",
          "large-1x",
          "large-2x"
        ],
        "description": "Filter for runs that match this machine preset"
      }
    },
    "additionalProperties": false,
    "$schema": "http://json-schema.org/draft-07/schema#"
  }
}