Getting Started

Get DeepPlan MCP running in your IDE in under 5 minutes.

Prerequisites

  • Node.js 18+ or Bun 1.0+
  • An OpenRouter API key — get one here
  • An MCP-compatible IDE (Windsurf, Cursor, or VS Code with MCP extension)

Installation

1. Clone the repository

git clone https://github.com/deepplan-mcp/deepplan.git
cd deepplan/client

2. Install dependencies

npm install
# or
bun install

3. Configure environment

Create a .env file in the client/ directory:

OPENROUTER_API_KEY=sk-or-v1-your-key-here
COUNCIL_MODEL=minimax/minimax-m2.5
LEAD_ARCHITECT_MODEL=google/gemini-3-flash-preview

4. Build

npm run build

5. Add to your IDE

Add the following to your MCP configuration:

{
  "mcpServers": {
    "deepplan": {
      "command": "node",
      "args": ["/path/to/deepplan/client/dist/index.js"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-v1-your-key-here"
      }
    }
  }
}

Your First Plan

Ask your IDE AI agent to upgrade a plan:

“I want to build a real-time chat app with SvelteKit and Cloudflare. Use the DeepPlan MCP to upgrade this plan.”

The agent will call upgrade_architecture_blueprint and receive a production-ready blueprint from the Council of Architects.

Next Steps