MCP Server - PairCoder Docs

Pro Feature

MCP integration requires Pro or Enterprise license.

Prerequisites

Python 3.10+
Claude Desktop installed

Installation

bash

pip install 'bpsai-pair[mcp]'

# Verify
bpsai-pair mcp tools

Configure Claude Desktop

macOS

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

json

{
  "mcpServers": {
"paircoder": {
  "command": "bpsai-pair",
  "args": ["mcp", "serve"],
  "env": {
    "PAIRCODER_PROJECT": "/path/to/your/project"
  }
}
  }
}

Linux

Edit ~/.config/claude/claude_desktop_config.json

Windows

Edit %APPDATA%\Claude\claude_desktop_config.json

Verify Setup

Restart Claude Desktop (quit and reopen)
Start a new conversation
Ask: "List my pending tasks using paircoder"
Claude should call paircoder_task_list tool

Available MCP Tools

Tool	Description
Task Management
`paircoder_task_list`	List tasks with optional filters (status, plan, sprint)
`paircoder_task_next`	Get the next recommended task to work on
`paircoder_task_start`	Start a task and update status to in_progress
`paircoder_task_complete`	Complete a task and update status to done
Planning
`paircoder_plan_status`	Get plan status with sprint/task breakdown
`paircoder_plan_list`	List all available plans
Context
`paircoder_context_read`	Read project context files (state, project, workflow, config, capabilities)
Orchestration
`paircoder_orchestrate_analyze`	Analyze task complexity and get model/agent recommendation
`paircoder_orchestrate_handoff`	Create handoff package for agent transition
`paircoder_orchestrate_plan`	Invoke the planner agent for design and planning tasks
`paircoder_orchestrate_review`	Invoke the reviewer agent for code review tasks
Metrics
`paircoder_metrics_record`	Record token usage and cost metrics for an action
`paircoder_metrics_summary`	Get metrics summary (daily, weekly, monthly, or by task)
Integrations
`paircoder_trello_sync_plan`	Sync plan tasks to Trello board as cards
`paircoder_trello_update_card`	Update Trello card on task state change
Support
`paircoder_support_create`	Create a support ticket with auto-attached system info

Testing Tools Locally

bash

# Test task listing
bpsai-pair mcp test paircoder_task_list

# Test with parameters
bpsai-pair mcp test paircoder_task_list --status pending

# Test plan status
bpsai-pair mcp test paircoder_plan_status

Troubleshooting

Problem	Solution
Server won't start	Run `which bpsai-pair` to verify installation
Tools not appearing	Restart Claude Desktop completely
Tools return errors	Check `PAIRCODER_PROJECT` path exists
Python not found	Use full path in config (see below)

Python not found workaround

json

{
  "mcpServers": {
"paircoder": {
  "command": "/usr/bin/python3",
  "args": ["-m", "bpsai_pair.cli", "mcp", "serve"],
  "env": {
    "PAIRCODER_PROJECT": "/path/to/project"
  }
}
  }
}