Start file upload

Start uploading a file that only exists in your local/sandbox filesystem (use this when no host-attached file reference is available, e.g. on Claude).

The MCP server is in public beta. It is open to use and still being refined, so tools and behavior may change.

Tool start_file_upload · Behavior Additive

Start uploading a file that only exists in your local/sandbox filesystem (use this when no host-attached file reference is available, e.g. on Claude). Returns a short-lived signed upload_url: PUT the file bytes straight to it from your sandbox, for example curl -X PUT --upload-file <path> "<upload_url>". Then call finish_file_upload with the returned file_id to register and process the file. Target with project_id, vault_id, or scope (mutually exclusive, default “my-files”). If the host already populates a file reference, prefer upload_file instead.

Input parameters

file_name · string · required

Original filename, including extension (e.g. “contract.pdf”).

mime_type · string

MIME type, if known. Inferred from the filename when omitted.

project_id · string (uuid)

Upload into a project you can edit. Mutually exclusive with vault_id and scope.

vault_id · string (uuid)

Add the file as a document in this Contract Intelligence vault, so it gets scanned against the vault’s columns. Requires the editor or owner role in the vault, and the vault accepts PDF, Word, and text files only. Find the id with get_vaults. Mutually exclusive with project_id and scope.

scope · 'my-files' | 'organization'

Upload to the root of “my-files” or “organization”. Mutually exclusive with project_id and vault_id. Defaults to “my-files”.

Response

file_id · string (uuid)

upload_url · string

expires_at · string