Get Started

GhostShorts API & MCP server

Make videos from code and AI agents

Ask Claude, ChatGPT or Cursor for a Reddit story, a text message story, a quiz or an article video, and get a finished MP4 back. Or call the REST API from your own scripts. Included in every paid plan: there is no separate API plan.

Connect your AI Read the docs
  • 4 templates on REST and MCP
  • Signed webhooks
  • 1080x1920 MP4s
What you can make

Four templates, ready for your agent

Real videos made with GhostShorts. Each template has its own API page.

Reddit StoryYour own Reddit-style story narrated over gameplay footage, with a title card and captions.Reddit Story Video API
Text MessagesYour own chat conversation as an iMessage, WhatsApp, Instagram or Tinder chat, with a voice per side.Fake Text Message Video API
AI Quiz VideoA multiple-choice quiz short: question, countdown, answer reveal with a fact line, narrated.Quiz Video API
Article to VideoAn article, blog post or newsletter (URL or pasted text) turned into a narrated short with captions.Article to Video API
Connect your AI

Ask your assistant for a video

Connect once, then just ask. The GhostShorts MCP server:

No key needed

Claude.ai or Claude Desktop

  1. Settings, Connectors, Add custom connector.
  2. Name it GhostShorts and paste as the URL.
  3. Click Add, then Connect. Sign in to GhostShorts and click Allow.
API key

Claude Code

Create an API key, then run one command:

Terminal
claude mcp add --transport http ghostshorts https://api.ghostshorts.com/mcp --header "Authorization: Bearer gs_live_..."
API key

Cursor

One click adds GhostShorts to Cursor. Then replace gs_live_... with your key.

Add to Cursor

Settings, API keys in the app shows this link with your key already filled in.

API key

ChatGPT, n8n and your own code

Any MCP client works with an API key. Prefer plain HTTP? One request makes a video.

REST quick start
What it costs

Included in every paid plan

The API and MCP server use the same plan, videos and credits as the app. There is no API surcharge.

See plans
  • Each video uses one video from your plan's monthly allowance.
  • AI narration is included on current plans, within fair use.
  • Check the cost first: the estimate endpoint spends nothing.
  • Previews and scripts use no credits, and a refused request costs nothing.
FAQ

Questions about the API

Do I need a separate API plan?

No. API keys and connected AI assistants use the same plan, videos and credits as the app. Any paid GhostShorts plan includes API and MCP access.

Which AI assistants can make GhostShorts videos?

Any MCP client. Claude.ai and Claude Desktop connect without a key; Claude Code, Cursor, ChatGPT and n8n connect with an API key.

Which videos can I make through the API?

Four templates today: Reddit Story, Text Messages, AI Quiz Video and Article to Video. Every video is a 1080x1920 MP4.

How long does a video take?

Usually about a minute. Poll the video every 20 seconds or so, or pass a webhook URL and we tell you when it is done.

How do I get the finished video?

The finished video has a download link that needs no key and works for 7 days. You can also make up to 10 videos in one request.

Can I check the cost before I make a video?

Yes. The estimate endpoint returns the cost without spending anything, and each template has a preview or script step that uses no credits.

Make your first video from your AI

Connect once, ask for a video, get an MP4 back in about a minute.

Create an API key