
StoryShort
Remote MCP server that turns a story idea into a faceless short video
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://storyshort.app/api/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"storyshort": {
"url": "https://storyshort.app/api/mcp"
}
}
}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

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media