`list_assets`

List media (images/videos) the user has uploaded to their SocialClaw library, newest first. Each asset includes a publicUrl usable directly as media_link in validate_schedule/apply_schedule. Use this to find a previously uploaded file (e.g. from the dashboard) to post. Optionally filter by kind (image/video), mime, or a text query over filename/id.

Calling it

Invoke this tool with a JSON-RPC 2.0 tools/call request against the hosted MCP endpoint at POST https://getsocialclaw.com/mcp. Send your workspace API key as Authorization: Bearer sc_live_your_key. In an MCP client (Claude, Cursor, Claude Code) the client makes this call for you — just ask it to use list_assets.

Arguments

Parameter	Type		Description
`query`	`string`	optional	Optional text match over filename, id, kind, mime, or url.
`kind`	`enum: image \| video`	optional	Filter by media kind: image or video.
`mime`	`string`	optional	Optional mime prefix filter, e.g. video/mp4.
`sort`	`enum: created_desc \| created_asc`	optional	created_desc (default, newest first) or created_asc.
`limit`	`number`	optional	Maximum assets to return. Defaults to 24, capped at 48.

Example request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_assets",
    "arguments": {
      "query": "...",
      "kind": "image"
    }
  }
}

Response

The server replies with a JSON-RPC result whose content array carries the tool output as a JSON-encoded text block. isError is true when the call failed.

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ /* JSON-encoded tool result */ }"
      }
    ],
    "isError": false
  }
}