Morpha API

Morpha is an AI-driven video editor for short-form social video. You arrange layered elements — video clips, images, text, shapes — over a composition, animate them on a 30 fps keyframe timeline, and export an MP4. The editor runs in the browser; this site documents the programmatic API that drives the same projects from outside the editor.

What the API is for

Every project Morpha can edit in the browser, an external agent can edit over the network. The recommended way in is the npm SDK; beneath it are two raw protocol surfaces — all driving the same tool catalog:

They all call the same pure dispatch layer, so behaviour is identical whichever you use. A tool call loads the project from storage, applies the change, validates it against the schema, and writes it back.

The API is built for the work a person would never click through by hand: "place 50 stars at random positions, each with a staggered fade-in", "duplicate this layer 30 times in a circle", "recolour every shape along a gradient". One described instruction, hundreds of mutations.

npm i morpha-studio-sdk
import { createClient } from "morpha-studio-sdk";

const morpha = createClient({ token: process.env.MORPHA_TOKEN }); // origin defaults to https://morphastudio.ai

const tools = await morpha.listTools();
const project = await morpha.getProject("your-project-id");
const { result, project: next, editorUrl } = await morpha.callTool(
  "your-project-id",
  "describe_video",
  {},
);

createClient talks to the same Worker endpoints as MCP (GET /api/project/:id, GET /api/tools, POST /api/tool/:name); callTool does the load → dispatch → write round-trip server-side. It also renders a composited PNG frame with renderFrame, or the full composition to MP4 with renderVideo (no ffmpeg, no server — a real local browser does the encode). For local dev, createClient({ origin: "http://localhost:8787" }) needs no token. Full reference: the [SDK page](/docs/sdk).

Connecting over MCP

Add Morpha to your MCP client config:

{
  "mcpServers": {
    "morpha": {
      "url": "https://morphastudio.ai/mcp",
      "headers": {
        "Authorization": "Bearer mp_your_api_key_here"
      }
    }
  }
}

For local development against wrangler dev, point at http://localhost:8787/mcp — no auth header is needed in dev (ENVIRONMENT=development bypasses the auth gate).

Connecting over HTTP

The HTTP base URL is https://morphastudio.ai.

curl -X POST https://morphastudio.ai/api/tool/describe_video \
  -H "Authorization: Bearer mp_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "projectId": "your-project-id", "args": {} }'

Authentication

The SDK, MCP, and HTTP all use the same credential: a bearer API key.

  1. Sign in to the editor at morphastudio.ai/app.
  2. Open `/app/settings` and mint an API key. It looks like mp_… and is shown once — copy it immediately.
  3. Use it: createClient({ token: "mp_…" }) with the SDK, or send Authorization: Bearer mp_… on every MCP or HTTP request.

Keys are revocable from the same settings page. Each key maps to your account, so a tool call sees exactly the projects you'd see in the editor. In local wrangler dev the auth gate is bypassed entirely — no key required (createClient({ origin: "http://localhost:8787" })).

Where to go next

Morpha — AI video editor for short-form social video. Open the editor · Docs home