Search

Last updated: May 15, 2026

Search tools include field-level argument descriptions and runnable examples for MCP clients.

Tools Covered

Tool	Mutation	Backend Routes
search_query_content	No	/ai-search/search/db-exact , /ai-search/search/content-search , /batch-open-thumbnails
folder_find	No	/ai-search/search/db-exact

search_query_content

Search content and deal room resources using exact DB and/or semantic RAG search.

Backend routes: /ai-search/search/db-exact , /ai-search/search/content-search , /batch-open-thumbnails

Arguments

Field	Type	Required	Description	Example
query	string	No	Natural language search query text. Keep this user facing and specific to improve ranking quality.	security questionnaire
search_type	string (all \| content)	No	Search domain selector. `all` searches both deal room + content metadata, `content` narrows to content records.	all
include_exact	boolean	No	When true, include DB exact-match search against indexed metadata and text.	true
include_rag	boolean	No	When true, include semantic AI search (RAG) results.	true
include_thumbnails	boolean	No	When true, fetch thumbnail payloads for provided/returned content IDs.	true
thumbnail_content_ids	array	No	Optional explicit content IDs to fetch thumbnails for during search.	["KBD0215806635290000000000"]
filters	object	No	Structured filter object passed through to backend list/search endpoints.	{"source":["PDF"],"tags":["TAG1775..."]}
include_archived	boolean	No	Include archived records in semantic search.	false
viewer_id	string	No	Optional explicit user context override. If omitted, MCP resolves this from the authenticated token/session.	IGH6969811447860000000000
organisation_id	string	No	Optional explicit organisation context override. If omitted, MCP resolves this from the authenticated token/session.	PDX7478889578460000000000
idempotency_key	string	No	Client supplied unique key for mutation safety. Re-using the same key returns the cached mutation result instead of executing again.	mcp-mutation-2026-05-13-001

Example Request

Hybrid search with semantic and exact results

{
  "jsonrpc": "2.0",
  "id": "search_query_content-1",
  "method": "tools/call",
  "params": {
    "name": "search_query_content",
    "arguments": {
      "query": "security deck for healthcare",
      "search_type": "all",
      "include_exact": true,
      "include_rag": true,
      "include_thumbnails": true,
      "thumbnail_content_ids": [
        "KBD0215806635290000000000"
      ]
    }
  }
}

Example Success

{
  "success": true,
  "data": {
    "tool": "search_query_content",
    "note": "Payload shape depends on tenant data and backend route output."
  },
  "error": null
}

Example Failure

{
  "success": false,
  "data": null,
  "error": {
    "code": "INVALID_ARGUMENTS",
    "message": "Missing or invalid parameters for search_query_content.",
    "status": 400,
    "retryable": false
  }
}

folder_find

Find folders by name with exact-match prioritization.

Backend routes: /ai-search/search/db-exact

Arguments

Field	Type	Required	Description	Example
query	string	Yes	Natural language search query text. Keep this user facing and specific to improve ranking quality.	security questionnaire
limit	number	No	Maximum records to return.	20
viewer_id	string	No	Optional explicit user context override. If omitted, MCP resolves this from the authenticated token/session.	IGH6969811447860000000000
organisation_id	string	No	Optional explicit organisation context override. If omitted, MCP resolves this from the authenticated token/session.	PDX7478889578460000000000

Example Request

Find folder by business keyword

{
  "jsonrpc": "2.0",
  "id": "folder_find-1",
  "method": "tools/call",
  "params": {
    "name": "folder_find",
    "arguments": {
      "query": "Proof",
      "limit": 20
    }
  }
}

Example Success

{
  "success": true,
  "data": {
    "tool": "folder_find",
    "note": "Payload shape depends on tenant data and backend route output."
  },
  "error": null
}

Example Failure

{
  "success": false,
  "data": null,
  "error": {
    "code": "INVALID_ARGUMENTS",
    "message": "Missing or invalid parameters for folder_find.",
    "status": 400,
    "retryable": false
  }
}