Back to Docs

MCP Integration

Connect your AI coding assistant to Version Pill

Quick Start

1

Connect your client

Version Pill uses OAuth for authentication - no API keys needed. Just run one command:

Claude CodeRecommended
claude mcp add --scope user --transport http versionpill https://mcp.versionpill.com/mcp
Global Installation

The --scope user flag makes MCP available in all your projects. You only need to run this command once, and Version Pill will work everywhere.

A browser opens for OAuth authorization on first use.

Per-project installation (not recommended)

If you only want MCP in the current project, omit the --scope user flag:

claude mcp add --transport http versionpill https://mcp.versionpill.com/mcp

You'll need to run this in each project separately.

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "versionpill": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.versionpill.com/sse"]
    }
  }
}
Cursor

Go to Settings → MCP → Add Server:

{
  "mcpServers": {
    "versionpill": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.versionpill.com/sse"]
    }
  }
}
2

Authorize in browser

On first use, a browser window will open to authorize access. Sign in and click "Authorize".

3

Verify installation

Check that Version Pill is available in Claude Code:

claude mcp list

You should see versionpill in the list. If you used --scope user, it will show as a global MCP.

4

Start using MCP tools

Once connected, you can ask your AI to manage tasks, create releases, and more. Try asking: "List my Version Pill projects"

API Key Authentication (Advanced)

For CI/CD pipelines and scripts where OAuth flow isn't practical, you can use API keys. Create one in Settings.

npx mcp-remote https://mcp.versionpill.com/sse?key=YOUR_API_KEY

Never commit API keys to version control. Use environment variables for security.

Available Tools

get_full_context

Get complete project state in one call - tasks, columns, releases, stats

"Get full context for my project"

brain_dump

Sync learnings, create follow-up tasks, add notes from development

"Brain dump: found a bug in auth, needs fixing before release"

list_projects

List all your Version Pill projects

"List my projects"

get_project

Get project details with task counts per column

"Get details for project xyz"

list_tasks

List tasks with optional column/type/priority filters

"Show me all bugs in the backlog"

create_task

Create a new task with title, description, type, priority

"Create a bug: login button not working on mobile"

update_task

Update task title, description, type, priority, or public status

"Update task abc to high priority"

move_task

Move task to a different column (backlog, todo, in-progress, done)

"Move task xyz to done"

list_releases

List published releases/versions

"Show recent releases"

create_release

Create a new release with version, title, and features

"Create release v1.2.0 with the completed tasks"

Example Workflows

Start of coding session

Get full project context before starting work:

"Get full context for my project and show me what's in progress"

During development

Move tasks as you work on them:

"Move the auth task to in-progress, I'm starting on it now"

End of session brain dump

Sync learnings and create follow-up tasks:

"Brain dump: completed auth, found a bug in the logout flow that needs fixing, also need to add rate limiting"

Create a release

Ship a new version with completed tasks:

"Create release v1.3.0 with the tasks we completed today"

Troubleshooting

MCP not available in other projects

If you installed MCP per-project (without --scope user), it won't work in other projects. To fix this:

1. Remove the per-project installation:

claude mcp remove versionpill

2. Install globally:

claude mcp add --scope user --transport http versionpill https://mcp.versionpill.com/mcp

Connection refused

Make sure you have npx installed and your API key is correct. Try running the command manually in terminal first.

Invalid API key

Check that your API key starts with vp_ and is active in Settings.

OAuth redirect fails

Make sure you're logged in to versionpill.com before authorizing. Clear browser cookies if issues persist.

Need to re-authenticate

If your OAuth session expires, restart Claude Code or run:

claude mcp remove versionpill && claude mcp add --scope user --transport http versionpill https://mcp.versionpill.com/mcp