Chunkydotdev/bldbl-mcp

**Official MCP client for Buildable - AI-powered development platform that makes any project buildable**
This package enables AI assistants (Claude, GPT, etc.) to work directly with Buildable projects using the Model Context Protocol (MCP). AI assistants can get project context, manage tasks, track progress, and communicate with human developers.
🌟 What is Buildable?
Buildable (bldbl.dev) is an AI-powered development platform that makes any project buildable. It provides:
- **AI-Generated Build Plans**: Comprehensive project roadmaps with implementation details
- **Smart Task Management**: Automated task breakdown with dependencies and priorities
- **AI Assistant Integration**: Direct integration with Claude, GPT, and other AI assistants
- **Real-time Collaboration**: Seamless human-AI collaboration on complex projects
- **Progress Tracking**: Live monitoring of development progress and blockers
🚀 Features
- **Full Project Integration**: Get complete project context, plans, and task details
- **Autonomous Task Management**: Start, update progress, and complete tasks
- **Human Collaboration**: Create discussions for questions and blockers
- **Real-time Progress Tracking**: Live updates and status monitoring
- **Type-Safe API**: Full TypeScript support with comprehensive type definitions
- **Claude Desktop Ready**: CLI interface for seamless Claude Desktop integration
📦 Installation
Installing via Smithery
To install @bldbl/mcp for Claude Desktop automatically via Smithery:
Manual Installation
🚀 Quick Start
**Step 1: Install the MCP Server**
**Step 2: Get Your Buildable API Key**
1. Go to bldbl.dev and create an account
2. Create or select a project
3. Go to **Project Settings** → **AI Assistants** → **Generate API Key**
**Step 3: Configure Your AI Assistant**
**🤖 For Claude Desktop:**
Add this to your Claude Desktop config file (~/.config/claude/claude_desktop_config.json):
*Minimal setup - only API URL is auto-detected.*
**✨ For Cursor AI:**
**Option 1: One-Click Setup (Recommended)**
1. Go to your project on bldbl.dev
2. Navigate to **Integrations**
3. Click **"Add to Cursor"** - Done! 🎉
**Option 2: Manual Configuration**
Add this to your Cursor AI config file:
*Minimal setup - only API URL is auto-detected.*
**Step 4: Start AI-Powered Development!**
Once configured, your AI assistant has access to these powerful tools:
- **🏗️ get_project_context** - Understand your entire project structure
- **📋 get_next_task** - Find what to work on next based on priorities
- **▶️ start_task** - Begin working on a specific task
- **📊 update_progress** - Report detailed progress updates
- **✅ complete_task** - Mark tasks finished with comprehensive notes
- **💬 create_discussion** - Ask questions when you need human input
- **🔍 health_check** - Verify connection to Buildable
**💡 Example AI Conversation:**
🔧 Advanced Configuration
**Environment Variables**
3 environment variables are recommended for proper AI assistant tracking:
**Why AI Assistant ID matters:** This helps you track which AI assistant is doing what work in your project dashboard.
**CLI Usage**
You can also run the MCP server directly:
**Multiple Projects**
To work with multiple Buildable projects, create different MCP server configs:
🛠️ API Reference
BuildPlannerMCPClient
The main client class for interacting with Buildable projects.