What is pull/story?
Pull/story turns any GitHub pull request into a narrated video walkthrough — complete with auto-generated architecture diagrams, code diffs, a blast-radius map of what the PR touches, and scene-by-scene narration explaining what changed and why. 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 “turn this into a PR” 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. Every PR you create or get tagged in auto-generates its pull story, and the link is posted to the PR description within about 60 seconds.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 /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 “turn this into a PR with a pull story” and it handles both steps — creating the PR via
gh CLI, then calling our API to generate and return the story link.How billing works
Pull/story is metered by video length, not PR 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.Node SDK
Coming soon.
Support
X / Twitter
Fastest: DM @echomosh_