Buildable
About
Official MCP server for Buildable AI-powered development platform. Enables AI assistants to manage tasks, track progress, get project context, and collaborate with humans on software projects.
Explore
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
BuildableCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
npm install @bldbl/mcp
npm install -g @bldbl/mcp
3 environment variables are recommended for proper AI assistant tracking:
export BUILDABLE_API_KEY="bp_your_api_key_here" # Your API key (required)
export BUILDABLE_PROJECT_ID="your-project-id" # Target project (required)
export BUILDABLE_AI_ASSISTANT_ID="my-ai-assistant" # AI Assistant ID (recommended)
You can also run the MCP server directly:
npm install -g @bldbl/mcp
bldbl
npx @bldbl/mcp
1. Generate API Key: Go to your Buildable project → AI Assistant tab → Generate API Key
2. Secure Storage: Store your API key securely (environment variables recommended)
3. Key Format: API keys start with bp_ followed by project and random identifiers
// Get usage statistics for your AI assistant
const stats = await client.getUsageStats();
console.log(
Tasks completed: ${stats.tasksCompleted});console.log(
Average completion time: ${stats.avgCompletionTime}min);console.log(
Success rate: ${stats.successRate}%);
npx @bldbl/mcp
npm install -g @bldbl/mcp
bldbl
Environment Variables Required:
- BUILDABLE_API_URL - Your Buildable API URL
- BUILDABLE_API_KEY - Your API key (starts with 'bp_')
- BUILDABLE_PROJECT_ID - Target project ID
- BUILDABLE_AI_ASSISTANT_ID - Unique assistant identifier
get_project_context
get_next_task
start_task
update_progress
complete_task
create_discussion
health_check
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"buildable": {
"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>"
}
}
}
}
}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>"
}
}
}export BUILDABLE_API_URL="https://bldbl.dev/api" # API endpoint (default)
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:
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
