Tools

search_footage

Find moments in the user's own library by words in the transcript, the frame description, or a tag. Optional role and collection narrow it. Nothing is generated.

Access token · read · Read only

Parameters

query string required

Words to find in the transcript, description, or tags.

View schema

{
  "description": "Words to find in the transcript, description, or tags.",
  "type": "string",
  "minLength": 1,
  "maxLength": 200
}

collection string optional

View schema

{
  "type": "string",
  "minLength": 1,
  "maxLength": 80
}

role string optional

View schema

{
  "type": "string",
  "enum": [
    "reaction",
    "demo",
    "talking_head",
    "b_roll",
    "product",
    "other"
  ]
}

limit integer optional

View schema

{
  "type": "integer",
  "minimum": 1,
  "maximum": 50
}

Request example

{
  "name": "search_footage",
  "arguments": {
    "query": "My video"
  }
}

Replace example values with ids and arguments read from your own Heavenly account. This example does not execute a tool.

Returns

The tool result from Heavenly’s workspace, encoded as MCP text content. The connector returns isError when an argument, permission, plan or account check fails.

Account access and permissions are checked by Heavenly. See errors for failure handling.