Loading ToolBench
27 tools with consistent verb-noun naming (list_, get_, create_, delete_, restore_, etc.) and explicit input schemas. Descriptions present for all tools but vary in quality, some are clear (e.g., 'List items in the trash'), others are placeholder text (e.g., rewind tools). Parameter descriptions are present but minimal (avg ~30 chars). Output schemas are not documented; responses are shaped ad-hoc in handlers. Error handling is basic (result code checks) with limited recovery guidance. No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Confirmation pattern used for destructive ops (delete_file, delete_folder, restore_from_trash) but not consistently applied. Missing: pagination support, output schema documentation, per-parameter type constraints (enums), and LLM-optimized descriptions.
Accept a shared folder invitation
Copy a file to a new location
Create a public link for a file
Create a new folder
Create a public link for a folder
Decline a shared folder invitation
Delete a file
Output schemas not documented. Handlers return ad-hoc shaped responses (ok() wrapper with JSON text content). LLMs cannot predict response structure for downstream tool chaining or field extraction.
Rewind tools (list_rewind_events, restore_from_rewind) return placeholder error messages instead of being removed or properly documented as unavailable. Descriptions state 'Rewind is not available through the pCloud API' but tools remain callable, wasting agent reasoning.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Agents cannot distinguish safe reads from destructive writes without parsing descriptions. Destructive tools (delete_file, delete_folder) lack explicit hints.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 59 | 2026-07-28+ | v2 |
Delete a folder
Delete a public link
Get file checksums (SHA256, SHA1, MD5)
Get a download link for a file
Get file or folder metadata
Get user account information
Get a download link for a zip archive of files and folders
List contents of a folder
List public links
List previous versions of a file
Rewind is not available through the pCloud API — it exists only in the pCloud web app at pcloud.com. Use list_changes to see what changed and when, list_revisions for previous versions of a file, or list_trash for recoverable deletions.
List shared folders
List items in the trash
Move a file to a new location
Remove a shared folder
Rename a file
Rewind is not available through the pCloud API — it exists only in the pCloud web app at pcloud.com. Use list_changes to see what changed and when, list_revisions for previous versions of a file, or list_trash for recoverable deletions.
Restore a file from trash
Revert a file to a previous version
Share a folder with another user
Parameter descriptions are minimal (avg ~30 chars). E.g., 'The file ID to restore' lacks context on format, range, or how to obtain it. LLMs cannot infer whether to pass a number, string, or path.
No pagination support. list_folder, list_trash, list_shares, list_publinks, list_revisions lack limit/offset or cursor parameters. Large result sets will blow context windows.