MCP

Use StoryCapture from an AI client

The StoryCapture desktop app runs an MCP server on your computer. Connect Claude or another MCP client and it can plan a demo video with you, write and rehearse the story against the real page, record it in the app, review the export and publish it.

Last updated

1. Turn on the server

In the StoryCapture app open Settings → Integrations and turn on MCP server. It listens only on this computer, on port 47823 unless you change it, and answers only clients that send its token, shown on the same page. New token makes a new one; clients set up with the old one stop working.

2. Connect your client

Claude Code

Copy the command from Integrations, or run it with your token:

claude mcp add --transport http storycapture http://127.0.0.1:47823/mcp --header "Authorization: Bearer <token>"

Claude Desktop

Install the StoryCapture extension from Claude's extension directory, or open the storycapture.mcpb file, and paste the token when it asks. The token is kept in your system keychain.

Cursor, VS Code, Windsurf and other clients

Clients that start servers over stdio run the @storycapture/mcp bridge with Node.js 20 or later. It relays your client to the app on this computer and nowhere else. Add it to the client's MCP settings:

{
  "mcpServers": {
    "storycapture": {
      "command": "npx",
      "args": ["-y", "@storycapture/mcp"],
      "env": { "STORYCAPTURE_MCP_TOKEN": "<token from Settings → Integrations>" }
    }
  }
}

Set STORYCAPTURE_MCP_PORT too if you changed the port. A token in a config file is kept in plain text there; New token in Integrations revokes it.

3. Make a video

Ask your client for a demo video of a page, or start the write_demo_video prompt. It interviews you, writes a beat sheet for you to approve, then builds and rehearses the story before anything is recorded. For a video already published, the improve_published_video prompt reads where viewers leave and re-records that one scene.

What asks you first

These tools wait for you to confirm in the app, unless you turn on Full access in Settings → Integrations:

  • record: Record
  • upload: Upload a video
  • resume_upload: Resume an upload
  • set_playing_version: Set the playing version

A story of a website records only its own browser window, not your screen. Uploads go to your StoryCapture workspace. See the privacy policy for what an AI client receives.

Tools

Plan the video

  • video_script_guide: Read the video guide
  • beat_template: Beat sheet template
  • validate_beat_sheet: Validate a beat sheet
  • story_skeleton: Story skeleton
  • dsl_reference: Story language reference
  • list_card_styles: List card styles
  • preview_card_style: Preview a card style
  • write_card_template: Write a card template
  • delete_card_template: Delete a card template
  • list_sounds: List sounds

Write and rehearse the story

  • list_projects: List projects
  • create_project: Create a project
  • read_story: Read a story
  • write_story: Write a story
  • validate_story: Validate a story
  • inspect_page: Inspect a page
  • run_simulator: Rehearse in the simulator

Record, review and export

  • record: Record
  • get_recording_status: Recording status
  • cancel_recording: Cancel a recording
  • list_recordings: List recordings
  • check_take: Check a take
  • preview_look: Preview the look
  • export: Export a video
  • get_job_status: Export status
  • list_exports: List exports
  • review_export: Review an export

Publish and improve

  • list_workspaces: List workspaces
  • upload: Upload a video
  • get_upload_status: Upload status
  • list_pending_uploads: List unfinished uploads
  • resume_upload: Resume an upload
  • watch_analytics: Watch analytics
  • set_playing_version: Set the playing version

Troubleshooting

  • "StoryCapture is not answering on port …": open the app and turn on the MCP server in Settings → Integrations; check the port matches.
  • "StoryCapture refused the token": a new token was made; copy it again from Integrations into your client.
  • A recording or upload never starts: the app is waiting for your confirmation; bring its window forward.