List media

Read onlylist_media

Files in your team's Media Library, newest first, with id, name, kind and whether AI made them. Use the ids as mediaFileIds on posts.

Needs the read scope. Looks things up. Changes nothing.

Inputs

Input	Type	Description
`kind`	"image" \| "video"
`search`	string	Words in the file name
`limit`	integer	Up to 40
`offset`	integer	Skip this many of the newest files, to page through a large library
`fileIds`	integer[]	Only these files, in this order (for example the matches you found with look_at_media) Up to 12.
`show`	boolean	true when the user wants to see the files: they appear as thumbnails under your reply (up to 12)

curl https://chirpy.me/api/v1/list_media \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_media",
    "arguments": {}
  }
}

MCP hints: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false.