StoryShort
StoryShort MCP
Turn a story idea into a narrated faceless short video (script, AI voiceover, AI scene images, captions) from any AI assistant that speaks MCP. The primary way to use it is the hosted remote MCP server of StoryShort (nothing to install). This repository also holds the MIT-licensed source of the local stdio server (@storyshort/mcp-server on npm), which wraps the StoryShort public API /api/v1 with a smaller set of tools than the hosted server.
StoryShort (storyshort.app) is independent of storyshort.ai, a different company.
Endpoint:
https://storyshort.app/api/mcp(Streamable HTTP)Registry name:
app.storyshort/storyshort(Official MCP Registry)Auth: OAuth 2.0 with PKCE and dynamic client registration (discovered from
/.well-known/oauth-protected-resource), or a StoryShort API key asAuthorization: Bearer sk_live_...Docs and API keys: https://storyshort.app/en/developers
Also on npm as a stdio server:
npx -y @storyshort/mcp-serverwithSTORYSHORT_API_KEYset (source insrc/)
What you need
A StoryShort account. The server is a connector to your own account, not a free video generator: drafts are free, renders spend credits from your balance. See https://storyshort.app/en/pricing for the live plans and prices.
Related MCP server: WhisperCUT
Connect
Claude Code
claude mcp add --transport http storyshort https://storyshort.app/api/mcpthen run /mcp and authenticate storyshort (a browser opens: sign in and allow).
Gemini CLI
gemini extensions install https://github.com/airdropfi/storyshort-gemini-extensionVS Code (.vscode/mcp.json)
{
"servers": {
"storyshort": { "type": "http", "url": "https://storyshort.app/api/mcp" }
}
}Any other client that supports remote (Streamable HTTP) servers: add the URL above. If the client cannot do OAuth, create an API key in the StoryShort dashboard and send it as Authorization: Bearer sk_live_....
What the tools cover
29 tools, each with a title and read-only / destructive annotations:
Area | Tools |
Draft and render |
|
Series |
|
Characters |
|
Account and publishing |
|
Rules the server enforces: a draft is free and renders nothing; a render that the balance cannot pay is refused before it starts; impersonation of real people, protected characters and sexual content are refused. Videos use AI-generated images and a synthetic voice: switch on the platform's AI-content label when you post. No result or performance is promised.
Related
Gemini CLI extension: https://github.com/airdropfi/storyshort-gemini-extension
Privacy: https://storyshort.app/en/privacy · Terms: https://storyshort.app/en/terms · Support: support@storyshort.app
Run the stdio server from source
npm ci && npm run build
STORYSHORT_API_KEY=sk_live_... node dist/index.js # or: docker build -t storyshort-mcp . && docker run -i -e STORYSHORT_API_KEY storyshort-mcpThe stdio server registers 8 tools (generate video, get video, list videos, list niches, credit balance, usage stats, subscription, list API keys), 2 prompts and 2 resources. Without an API key it still starts and answers tools/list (no network needed), but every tool call is refused until a key is set. The hosted remote server above exposes the fuller tool set listed in the table.
About this repository
It holds the registry metadata (server.json, identical to the published registry entry), documentation and the source of the stdio server (src/, tests/, Dockerfile). The hosted server's own code runs at storyshort.app and is closed source. MIT license covers the contents of this repository.
Available Tools
8 toolsstoryshort_generate_videoA
Generate an AI video from a topic. Returns a video ID for status polling. Costs 40 credits with the default voice; art style does not change the price. The request is refused with 402 INSUFFICIENT_CREDITS (credits needed, available, top-up URL) when the balance is short. Rendering is asynchronous: poll storyshort_get_video every 20-30 seconds until status is COMPLETED or FAILED. If get_video returns blockedReason, stop polling and act on it (e.g. top up credits).
Inputs: topic (required), niche, quality, artStyle, +1 more.
storyshort_get_credit_balanceA
Check your current credit balance, monthly allocation, bonus credits, and plan tier.
Inputs: no named parameters.
storyshort_get_subscriptionA
Check your subscription plan, status, video limits, and credit allocation.
Inputs: no named parameters.
storyshort_get_usage_statsA
Get API usage statistics: credit balance, API call counts (today/total), and recent credit transactions.
Inputs: no named parameters.
storyshort_get_videoA
Get video status and details by ID. Use after generating to check progress. A video that failed for lack of credits returns blockedReason INSUFFICIENT_CREDITS with creditsNeeded, creditsAvailable and topUpUrl: it will not be retried.
Inputs: id (required).
storyshort_list_api_keysA
List your API keys with prefix, scopes, rate limits, and usage stats. Note: only key prefixes shown, never full secrets.
Inputs: no named parameters.
storyshort_list_nichesA
List available video niches, art styles, video qualities, and duration options for video generation.
Inputs: no named parameters.
storyshort_list_videosB
List your videos with optional pagination and status filter.
Inputs: limit, offset, status.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
The generate/poll/list video tools are clearly distinct, but three read tools overlap on billing information: get_credit_balance, get_subscription, and get_usage_stats all report credits/plan/allocation, so an agent asking 'how many credits do I have?' or 'what's my plan?' could reasonably land on any of them. Descriptions help somewhat but the boundaries are not clean.
Every tool follows the same storyshort_<verb>_<noun> pattern (get_credit_balance, get_subscription, generate_video, get_video, list_videos, list_niches, list_api_keys, get_usage_stats) with no camelCase or mixed-verb deviations.
Eight tools is well-scoped for a video-generation API: one generation action, one polling action, three list/introspection tools, and three account tools. Nothing feels padded or missing at the count level.
The core lifecycle (discover niches/options, generate, poll status, list past videos) plus billing introspection is covered end to end. Minor gaps remain: no delete/cancel for videos and API keys are list-only (no create or revoke), presumably pushed to the dashboard.
Maintenance
Related MCP Connectors
MCP server for Hailuo (MiniMax) AI video generation
Make, render and auto-post AI faceless videos to YouTube, TikTok and Instagram from any MCP client.
MCP server for Google Veo AI video generation
MCP server for Kling AI video generation
Related MCP Servers
AlicenseAqualityBmaintenanceCreate AI-powered videos from any MCP-compatible client. Generate videos with AI narration, visuals, and synced captions for short-form and long-form content.28MIT- FlicenseNot gradedqualityDmaintenanceAn MCP server that automates short-form video production for TikTok, Instagram Reels, and YouTube Shorts, using AI agents and behavioral science to generate production-ready videos from a topic and vibe.1-
- AlicenseAqualityDmaintenanceMCP server for faceless YouTube video automation, turning LLM-authored scripts into narrated, captioned videos with AI-generated images and motion.9MIT
- AlicenseNot gradedqualityDmaintenanceAutomated short-form video creation from text prompts, combining text-to-speech, captions, background videos, and music, exposed as an MCP server for AI agents.MIT