Skip to main content

​
What you get

Tell Claude Code, in plain English:
“Make a pull story explaining the auth flow in this repo.”
It will:
  1. Identify the relevant files
  2. Read the meaningful line ranges
  3. Build a concise structured brief
  4. Call the pull/story MCP tool
  5. Paste the pull story URL back into your chat
All without leaving your terminal.
Claude Code creating a pull story video

​
Setup (2 minutes)

1

Get an API key

Visit pullstory.com/dashboard/api-keys → Create key.
2

Add the pull/story MCP server

Create or edit .mcp.json in your project root:
.mcp.json
{
  "mcpServers": {
    "pullstory": {
      "command": "npx",
      "args": ["-y", "@pullstory/mcp@latest"],
      "env": {
        "PULLSTORY_API_KEY": "${PULLSTORY_API_KEY}"
      }
    }
  }
}
Keep PULLSTORY_API_KEY in your shell or password manager. Do not commit a raw ps_live_... key in .mcp.json.
On native Windows, use "command": "cmd" and "args": ["/c", "npx", "-y", "@pullstory/mcp@latest"].
3

Restart Claude Code

Close and reopen, or run /mcp to reload. You should see pullstory listed.
4

Try it

> Make a pull story explaining the auth flow in this repo
Claude Code will read the relevant files, create a structured brief, call pull/story, and return the link.

​
Available tools

Once the MCP is wired up, Claude Code has access to these tools:
​
create_pull_story
tool
Generate a pull story from a structured code brief. Returns the story URL.
​
get_pull_story
tool
Check the generation status of an existing pull story.

​
Natural-language triggers

Any of these phrasings will typically trigger the tool:
  • “make a video explaining this feature”
  • “create a pullstory for auth”
  • “visualize this flow”
  • “walk me through how this code works”
  • “turn this branch into a pullstory”

​
Troubleshooting

Run /mcp inside Claude Code to list active servers. If pullstory is missing, check .mcp.json for JSON errors and restart.
Your PULLSTORY_API_KEY is wrong or revoked. Generate a new one at pullstory.com/dashboard/api-keys.
The generated brief is missing required fields or includes oversized excerpts. Ask Claude Code to use fewer files and tighter excerpts.

​
Next

MCP setup details

Works with Cursor, Windsurf, Claude Desktop too.

Full workflow cookbook

Step-by-step example with real output.