# Connect an AI agent to TopPost over MCP

Updated: 2026-10-01 · URL: https://www.toppost.ai/mcp/

TopPost has a hosted MCP server, so an AI agent can run the whole video editor for you. It uploads your footage, edits it, renders the video, sends a review link, reads the comments and schedules the post. Add the endpoint to your agent, authenticate with an API key, and there is nothing to install or host.

**Quick answer:** The TopPost MCP endpoint is https://app.toppost.ai/api/mcp (streamable HTTP). Authenticate by sending "Authorization: Bearer <your API key>" with a key created at https://app.toppost.ai/integrations. It exposes 45 tools.

**Key takeaways**

- One hosted endpoint, 45 tools, nothing to install or host.
- Works with Claude Code, Codex, Cursor, VS Code Copilot, Gemini CLI.
- Rendering runs on TopPost’s cloud; the agent gets back a finished MP4 and a review link.
- Edits made by your own AI use no TopPost credits, so you pay for storage only.

## What is the TopPost MCP endpoint and how do I authenticate?

| Setting | Value |
| --- | --- |
| Endpoint | https://app.toppost.ai/api/mcp |
| Transport | Streamable HTTP |
| Authentication | API key sent as a bearer token: Authorization: Bearer <your API key> |
| Create a key | https://app.toppost.ai/integrations |
| Tools | 45 |

Without a key the endpoint answers 401 and points to its authorization metadata, so a compliant MCP client can tell what it needs.

## How do I add TopPost to my agent?

1. **Create an API key.** Sign in to TopPost and create a key on the Integrations page (https://app.toppost.ai/integrations). Keep it private: it acts as you.
2. **Add the server to your client.** Point any client that supports streamable-HTTP MCP servers at https://app.toppost.ai/api/mcp and set the header Authorization: Bearer <your API key>. TopPost works with Claude Code, Codex, Cursor, VS Code Copilot, Gemini CLI.
3. **Ask for the job in plain language.** For example: “Upload these clips, cut them into a 30-second vertical video with captions, and send me a review link.”

In Claude Code, for example:

```
claude mcp add --transport http toppost https://app.toppost.ai/api/mcp --header "Authorization: Bearer <your API key>"
```

## What can an AI agent do in TopPost?

The agent works on the same editor a person uses, through these tool groups:

- Media: upload footage (up to 2 GB per file) or import it from a URL.
- Editing: read the edit as a video sheet, patch it or replace it. The sheet is HTML-like markup of beats, speech, cuts, text and motion.
- Motion graphics: read, lint and write HTML and CSS pages.
- Guidance: the same editing rules TopPost’s own agents follow.
- Rendering: managed in the cloud; the output is an MP4.
- Review: create a review link, list comments, reply and resolve them.
- Captions, the calendar and templates.

Two limits to know about: there is no project or code export (the export is the MP4), and there is no version history over MCP.

[Video: Motion graphics applied by the TopPost agent to real footage](/media/edits/5r2x9vKE3ql0ytLVdtQbj7HQ.mp4)

## What does it cost to connect my own AI?

Connecting your own AI adds no MCP fee. Edits made by your own AI use no TopPost credits, so you pay for storage only: edits your agent makes don’t spend TopPost credits, and storage is the only charge on this path. See the pricing page for storage limits by plan.

## TopPost: frequently asked questions

### What is the TopPost MCP server URL?

https://app.toppost.ai/api/mcp. It is a hosted streamable-HTTP endpoint, so there is nothing to run yourself.

### How does an agent authenticate with TopPost?

With an API key from https://app.toppost.ai/integrations, sent as Authorization: Bearer <your API key>.

### Which AI tools work with TopPost?

Claude Code, Codex, Cursor, VS Code Copilot, Gemini CLI. Any other client that supports streamable-HTTP MCP servers and custom headers should also connect.

### Can an agent render and post videos through TopPost?

It can build the edit, render it in the cloud and hand back an MP4 and a review link. It can also read review comments and schedule posts from the calendar.

**Keep exploring**

- [How TopPost works](https://www.toppost.ai/how-it-works/): The five-step workflow, raw footage to posted.
- [TopPost pricing](https://www.toppost.ai/pricing/): Plans, add-ons and storage-only pricing for your own AI.
- [TopPost vs HyperFrames](https://www.toppost.ai/compare/toppost-vs-hyperframes/): Hosted agent editing vs an install-and-render framework.

## Try TopPost free on your own footage

Drop in the clips you already shot. The agent edits, captions and formats them for every platform, then sends you a review link. [Try free now](https://app.toppost.ai/)