Agent access

Make StoryTok videos from your coding agent

One package, storytok, gives Claude Code, Claude Desktop, Cursor, Windsurf and Codex an MCP server, and gives every other agent a CLI and a skill file. You ask for a video in plain English. The agent writes the script, picks a voice and background from the catalog, shows you the cost in credits, renders it on StoryTok and saves the MP4 into your folder.

It spends the same credits as the app: 1 per rendered minute, 2 with premium voices, from the 3 free trial minutes onward. No plan, no OAuth setup, nothing to host. StoryTok does not post the video anywhere; you do.

Install

Get a key under Settings, Developer API, then paste the line for your client. Replace stk_live_… with the key.

claude mcp add storytok -e STORYTOK_API_KEY=stk_live_… -- npx -y github:juanditb/storytok-agent mcp

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

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

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

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

export STORYTOK_API_KEY=stk_live_…
npx -y github:juanditb/storytok-agent story --title "…" --script-file story.txt --background "Minecraft 4.mp4" --wait --out .

Or skip the key: storytok login

If you would rather not copy a key, run the login command. It prints a short code and a link; approve it in the browser while signed in to StoryTok, and the CLI stores a fresh key for that machine. The MCP server picks the stored key up automatically when STORYTOK_API_KEY is not set.

$ npx -y github:juanditb/storytok-agent login
Open https://storytok.ai/connect?code=K7QD4M2X
and approve code K7QD-4M2X (expires in 10 min). Waiting…
Connected as "Claude Code (2026-09-08)". Key saved to your config; STORYTOK_API_KEY overrides it if set.

What the agent can do

The CLI mirrors the same list: story, text, captions, splitscreen, highlights, estimate, reddit, job, wait, download, jobs. Run npx -y github:juanditb/storytok-agent --help for every flag.

The confirm-cost rule, and the daily cap

Every creating tool is two-phase. Called without confirm it returns an estimate: minutes, credits, your balance, and whether you are short. Only a second call with confirm: true reserves credits and queues the render. The tool descriptions instruct the agent to show you the estimate and wait for a yes, so a sensible agent will not spend on its own. On the CLI the same rule is the --yes flag: without it the command prints the estimate and exits with code 3.

Two more guards sit underneath. Job creation sends an idempotency key derived from the inputs, so a retried call returns the job it already made instead of rendering twice. And every API key carries a rolling 24-hour credit cap, 30 credits by default, which you can change per key under Settings, Developer API. If a render fails for any reason the reservation is refunded automatically.

Three example conversations

Troubleshooting

no_api_key

No key in STORYTOK_API_KEY or ~/.config/storytok/config.json. Run npx -y github:juanditb/storytok-agent login, or put the key in your MCP config as shown above.

insufficient_credits (402)

The estimate is larger than your balance. The tool refuses to confirm and nothing is charged. Shorten the script, or add a pack at /pricing.

too_many_active_jobs (429)

Three renders are already running on your account. Wait for one to finish (wait_for_job), then retry.

daily_cap_reached (429)

This key has reserved its 24-hour cap, 30 credits by default. Raise it under Settings, Developer API, or wait for the window to roll.

idempotent_replay

Identical inputs rendered recently, so that job was returned instead of a second charge. Pass fresh: true (MCP) or --fresh (CLI) to force a new render.

not_confirmed (CLI exit code 3)

The command printed the estimate and stopped because --yes was not passed. Show the estimate, get a yes, then re-run with --yes.

Questions

Building something that is not an agent? The raw REST API, job schema and webhook signing are documented at /developers. The package is open source at github.com/juanditb/storytok-agent.