Skip to content
MCP server

StoryShort

Remote MCP server that turns a story idea into a faceless short video

Install
Pricing
Paid
Platforms
Web, API
Runs
Remotely
Version
1.0.0
Listing updated
3 days ago

About StoryShort

StoryShort is a paid MCP server for design and media. It runs as a hosted remote server, so there is nothing to install locally.

Videos are generated from a topic, a niche, an art style and a target length, and the same engine is reachable through a REST API with Bearer-token keys. Output is aimed at vertical formats such as TikTok, YouTube Shorts and Instagram Reels.

Usage is metered in credits. A standard video costs 40 credits, an avatar video built on Veo 3.1 with audio costs 100, and ElevenLabs narration adds 25. Art styles such as brick toy, comic, storybook cartoon and hand-drawn anime cost the same as the standard style. The developer page lists an OpenAPI 3.1 spec, an MCP server card and an llms.txt for machine-readable docs.

Install

Run in a terminal

claude mcp add --transport http storyshort https://storyshort.app/api/mcp

Add to Settings → Connectors → Add custom connector

https://storyshort.app/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "storyshort": {
      "url": "https://storyshort.app/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "storyshort": {
      "type": "http",
      "url": "https://storyshort.app/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "storyshort": {
      "serverUrl": "https://storyshort.app/api/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "storyshort": {
      "type": "http",
      "url": "https://storyshort.app/api/mcp"
    }
  }
}

Tools this server provides (29)

Read directly from the server.

create_video
Create (enqueue) a new AI faceless video from a topic. Returns immediately with a video id and status "PENDING"; the render runs asynchronously — poll get_video every 20-30 seconds until status is "COMPLETED" (playable videoUrl) or "FAILED". Costs 40 credits with the default voice (+25 for a language only ElevenLabs speaks, e.g. Persian); art style does not change the price. A short balance is ref
get_video
Get the status and details of one video the caller owns, by id. While rendering, status is PENDING/GENERATING_*/RENDERING and estimatedCompletionTime (seconds) is returned. When status is COMPLETED, a playable videoUrl and thumbnailUrl are returned; when FAILED, error says why, and a failure for lack of credits adds blockedReason "INSUFFICIENT_CREDITS" with creditsNeeded, creditsAvailable and topU
list_videos
List the caller's videos, newest first, with pagination. Optionally filter by status (one of the VideoStatus values in the schema). Returns id, title, status, videoUrl, thumbnailUrl and timestamps. Requires the "video:read" scope. Read-only, never charges credits.
list_niches
List the available content niches, art styles, video qualities and durations that create_video accepts. Use this to pick valid niche/artStyle values. Requires the "video:read" scope. Read-only, never charges credits.
get_credit_balance
Get the caller's current credit balance, monthly allocation and plan. Use this before create_video to confirm the account can afford a render (40 credits). Requires the "credits:read" scope (included by default in new keys); a key without it gets 403 INSUFFICIENT_SCOPE with a link to create a key that has it. Read-only, never charges credits.
list_social_accounts
List the connected publishing accounts (YouTube, TikTok) with username, whether they need reconnecting, the publish mode, the AI-disclosure handling and today's platform limits. Never returns tokens. For a platform that is not connected, call get_connection_status to get a connectUrl. Requires the "video:read" scope. Free.
get_connection_status
Is this platform connected? If yes, returns the account. If not, returns connectUrl: the page that opens the platform's consent screen. Give it to the user — that consent is the only human step, once per platform; they must be signed in to the same StoryShort account as this API key — then call this again every 10 seconds (pollAfterSeconds) until connected is true and continue on your own. The lin
publish_video
Publish one of the user's COMPLETED videos. YOUTUBE: uploads to the connected channel with your title/description and privacy (public, unlisted, private); the "altered or synthetic content" disclosure is always set; madeForKids is the user's COPPA answer (ask them for a kids audience); nothing is appended to the description unless addAttribution is true (default false — only when the user asked fo
list_series
List the user's series (autopilot channels), newest first, with schedule, auto-post flags, active/paused state, credits per video and an estimate per month. Paginated (page, limit). Requires the "video:read" scope. Free.
create_series
Create a series: StoryShort makes a video on this niche every scheduleIntervalDays, and can auto-post it to YouTube. The series NAME is the topic every video is written from, so put the user's own subject in it. Creating or changing a series is FREE. While active, the scheduler makes one video every scheduleIntervalDays (the first at its next run, within about 30 minutes) and charges each video li
update_series
Change a series: how often it runs, YouTube auto-post, the madeForKids answer or the language. Only the fields you pass change. The name and niche cannot be changed (create a new series). Making an ACTIVE series run more often raises its spend, so it goes through the same credit check as resume_series. Creating or changing a series is FREE. While active, the scheduler makes one video every schedul
pause_series
Pause a series: the scheduler stops making (and charging for) its videos until resume_series. Videos already made are untouched. Requires the "video:create" scope. Free.
resume_series
Resume a paused series. Refused with SERIES_NEEDS_CREDITS when the balance cannot pay the next video, and with SERIES_LIMIT_REACHED at 5 active series. Creating or changing a series is FREE. While active, the scheduler makes one video every scheduleIntervalDays (the first at its next run, within about 30 minutes) and charges each video like any video, 40 credits with the default render, at render
get_series_performance
How YOUR OWN posted YouTube Shorts performed, per series: videos posted/measured, total/median/mean views, top 3 and bottom 3 videos (with outlierScore = views / series median), and views gained in the last 7 days vs the 7 days before. Use it to decide what to make next. Only your own videos; views come from daily YouTube snapshots; audience retention is not available. Requires the "video:read" sc
draft_video
Write a video's script and scenes WITHOUT rendering or charging, so the user can read and change it first. Returns draftId, the scenes (narration + visual prompt each) and the exact render price. Free, but it runs the script writer once: needs a balance that can pay for a render and is limited to 20 drafts per hour. Then: show it → update_draft / revise_scene → render_draft only after the user app
get_draft
Read a draft: its scenes (narration, visual prompt, length), whether the narration is long enough for the target duration, and the exact render price against the current balance. Free, read-only. Requires the "video:read" scope.
update_draft
Change a draft: its title and/or REPLACE all its scenes (1-12, each with scriptText and optional visualPrompt / durationSeconds). The narration you send is exactly what is spoken. To change one scene use revise_scene. Edits are screened like any prompt. Free; works only while the draft has not been rendered. Requires the "video:create" scope.
revise_scene
Change ONE scene of a draft in place: its narration (scriptText), its visualPrompt and/or its durationSeconds. Scene numbers start at 1 (see get_draft). Only the fields you pass change. Screened like any prompt. Free; draft only. Requires the "video:create" scope.
render_draft
Render an approved draft into the video. THIS IS THE ONLY STEP THAT COSTS CREDITS: the price is quote.credits from get_draft / draft_video, charged once after the render succeeds (a failed attempt costs nothing; StoryShort may retry a failed render automatically, up to 3 times, and the same video is never charged twice — cancel_video stops the retries). Call it first without confirmCredits to get
cancel_video
Cancel a video that has NOT started rendering: a draft, a video still queued (PENDING), or one whose failed render is waiting for an automatic retry. The video ends as FAILED "Cancelled" and is never rendered. Credits are charged only after a render succeeds, so normally nothing had been charged; if the ledger holds a charge for it, exactly that is refunded (idempotent, never twice) and refundedCr
quote_video
The exact credit price of a video with AI motion clips BEFORE it is made, and whether this account may make it. Read-only: nothing is created, reserved or charged, and no prompt is checked. Returns baseCredits (the normal video), motionCredits (115 credits per motion scene, each a 5-second clip, on top of the normal video price), totalCredits, the balance and whether it covers the total, maxMotion
get_character_sheet
Read the character sheets of one of your series: each sheet is a set of AI images of one fictional character, its images (id, view, url), which sheet and which image are chosen, how many sheets the series may still make (3 in total), and the exact price of a new sheet (23 credits for 5 images of a person, 11 for an animal or mascot). Free. Use this before create_character_sheet and tell the human
create_character_sheet
Make a character sheet for one of your series: 4-6 AI images (default 5: front portrait, full body, side, expressions) of ONE fictional character, from a text description. CHARGES credits: 23 credits for 5 images of a person, 11 for an animal or mascot. ALWAYS call get_character_sheet first and tell the human the price: the human, not the agent, decides to spend. This tool refuses unless confirm i
select_character_image
Choose which character sheet a series uses and which of its images is the main one. The main image is the reference every still of an episode is made from. Only your own READY sheets and their images can be chosen. Free. Requires the "video:create" scope.
quote_character_episode
Price one PLANNED episode (12-60 seconds, 3-8 shots) of a series with a confirmed season plan, starring the character the plan names. FREE: it spends nothing and starts nothing. Returns the shot plan (narration, action, camera and seconds of every shot), the exact credits (up to 313 credits for a default 12-second episode; longer ones (up to 60 seconds) cost more: an AI clip per shot, a still per
create_character_episode
Make the episode: 3-8 shots, 12-60 seconds, the same fictional character in every shot, narrated with captions. CHARGES credits (up to 313 credits for a default 12-second episode; longer ones (up to 60 seconds) cost more). ALWAYS call quote_character_episode first and tell the human the price: the human, not the agent, decides to spend. This tool refuses unless confirm is true, expectedCredits equ
plan_drama_season
Drama Studio writers room: turn a one-line premise into a short-drama season: a character bible (1-4 original fictional characters: name, role, look) and 2-8 episode scripts, each with a title, a logline, a script and a "cliffhangerLine". The cliffhanger is SPOKEN: the script's last sentence is exactly "cliffhangerLine" (an open hook for every episode but the last; a payoff plus one lingering ques
get_season_plan
Read the season plan of one of your series: the plan (logline, genre, narrator voice, language, style, cast with outfits, every episode), its hash, its status (none, saved, reviewed or confirmed) and the recorded season review (a checklist with pass or fail per rule, the season price and, if it ran, the AI review). Free. An episode can only be made from a plan that is reviewed and confirmed: use t
save_season_plan
Design, review and confirm the WHOLE season of a series before any episode is made. Free (no credits). A series is fully designed and reviewed before any video is produced, and its characters, voice and style are fixed in every episode. Three steps, one tool: (1) pass `plan` to save it (version 1: logline, genre, language, narratorVoiceId, styleTokens, characters[] with look, sheetId and wardrobeL

What it does

Script to video
Produces script, voiceover, captions and scenes from one story idea.
Art style choice
Offers styles including brick toy, comic, storybook cartoon and hand-drawn anime.
Avatar videos
Avatar videos use Veo 3.1 with audio.
Premium narration
ElevenLabs voices can be added for an extra credit cost.
REST API alongside MCP
The same generation is available through a documented REST endpoint.

Good for

  • Producing faceless short videos for TikTok or YouTube Shorts from a chat with an AI assistant
  • Automating batches of niche story videos from code
  • Trying different art styles for the same story idea
  • Adding video generation to an agent workflow

Pricing

Paid, from $19 a month

Plans from $19/month for 1,200 credits

Prices change. Check storyshort.app before you buy.

StoryShort FAQ

How is usage charged?

In credits: 40 for a standard video, 100 for an avatar video and 25 extra for ElevenLabs narration.

What does a paid plan cost?

Plans start at $19 per month and include 1,200 credits.

How do I authenticate API calls?

Send your API key as a Bearer token in the Authorization header.

Where is the MCP endpoint?

The registry lists a streamable-http endpoint at https://storyshort.app/api/mcp.

Is StoryShort free?

No. StoryShort is a paid product. Paid plans start at $19 a month.

How do I add StoryShort to Claude Code?

Run this command in your terminal: claude mcp add --transport http storyshort https://storyshort.app/api/mcp

What are the best alternatives to StoryShort?

The closest alternatives to StoryShort are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

Alternatives to StoryShort

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media