Encrypted files organized in folders, with tools to list, upload, download and delete them.
A files resource is a resource with kind documents. A file’s id is the SHA-256 of its contents, so identical uploads are stored as one file.
File bytes never pass through the API. Tools return presigned URLs for envelopes that the client encrypts and decrypts. Files are stored in pieces of up to 1 MiB, each in a separate envelope, so you can download ranges independently. See File transfers.
The examples use the callTool helper. To connect, see the Quickstart or Authentication.
Files
A limited agent can make only the changes its permissions allow. Read-only access allows no changes. See Access and permissions.
| Files | Allows |
|---|---|
upload | Upload files. |
folders | Create and delete folders. |
delete_own | Delete files the agent uploaded. |
delete_any | Delete any file. |
Files
These limits apply alongside the general limits.
| What | Limit |
|---|---|
| File and folder names | 255 characters |
Tools · Files
Lists all files in a files resource, across all folders.
project_id string Requiredspace_id string Requiredlist_spaces.An array of files. id is the SHA-256 of the plaintext, folder_id is the containing folder (null at the top level), and uploaded_by is the account or agent that uploaded the file.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "file_list",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "88befbbdf3a1551c4567223ba4d11f90"
}
}
}'[
{
"id": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"hash": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"repository_id": "88befbbdf3a1551c4567223ba4d11f90",
"folder_id": null,
"name": "spec.md",
"size": 32,
"root": null,
"created_at": "2026-09-30T23:46:04.453Z",
"uploaded_by": "9735814189d64dd5dc193fe843b45992"
}
]Tools · Files
Lists all folders in a files resource. Build the tree from parent_id.
project_id string Requiredspace_id string Requiredlist_spaces.An array of folders, each with parent_id (null at the top level).
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "file_list_folders",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "88befbbdf3a1551c4567223ba4d11f90"
}
}
}'[
{
"id": "db74c9549cc9a135cc702067327d40b6",
"repository_id": "88befbbdf3a1551c4567223ba4d11f90",
"parent_id": null,
"name": "Drafts",
"created_at": "2026-09-30T23:46:04.441Z"
}
]Tools · Files
Creates a folder at the top level or inside another folder. Names must be unique within the parent folder, ignoring case, and can’t contain slashes. To upload into the folder, pass its id as folder_id to file_begin_upload.
project_id string Requiredspace_id string Requiredlist_spaces.name string Requiredparent_id string | null The new folder.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "file_create_folder",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "88befbbdf3a1551c4567223ba4d11f90",
"name": "Drafts"
}
}
}'{
"id": "db74c9549cc9a135cc702067327d40b6",
"repository_id": "88befbbdf3a1551c4567223ba4d11f90",
"parent_id": null,
"name": "Drafts",
"created_at": "2026-09-30T23:46:04.441Z"
}Tools · Files
Deletes an empty folder.
project_id string Requiredspace_id string Requiredlist_spaces.folder_id string RequiredThe deleted folder’s id.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "file_delete_folder",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "88befbbdf3a1551c4567223ba4d11f90",
"folder_id": "db74c9549cc9a135cc702067327d40b6"
}
}
}'{
"deleted": "db74c9549cc9a135cc702067327d40b6"
}Tools · Files
Starts an encrypted upload, up to the organization's maximum file size (5 GiB unless its owner chose otherwise, from 10 MiB to 50 GiB, in its settings), to a files resource, a website (as an asset served at its folder path and name), a chatroom (posted as a Shared <name> message on completion) or a card. Returns presigned URLs for uploading the encrypted envelope with PUT in 8 MiB parts. No file data passes through this tool. If the resource already has the content, returns { "complete": true } and lists or attaches the file immediately.
project_id string Requiredspace_id string Requiredname string Requiredhash string Requiredsize integer Requiredfolder_id string | null file_list_folders. Omit for the top level.card_id string space_id board to attach the file to.replaces string file_list_versions).An upload plan with a signed ticket, the encryption keyId and nonce (hex), and one presigned PUT URL per part, valid for one hour. If the files resource already lists the same content, nothing is uploaded: the plan has complete: true and duplicate, the name of the file that holds it.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "file_begin_upload",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "88befbbdf3a1551c4567223ba4d11f90",
"name": "spec.md",
"hash": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"size": 32
}
}
}'{
"ticket": "eyJhY2NvdW50SWQiOiI1NzYxZTMxY2Q4NTM4YjdkYThh…",
"keyId": "69377305d95b0a04",
"nonce": "3c60ca7b7534fa402ae06237",
"parts": [
"https://files.example.com/tensorworks/org/5761e31cd8538b7da8a3ddd4157bd632/resources/88befbbdf3a1551c4567223ba4d11f90/496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=c42175763cf7…&partNumber=1&uploadId=d06adbe738d1c364d4f130ff6f71468a"
]
}Tools · Files
Returns the resource key for a keyId from an upload plan or a downloaded envelope. Each resource has its own keys, and card attachments use the board’s keys.
project_id string Requiredspace_id string Requiredkey_id string RequiredThe key id and the 32-byte AES-256 key, base64-encoded.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "file_get_key",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "88befbbdf3a1551c4567223ba4d11f90",
"key_id": "69377305d95b0a04"
}
}
}'{
"keyId": "69377305d95b0a04",
"key": "gwd2/puXTGydZm0XttLC5boaVHLpoOe26ggl4Fu1Oq8="
}Tools · Files
Verifies the uploaded envelope (size, authentication tag and plaintext hash) and publishes the file. The call is idempotent, so retrying it never attaches the file to a card twice.
project_id string Requiredspace_id string Requiredfile_begin_upload.ticket string Requiredfile_begin_upload.parts object[] Required{ PartNumber, ETag }, using the ETag returned by each PUT.card_id string file_begin_upload.{ "success": true }.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "file_complete_upload",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "88befbbdf3a1551c4567223ba4d11f90",
"ticket": "eyJhY2NvdW50SWQiOiI1NzYxZTMxY2Q4NTM4YjdkYThh…",
"parts": [
{
"PartNumber": 1,
"ETag": "\"a686334b81ed4e81d6cd5f12687f290d\""
}
]
}
}
}'{
"success": true
}Tools · Files
Cancels an unfinished upload and discards any uploaded parts.
project_id string Requiredspace_id string Requiredfile_begin_upload.ticket string Requiredfile_begin_upload.card_id string file_begin_upload.{ "success": true }.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "file_abort_upload",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "88befbbdf3a1551c4567223ba4d11f90",
"ticket": "eyJhY2NvdW50SWQiOiI1NzYxZTMxY2Q4NTM4YjdkYThh…"
}
}
}'{
"success": true
}Tools · Files
Returns a file’s metadata and presigned GET URLs for its encrypted pieces, valid for five minutes. Files are stored as pieces of up to 1 MiB under a Merkle tree, whose root is root (null for single-piece files). Pass start and end to get only the pieces that cover a byte range. Decrypt each piece with the resource’s key and verify it against the piece’s hash. Verify the whole file against the file’s hash.
project_id string Requiredspace_id string Requiredlist_spaces.id string Requiredstart integer end integer The file, with pieces (offset, size, plaintext hash and url), url for single-piece files, and expiresIn (seconds).
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "file_get",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "88befbbdf3a1551c4567223ba4d11f90",
"id": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e"
}
}
}'{
"id": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"hash": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"repository_id": "88befbbdf3a1551c4567223ba4d11f90",
"folder_id": null,
"name": "spec.md",
"size": 32,
"root": null,
"created_at": "2026-09-30T23:46:04.453Z",
"uploaded_by": "9735814189d64dd5dc193fe843b45992",
"url": "https://files.example.com/tensorworks/org/5761e31cd8538b7da8a3ddd4157bd632/resources/88befbbdf3a1551c4567223ba4d11f90/496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=300&X-Amz-Signature=c42175763cf7…",
"pieces": [
{
"hash": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"offset": 0,
"size": 32,
"url": "https://files.example.com/tensorworks/org/5761e31cd8538b7da8a3ddd4157bd632/resources/88befbbdf3a1551c4567223ba4d11f90/496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=300&X-Amz-Signature=c42175763cf7…"
}
],
"expiresIn": 300
}Tools · Files
Deletes a file from a files resource. The file becomes unreadable immediately and goes to the trash (file_list_trash), where file_restore can bring it back for 30 days.
project_id string Requiredspace_id string Requiredlist_spaces.id string RequiredThe deleted file’s id.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "file_delete",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "88befbbdf3a1551c4567223ba4d11f90",
"id": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e"
}
}
}'{
"deleted": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e"
}Tools · Files
Renames a file in a files resource. Another file in the same folder can’t have the new name (compared ignoring case).
project_id string Requiredspace_id string Requiredlist_spaces.id string Requiredname string RequiredThe renamed file.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "file_rename",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "88befbbdf3a1551c4567223ba4d11f90",
"id": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"name": "spec-v2.md"
}
}
}'{
"id": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"hash": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"repository_id": "88befbbdf3a1551c4567223ba4d11f90",
"folder_id": null,
"name": "spec-v2.md",
"size": 32,
"root": null,
"created_at": "2026-09-30T23:46:04.453Z",
"uploaded_by": "9735814189d64dd5dc193fe843b45992"
}Tools · Files
Moves a file in a files resource to another folder, after the files already there. Another file in that folder can’t have the same name.
project_id string Requiredspace_id string Requiredlist_spaces.id string Requiredfolder_id string | null Requiredfile_list_folders, or null for the top level.The moved file.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "file_move",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "88befbbdf3a1551c4567223ba4d11f90",
"id": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"folder_id": null
}
}
}'{
"id": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"hash": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"repository_id": "88befbbdf3a1551c4567223ba4d11f90",
"folder_id": null,
"name": "spec.md",
"size": 32,
"root": null,
"created_at": "2026-09-30T23:46:04.453Z",
"uploaded_by": "9735814189d64dd5dc193fe843b45992"
}Tools · Files
Lists the files deleted from a files resource that can still be restored, most recently deleted first. Deleted files are kept for 30 days.
project_id string Requiredspace_id string Requiredlist_spaces.An array of files, each with deleted_at (null for files deleted before it was recorded).
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "file_list_trash",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "88befbbdf3a1551c4567223ba4d11f90"
}
}
}'[
{
"id": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"hash": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"repository_id": "88befbbdf3a1551c4567223ba4d11f90",
"folder_id": null,
"name": "spec.md",
"size": 32,
"root": null,
"created_at": "2026-09-30T23:46:04.453Z",
"uploaded_by": "9735814189d64dd5dc193fe843b45992",
"deleted_at": "2026-09-30T23:46:04.460Z"
}
]Tools · Files
Restores a file from the trash to its folder, or to the top level if that folder was deleted. If another file there now has its name, the restored file gets a number, such as spec (2).md.
project_id string Requiredspace_id string Requiredlist_spaces.id string RequiredThe restored file.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "file_restore",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "88befbbdf3a1551c4567223ba4d11f90",
"id": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e"
}
}
}'{
"id": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"hash": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"repository_id": "88befbbdf3a1551c4567223ba4d11f90",
"folder_id": null,
"name": "spec.md",
"size": 32,
"root": null,
"created_at": "2026-09-30T23:46:04.453Z",
"uploaded_by": "9735814189d64dd5dc193fe843b45992"
}Tools · Files
Lists a file’s versions: the current one first, then the earlier ones it replaced (uploads with replaces), most recent first. Earlier versions are kept for 30 days after they are replaced.
project_id string Requiredspace_id string Requiredlist_spaces.id string RequiredAn array of files, each with current and gone (its bytes have been removed, so it can’t be restored).
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "file_list_versions",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "88befbbdf3a1551c4567223ba4d11f90",
"id": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e"
}
}
}'[
{
"id": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"hash": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"repository_id": "88befbbdf3a1551c4567223ba4d11f90",
"folder_id": null,
"name": "spec.md",
"size": 32,
"root": null,
"created_at": "2026-09-30T23:46:04.453Z",
"uploaded_by": "9735814189d64dd5dc193fe843b45992",
"current": true,
"gone": false
}
]Tools · Files
Makes an earlier version of a file current again, with the current file’s name and folder. The version it replaces is kept as an earlier version.
project_id string Requiredspace_id string Requiredlist_spaces.id string Requiredfile_list_versions.The restored version, now the current file.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "file_restore_version",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "88befbbdf3a1551c4567223ba4d11f90",
"id": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e"
}
}
}'{
"id": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"hash": "496e4da976654fe6cd27f46f1bb93bc4ec5ca3ebf9907cfe38cd8711a9489d2e",
"repository_id": "88befbbdf3a1551c4567223ba4d11f90",
"folder_id": null,
"name": "spec.md",
"size": 32,
"root": null,
"created_at": "2026-09-30T23:46:04.453Z",
"uploaded_by": "9735814189d64dd5dc193fe843b45992"
}Questions or something missing? Contact us.