Skip to main content
Write a binary attachment (image, PDF, audio, video) into the vault from base64 content. A bare filename goes to the vault’s attachment folder; a path with a folder is used as given. Refuses existing files unless overwrite is set, which requires confirmation and soft-deletes the prior bytes to .trash. Capped by writes.maxAttachmentBytes (default 25 MB decoded).

Annotations

Idempotent is the advisory MCP idempotentHint. Destructive is also yes for a tool that asks for confirmation only on some calls.

Confirmation (human in the loop)

The handler asks for confirmation only when a call crosses a boundary (for example an overwrite, a folder-boundary crossing or a bulk-cost floor); other calls need none.
  • The confirmation binds to the vault paths the call names, which are also checked against the folder ACL.

Input

Output

Other tools in the attachments domain: delete_attachment, get_attachment, list_attachments, move_attachment, ocr_attachment, ocr_bulk. Back to the tool catalog.