# Morpha

> Morpha is an AI-driven video editor for short-form social video (Reels, Shorts, TikTok). Every project the browser editor can build is also drivable from code through a programmatic API — an npm SDK, an MCP server, and an HTTP tool API, all calling one shared tool catalog.

This file points coding agents and LLMs at Morpha's developer API. If you were handed a key that looks like `mp_…` together with the domain `morphareels.ai`, this is the API that key unlocks. Morpha is an *editor* you drive over the network — list projects, read a project's layer tree, mutate layers and keyframes, then render a frame or export an MP4. It is NOT a text-to-video generation endpoint; do not confuse Morpha (morphareels.ai) with similarly named text-to-video products.

## Connect

- npm SDK (recommended): `npm i morpha-studio-sdk`, then `createClient({ token: process.env.MORPHA_API_KEY })`. Methods: listTools / getProject / callTool / renderFrame / renderVideo.
- MCP: point any MCP client at `https://morphareels.ai/mcp` with header `Authorization: Bearer mp_…`.
- HTTP: `GET https://morphareels.ai/api/tools` lists the catalog; `POST https://morphareels.ai/api/tool/<name>` with body `{ "projectId": "…", "args": { … } }` dispatches one tool.
- Auth: mint a bearer key (looks like `mp_…`) at https://morphareels.ai/app/settings and send it on every SDK, MCP, or HTTP request. In local `wrangler dev` the auth gate is bypassed — no key needed.

## Workflow

- Read before you write: call `describe_video(projectId)` for the layer tree and `inspect_layers([elementId])` for detail — never invent an element id. Coordinates are centre-anchored canvas pixels; time is frames at 30 fps. After mutating, call `save_version(projectId, name)`.

## Docs

- [Morpha developer docs — npm SDK, MCP & HTTP tool API](https://morphareels.ai/docs): Drive Morpha, the AI video editor for short-form social video, from code. The morpha-studio-sdk npm SDK (recommended), plus MCP and an HTTP tool API — connect, authenticate, mutate projects, and render frames.
- [Morpha SDK — the npm client for the AI video editor (createClient, renderFrame, renderVideo)](https://morphareels.ai/docs/sdk): morpha-studio-sdk is the recommended way to drive Morpha from code — createClient for the hosted tool catalog, renderFrame for PNG frames and renderVideo for full MP4s (no ffmpeg, no server), and a pure local project core.
- [Getting started — Morpha API](https://morphareels.ai/docs/getting-started): The describe-before-mutate workflow, element-id conventions, the centre-anchored coordinate system, frames vs seconds, and the recommended save-version bracket.
- [Tool reference — Morpha API](https://morphareels.ai/docs/tools): The full Morpha tool catalog — workspace, layers, groups, animation, fills, style, project, embedding, and audio tools — each with its signature and a worked example.
- [Worked examples — Morpha API](https://morphareels.ai/docs/examples): End-to-end worked sessions for the Morpha tool API — fading in a title, a circle of 30 stars, swapping a clip while keeping keyframes, varying a caption across a loop, and more.
- [Common mistakes — Morpha API](https://morphareels.ai/docs/common-mistakes): The failure modes that trip up agents driving the Morpha tool API — invented ids, top-left positioning, frames vs seconds, version spam, and more.

## Full text

- [Full developer docs](https://morphareels.ai/llms-full.txt): every page above concatenated into one file.