storytok-agent

Make StoryTok videos from any coding agent or shell: narrated Reddit story videos, texting-story videos, auto captions, split-screen edits and AI highlight clips, as 1080×1920 MP4s. One package, three ways in. The npm package is storytok-agent; the installed command is storytok.

• CLI: npx -y storytok-agent story --reddit <url> --background "GTA 1.webm" --wait --out .

• MCP server: npx -y storytok-agent mcp for Claude Code, Claude Desktop, Cursor, Windsurf, Codex and any MCP client.

• Skill: skill/SKILL.md teaches agents without MCP how to use the CLI. Install it by copying skill/ to ~/.claude/skills/storytok/ (Claude Code) or wherever your agent loads skills from.

Billing is StoryTok's: 1 credit per rendered minute (2 with premium voices), from packs that never expire, 3 free minutes on every new account. Failed renders refund automatically. There is no subscription and nothing to cancel.

Install

Needs Node 20 or newer (node -v); npx downloads the package the first time it runs. Restart your agent after adding the server. With Claude Code, run the command in the folder you make videos from, or add -s user to register it everywhere.

Claude Code

claude mcp add storytok -e STORYTOK_API_KEY=stk_live_… -- npx -y storytok-agent mcp

Codex (~/.codex/config.toml)

[mcp_servers.storytok]
command = "npx"
args = ["-y", "storytok-agent", "mcp"]
env = { STORYTOK_API_KEY = "stk_live_…" }

Cursor / Windsurf / Claude Desktop (mcp.json)

{ "mcpServers": { "storytok": { "command": "npx", "args": ["-y", "storytok-agent", "mcp"], "env": { "STORYTOK_API_KEY": "stk_live_…" } } } }

Get a key at storytok.ai/settings/developer, or skip the copying: run npx -y storytok-agent login in your own terminal, approve the code in your browser, and the key is stored in ~/.config/storytok/config.json (restart the MCP server afterwards so it picks the key up).

Related MCP server: brainrot

What the agent can do

Every creating tool is two-phase: called without confirm it returns the cost estimate; the agent shows it, the user agrees, and only then does it render. Job creation sends an Idempotency-Key, so a retried call returns the same job instead of a second charge. Each key also has a rolling 24-hour credit cap (30 by default, editable in settings).

CLI

storytok login | logout | account | catalog | estimate | reddit
storytok story | text | captions | splitscreen | highlights
storytok job <id> | wait <id> | download <id> | jobs
storytok mcp

storytok --help lists every flag. Set STORYTOK_API_URL to point at another deployment.

Development

npm install
npm test          # unit tests against a mock API, plus an MCP round trip over stdio
node bin/storytok.js --help

MIT licensed. Issues and pull requests welcome.