Skip to main content

​
What is MCP?

Model Context Protocol (MCP) is Anthropic’s open standard for giving AI agents access to tools. Any MCP-compatible client — Claude Code, Claude Desktop, Cursor, Windsurf — can call the pull/story tools once you wire up the MCP server.

​
Install

1

Get an API key

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

Pick your client

Edit .mcp.json in your project root:
{
  "mcpServers": {
    "pullstory": {
      "command": "npx",
      "args": ["-y", "@pullstory/mcp@latest"],
      "env": { "PULLSTORY_API_KEY": "ps_live_..." }
    }
  }
}
3

Restart

Close and reopen the client. Verify pullstory appears in your MCP server list.
4

Try it

Ask naturally:
Create a pull story for vercel/next.js PR 12345

​
Tools exposed

​
create_pull_story
tool
Input: owner, repo, number (or full PR URL) Output: story ID, status, URLTriggers generation if not already cached.
​
get_pull_story
tool
Input: story_id or owner + repo + number Output: status (generating | ready | failed), URL, duration, scene count
​
list_pull_stories
tool
Input: optional owner, repo, limit Output: array of pull stories
​
get_usage
tool
Input: none Output: minutes remaining, minutes used, plan name

​
Security

  • Your API key lives only in your local MCP config — it never leaves your machine except when the MCP server calls the pull/story API directly
  • The MCP server is open source — you can audit exactly what it sends
  • Revoke any key instantly from pullstory.com/dashboard/api-keys

​
Troubleshooting

Make sure you have Node 20+. Try npx -y @pullstory/mcp@latest --version in your terminal to verify installation works.
The MCP server is listed but tools aren’t visible. Run /mcp (Claude Code) or restart the client. Some clients cache tool schemas.
Your API key is missing, wrong, or revoked. Check the value in your MCP config matches pullstory.com/dashboard/api-keys.