Elnora Search

Full-text search across tasks and files on the Elnora AI Platform. Search by keyword to find protocols, conversations, and documents across all projects you have access to.

Organization Context

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

Concepts

• Search results include a snippet with HTML-bold highlighted matches and a rank score for relevance sorting.
• Search is read-only. Use search to find resources, then use domain-specific tools (elnora_get_task, elnora_get_file_content, etc.) to act on them.
• Results span all projects you have access to. There is no project filter on search -- use elnora_list_tasks or elnora_list_files with project_id to browse within a single project.

MCP Tools

elnora_search_all

Full-text search across all resource types (tasks, files, etc.) in a single call.

Returns paginated results:

{
  "items": [
    {
      "type": "task",
      "id": "<UUID>",
      "title": "PCR Protocol for BRCA1",
      "snippet": "...amplify <b>BRCA1</b> exon 11 using standard <b>PCR</b>...",
      "projectId": "<UUID>",
      "createdAt": "...",
      "rank": 0.85
    },
    {
      "type": "file",
      "id": "<UUID>",
      "title": "brca1-protocol-v2.md",
      "snippet": "...<b>PCR</b> amplification protocol for...",
      "projectId": "<UUID>",
      "createdAt": "...",
      "rank": 0.72
    }
  ],
  "page": 1,
  "totalCount": 8,
  "hasNextPage": false
}

Use the type field to distinguish between tasks and files in results.

elnora_search_tasks

Full-text search scoped to tasks only.

Same response shape as elnora_search_all but only returns task results. Use this when you know you are looking for a conversation thread.

elnora_search_files

Full-text search scoped to files only.

Same response shape as elnora_search_all but only returns file results. Use this when you know you are looking for a document or protocol output.

elnora_search_file_content

Full-text search inside file bodies (protocols, documents). Unlike elnora_search_files which searches metadata, this searches the actual content of files.

Same response shape as other search tools. Use this to find specific protocol steps, reagent mentions, or methods within generated protocols.

Token Efficiency

All search tools support optional compact and fields parameters:

Choosing the Right Search Tool

Pagination

Search results use page-based pagination:

{
  "items": [...],
  "page": 1,
  "totalCount": 50,
  "hasNextPage": true
}

If hasNextPage is true, increment page and call again.

Agent Workflow Recipes

Find a task by topic, then read the conversation

1. Call elnora_search_tasks with a keyword query (e.g., "BRCA1")
2. Pick the best match by rank
3. Call elnora_get_task_messages with the task's id to read the full conversation

Find a protocol file and read its content

1. Call elnora_search_files with a keyword query (e.g., "gel electrophoresis")
2. Pick the best match by rank
3. Call elnora_get_file_content with the file's id to read the protocol

Search across everything, then route by type

1. Call elnora_search_all with a broad query
2. For each result, check the type field:
   • "task" -- use elnora_get_task or elnora_get_task_messages
   • "file" -- use elnora_get_file or elnora_get_file_content