Tool reference/search

SEARCH

search_media

Search owned saved image/video asset titles and captions. Returns IDs and existing public media URLs, never storage credentials or paths.

Read onlyread:media
Take the docs with youMarkdown for your editor or agent.
Download guide
TransportStreamable HTTP
Methodtools/call
ExecutionImmediate handler

Request contract

Input parameters

querystringrequired
limitinteger
cursorinteger
post_idinteger
media_typestring
"image""video"

Exact JSON schemas

These are the schemas exported by the Caroush MCP server.

Input schema · JSON
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 200
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "type": "integer",
      "minimum": 1
    },
    "post_id": {
      "type": "integer",
      "minimum": 1
    },
    "media_type": {
      "type": "string",
      "enum": [
        "image",
        "video"
      ]
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Read the actual outcome

A successful handler response does not necessarily mean generation or publication is finished. Follow the returned operation, native run or schedule status. Results and job states

Back to all 49 tools