Elnora Files

Manage files on the Elnora AI Platform. Files are protocol outputs, templates, datasets, and other artifacts attached to projects. The platform tracks version history for every file, supports working copies for edit-in-place workflows, and allows forking files across projects.

Organization Context

All list, create, and upload tools accept an optional org_id parameter (UUID). When provided, the operation targets that organization instead of the user's active org. The user must be a member of the target org.

Concepts

• File: A document stored in a project. Has metadata (name, type, size) and content.
• Version: An immutable snapshot of file content. Every change creates a new version.
• Working copy: A mutable draft of a file for editing. Commit to save changes as a new version.
• Fork: Copy a file to another project, preserving content but creating an independent copy.
• Promote: Change a file's visibility level (e.g., to organization library).
• All IDs are UUIDs (e.g., bfdc6fbd-40ed-4042-9ea7-c79a5ec90085).

MCP Tools

elnora_list_files

List files in a project or workspace.

Returns paginated results:

{
  "items": [
    {
      "id": "<UUID>",
      "name": "pcr-protocol.md",
      "mimeType": "text/markdown",
      "size": 2048,
      "createdAt": "...",
      "updatedAt": "..."
    }
  ],
  "page": 1,
  "totalCount": 5,
  "hasNextPage": false
}

elnora_get_file

Get file metadata (name, type, size, timestamps) without content.

Use this to inspect a file before reading its content.

elnora_get_file_content

Retrieve the full content of a file.

Returns the raw file content. Use this to read protocol outputs, templates, or any file stored on the platform.

elnora_create_file

Create a new empty file in a project.

Returns the created file object with its id. The file is created empty; use elnora_create_version to add content.

elnora_upload_file

Upload a text file with content in a single call.

Use this for quick uploads when you have the content ready. For structured project placement, use elnora_create_file + elnora_create_version instead.

elnora_update_file

Update file metadata (rename or move to a different folder).

Must provide at least one of name or folder_id.

elnora_archive_file

Archive (permanently delete) a file. Destructive -- confirm with user first.

elnora_download_file

Download a file (returns a download URL or content).

Version Management

elnora_get_file_versions

Get version history for a file. Use this to track how a protocol evolved across iterations.

Returns paginated list of versions with timestamps and metadata.

elnora_get_version_content

Get the content of a specific historical file version. Essential for comparing versions or reviewing past protocol iterations.

Get version IDs from elnora_get_file_versions first.

elnora_create_version

Create a new version of a file with updated content.

Each call creates a new immutable version. The file's current content becomes this version.

elnora_restore_version

Restore a file to a specific previous version.

Get version IDs from elnora_get_file_versions first.

Working Copies

Working copies let you edit a file in place before committing changes.

elnora_create_working_copy

Create a mutable working copy of a file for editing.

elnora_commit_working_copy

Commit the working copy back to the file, saving changes as a new version.

Cross-Project Operations

elnora_fork_file

Fork (copy) a file to another project. Creates an independent copy in the target project.

elnora_promote_file

Change a file's visibility level (e.g., promote to organization library).

Agent Workflow Recipes

Read a protocol from a project

1. Call elnora_list_files with project_id to browse files
2. Call elnora_get_file_content with the target file's id

Upload a protocol template

1. Call elnora_upload_file with name and content
2. Use the returned file id in elnora_send_message via file_ids to reference it in a task

Track protocol evolution

1. Call elnora_get_file_versions to see all versions
2. Call elnora_get_file_content to read current content
3. Use elnora_restore_version if you need to revert

Edit a file with working copies

1. Call elnora_create_working_copy with the file ID
2. Make edits (the working copy is mutable)
3. Call elnora_commit_working_copy to save changes as a new version

Copy a file to another project

1. Get the source file ID from elnora_list_files or elnora_search_files
2. Get the target project ID from elnora_list_projects
3. Call elnora_fork_file with both IDs

Reference a file in a task conversation

Use file IDs from elnora_list_files as file_ids in elnora_send_message or context_file_ids in elnora_create_task to give the AI context about existing protocols or datasets.

Presigned URL Upload (Large/Binary Files)

For files too large for inline upload (>100KB) or binary files, use the two-step presigned URL flow:

elnora_initiate_upload

Start a multi-step file upload. Returns a presigned URL for uploading content directly to storage.

Returns a presigned URL and file ID. PUT the file content to the URL, then confirm.

elnora_confirm_upload

Confirm that a file upload to the presigned URL has completed.

Search Inside Files

elnora_search_file_content

Full-text search inside file bodies. Finds content within protocols and documents, not just metadata.

Token Efficiency

All file tools support optional compact and fields parameters: