Skip to main content
Glama

StoryShort MCP

Official MCP Registry

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 as Authorization: Bearer sk_live_...

  • Docs and API keys: https://storyshort.app/en/developers

  • Also on npm as a stdio server: npx -y @storyshort/mcp-server with STORYSHORT_API_KEY set (source in src/)

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/mcp

then run /mcp and authenticate storyshort (a browser opens: sign in and allow).

Gemini CLI

gemini extensions install https://github.com/airdropfi/storyshort-gemini-extension

VS 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

draft_video, get_draft, update_draft, revise_scene, render_draft, create_video, get_video, list_videos, cancel_video, quote_video, list_niches

Series

create_series, list_series, update_series, pause_series, resume_series, get_series_performance, plan_drama_season, get_season_plan, save_season_plan

Characters

create_character_sheet, get_character_sheet, select_character_image, quote_character_episode, create_character_episode

Account and publishing

get_credit_balance, list_social_accounts, get_connection_status, publish_video

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.

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-mcp

The 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 tools
storyshort_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

    A3.7/5.0

    Scored across 8 tools

    Disambiguation3/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      An 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
      -
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for faceless YouTube video automation, turning LLM-authored scripts into narrated, captioned videos with AI-generated images and motion.
      9
      MIT