{
  "name": "run_dashboard_query",
  "description": "Execute a single widget query from a built-in dashboard. Use list_dashboards first to see available dashboards, widget IDs, and their queries. Supports time period and scope options.",
  "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"
      },
      "dashboardKey": {
        "type": "string",
        "description": "The dashboard key (e.g. 'overview', 'llm'). Use list_dashboards to discover available dashboards."
      },
      "widgetId": {
        "type": "string",
        "description": "The widget ID to execute. Use list_dashboards to see available widget IDs and their queries."
      },
      "period": {
        "type": "string",
        "description": "Time period shorthand, e.g. '1h', '7d', '30d'. Defaults to 1d."
      },
      "from": {
        "type": "string",
        "description": "Start of time range (ISO 8601). Must be paired with 'to'."
      },
      "to": {
        "type": "string",
        "description": "End of time range (ISO 8601). Must be paired with 'from'."
      },
      "scope": {
        "type": "string",
        "enum": [
          "environment",
          "project",
          "organization"
        ],
        "default": "environment",
        "description": "Data access scope."
      }
    },
    "required": [
      "dashboardKey",
      "widgetId"
    ],
    "additionalProperties": false,
    "$schema": "http://json-schema.org/draft-07/schema#"
  }
}