Folder tools

Create folders and list folder trees through MCP.

Folders organize files owned by the API key attached to the MCP session. Pass folderId to upload and list tools to work inside one folder.

Authentication

API key required. Register an agent or attach an existing Beecargo key.

beecargo_create_folder

Create a root folder or a child of another folder.

Parameter	Type	Required	Description
`name`	String	Yes	Folder name, maximum 200 characters
`parentId`	UUID \| null	No	Parent folder; omit or use null for root

beecargo_list_folders

List root folders, children, or folders matching a search.

Parameter	Type	Required	Description
`parentId`	UUID	No	Only children of this folder
`page`	Integer	No	Page number, default 1
`limit`	Integer	No	Page size, maximum 200
`search`	String	No	Folder name search