items-upload_file
items-upload_fileUpload a file to a case by passing base64-encoded content and filename. Attach it to a note or task with an optional parent ID.
Instructions
Uploads a local file to a case in one MCP call. The agent reads the file from the local filesystem (e.g., via Read or base64 < file), passes the encoded bytes, and the server decodes and stores them in FileStore as a real binary file (identical to POST /api/upload). Best for screenshots and small/medium files — base64 inflates payload ~33%, so for files larger than a few MB use the curl path to /api/upload instead. Use parent_id to attach the file as a child of a note or task in one call.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| case_id | Yes | Case ID (@rid format) | |
| content_base64 | Yes | File content as a base64-encoded string | |
| filename | Yes | Original filename including extension (e.g., 'screenshot.png') | |
| mime_type | No | Optional MIME type override (auto-detected from extension if omitted) | |
| name | No | Optional display name (defaults to filename) | |
| parent_id | No | Optional parent item ID (@rid) — attaches the file as a child of a note, task, or folder |