MCP Setup

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

Get an API key

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

Pick your client

Claude Code
Claude Desktop
Cursor
Windsurf

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"].

Edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows:

{
  "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"].

Cmd/Ctrl + Shift + J → MCP → Add new MCP server:

{
  "pullstory": {
    "command": "npx",
    "args": ["-y", "@pullstory/mcp@latest"],
    "env": { "PULLSTORY_API_KEY": "${PULLSTORY_API_KEY}" }
  }
}

Settings → Cascade → MCP servers:

{
  "pullstory": {
    "command": "npx",
    "args": ["-y", "@pullstory/mcp@latest"],
    "env": { "PULLSTORY_API_KEY": "${PULLSTORY_API_KEY}" }
  }
}

Restart

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

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

MCP server doesn't start

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.

'Tool not found' in the agent

The MCP server is listed but tools aren’t visible. Run /mcp (Claude Code) or restart the client. Some clients cache tool schemas.

'Unauthorized' on every call

Your API key is missing, wrong, or revoked. Check the value in your MCP config matches pullstory.com/dashboard/api-keys.

Getting Started

Integrations

What is MCP?

Install

Tools exposed

Security

Troubleshooting

​What is MCP?

​Install

​Tools exposed

​Security

​Troubleshooting

What is MCP?

Install

Tools exposed

Security

Troubleshooting