StoryShort MCP Server

About StoryShort

Remote MCP server (OAuth 2.1) for StoryShort at storyshort.app: turns a story idea into a narrated faceless short video with AI-generated scenes and voice. Renders spend credits. Videos, images and narration are AI-generated. Official MCP Registry: app.storyshort/storyshort.

StoryShort tools (29)

Read from the live server on Nov 13, 2026. These are the tools your AI assistant can call once connected.

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"

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

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

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 i

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, ca

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

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'

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 serie

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 sp

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

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

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: ne

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 lik

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 t

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 faile

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

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), motionCred

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 th

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 anim

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

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 o

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

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". T

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

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. Thr

How to connect StoryShort to Claude, Cursor or VS Code

StoryShort runs as a hosted remote MCP server at https://storyshort.app/api/mcp. Add that URL to your MCP client's config (Claude Code, Cursor, Windsurf or VS Code) and the tools appear immediately, no install required.

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

Claude Code: claude mcp add --transport http storyshort https://storyshort.app/api/mcp. VS Code's .vscode/mcp.json uses a servers key instead of mcpServers (see how). Servers that require OAuth or an API key will prompt on first use.