All tools
ToolRead
List Projects
list_projectsYou need the user's accessible workspace map or a compact context pack.
When to use it
You need the user's accessible workspace map or a compact context pack.
Typical workflow
Orient first, then choose the smallest task-specific tool.
What it returns
Workspace availability, recent objects, tool routing, or query-focused context.
Avoid using it when
You already have the exact source, draft, post, artifact, or portfolio id.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View JSON Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"state": {
"type": "string",
"enum": [
"active",
"archived"
],
"default": "active"
},
"relationship": {
"type": "string",
"enum": [
"all",
"owned",
"shared"
],
"default": "all"
},
"favorite": {
"type": "boolean"
},
"parentId": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Filter owned folders by direct parent. Omit or pass null for top-level Projects."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
},
"cursor": {
"type": "string",
"description": "Opaque nextCursor from a previous page."
}
},
"additionalProperties": false
}