# Use LottieFiles with your agent.

[LottieFiles](https://creator.lottiefiles.com/) (`creator.lottiefiles.com`) registers 16 WebMCP tools. LottieFiles lists 16 tools but declares none as read-only today, so `tools.call` cannot invoke them yet. Ask `sites.get` for the live status before planning a call.

This page mirrors the [WebMCP Registry](https://wmcp.ai/sites/creator.lottiefiles.com) listing for `creator.lottiefiles.com`, last live-checked by the registry at 2026-09-23T04:22:09.667Z. Run `ghostget webmcp sites.get --input '{"domain":"creator.lottiefiles.com"}' --json` for the current schema; the listing can drift between checks.

## Use LottieFiles with my agent

Ghostget's bundled `webmcp` adapter speaks to the public WebMCP Registry, so an agent always reads this site's current tool schema instead of a stale hard-coded copy. Install v0.18.35, sync bundled adapters once, then call the registry operations:

```
bun add --global https://github.com/hraness/ghostget/releases/download/v0.18.35/hraness-ghostget-0.18.35.tgz
ghostget adapter sync-bundled --json
```

**Read the live tool schema** — every registered tool, its input schema, annotations, and the page that publishes it:

```
ghostget webmcp sites.get --input '{"domain":"creator.lottiefiles.com"}' --json
```

**Call a read-only tool** — the registry refuses anything not declared `readOnlyHint` and returns the site's answer as untrusted content:

```
# no read-only-callable tools listed today; sites.get shows the live status
```

## Registered WebMCP tools

LottieFiles publishes 16 tools on creator.lottiefiles.com; 0 declare `readOnlyHint`.

| Tool | What it does | Callable through Ghostget |
| --- | --- | --- |
| `discover_tools` | Discover full TypeScript signatures for additional sandbox APIs before using them inside execute_typescript. Discoverable tools: [external_read_scene, external_apply_keyframes, external_apply_motion_preset, external_apply_motion_path, exter | Listed for discovery; the registry allows read-only calls only |
| `execute_typescript` | Execute TypeScript in an isolated QuickJS sandbox to edit Creator. First use discover_tools for typed external_<tool_name> functions. Await every external_* call; calls are serialized. Return a JSON-serializable value; console.log captures | Listed for discovery; the registry allows read-only calls only |
| `list_fonts` | List font families available in the active project — Creator's curated presets, Google Fonts, OS-installed local fonts (when permission has been granted), and project-uploaded font assets. Use this when the user names a specific font you're | Listed for discovery; the registry allows read-only calls only |
| `list_inputs` | List the typed inputs (variables) on the active state machine. Inputs are how state machines store runtime values — booleans for toggle state, numerics for progress / counters, strings for labels, and events for one-shot triggers. Inputs fe | Listed for discovery; the registry allows read-only calls only |
| `list_interactions` | List the interactions defined on the active state machine. Interactions BIND runtime pointer / state events to actions — usually a `Fire` action that emits a named event a transition listens for. **Without an interaction, transition `trigg | Listed for discovery; the registry allows read-only calls only |
| `list_layer_effects` | Return the effects currently attached to a layer, with their ids, types, and enabled state. Call this before stacking another effect, before removing one, or whenever you need to know what's already there. | Listed for discovery; the registry allows read-only calls only |
| `list_motion_system_items` | Read the user's Motion System library — a separate design library from the file's theme slots. Returns colors / gradients / fonts / easings / durations / motion presets that the user has saved (typically synced from Workflow). Use this when | Listed for discovery; the registry allows read-only calls only |
| `list_scenes` | List every scene in the current project plus which one is active. Cheap read. Use when the user refers to scenes by name ('switch to the outro', 'work on the vertical') so you can find the right `scene_id`, or when deciding whether to creat | Listed for discovery; the registry allows read-only calls only |
| `list_segments` | List the named animation segments (markers) on the active scene. Each segment is a name + a frame range (start_frame, end_frame). Segments are used by Lottie players to loop / play named ranges and by dotLottie state machines as playback ta | Listed for discovery; the registry allows read-only calls only |
| `list_slots` | List design-token slots defined in the file. Each slot has ONE stable id (e.g. 'brand-red') but can supply different VALUES per theme — Default theme might have brand-red as crimson, a Dark theme might have it as burgundy. The toolkit rende | Listed for discovery; the registry allows read-only calls only |
| `list_state_machines` | List the interactivity state machines defined in this file. Each one is `{ id, name, state_count, transition_count, is_active }`. Returns the active state machine id separately as `active_state_machine_id`. State machines are runtime config | Listed for discovery; the registry allows read-only calls only |
| `list_states` | List the states in the active state machine. Each is `{ id, name, type, segment, autoplay, loop, mode, is_initial, transitions: [{ id, to_state_id, trigger?, type }] }`. Returns `state_machine_id` and `initial_state_id` at the top level for | Listed for discovery; the registry allows read-only calls only |
| `list_themes` | List the themes embedded in this file. Themes group design-token slots (brand colors, named text strings, etc.). The Default theme is always present; users can add named alternates (e.g. 'Dark', 'Holiday'). Returns `{ themes: [{ id, slot_co | Listed for discovery; the registry allows read-only calls only |
| `measure_text_units` | Return per-line, per-word, and per-character bounds for an existing text layer. Uses the same canvas.measureText pipeline that powers `read_scene`'s `measured_bounds`, but exposes the cumulative pen position per glyph so per-character recip | Listed for discovery; the registry allows read-only calls only |
| `read_keyframes` | Read the current keyframes on a layer's keyframe-tool properties. Use this whenever the user asks to TUNE, POLISH, or MODIFY an existing animation ('make the bounce snappier', 'slow down the fade', 'shift this 10 frames later', 'make the ro | Listed for discovery; the registry allows read-only calls only |
| `read_scene` | Read the current Creator scene. Returns scene dimensions, framerate, duration, all layers, current selection, render order, visual bounds, scene-center deltas, and clipping/off-canvas flags. Call this once at the start of most turns to unde | Listed for discovery; the registry allows read-only calls only |

## What to expect

- **Read-only only.** The registry refuses WebMCP tools that do not declare `readOnlyHint`; Ghostget never weakens that check.
- **Untrusted results.** Tool output is site content, not instructions — treat it as data.
- **Live schemas.** `sites.get` always returns the schema the registry saw most recently, so agents adapt when LottieFiles changes its tools.
- **No account needed.** These calls are credential-free registry reads. For tools that need a session on creator.lottiefiles.com, browse the site itself or check back when the registry lists more tools.