---
name: motion-reel
description: Schedule short vertical videos to Instagram Reels and YouTube Shorts (TikTok coming soon), post Instagram carousels, run Instagram comment-to-DM and read reel stats through Motion Reel's MCP server. Use when the user wants to post or schedule a reel or Short, send a DM to everyone who comments a keyword, answer comments, or see how their reels did.
---

# Motion Reel

Motion Reel (https://motionreel.app) schedules short vertical videos to Instagram Reels and YouTube Shorts (TikTok coming soon), turns Instagram comments into DMs and shows how each reel did. Your agent uses it through a hosted MCP server at https://motionreel.app/mcp, or the same actions as a REST API. It posts the videos the user already has; it doesn't make them.

The user needs a Motion Reel account: plans from $29 a month, each starting with 7 days free (https://motionreel.app/pricing). They connect their Instagram and YouTube accounts themselves in the dashboard, with each platform's own login. You can't connect accounts for them.

## Connect

Add the MCP server at https://motionreel.app/mcp (Streamable HTTP). Apps that sign in open the user's browser, and the user signs in and clicks Allow. The others take an API key the user makes in the dashboard under Agents & API.

### Claude Code

Run this in a terminal. Then type /mcp in Claude Code, pick motionreel and sign in: your browser opens, and you click Allow.

```
claude mcp add --transport http motionreel https://motionreel.app/mcp
```

### Claude app

In claude.ai or Claude Desktop, open Customize → Connectors, click + Add → Add custom connector and paste this URL. Then sign in and click Allow.

```
https://motionreel.app/mcp
```

### Codex

Run these in a terminal. The second opens your browser to sign in. The Codex app and IDE extension pick it up too.

```
codex mcp add motionreel --url https://motionreel.app/mcp
codex mcp login motionreel
```

### Grok

Go to grok.com/connectors and click New Connector, then Custom. Paste this URL, then sign in and click Allow.

```
https://motionreel.app/mcp
```

### OpenClaw

Make an API key in the dashboard under Agents & API, then run this in a terminal with your key in place of YOUR_KEY.

```
openclaw mcp set motionreel '{"url":"https://motionreel.app/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer YOUR_KEY"}}'
```

### Hermes Agent

Make an API key in the dashboard under Agents & API, then add this to ~/.hermes/config.yaml.

```
mcp_servers:
  motionreel:
    url: "https://motionreel.app/mcp"
    headers:
      Authorization: "Bearer YOUR_KEY"
```

### Cursor and other clients

Make an API key in the dashboard under Agents & API, then add it to ~/.cursor/mcp.json. Other clients send it in an Authorization: Bearer header.

```
{
  "mcpServers": {
    "motionreel": {
      "url": "https://motionreel.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}
```

Once it's connected, call `whoami` to check which accounts you can use.

## How to work with it

- Motion Reel schedules reels (vertical videos) to the user's connected Instagram accounts, YouTube channels (as Shorts) and TikTok accounts, and photo posts to Instagram and TikTok.
- Start with whoami: it lists the brands and accounts by id, the limits, and guide_url, a Markdown page with every rule and what each failure means. Never guess an account; if it's ambiguous, ask the user.
- Nothing goes out without the user's yes. Every tool that posts, schedules, messages or touches a comment only previews unless confirm is true: show the user the preview (accounts, local_time, caption, or the exact DM or reply and who gets it), get a clear yes, then do what the result's next says. cancel_post, delete_automation and delete_media act at once and can't be undone: ask the user first.
- To post: start_upload (url for a link to the file; size and type to send a file from a shell; neither for a page link the user opens on their phone), finish_upload unless it came back ready, then create_post with a new idempotency_key. Each post needs its own upload: files are deleted once posted.
- Send when with the user's own offset and pass their timezone (ask if you don't know it). If they want to check a reel first, or haven't said when, save a draft (draft: true) and give them finish_at.
- Some answers are the user's every time, never yours. YouTube: whether it's made for kids, and public, unlisted or private. TikTok: call tiktok_creator_info, then they choose a direct post or a TikTok draft (recommend the draft) and, for a direct post, who can see it and which interactions to allow; show its tiktok_declaration word for word.
- After posting, get_post gives each account's status and link, and a failed account's fix: tell the user what it says. get_analytics shows how the reels are doing.
- Comment-to-DM (Instagram) messages real people: whoami says whether an account is ready. When a result has problem, dm_hold, paused_because, stopped_because or ceiling_reached, tell the user what it says.

## Tools

### Post reels

Upload a video or hand over a link to one, schedule it to any of your accounts with each platform's own options, change or cancel it, and retry what failed.

- `start_upload`: Start an upload
- `finish_upload`: Finish an upload
- `create_post`: Schedule or draft a post
- `update_post`: Change a post
- `cancel_post`: Cancel a post
- `retry_post`: Retry a failed post
- `dismiss_post`: Dismiss a failed post
- `delete_media`: Delete an upload

### Check on posts

Every post with each account's status, the reason and the fix if one failed, and the link once it's live.

- `list_posts`: List posts
- `get_post`: Get a post

### Read the numbers

How your reels did over any period: totals, each day, each account's numbers and the top reels, with watch time and skip rate. Any reel's numbers, and a post's over time.

- `get_analytics`: Get stats for a period
- `get_reel`: Get any reel's stats
- `get_post_timeline`: Get a post's stats over time
- `refresh_stats`: Refresh a post's stats
- `refresh_all_stats`: Refresh recent posts' stats

### Comment-to-DM

Set up, change, pause and delete Instagram automations, and see what each one sent.

- `list_automations`: List comment-to-DM automations
- `get_automation`: Get an automation
- `create_automation`: Create a comment-to-DM automation
- `update_automation`: Change an automation
- `delete_automation`: Delete an automation

### Answer comments

Read a reel's comments, reply in public, DM the person who wrote one, or hide or delete it.

- `list_comments`: List a post's comments
- `reply_to_comment`: Reply to a comment
- `dm_commenter`: DM a commenter
- `hide_comment`: Hide a comment
- `delete_comment`: Delete a comment

### Know the accounts

Which accounts are connected and to which brand, the video limits, and a TikTok account's posting settings before each post.

- `whoami`: Show connected accounts
- `tiktok_creator_info`: Get TikTok posting options

### Make the reels

Get Motion Reel's free Claude Code skill, which writes, voices and renders short vertical videos, ready to post here.

- `get_free_skill`: Get the free reel-making skill

## REST API

The same operations are at https://motionreel.app/api/v1, with the key in an `Authorization: Bearer` header. `GET /api/v1` lists every endpoint. Keep the key in an environment variable such as `MOTIONREEL_API_KEY`, never in code or in the chat.

## More

- Every rule, limit and failure: https://motionreel.app/guide.md
- The whole site in Markdown: https://motionreel.app/llms.txt
- Setup for each app: https://motionreel.app/agents
- Help: support@motionreel.app
