Files

MCP tools for the Files module. See the Files module docs for permissions and data model.

list-files

List all files

Arguments

Argument	Type	Required	Description
projectId	string	no	Filter files by project ID
limit	number	no	Maximum number of results to return
offset	number	no	Number of results to skip

create-file

Create a file

Arguments

Argument	Type	Required	Description
projectId	string	no	Public ID of the project. Optional when authenticating with a project-scoped API key, which defaults to the key's project; required otherwise.
prefix	string	no	Directory within the project (e.g. /images). Optional; defaults to / (root). Combined with filename to form the file's key (path).
filename	string	no	Original / download name and the key's leaf segment (e.g. logo.png).
contentType	string	no	MIME type of the file
size	number	no	File size in bytes
metadata	string	no	JSON string with additional metadata

upload-file

Upload a file

Arguments

Argument	Type	Required	Description
file	string	yes	File content
projectId	string	no	Project ID to associate the file with. Optional when authenticating with a project-scoped API key, which defaults to the key's project; required otherwise.
prefix	string	no	Directory within the project (e.g. /images). Optional; defaults to / (root).
filename	string	no	Original / download name. Optional; defaults to the uploaded file's name.
metadata	string	no	Additional metadata as a JSON string

upload-file-base64

Upload a file using base64 encoding

Arguments

Argument	Type	Required	Description
projectId	string	no	Public ID of the project
content	string	yes	Base64-encoded file content
prefix	string	no	Directory within the project (e.g. /documents). Optional; defaults to / (root).
filename	string	no	Original / download name and the key's leaf segment.
contentType	string	no	MIME type of the file
metadata	string	no	JSON string with additional metadata

create-presigned-url

Create a presigned upload URL

Arguments

Argument	Type	Required	Description
projectId	string	yes	Public ID of the project
prefix	string	no	Directory within the project (e.g. /documents). Optional; defaults to / (root).
filename	string	no	Original / download name and the key's leaf segment.
contentType	string	no	MIME type of the file to be uploaded

upload-file-with-token

Upload a file using an upload token

Arguments

Argument	Type	Required	Description
token	string	yes	The single-use upload token (e.g. upt_...)
content	string	no	Base64-encoded file content (alternative to multipart file)
filename	string	no	Original / download name (overrides the token's filename)
contentType	string	no	MIME type of the file (overrides the token's content type)
metadata	string	no	JSON string with additional metadata

get-file

Get a file by ID

Arguments

Argument	Type	Required	Description
fileId	string	yes	File ID

delete-file

Delete a file

Arguments

Argument	Type	Required	Description
fileId	string	yes	ID of the file to delete

download-file

Download a file

Arguments

Argument	Type	Required	Description
fileId	string	yes	File ID

update-file-metadata

Update file metadata

Arguments

Argument	Type	Required	Description
fileId	string	yes	File ID
metadata	string	no	New metadata as a JSON string
prefix	string	no	New directory — moves the file. The resulting path (prefix + filename) must be unique within the project.
filename	string	no	New filename — renames the key's leaf and the download name.

download-file-base64

Download file as base64

Arguments

Argument	Type	Required	Description
fileId	string	yes	File ID

get-file-tags

Get file tags

Arguments

Argument	Type	Required	Description
fileId	string	yes	File ID

replace-file-tags

Replace file tags

Arguments

Argument	Type	Required	Description
fileId	string	yes	File ID

merge-file-tags

Merge file tags

Arguments

Argument	Type	Required	Description
fileId	string	yes	File ID