list_agent_runs
Use this tool with agents built with eve.
List Agent Runs for a Vercel project. The response includes summaries, status, model, trigger, token usage, time series, and pagination metadata for eve agent activity.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
teamId | string | Yes | - | The team ID to list Agent Runs for. Alternatively the team slug can be used. Team IDs start with 'team_'. Can be found by reading .vercel/project.json (orgId) or using the list_teams tool. |
projectId | string | Yes | - | The project ID to list Agent Runs for. Alternatively the project slug can be used. Project IDs start with 'prj_'. Can be found by reading .vercel/project.json (projectId) or using list_projects. |
environment | string | No | production | Agent run environment, usually production or preview |
period | string | No | - | Preset time range. Supports 5m, 15m, 1h, 6h, 12h, 1d, 3d, 7d, 14d, 30d, and 90d. Ignored when both from and to are provided. |
from | string | No | - | Start time as ISO 8601, Unix seconds, Unix milliseconds, or a relative duration like 12h. Must be used with to. |
to | string | No | - | End time as ISO 8601, Unix seconds, Unix milliseconds, a relative duration like 1h, or now. Must be used with from. |
page | number | No | 1 | Page number |
pageSize | number | No | - | Number of runs per page. The dashboard endpoint caps this at 100. |
search | string | No | - | Server-side title search for Agent Runs |
Sample prompt: "Show me the latest production Agent Runs for my project"
Was this helpful?