Find any resource by `type`; filter by `query` (name substring unless noted) or exact `id`. Returns {type, count, items: [{id, name, type, ...}]} (+ total, has_more for projects/folders); pass ids straight to the consuming tool. Any `duration` is in SECONDS (= add_audio source_duration).
- projects | folders | workspaces | backgrounds.
- tags: project tags (color, project_count; apply with update_project). Project rows carry `tags`; filter with tags + tag_match.
- clueprints: `query` = relevance search over workspace + community (search_summary, relevance_reason, tags, is_community, fork_count). Cut at `limit` with no marker: page through.
- clip_templates: one-clip intro/outro/chapter covers (a clueprint is a whole video). Reply in sections: `defaults` {intro, outro}, `folders` + `templates` (workspace), `library_templates` (Clueso's, unnamed: use template_id). Insert: add_clips(kind='template').
- voices: choose on `description` (tone, age, accent, use); `tags` is a small closed vocabulary. `query` matches names only (descriptive words go in `tags`); query/tags also search the shared catalog (row source org|catalog), else workspace voices only. saved: true = workspace picks; custom: true = clones. Voiceover is the clock: regenerating it later rescales the clip, element times and keyframes.
- images | videos | music | sfx: row `source` org (saved media) | stock (a short described shortlist; use its `src`). Stock video: use `safe_src` (or the `recommended` video_files tier); tiers above 1080p can exceed add_elements' ~200MB cap. Freesound `src` is an OPAQUE handle: pass it to add_audio as is; detail:'full' adds preview_url. Music/sfx: `query` = 2-5 words for how it SOUNDS ("warm acoustic upbeat", "fast air whoosh"), never the video's topic; other filters only for what the brief says; under voiceover vocals:false. Choose on returned labels (mood, genre, energy 1-5, vocals none|wordless|lyrics, sfx_type, bpm) + description, never the name.
- brand_kits: default first (is_default, source_domain, accent, title_font, logo_count (real logos; generated = sample_logo_count), icon_library, updated_at, edit_url). Nothing implicit: pass the id as brand_kit_id to get_design_guide / create_project / update_project. detail:'full' = the whole kit (palette by role, logos, fonts with their font_setting, icons, captions, voices, guidelines, knowledge, reference images).
- icons: names in the kit's icon set for `query`, drawn the kit's way, pinned ones first; kit = project_id's (built-in set if none) or brand_kit_id's. A kit with its own uploaded icons: use those first (get_design_guide 'brand.icons'). Reply carries `usage` (how to draw one). One set + style per video: missing icon → search again with other words, never switch sets. detail:'full' adds each `src` (SVG in kit color, for an add_elements image).
- fonts: this workspace's uploaded brand fonts (id, name; add with upload_file purpose:'font'). Pass `name` as font_setting.font. The ONLY list of non-Google families: a family in neither this list nor Google Fonts silently renders Inter (layout then measures the wrong face).
- animations: the project's own first (project_id; a query searches every project's). kind: 'page' = HTML animations (row `id` = the `animation` for edit_animation / animation.place; title, site, scope, tier, rev, probe, uses, entries). kind: 'canvas' = older canvas kits (ref, title, entries, scope, rev, uses): place as is with add_elements(element_type='animation', type_data: {animation: ref, entry}); editing converts it to a page. Read with read_animation.
- image_gen_style_packs: presets for generate_media(kind='image') style_id (`ready`). code_style_packs = looks for animation code (`examples` count); `id` + `query` (what you'll animate) returns its style_prompt + closest examples whole.
- element_components: this workspace's saved components (param_keys). Insert as is: add_elements(component_id); a variant: base_component_id.
- avatars: looks for an add_elements avatar (type_data.avatarId). No query = one default look per character; query matches character/look names. Rows: styles, engine, credits_per_minute, preview_image.
View input schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"projects",
"folders",
"tags",
"clueprints",
"workspaces",
"backgrounds",
"voices",
"fonts",
"brand_kits",
"icons",
"image_gen_style_packs",
"code_style_packs",
"element_components",
"animations",
"avatars",
"images",
"videos",
"music",
"sfx",
"clip_templates"
],
"description": "Resource type to find."
},
"query": {
"description": "Name substring (case-insensitive). Stock media: the search phrase. Clueprints: relevance search.",
"type": "string"
},
"id": {
"description": "Exact id: just that record (music/sfx: a stock id or src).",
"type": "string"
},
"folder_id": {
"description": "projects/images/videos/music/clip_templates: restrict to a folder; projects: 'root' = outside every folder.",
"type": "string"
},
"source": {
"description": "Media: 'org' (saved media) | 'stock' | 'all' (default; stock added only with a query). sfx: stock only. clip_templates: 'defaults' | 'org' | 'library' | 'all'. voices: 'saved' | 'own' (saved + custom; neither searches the catalog).",
"type": "string",
"enum": [
"org",
"stock",
"all",
"defaults",
"library",
"saved",
"own"
]
},
"clip_label": {
"description": "clip_templates only: one kind of cover.",
"type": "string",
"enum": [
"intro",
"outro",
"chapter break",
"others"
]
},
"engine": {
"description": "voices only: 'eleven' | 'cartesia' | 'google'.",
"type": "string"
},
"language": {
"description": "voices only: e.g. 'en'.",
"type": "string"
},
"tags": {
"description": "voices: descriptive words ('calm', 'british', 'narration'; list or comma-separated), any one matches. projects: tag names, ignoring case (see tag_match).",
"anyOf": [
{
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 40
}
},
{
"type": "string"
}
]
},
"creator_id": {
"description": "clueprints only: filter by creator id.",
"type": "string"
},
"mine_only": {
"description": "clueprints only: only ones I created.",
"type": "boolean"
},
"orientation": {
"description": "stock images/videos only: result orientation.",
"type": "string",
"enum": [
"landscape",
"portrait",
"square"
]
},
"color": {
"description": "stock images only: color name or hex, e.g. 'blue'.",
"type": "string"
},
"size": {
"description": "stock videos only: minimum resolution bucket.",
"type": "string",
"enum": [
"large",
"medium",
"small"
]
},
"min_duration": {
"description": "stock videos only: minimum clip length in seconds.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"max_duration": {
"description": "stock videos + freesound audio: maximum clip length in seconds.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"provider": {
"description": "Stock library, one per call. images/videos: 'pexels' (default; realistic) | 'pixabay' (illustration, vector, clip-art, motion graphics; set image_type/video_type). music: 'clueso' (default; curated, best search) | 'freesound' (niche). sfx: 'freesound' (default) | 'clueso'. Offering the user options → search both in parallel, offer the best 3-5; picking yourself → clueso first.",
"type": "string",
"enum": [
"pexels",
"pixabay",
"clueso",
"freesound"
]
},
"image_type": {
"description": "Pixabay images: illustration/vector for graphic looks (flat, icons, clip-art); photo (or Pexels) for realism.",
"type": "string",
"enum": [
"photo",
"illustration",
"vector"
]
},
"video_type": {
"description": "Pixabay videos: 'film' (live footage) | 'animation' (motion graphics).",
"type": "string",
"enum": [
"film",
"animation"
]
},
"tier": {
"description": "animations: 'org' (workspace) | 'official' (Clueso's) | 'community'; default all.",
"type": "string",
"enum": [
"org",
"official",
"community"
]
},
"project_id": {
"description": "animations: this project's own, listed first. icons: this project's brand kit's set.",
"type": "string"
},
"brand_kit_id": {
"description": "icons: this brand kit's set (find(type='brand_kits')) instead of the project's.",
"type": "string"
},
"library": {
"description": "icons: another set id ('lucide', 'ph', 'tabler', ...); only for a video using no other set.",
"type": "string"
},
"tag_match": {
"description": "projects with tags: 'any' (default) | 'all'. An unknown name matches nothing.",
"type": "string",
"enum": [
"any",
"all"
]
},
"mood": {
"description": "music/sfx: rank first (misses not hidden).",
"maxItems": 3,
"type": "array",
"items": {
"type": "string",
"enum": [
"uplifting",
"hopeful",
"happy",
"playful",
"quirky",
"confident",
"inspiring",
"epic",
"energetic",
"laid-back",
"calm",
"dreamy",
"warm",
"sentimental",
"focused",
"serious",
"mysterious",
"suspenseful",
"dark",
"sad"
]
}
},
"genre": {
"description": "music: rank first.",
"maxItems": 3,
"type": "array",
"items": {
"type": "string",
"enum": [
"corporate",
"electronic",
"pop",
"rock",
"indie",
"hip-hop",
"lo-fi",
"house",
"funk",
"rnb",
"jazz",
"acoustic-folk",
"ambient",
"cinematic",
"classical",
"world"
]
}
},
"energy": {
"description": "music: 1 still, 2 gentle, 3 steady, 4 driving, 5 intense; ranks.",
"type": "integer",
"minimum": 1,
"maximum": 5
},
"vocals": {
"description": "music: false = instrumental only, true = with vocals.",
"anyOf": [
{
"type": "boolean"
},
{
"type": "string",
"enum": [
"0",
"1",
"true",
"false",
"yes",
"no"
]
}
]
},
"bpm_min": {
"description": "music: tempo floor.",
"type": "integer",
"minimum": 1,
"maximum": 400
},
"bpm_max": {
"description": "music: tempo ceiling.",
"type": "integer",
"minimum": 1,
"maximum": 400
},
"avoid": {
"description": "music/sfx: exclude (unlabelled tracks pass).",
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"enum": [
"uplifting",
"hopeful",
"happy",
"playful",
"quirky",
"confident",
"inspiring",
"epic",
"energetic",
"laid-back",
"calm",
"dreamy",
"warm",
"sentimental",
"focused",
"serious",
"mysterious",
"suspenseful",
"dark",
"sad",
"corporate",
"electronic",
"pop",
"rock",
"indie",
"hip-hop",
"lo-fi",
"house",
"funk",
"rnb",
"jazz",
"acoustic-folk",
"ambient",
"cinematic",
"classical",
"world"
]
}
},
"sfx_type": {
"description": "sfx: the kind of effect.",
"type": "string",
"enum": [
"whoosh",
"riser",
"impact",
"sub-drop",
"click",
"pop",
"typing",
"swipe",
"notification",
"success",
"error",
"glitch",
"shimmer",
"camera-shutter",
"ambience"
]
},
"similar_to": {
"description": "music/sfx: an earlier result's id (or a Freesound src, not a clueso src) → sounds like it, instead of text search (e.g. a rejected pick). No other filters.",
"type": "string"
},
"detail": {
"description": "voices, music, sfx, fonts, brand_kits, icons: 'compact' (default; what you need to choose and use one) | 'full' (every field: preview urls, thumbnails, attribution, rhythm, full descriptions; whole brand kits; icon src).",
"type": "string",
"enum": [
"compact",
"full"
]
},
"page": {
"description": "Page (default 1) — projects/element_components/clueprints.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"limit": {
"description": "Page size; caps every type, stock media included (default 8 for voices, music, sfx; every font for fonts; 50 otherwise). A '_more' item or note says when more exist.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"type"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}