| { |
| "name": "list_agent_runs", |
| "description": "List Agent Runs for a Vercel project, including summaries, status, model, trigger, token usage, time series, and pagination metadata. Use this to find recent or matching production agent runs before fetching detail or trace data.", |
| "inputSchema": { |
| "type": "object", |
| "properties": { |
| "teamId": { |
| "type": "string", |
| "description": "The team ID to get the deployment events for. Alternatively the team slug can be used.\nTeam IDs start with \"team_\".\nIf you do not know the team ID or slug, it can be found through these mechanism:\n- Read the file .vercel/project.json if it exists and extract the orgId\n- Use the `list_teams` tool" |
| }, |
| "projectId": { |
| "type": "string", |
| "description": "The project ID to get the deployment events for. Alternatively the project slug can be used.\nProject IDs start with \"prj_\".\nIf you do not know the project ID or slug, it can be found through these mechanism:\n- Read the file .vercel/project.json if it exists and extract the projectId\n- Use the `list_projects` tool" |
| }, |
| "environment": { |
| "type": "string", |
| "description": "Agent run environment, usually \"production\" or \"preview\". Defaults to \"production\"." |
| }, |
| "period": { |
| "type": "string", |
| "enum": [ |
| "5m", |
| "15m", |
| "1h", |
| "6h", |
| "12h", |
| "1d", |
| "3d", |
| "7d", |
| "14d", |
| "30d", |
| "90d" |
| ], |
| "description": "Preset time range. Ignored when both from and to are provided. Defaults to the dashboard endpoint default." |
| }, |
| "from": { |
| "type": "string", |
| "description": "Start time as ISO 8601, Unix seconds, Unix milliseconds, or a relative duration like \"12h\". Must be used with to." |
| }, |
| "to": { |
| "type": "string", |
| "description": "End time as ISO 8601, Unix seconds, Unix milliseconds, a relative duration like \"1h\", or \"now\". Must be used with from." |
| }, |
| "page": { |
| "type": "number", |
| "description": "1-based page number. Defaults to 1." |
| }, |
| "pageSize": { |
| "type": "number", |
| "description": "Number of runs per page. The dashboard endpoint caps this at 100." |
| }, |
| "search": { |
| "type": "string", |
| "description": "Server-side title search for Agent Runs." |
| } |
| }, |
| "required": [ |
| "teamId", |
| "projectId" |
| ], |
| "additionalProperties": false, |
| "$schema": "http://json-schema.org/draft-07/schema#" |
| } |
| } |
