findMedia
Content images, videos and documents (stock + uploads). MCP can READ + UPDATE metadata (alt-text, copyright, aiOrigin = "generated"/"edited" for AI images — set it for every image from an AI generator; it is written into all image sizes and shown in the credits; aiNotice = true additionally shows the EU "AI" icon on the image or video wherever it appears: use it for AI images/videos that look like real recordings of something real or plausible, not for drawings or stylised illustrations; never set by the system — when unsure, leave it out and tell the user) + DELETE (⚠ PERMANENT — the admin Trash does NOT catch MCP deletes); binaries come via the addMediaFromUrl tool, not raw upload (admin-only). Use id when referencing in upload-fields. VIDEOS: subtitles (per locale) = the id of a WebVTT (.vtt, text/vtt) media item — import the .vtt via addMediaFromUrl (url or upload: true), then updateMedia the video with "locale"; every block showing the video renders the captions in the page language. media collection. Drafts: no. Public read: yes via /api/agents. MCP capabilities: find, update, delete. ⚠ delete is PERMANENT (hard-delete; the admin Trash does NOT catch MCP deletes). Write ONE document at a time: wait for the response of each create/update/delete call before sending the next — parallel writes can fail with a database deadlock (HTTP 500, nothing saved; retry that call alone). Before writing public text here, call getWritingGuidelines with this collection and the locale (brand voice, writing rules, fixed terms, SEO rules, taken keywords, field rules). Fields: alt (localized, required), title (localized), caption (localized), description (textarea, localized), aiAutofillStatus (enum: pending|done|error (AI generation error)|skipped, redacted), poster (rel: media), subtitles (rel: media, localized), copyrightHolder, copyrightLicense (enum: all-rights-reserved|own-work|stock-licensed (Licensed (stock))|cc0 (CC0 (Public Domain))|cc-by|cc-by-sa|+2), copyrightUrl, aiOrigin (enum: generated (Created with AI)|edited (Edited with AI)), aiNotice (boolean).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "findMedia"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Optional: specific document ID to retrieve. If not provided, returns all documents | |
| page | No | Page number for pagination (default: 1) | |
| sort | No | Field to sort by (e.g., "createdAt", "-updatedAt" for descending) | |
| depth | No | How many levels deep to populate relationships (default: 0) | |
| draft | No | Optional: Whether the document should be queried from the versions table/collection or not. | |
| joins | No | Optional: configure join field queries, or pass false to disable all join fields. | |
| limit | No | Maximum number of documents to return (default: 10, max: 100) | |
| trash | No | Optional: include soft-deleted documents when trash is enabled on the collection | |
| where | No | Optional JSON string for where clause filtering (e.g., '{"title": {"contains": "test"}}') | |
| locale | No | Optional: locale code to retrieve data in (e.g., "en", "es"). Use "all" to retrieve all locales for localized fields | |
| select | No | Optional: define exactly which fields you'd like to return in the response, e.g., {"title": true} | |
| populate | No | Optional: control which fields to include from populated relationship or upload documents. | |
| pagination | No | Optional: set to false to skip the count query overhead | |
| fallbackLocale | No | Optional: fallback locale code to use when requested locale is not available |