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

# Reframe Videos With MCP

> Auto-crop landscape video to portrait (9:16) or square (1:1) with face tracking by asking your AI agent through Reap MCP.

> **For AI agents:** a documentation index is at [/llms.txt](/llms.txt). Every page is also available as markdown, just append `.md` to the URL.

## Overview

With Reap MCP connected, your AI agent can reframe a video to a social-friendly aspect ratio — portrait (9:16) or square (1:1) — using auto-tracking that keeps the active speaker centered.

If you have not connected Reap yet, start with [Connect Reap MCP Server](/help-center/connect-reap-mcp-server). The examples use Claude, but the same prompts work in any MCP-compatible agent.

<Note>
  Reframing runs on a video **uploaded** to Reap — a public URL is not supported for reframe. Ask your agent to upload the file first.
</Note>

## Reframe An Upload

```text theme={"system"}
Upload ~/Videos/panel.mov, then reframe it to vertical 9:16 with the speaker centered.
```

```text theme={"system"}
Reframe my last upload to square.
```

## Options You Can Ask For

* **Orientation** — portrait (9:16, default) or square (1:1).
* **Face tracking** — keep the active speaker centered (on by default), or ask for a fixed crop instead.
* **Auto-split** — Reap can split scenes automatically; ask to keep the video as one piece if you prefer.

```text theme={"system"}
Reframe my last upload to portrait, fixed crop, and keep it as one piece.
```

## How Your Agent Handles It

<Steps>
  <Step title="It uploads the video">
    Reframe needs an upload, so your agent uploads your `.mp4` or `.mov` first if it isn't already in Reap.
  </Step>

  <Step title="It proposes settings">
    Your agent shows the planned orientation and face-tracking choice, then asks you to confirm.
  </Step>

  <Step title="It tracks the job">
    Reframing runs asynchronously — ask for status anytime, and you'll get an email when it completes.
  </Step>
</Steps>

## Related

* [Create Clips With Reap MCP](/help-center/create-clips-with-reap-mcp)
* [Track & Download Results With Reap MCP](/help-center/track-and-download-results-with-reap-mcp)
* [Connect Reap MCP Server](/help-center/connect-reap-mcp-server)
* [MCP API Reference](/api-reference/mcp)