List projects
list_projectsList security analysis projects for the authenticated user, one page at a time.
Browse projects or find one covering a repository. Each project's
repositories array includes owner and repository. Use that match to get
project_id or project_name for other tools.
A reply with next_cursor is one page of a longer list. Call again with it
as cursor until a reply has none.
Each project's ticketing says whether Trent files tickets for its tasks in
the team's issue tracker, and where. To make a project, use create_project;
to change one, update_project. A project_name two projects share is
refused by the other tools; pass project_id instead.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_projects"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | Opaque cursor from a previous call's `next_cursor`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | True when the call itself failed. False for successful calls, including a scan still running, an already approved plan, or a repository classified as non-agentic. The reason field describes these workflow states. | |
| reason | No | A stable snake_case code from the allowed set. Present on every error and on successful calls that carry a workflow state. | |
| message | No | Exactly one sentence written for the user. Never raw exception text or a backend error string, which may expose private details. | |
| metadata | No | Caller metadata, such as 'expiration_warning'. Substantive results have their own fields. Never includes exception or backend error text, which may expose private details. | |
| projects | No | Projects available to the authenticated user. | |
| next_steps | No | Recommended next actions, in order. | |
| next_cursor | No | Pass back as `cursor` to read the next page of projects. Absent when this is the last page, so a list with no next_cursor is the whole list. | |
| retry_after_seconds | No | With reason rate_limited, how many seconds Trent asks the caller to wait. | |
| ticket_destination_unavailable | No | True after a failed read of the ticket destination. Project ticket destinations are then absent, while each project's ticketing switch remains visible. |