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": "${PULLSTORY_API_KEY}" }
    }
  }
}
On native Windows, use "command": "cmd" and "args": ["/c", "npx", "-y", "@pullstory/mcp@latest"].
3

Restart

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

Try it

Ask naturally:
Make a video explaining how auth works in this repo

​
Tools exposed

​
create_pull_story
tool
Input: structured brief with title, summary, files, optional repo, flow, and highlights Output: story ID, status, URLTriggers generation if an identical brief is not already cached.
​
get_pull_story
tool
Input: id returned by create_pull_story (brief_<16-hex>) Output: status (generating | ready | failed | not_found), URL, duration, scene count

​
Security

  • Keep your API key in your environment or password manager; do not commit raw ps_live_... values in project config
  • The key is sent only by the MCP server when it 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+. The MCP server is a stdio process, so it stays open waiting for JSON-RPC messages when launched manually.
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.