Skip to content
Keyloom API & MCP: Claude and ChatGPT can now add items to your After Effects comp. See how
Keyloom
API & MCP

API documentation

Connect an AI assistant through MCP, or call the REST API from your own scripts. Both search the Keyloom library and act in After Effects through the Keyloom panel.

REST base URL
https://keyloom.art/api/v1
MCP endpoint
https://keyloom.art/mcp

Authentication

API keys are part of Premium. Make one in your dashboard (API & MCP) or in the plugin (Settings › AI assistants). A key is shown once: keep it secret, and delete it anytime to disconnect.

Send the key in the Authorization header:

Authorization: Bearer 12|xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Apps that only take a URL (claude.ai connectors, ChatGPT) use the key inside the address instead:

https://keyloom.art/mcp/12%7Cxxxxxxxxxxxxxxxx

Every request acts as your account: items you place count like a normal Apply, so creators are paid.

MCP server

Keyloom speaks the Model Context Protocol over HTTP (JSON-RPC 2.0, POST). Supported methods: initialize, ping, tools/list, tools/call, resources/list, resources/read.

Claude Desktop · Claude Code · Cursor · VS Code

{
  "mcpServers": {
    "keyloom": {
      "url": "https://keyloom.art/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

claude.ai · ChatGPT

Add a custom connector and paste the address with your key: https://keyloom.art/mcp/YOUR_KEY

Raw call

curl https://keyloom.art/mcp \
  -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"search_library","arguments":{"query":"rocket","limit":4}}}'

MCP tools

What your assistant can call. The descriptions are the ones the assistant reads.

search_library Search the Keyloom motion library read-only

Search Keyloom's library of animated After Effects elements (icons, shape elements, backgrounds, transitions, scenes — all delivered as precomps). Keyword search over English, French and Arabic keywords: use short concrete words ("rocket", "loading spinner", "liquid transition"), not long sentences. If nothing is found, try synonyms or a broader word, or drop filters. Returns items with an `id` you pass to add_to_after_effects or get_item. Show the user a few good matches (title, duration, Premium or free, thumbnail link) before adding many items.

ParameterTypeDescription
query string What to look for, a few keywords. Empty = browse.
category icons | logos | shape-elements | backgrounds | transitions | scenes | lower-thirds | social-media | infographics | overl... Category slug (see list_categories).
premium boolean true = Premium items only, false = free items only.
color red | orange | yellow | green | teal | blue | purple | pink | black | white | gray Main color family.
style flat | line | gradient | 3d-look | hand-drawn | glitch | minimal | corporate | playful | neon
duration short | medium | long short ≤ 5 s, medium 5–10 s, long > 10 s.
aspect landscape | square | portrait Shape of the item's comp.
collection string Curated collection slug (see list_collections).
sort relevant | new | popular | rating Default: relevant with a query, popular without.
limit integer Items per page, default 10.
page integer
get_item Get one library item read-only

Full details of one item: description, tags, colors, the names of its controls (Color, Size… effects the user can change in After Effects), size, duration, fps, preview video.

ParameterTypeDescription
id* string Item id from search_library.
list_categories List categories read-only

The library's categories with their kind (icon, element, background, transition, scene). Use a slug as `category` in search_library.

list_collections List curated collections read-only

Hand-picked sets that look good together (same style). Use a slug as `collection` in search_library when the user wants a consistent look.

after_effects_status Is After Effects ready? read-only

Whether the Keyloom panel is open in the user's After Effects, and what is open there: project, active comp (name, size, fps, duration, playhead time in seconds). Call it before adding items, to pick items that fit the comp (a 1080×1920 comp needs portrait backgrounds) and to choose times.

add_to_after_effects Add an item to After Effects acts in After Effects

Places one library item into the active comp in the user's After Effects, through the Keyloom panel (it must be open: check after_effects_status). Like clicking Apply in the panel: icons, elements and scenes start at the playhead (or `at_time`); backgrounds go to the bottom, scaled to cover and looped; transitions align to the nearest cut. With no comp open, a comp matching the item is created. One undo step in After Effects. Call it once per item; for a sequence, give each item its own `at_time`. Waits up to about 20 seconds for the result; if the answer is still "pending" (a large download), check later with get_job.

ParameterTypeDescription
id* string Item id from search_library.
at_time number Seconds in the active comp where the item starts. Default: the playhead.
use_after_effects_tool Use a Keyloom tool in After Effects acts in After Effects

Runs one of the Keyloom panel's animation tools in the user's After Effects, on what is SELECTED there (layers, properties or keyframes) in the active comp. You cannot select things yourself: ask the user to select first, or pass options.allLayers = true for tools that work on layers. One undo step in After Effects. Good after add_to_after_effects, which leaves the new layer selected (e.g. align it, ease it, add overshoot). Tools and their options: ease (preset: linear | ease | smooth | strong | snap (fast start, soft landing) | slowStart | hold | custom | curve; in: custom only: incoming influence %, 0.1–100; out: custom only: outgoing influence %, 0.1–100; x1: curve only: CSS cubic-bezier x1 (0–1); y1: curve only: y1 (may be < 0 or > 1 for anticipation / overshoot); x2: curve only: x2 (0–1); y2: curve only: y2) · ease-copy (action: copy (from the first selected keyframes) | paste (onto...

ParameterTypeDescription
tool* ease | ease-copy | stagger | layer-create | layer-shift | trim-to-keys | bake | animate | loop-precomp | trim-paths | ec...
options object Options of that tool (see the list above). Leave out for the defaults.
get_job Check an item sent to After Effects read-only

Status of an item sent with add_to_after_effects: pending (waiting for the panel), sent (After Effects is placing it), done, failed (with the reason), expired (the panel was closed).

ParameterTypeDescription
job_id* string

REST API

JSON in, JSON out. Search endpoints are public; the After Effects endpoints need your key.

MethodPathWhatParametersKey
GET /api/v1/assets Search the library q, category, premium, color, style, duration, aspect, resolution, collection, sort, page, keyword —
GET /api/v1/assets/{id} One item: description, tags, controls, preview video — —
GET /api/v1/categories The categories (slug, name, kind) — —
GET /api/v1/tools The plugin tools and which ones need Premium — —
GET /api/v1/ae/status Is the panel open, and which comp is active — 🔑
POST /api/v1/ae/send Place an item in the active comp item, at_time, wait 🔑
POST /api/v1/ae/tool Run a tool on what is selected in After Effects tool, options, wait 🔑
GET /api/v1/ae/jobs/{job_id} How a sent item or tool went — 🔑

Search

category = slug from /categories · duration = short | medium | long · aspect = landscape | square | portrait · resolution = hd | 4k · sort = relevant | new | popular | rating · keyword=1 = keyword search only

curl "https://keyloom.art/api/v1/assets?q=rocket&category=icons&sort=popular"

{ "data": [ { "uuid": "…", "title": "Rocket launch", "category": "icons", "type": "icon",
             "is_premium": true, "width": 1080, "height": 1080, "duration_frames": 90, "fps": 30,
             "thumb_url": "…", "preview_sm_url": "…" } ],
  "meta": { "current_page": 1, "last_page": 3 },
  "search": { "mode": "keyword", "corrected": null } }

Place an item in After Effects

curl -X POST https://keyloom.art/api/v1/ae/send \
  -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"item":"ITEM_UUID","at_time":2,"wait":true}'

{ "data": { "job_id": "…", "status": "done", "item": { "id": "…", "title": "Rocket launch" },
            "result": { "comp": "Main", "layer": "Rocket launch" } } }

Run a tool

Tools act on what is selected in After Effects. The full list, with what each one does, is on the tools page. /tools

curl -X POST https://keyloom.art/api/v1/ae/tool \
  -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"tool":"align","options":{"edge":"center","to":"comp"},"wait":true}'

tool = ease · ease-copy · stagger · layer-create · layer-shift · trim-to-keys · bake · animate · loop-precomp · trim-paths · echo · fit-comp · comp-duration · precompose-each · key-clean · reverse-keys · wiggle · loop · overshoot · bounce · spin · control-null · parent-chain · anchor · align · distribute · flip · rename · reverse-order · crop-comp · cleanup · color

Jobs

Sending an item or a tool creates a job. The Keyloom panel picks it up within seconds, does it in After Effects and reports back. With wait=true the answer waits up to 20 seconds for the result.

  1. pending

    Waiting for the panel

  2. sent

    After Effects is working

  3. done

    Finished: see result

  4. failed

    See message

  5. expired

    The panel was closed

Errors and limits

Errors come back as JSON with a message for people and a reason for code:

{ "message": "The Keyloom panel is not open in After Effects…", "reason": "panel_closed" }
401invalid_keyThe key is wrong, expired or deleted.
403premium_requiredAPI keys need an active Premium plan.
404not_foundNo such item, tool or job.
409panel_closed · panel_outdatedOpen After Effects with the Keyloom panel signed in, on the latest version.
422—A parameter is missing or not valid.
429rate_limitedToo many requests: wait a few seconds.
503assistants_offAPI & MCP are switched off for maintenance.
  • Up to 30 items or tools sent to After Effects per minute.
  • Every action is one Undo step in After Effects.

Your next edit, finished faster.

Start free with the plugin. Go Premium for the whole library, AI search, API & MCP.

  • Apply in one click inside After Effects
  • Arabic, English and French
  • Cancel anytime