Buildable

Created By

chunkydotdev8 months ago

Buildable generates a phased backlog, scaffolds a private repo with CI, then serves JSON tasks through the Model-Controller-Prompt protocol. Any MCP-compatible assistant can pull tasks, push code, and move Kanban cards to Done.

# task-planning

# repo-scaffold

Overview Content Tools Comments

Overview

What is it?

@bldbl/mcp is an official npm package that connects AI assistants (Claude, Cursor, GPT) to the Buildable development platform via the Model Context Protocol (MCP).

Core Purpose

Enables AI assistants to autonomously work on software projects by:

Getting project context and understanding codebase structure
Finding and starting tasks based on priorities
Tracking progress and updating status in real-time
Communicating with human developers when input is needed

Key Features

🤖 AI Assistant Integration - Works with Claude Desktop, Cursor AI, and other MCP-compatible tools
📋 Smart Task Management - AI can start, update, and complete development tasks
💬 Human Collaboration - AI can ask questions and create discussions when blocked
📊 Progress Tracking - Real-time monitoring of what AI is working on
🔐 Secure Authentication - API key-based access with per-project permissions

Installation & Setup

Install: npm install -g @bldbl/mcp
Get API Key: Sign up at bldbl.dev → Project Settings → AI Assistants
Configure AI Assistant: Add MCP server config with 3 environment variables:
- BUILDABLE_API_KEY (your API key)
- BUILDABLE_PROJECT_ID (target project)
- BUILDABLE_AI_ASSISTANT_ID (unique identifier)

How It Works

AI gets project context → understands current state, tech stack, priorities
AI finds next task → gets recommended work based on dependencies
AI starts working → begins task with approach and time estimates
AI updates progress → provides detailed status with files modified, challenges
AI asks questions → creates discussions when human input needed
AI completes task → provides comprehensive completion summary

Target Users

Developers using AI assistants for coding (Claude Desktop, Cursor AI)
Teams wanting structured AI-human collaboration on projects
Companies building AI-powered development workflows

Business Model

Package: MIT licensed (free to use)
Platform: Commercial service at bldbl.dev
Strategy: Free client drives adoption of paid platform

Technical Details

Language: TypeScript with full type definitions
Protocol: Model Context Protocol (MCP) standard
API: REST-based communication with Buildable platform
Security: API key authentication, no hardcoded secrets

This package essentially turns any AI assistant into a collaborative development team member that can work autonomously while staying connected to human oversight and project management systems.

Server Config

{
  "mcpServers": {
    "buildable": {
      "command": "npx",
      "args": [
        "-y",
        "@bldbl/mcp"
      ],
      "env": {
        "BUILDABLE_API_KEY": "<YOUR-API-TOKEN>",
        "BUILDABLE_PROJECT_ID": "<YOUR-PROJECT-ID>",
        "BUILDABLE_AI_ASSISTANT_ID": "<NAME-YOUR-ASSISTANT>"
      }
    }
  }
}

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

Visual Studio Code - Open Source ("Code - OSS")Visual Studio Code

Howtocook Mcp基于Anduin2017 / HowToCook （程序员在家做饭指南）的mcp server，帮你推荐菜谱、规划膳食，解决“今天吃什么“的世纪难题； Based on Anduin2017/HowToCook (Programmer's Guide to Cooking at Home), MCP Server helps you recommend recipes, plan meals, and solve the century old problem of "what to eat today"

EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

Baidu Map百度地图核心API现已全面兼容MCP协议，是国内首家兼容MCP协议的地图服务商。

TimeA Model Context Protocol server that provides time and timezone conversion capabilities. This server enables LLMs to get current time information and perform timezone conversions using IANA timezone names, with automatic system timezone detection.

MiniMax MCPOfficial MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.

Tavily Mcp

Zhipu Web SearchZhipu Web Search MCP Server is a search engine specifically designed for large models. It integrates four search engines, allowing users to flexibly compare and switch between them. Building upon the web crawling and ranking capabilities of traditional search engines, it enhances intent recognition capabilities, returning results more suitable for large model processing (such as webpage titles, URLs, summaries, site names, site icons, etc.). This helps AI applications achieve "dynamic knowledge acquisition" and "precise scenario adaptation" capabilities.

DeepChatYour AI Partner on Desktop