@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:

npx -y @smithery/cli install @buildable/bldbl-mcp --client claude

Manual Installation

npm install @bldbl/mcp

🚀 Quick Start

Step 1: Install the MCP Server

npm install -g @bldbl/mcp

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):

{
  "mcpServers": {
    "buildable": {
      "command": "npx",
      "args": ["-y", "@bldbl/mcp"],
      "env": {
        "BUILDABLE_API_KEY": "bp_your_api_key_here",
        "BUILDABLE_PROJECT_ID": "your-project-id",