Skip to main content

​
What you get

Tell Claude Code, in plain English:
“Turn this branch into a PR and give me a pull story link.”
It will:
  1. Push your branch with git push
  2. Create the PR with gh pr create
  3. Call the pull/story API to generate a narrated video
  4. Wait ~60-90 seconds
  5. Paste the pull story URL back into your chat
All without leaving your terminal.
Claude Code creating a PR and pull story in one command

​
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": "ps_live_your_key_here"
      }
    }
  }
}
If you commit .mcp.json, use an env reference instead: "PULLSTORY_API_KEY": "${env:PULLSTORY_API_KEY}".
3

Restart Claude Code

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

Try it

> Turn this branch into a PR and give me a pull story
Claude Code will chain git push → gh pr create → pull/story API → 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 PR URL or owner/repo/number. Returns the story URL.
​
get_pull_story
tool
Check the generation status of an existing pull story.
​
list_pull_stories
tool
List pull stories for a repo or all your recent stories.

​
Natural-language triggers

Any of these phrasings will typically trigger the tool:
  • “make this into a PR”
  • “create a pullstory for PR 123”
  • “explain what PR 456 does”
  • “summarize this pull request”
  • “walk me through the changes in #789”

​
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 GitHub account linked to your pull/story key doesn’t have read access to that repo. Install the pull/story GitHub App on the repo.

​
Next

MCP setup details

Works with Cursor, Windsurf, Claude Desktop too.

Full workflow cookbook

Step-by-step example with real output.