# Cardboard MCP MCP Server

> **Cardboard MCP MCP Server** is a hosted, multitenant Model Context Protocol (MCP) server run by **MewCP** (https://mewcp.com), giving AI agents managed access to Cardboard MCP.
>
> MewCP takes care of all MCP infrastructure for you — credential storage, OAuth flows,
> token refresh, and production-grade auto-scaling — so your AI agents can connect to
> third-party services and run freely without you managing any MCP server yourself.
>
> Server page:  https://mewcp.com/mcp/cardboard-mcp
> MewCP docs:   https://docs.mewcp.com
> All servers:  https://mewcp.com/servers (JSON: https://mewcp.com/api/servers)
> About MewCP:  https://mewcp.com/llms.txt

---

## About

Edit videos and create polished content using Cardboard's MCP server. Import footage from files or video links, trim and arrange clips, add captions, titles, music and voiceovers, search stock footage, generate media, inspect transcripts, preview edits, and export finished MP4 videos.

---

## Details

- Server ID: `cardboard-mcp`
- Version: 0.1.0
- Tools: 51
- Authentication: OAuth, managed by MewCP
- Transport: http

---

## Access

The gateway URL below serves your **entire MewCP toolset**, not this server on its
own. Pasting a config snippet is not enough — Cardboard MCP has to be in the toolset
first. In order:

1. Add Cardboard MCP to your toolset at https://mewcp.com/mcp/cardboard-mcp
2. Connect your Cardboard MCP account (OAuth); MewCP stores the credential and attaches it to each call
3. Add the gateway URL to your client (see Connect below). It signs in with OAuth
   the first time it connects, so there is no key to copy.

Once connected, an agent does **not** see this server's tools as top-level tools.
It sees four meta-tools and reaches everything through them:

- `search(query)` — find tools by keyword across the toolset
- `get_schema(tools)` — full description and arguments for the tools you picked
- `manage_connections(requests?)` — connection status and account aliases, plus
  links the user opens to add an app or connect an account
- `call_tool(app_maskedId, tool_name, args, alias?)` — execute

If Cardboard MCP isn't in the toolset or connected yet, `manage_connections` with
app_maskedId `cardboard-mcp` returns a link that adds it and connects an account.

So the list below is what `search` can return for this server, not a set of
callable tool names on their own.

---

## Tools (51)

Descriptions are truncated to 160 characters; call `get_schema`
for the full text and the argument schema. Where a tool is annotated, its type
is shown — treat `destructive` as irreversible.

- `list_projects` _(read)_ — The account’s Cardboard projects with their ids, the most recently edited first, as text that reaches only you: the person sees none of it. show_projects lists…
- `create_project` _(write)_ — Create an empty project. Where the new project goes: Personal or a workspace, by its exact name or id. With one choice, it is selected for you. With several…
- `print_timeline` _(read)_ — The canonical timeline.tsx for a project: header (aspect, duration, media table, diagnostics, rev) and the tree. A timeline longer than one result comes back…
- `check_timeline` _(read)_ — Report what apply_timeline would change for the same edits or source, without writing.
- `apply_timeline` _(destructive)_ — Changes the timeline. `edits` are exact { oldText, newText } replacements copied from print_timeline, with its header `rev`; text outside them stays as it is,…
- `verify_timeline` _(read)_ — Lint the timeline: overlaps, gaps, off-screen text, clips past their source, missing media.
- `timeline_history` _(read)_ — Saved timeline revisions, newest first, and the project's set-aside versions: saves refused because another app held the project, or offline work that came…
- `undo_timeline` _(destructive)_ — Restore the previous timeline revision, or a specific rev from timeline_history.
- `list_media` _(read)_ — Media in a project with arrival state. Uploading means the browser is still sending the file; its content cannot be read yet. Preparing means the original is…
- `download_media` _(write)_ — Download what a link points at into a project: the video behind a post on YouTube, X, Instagram, TikTok or another video site, or a video, audio or image file.…
- `capture_web_page` _(write)_ — Screenshot a web page in a headless Chrome: the first screen, the full page, or one element. With a project the image is imported into it; without one it comes…
- `search_footage` _(write)_ — Video footage for a shot, found across stock libraries (Pexels, Pixabay), archives (Internet Archive, Wikimedia Commons) and, on plans with web footage,…
- `search_music` _(read)_ — Tracks from Cardboard's music library, ranked by how well each fits `query`, `genre` and `mood`; a filter nothing matches is dropped and the result says so.…
- `search_sfx` _(read)_ — Sound effects from Cardboard's library, ranked by how well each fits `query` within `category`. Each has its length, when it suits, a volume, and the link…
- `probe_media` _(read)_ — What a media file is: kind, duration, size, frame rate, codec, audio.
- `grab_frame` _(read)_ — One frame of a video or image at a source time, returned as an image.
- `filmstrip` _(read)_ — Evenly spaced frames of a video tiled into one image, left to right then down, with the source time of each tile.
- `waveform_image` _(read)_ — The audio of a media file drawn as an image.
- `waveform_levels` _(read)_ — Peak and RMS audio levels (0-1) sampled across a media file; for finding silence, beats or the loudest moment.
- `process_audio` _(write)_ — Clean voice, remove background music from speech, or split singing vocals and instruments. Creates two new project audio assets without placing them; both…
- `transcribe_media` _(write)_ — The transcript of a media file’s audio (any video or audio in the project), with per-word timings, in seconds. It uses Cardboard’s transcription, and the…
- `search_transcript` _(read)_ — Find a phrase across every media of a project that has a transcript (from transcribe_media). Returns source times per media and timeline times through the…
- `caption_from_transcript` _(write)_ — A <track kind="caption"> for the current timeline built from the media transcripts (transcribing any not cached yet, in seconds). Its items carry captionText…
- `generate_video` _(write)_ — For an edit, pass sourceVideo (a project video, optionally #from-to): the actual clip goes to Wan 3 and determines the duration. For a transition pass image…
- `generate_image` _(write)_ — Generate a still image from a prompt with a hosted model and put it on the timeline as an image item. The still takes its place on the timeline at `start`…
- `generation_status` _(write)_ — The state of a generation started by generate_video or generate_image. `wait: true` waits up to about 30 seconds: once the run ends it fills the pending clip…
- `generate_voice` _(write)_ — Narrate text with a hosted ElevenLabs v3 voice and place it on the timeline: a pending audio item is filled with the MP3, and its word timings are stored as…
- `generate_music` _(write)_ — Compose instrumental music with Sonilo and place it on a "Music" track: a pending audio item is filled with the finished track. `sections` change the mood at…
- `generate_sfx` _(write)_ — Generate a sound effect with ElevenLabs and place it on an "SFX" track: a pending audio item is filled with the MP3. Place one per moment, with `start` at the…
- `list_voices` _(read)_ — The account’s own voices for generate_voice: favourites, recent voices and its clones.
- `search_voices` _(read)_ — Search the ElevenLabs voice library, most-used voices first; needs a query or a filter. Page with `cursor`.
- `detect_silence` _(read)_ — Silent stretches in a media file’s audio (offline). Source seconds.
- `measure_loudness` _(read)_ — Integrated loudness (LUFS), loudness range, true peak and mean/max volume of a media file (offline).
- `detect_scenes` _(read)_ — Shot changes in a video, as source seconds (offline).
- `matte_media` _(write)_ — Separate the subject of a video or image from its background on a hosted GPU (costs credits); video mattes find people, image mattes the main subject. Returns…
- `look` _(read)_ — Composited frames of the timeline as the player shows them, returned as images.
- `export_video` _(write)_ — Render the project in Cardboard's export pool, from the originals in Cardboard's storage. Hands back a job at once (an export takes minutes for a long edit):…
- `read_recipe` _(read)_ — Read a file of the recipe a project was started from: its brief (recipe/RECIPE.md), its data such as recipe/structure.json, the person's answers…
- `docs` _(read)_ — Cardboard's documentation by topic. `cardboard` is Cardboard's editing guide, the one its own editor agent follows, with these tools in place of `cb`: the…
- `job_status` _(read)_ — Waits on a job a Cardboard tool handed back in place of its result (export_video does after a few seconds, any other tool once it runs past about 40 seconds).…
- `cancel_job` _(destructive)_ — Stop a running job: an export stops and leaves no file. Work that cannot stop once started says so and ends on its own; a generation always runs to the end.
- `upload_media` _(destructive)_ — Opens Cardboard's upload card in the chat, where the person picks video, audio or photo files (JPEG, PNG, HEIC, WebP or GIF) on their device and uploads them…
- `add_media` _(write)_ — Adds video, audio and photo files (JPEG, PNG, HEIC, WebP or GIF) attached to this chat to a project: Cardboard copies each into the project and prepares it as…
- `show_preview` _(read)_ — Opens Cardboard's player in the chat on a project's latest edit, and on its export once one finishes: the person watches the export there and saves the file…
- `project_status` _(read)_ — How a project's uploads, edits, preview renders, playback in the chat and exports went in the last 6 hours, as the person's cards showed them, and why…
- `show_projects` _(read)_ — Lists the person’s Cardboard projects for them, in a card in the chat: the most recently edited first, each with a picture from its footage, how long it runs…
- `card_state` _(read)_ — For Cardboard's card: a fresh session and the project's latest preview and export.
- `send_feedback` _(write)_ — Sends a report to Cardboard's team: something in Cardboard that went wrong (`bug`), something the person asked for that Cardboard can't do yet (`request`), or…
- `account_usage` _(read)_ — The person's Cardboard subscription and what it has left: exports, usage, generative credits and when they renew. For questions like "what plan am I on?", "how…
- `show_recipes` _(read)_ — What Cardboard can make: shows the person Cardboard's recipes in a card in the chat, the answer when they ask what Cardboard can make or do: finished edits by…
- `start_recipe` _(write)_ — Makes a new project from one of Cardboard's recipes: the recipe's brief, graphics and data in its recipe/ folder, the recipe's own media in the project, and…

---

## Connect

- URL: https://gateway.mewcp.com/personal/mcp
- Transport: Streamable HTTP (remote). Nothing to install.
- Sign-in: OAuth. On first connect the client opens a browser window to sign in
  to MewCP and approve access. No API key.
- Headless clients (SDKs, servers without a browser) send an API key instead:
  `Authorization: Bearer <API_KEY>`, key from https://mewcp.com/dashboard/api-keys

Agents setting themselves up: follow https://mewcp.com/SKILL.md

Step-by-step guide per client:

- Claude Desktop: https://mewcp.com/mcp/cardboard-mcp/connect/claude
- ChatGPT: https://mewcp.com/mcp/cardboard-mcp/connect/chatgpt
- Grok: https://mewcp.com/mcp/cardboard-mcp/connect/grok
- DeepSeek Harness: https://mewcp.com/mcp/cardboard-mcp/connect/dsh
- Mistral Vibe: https://mewcp.com/mcp/cardboard-mcp/connect/mistral-vibe
- VS Code: https://mewcp.com/mcp/cardboard-mcp/connect/vscode
- Cursor: https://mewcp.com/mcp/cardboard-mcp/connect/cursor
- Codex: https://mewcp.com/mcp/cardboard-mcp/connect/codex
- Claude Code: https://mewcp.com/mcp/cardboard-mcp/connect/claude-code
- OpenCode: https://mewcp.com/mcp/cardboard-mcp/connect/opencode
- OpenClaw: https://mewcp.com/mcp/cardboard-mcp/connect/openclaw
- Antigravity: https://mewcp.com/mcp/cardboard-mcp/connect/antigravity
- Hermes: https://mewcp.com/mcp/cardboard-mcp/connect/hermes
- Kimi Code: https://mewcp.com/mcp/cardboard-mcp/connect/kimi-code
- Grok Build: https://mewcp.com/mcp/cardboard-mcp/connect/grok-build
- Devin Desktop: https://mewcp.com/mcp/cardboard-mcp/connect/devin-desktop
- Zed: https://mewcp.com/mcp/cardboard-mcp/connect/zed
- Muse Code: https://mewcp.com/mcp/cardboard-mcp/connect/muse-code
- Cline: https://mewcp.com/mcp/cardboard-mcp/connect/cline
- Kilo Code: https://mewcp.com/mcp/cardboard-mcp/connect/kilo-code
- Kiro: https://mewcp.com/mcp/cardboard-mcp/connect/kiro
- Junie: https://mewcp.com/mcp/cardboard-mcp/connect/junie
- Amp: https://mewcp.com/mcp/cardboard-mcp/connect/amp
- Qwen Code: https://mewcp.com/mcp/cardboard-mcp/connect/qwen-code
- Goose: https://mewcp.com/mcp/cardboard-mcp/connect/goose
- Python: https://mewcp.com/mcp/cardboard-mcp/connect/python
- TypeScript: https://mewcp.com/mcp/cardboard-mcp/connect/typescript