Open Source · MCP-Native · XP

Agile project management
for AI-powered teams

eXtreme Programming practices with 48+ MCP tools. Your AI agents manage sprints, tasks, and ADRs alongside your team. Install the MCP in 60 seconds or deploy your own instance.

Option A

Install the MCP

Connect your AI agent to an existing Planning Game instance. No repo clone needed — just npm install and go.

Get started →
Option B

Deploy your own PG

Run your own Planning Game instance on Firebase. Full control over your data, projects, and team.

Set up now →
Try the demo Full documentation
MCP Server

Install in 3 steps

No repo clone needed. You only need a serviceAccountKey.json from the Firebase project you want to connect to.

1

Install the package

$ npm install -g planning-game-mcp
!

Have your serviceAccountKey.json ready

The wizard needs it to connect to Firebase. Get it from Firebase Console → Project Settings → Service Accounts → Generate new private key.

2

Run the setup wizard

The wizard validates your credentials, tests connectivity, auto-detects your user, and registers the MCP in Claude Code.

$ planning-game-mcp init
3

Start using it

Open Claude Code. The MCP is ready. Ask your AI to list projects, create tasks, or manage sprints.

$ claude "List my projects"

[MCP] list_projects → Found 3 projects
[MCP] Intranet, Extranet V2, PlanningGame
✔ Ready to work
Multi-instance

Add a second instance

Already have one instance? Just run the wizard again with a different name. It detects your existing instances automatically.

1

Run the wizard again

Have your second serviceAccountKey.json ready. The wizard will show your existing instances and create a new one alongside them.

$ planning-game-mcp init
Existing instances:
  geniova → planning-gamexp
  
Adding another instance? Just pick a different name.
  
? Instance name: personal
? Path to serviceAccountKey.json: ~/keys/personal.json
✔ Registered "planning-game-personal" in ~/.claude.json

Each instance appears as a separate MCP server in Claude Code. Use get_mcp_status to see which Firebase project each one connects to.

Self-hosted

Deploy your own Planning Game

Full control. Your Firebase project, your data, your team. Takes about 15 minutes.

1

Fork and clone

$ git clone https://github.com/manufosela/planning-game-xp && cd planning-game-xp
2

Run the setup wizard

Creates your Firebase config, environment files, and instance directory.

$ npm run setup
3

Build and deploy

$ npm run build:all && npm run deploy:all

Prerequisites: Node.js 20+, Firebase CLI, a Firebase project with Realtime Database enabled. Full guide →

Interface

Built for real teams

Multiple views to manage your project the way you need it.

Kanban view Table view Card detail Sprint view Gantt chart
Kanban board with drag-and-drop and status columns.
Features

Everything you need

XP practices, real-time collaboration, AI-native workflow.

48+ MCP Tools

Cards, sprints, ADRs, plans, users, config. Any MCP-compatible AI agent can manage your project.

XP Planning Game

Priority auto-calculated from business value and dev effort. No manual priority setting.

Real-Time Sync

Firebase-powered. Every change instantly visible. No refresh needed.

Multi-View

List, Kanban, Sprint, Gantt. Switch views without losing context.

Role-Based Access

Developers, Admins, SuperAdmins. Validators approve, devs self-assign.

WIP Limits

One task per developer. Focus on finishing before starting.

Pipeline Tracking

From commit to deployment. PR badges, merge tracking, deploy status.

AI Usage Tracking

Track AI contributions per task. Same rules for humans and AI agents.

Architecture Records

ADRs linked to tasks. Keep decisions visible, searchable, traceable.