What is pull/story?
Pull/story turns a structured code brief into a narrated video walkthrough — complete with auto-generated architecture diagrams, code panels, and scene-by-scene narration explaining how the system works. The API lets you generate and retrieve pull stories without leaving your terminal, CI pipeline, or editor.Quickstart
Generate your first pull story in under 2 minutes.
Claude Code
Ask Claude Code “make a video explaining this feature” and get a pull story link back automatically.
Authentication
Mint an API key from the dashboard.
API Reference
Every endpoint, every parameter, every response.
Three ways to use pull/story
1. GitHub App (zero-setup, automatic)
1. GitHub App (zero-setup, automatic)
Install the pull/story GitHub App on any repo to auto-generate pull stories from PR activity where supported.No API calls required.
2. REST API (programmatic)
2. REST API (programmatic)
Use the REST API to generate pull stories from CI, scripts, internal tools, or anywhere you write code. Authenticate with a bearer token,
POST /api/v1/stories, poll until ready.Jump to the Quickstart →3. MCP server (for agents)
3. MCP server (for agents)
Pull/story exposes an MCP server that Claude Code, Claude Desktop, Cursor, or any MCP-compatible agent can call as a tool.Ask the agent “make a video explaining this feature” and it reads the relevant files, builds the brief, then calls our API to generate and return the story link.
How billing works
Pull/story is metered by video length, not request count.| Plan | Included | Overage |
|---|---|---|
| Free | 10 minutes of video / month | Generation blocked until next cycle |
| Pro | 120 minutes of video / month | $19 / month, overage blocked |
Base URL
All requests are served from:SDK & MCP
MCP Server
@pullstory/mcp — drop-in tool for Claude Code, Cursor, Windsurf.Claude Code workflow
Ask Claude Code to create the pull story from your editor.
What reviewers get
Pull/story should make review feel lighter, not add another noisy bot. A good story gives reviewers:- the intent of the change
- the runtime flow
- the risky files and behaviors
- code-linked chapters
- a transcript they can skim instead of watching
Support
X / Twitter
Fastest: DM @echomosh_