MCP Connector

Connect AutoShortForm to Claude Code, Claude.ai, or any MCP-compatible AI agent to generate videos programmatically. Requires an API key from your profile page.

Connector URL

https://autoshortform.com/api/mcp

This is the endpoint you paste into any MCP client. Authenticate with a Bearer token using an API key generated from your profile.

Setup — Claude Code

Run this command in your terminal (replace YOUR_KEY with a key from your profile):

/mcp add autoshortform \
  --url https://autoshortform.com/api/mcp \
  --header "Authorization: Bearer YOUR_KEY"

After adding, Claude will have access to three new tools: list_presets, generate_video, and get_video_status.

Setup — Claude.ai / ChatGPT

Go to Settings → Integrations → Add integration and enter:

URL: https://autoshortform.com/api/mcp
Auth header: Authorization: Bearer YOUR_KEY

Available Tools

list_presets

List all background videos, music tracks, languages, and voices available to pass to generate_video.

generate_video

Queue a video render. The AI writes the script; you choose style, voice, and background. Returns a job_id to poll with get_video_status.

Parameters

scriptstringSpoken narration text (80–160 words). Plain text only.

titlestringShort title shown on-screen at the start.

languagestring · optionalLanguage of narration and captions. Default: english.

background_videostring · optionalVideo background ID from list_presets. Default: satisfying.

background_musicstring · optionalMusic track ID from list_presets. Default: minecraft.

voicestring · optionalTTS voice: alloy, echo, fable, onyx, nova, shimmer. Default: echo.

music_volumenumber · optionalBackground music volume 0–1. Default: 0.1.

voice_speednumber · optionalNarration speed 0.5–2.0. Default: 1.15.

caption_positionstring · optional'bottom' or 'top'. Default: bottom.

title_durationnumber · optionalSeconds the title is shown (0–10). Default: 3.

get_video_status

Check the status of a video render job. Poll every 10–15 seconds until status is 'done'. Returns the download URL when ready.

Parameters

job_idstringThe job_id returned by generate_video.

Example prompt for Claude

Make me a 45-second motivational TikTok video about not giving up.
Use the 'nova' voice, 'satisfying' background, and upbeat music.
Download and share the video URL when it's ready.

Claude will call list_presets to find matching options, write the script, call generate_video, then poll get_video_status until the video is ready.

Token usage

Each generate_video call costs 1 token from your balance. If a render fails due to an infrastructure error, the token is automatically refunded. Failed renders can be retried from your dashboard.

API key security

API keys are stored only as SHA-256 hashes — never in plaintext. Copy your key when it's created; it won't be shown again. Revoke keys from your profile at any time. Keys have no expiry but will be limited to 10 per account.