All tools
ToolRead
List Project folders
list_project_foldersYou 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": {
"projectId": {
"type": "string",
"format": "uuid"
},
"parentId": {
"type": "string",
"format": "uuid"
},
"mode": {
"type": "string",
"enum": [
"children",
"subtree"
],
"default": "children"
},
"depth": {
"type": "integer",
"minimum": 1,
"maximum": 4,
"default": 2
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25
},
"cursor": {
"type": "string",
"description": "Opaque nextCursor from a previous page."
}
},
"required": [
"projectId"
],
"additionalProperties": false
}