> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mediamonster.app/llms.txt
> Use this file to discover all available pages before exploring further.

# SDKs and tools

> The TypeScript and Python SDKs, the mm command line, Postman and Bruno collections, and example projects — all generated from the same OpenAPI document.

Everything here is built from the [OpenAPI document](https://mediamonster.app/api/v1/openapi.json), so a skill added to the catalogue is in every SDK on its next release, with its options typed. Each one reads your key from `MEDIAMONSTER_API_KEY` when you don't pass one, and works the same with a [test key](https://docs.mediamonster.app/api/authentication.md#test-mode).

## TypeScript

```bash theme={"theme":{"light":"github-dark","dark":"github-dark"}}
npm install @mediamonster/sdk
```

Keep a live key on your server, never in a browser bundle.

```typescript theme={"theme":{"light":"github-dark","dark":"github-dark"}}
import { Mediamonster } from "@mediamonster/sdk";

const mm = new Mediamonster({ apiKey: process.env.MEDIAMONSTER_API_KEY });

// Any skill, by slug.
const job = await mm.skills.run("captions", {
  url: "https://example.com/clip.mp4",
  options: { style: "karaoke" },
});

// Or the skill's own method, generated from its operation.
const cutout = await mm.skills.backgroundRemover({ url: "https://example.com/photo.jpg" });

// A recipe by name, or steps written inline.
const run = await mm.recipes.run("tiktok-ready", { url: "https://example.com/clip.mp4" });

// Start without waiting, then wait on your own terms.
const started = await mm.recipes.run("podcast-to-clips", {
  url: "https://example.com/episode.mp3",
  wait: false,
});
const done = await mm.runs.wait(started.id);

// Send a file of any size your plan takes, straight to storage.
const upload = await mm.uploads.upload(file);
await mm.skills.run("transcript", { upload_id: upload.id });

// In a webhook receiver: throws unless the signature checks out.
const event = mm.webhooks.verify(rawBody, signatureHeader, process.env.MEDIAMONSTER_WEBHOOK_SECRET);
```

| Call | What it does |
| - | - |
| `mm.skills.run(slug, body)` | `POST /api/v1/run/{slug}` |
| `mm.skills.<camelCaseSlug>(body)` | The same, one method per skill |
| `mm.recipes.run(ref, body)` | `POST /api/v1/runs` with `recipe` — a slug or a saved recipe's id |
| `mm.recipes.run({ steps, … })` | `POST /api/v1/runs` with steps written inline |
| `mm.runs.wait(id)` | Polls a run or job until it settles |
| `mm.uploads.upload(file)` | Opens a [direct upload](https://docs.mediamonster.app/api/uploads.md), sends the bytes, completes it |
| `mm.webhooks.verify(body, header, secret)` | Checks `Mediamonster-Signature` and returns the event |

A run's body is the API's, so `dry_run: true` [prices it first](https://docs.mediamonster.app/api/run-skill.md#dry-runs) and `wait: false` starts it without waiting. A refused call throws with the API's `code`, `request_id` and `doc_url` — see [Errors](https://docs.mediamonster.app/api/errors.md).

## Python

```bash theme={"theme":{"light":"github-dark","dark":"github-dark"}}
pip install mediamonster
```

The same calls, in snake\_case.

```python theme={"theme":{"light":"github-dark","dark":"github-dark"}}
from mediamonster import Mediamonster

mm = Mediamonster()  # reads MEDIAMONSTER_API_KEY

job = mm.skills.run("captions", url="https://example.com/clip.mp4", options={"style": "karaoke"})
cutout = mm.skills.background_remover(url="https://example.com/photo.jpg")

run = mm.recipes.run("tiktok-ready", url="https://example.com/clip.mp4")
done = mm.runs.wait(run["id"])

upload = mm.uploads.upload(open("episode.mp3", "rb"))
event = mm.webhooks.verify(raw_body, signature_header, webhook_secret)
```

## The `mm` command line

```bash theme={"theme":{"light":"github-dark","dark":"github-dark"}}
npm install -g @mediamonster/cli
```

| Command | What it does |
| - | - |
| `mm login` | Saves a key for this machine — paste it, or pass `--key mm_test_…` |
| `mm run <skill> <file>` | Runs a skill on a local file or a URL, and downloads the result |
| `mm recipe run <ref> <file>` | Runs a recipe by slug or id |
| `mm listen --forward <url>` | Forwards webhooks to a local address while you build — test runs included |

`mm --help` lists every command and its flags.

## Postman and Bruno

Import the OpenAPI document straight into either — `https://mediamonster.app/api/v1/openapi.json` — or use the ready-made collections in the repository: `docs/api/postman_collection.json` for Postman and the `docs/api/bruno/` folder for Bruno, with `apiKey` and `baseUrl` variables to fill in. The API reference in these docs has a playground too: paste a `mm_test_` key and every call there is free.

## Examples

Small example projects that run as they are with a test key, each showing one way in:

| Example | Shows |
| - | - |
| `shopify-product-images` | A folder of product photos through a ready-made recipe, in Node |
| `podcast-to-clips` | An episode cut into clips, in Python |
| `nextjs-upload-form` | A browser upload sent straight to storage with a direct upload |
| `webhook-receiver-workers` | A Cloudflare Worker that checks every signature, rotation included |
| `mcp-configs` | Ready configs for Claude, ChatGPT, Cursor, VS Code and Codex |

## Generate your own

Any OpenAPI 3.1 generator works on the document. Each skill is its own operation — `runBackgroundRemover`, `runCaptions` — with its request as a JSON Schema and its price under `x-mediamonster`. `GET /api/v1/skills/{slug}` serves one skill's schema on its own.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.