{
  "name": "get_run_details",
  "description": "Get the details and trace of a run. Trace events are paginated — the first call returns run details and the first page of trace lines. Pass the returned cursor to fetch subsequent pages without re-fetching the trace. The run ID starts with run_.",
  "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"
      },
      "runId": {
        "type": "string",
        "description": "The ID of the run to get the details of, starts with run_"
      },
      "maxTraceLines": {
        "type": "integer",
        "description": "The maximum number of trace lines per page. Defaults to 200. Use the `cursor` parameter to fetch subsequent pages.",
        "default": 200
      },
      "cursor": {
        "type": "string",
        "description": "Pagination cursor returned from a previous get_run_details call. Pass this to fetch the next page of trace events."
      }
    },
    "required": [
      "runId"
    ],
    "additionalProperties": false,
    "$schema": "http://json-schema.org/draft-07/schema#"
  }
}