Overview Connect Bilt MCP Server to OpenClaw for powerful AI-assisted development across all platforms. OpenClaw natively supports MCP with advanced features like background execution, tool discovery, and multi-agent workflows.
OpenClaw supports MCP out of the box with zero configuration required beyond adding servers.
macOS Full support for macOS 11+
Windows Full support for Windows 10+
Linux Full support for all major distros
Prerequisites
OpenClaw installed - Download from openclaw.ai Bilt API token - Get one at bilt.me/sign-up
Quick Setup Step 1: Locate Config File The OpenClaw config file location varies by platform:
~/.openclaw/openclaw.json
%USERPROFILE%\.openclaw\openclaw.json
Step 2: Edit Configuration # Create directory if needed mkdir -p ~/.openclaw # Edit config nano ~/.openclaw/openclaw.json
# Create directory if needed mkdir - Force " $ env: USERPROFILE \.openclaw" # Edit config notepad " $ env: USERPROFILE \.openclaw\openclaw.json"
Step 3: Add Bilt Configuration Add this to your openclaw.json:
{ "mcpServers" : { "bilt" : { "transport" : { "type" : "sse" , "url" : "https://mcp.bilt.me/mcp/sse" , "headers" : { "Authorization" : "Bearer bilt_live_YOUR_TOKEN_HERE" } }, "capabilities" : [ "tools" ], "metadata" : { "name" : "Bilt" , "description" : "Build and deploy native mobile applications" , "icon" : "🏗️" } } } }
Replace YOUR_TOKEN_HERE with your actual Bilt API token.
Step 4: Restart OpenClaw Right-click system tray icon → Restart Gateway
Step 5: Verify Connection You should see:
✓ MCP Server: bilt (8 tools) - bilt_list_projects - bilt_get_project - bilt_create_project - bilt_get_session - bilt_send_message - bilt_resume_workflow - bilt_cancel_workflow - bilt_get_messages
Configuration Options Basic Configuration Minimal setup:
{ "mcpServers" : { "bilt" : { "transport" : { "type" : "sse" , "url" : "https://mcp.bilt.me/mcp/sse" , "headers" : { "Authorization" : "Bearer bilt_live_YOUR_TOKEN" } } } } }
Advanced Configuration With metadata and capabilities:
{ "mcpServers" : { "bilt" : { "transport" : { "type" : "sse" , "url" : "https://mcp.bilt.me/mcp/sse" , "headers" : { "Authorization" : "Bearer bilt_live_YOUR_TOKEN" } }, "capabilities" : [ "tools" ], "metadata" : { "name" : "Bilt Application Builder" , "description" : "AI-powered native mobile app development and deployment" , "icon" : "🏗️" , "version" : "1.0.0" }, "enabled" : true , "autoStart" : true } } }
Environment Variables Use environment variables for tokens (recommended):
{ "mcpServers" : { "bilt" : { "transport" : { "type" : "sse" , "url" : "https://mcp.bilt.me/mcp/sse" , "headers" : { "Authorization" : "Bearer ${BILT_API_TOKEN}" } } } } }
Then set the variable:
# Add to ~/.zshrc or ~/.bashrc export BILT_API_TOKEN = "bilt_live_YOUR_TOKEN" # Reload shell source ~/.zshrc # Restart OpenClaw openclaw gateway restart
# Set permanently [ System.Environment ]::SetEnvironmentVariable( "BILT_API_TOKEN" , "bilt_live_YOUR_TOKEN" , "User" ) # Restart OpenClaw openclaw gateway restart
Multiple Environments Configure dev and production:
{ "mcpServers" : { "bilt-dev" : { "transport" : { "type" : "sse" , "url" : "https://mcp.bilt.me/mcp/sse" , "headers" : { "Authorization" : "Bearer ${BILT_DEV_TOKEN}" } }, "metadata" : { "name" : "Bilt (Development)" , "icon" : "🔧" } }, "bilt-prod" : { "transport" : { "type" : "sse" , "url" : "https://mcp.bilt.me/mcp/sse" , "headers" : { "Authorization" : "Bearer ${BILT_PROD_TOKEN}" } }, "metadata" : { "name" : "Bilt (Production)" , "icon" : "🚀" } } } }
Using Bilt in OpenClaw Natural Language Commands OpenClaw automatically discovers and uses Bilt tools:
You: "Use Bilt to create a todo app" OpenClaw: [Discovers bilt_create_project tool] [Executes tool with parameters] "Created project: todo-app (proj_abc123)" You: "Add authentication and dark mode" OpenClaw: [Uses bilt_send_message] "Building features... Progress: 45%"
You can also invoke tools directly:
You: "Call bilt_list_projects" OpenClaw: [Returns JSON with all projects]
Background Execution OpenClaw supports background tool execution:
You: "Build my landing page in the background" OpenClaw: [Starts bilt_send_message in background] "Build started in background. I'll notify you when complete." [5 minutes later] OpenClaw: "Your landing page is ready! Deployed to: https://..."
OpenClaw-Specific Features OpenClaw automatically:
Discovers all 8 Bilt tools
Parses parameter schemas
Suggests tools based on context
Error Handling OpenClaw provides enhanced error messages:
Error: 401 Unauthorized Suggestion: Your Bilt API token may be invalid. Try: openclaw config get mcpServers.bilt
Session Management OpenClaw maintains MCP sessions across restarts:
# Check active sessions openclaw sessions list # View Bilt tool calls openclaw logs --filter bilt
Rate Limit Handling OpenClaw automatically:
Respects rate limits
Retries with backoff
Shows rate limit status
Troubleshooting
Check status :View logs :Test connection :curl -H "Authorization: Bearer YOUR_TOKEN" \ https://mcp.bilt.me/mcp/health
Check token format :openclaw config get mcpServers.bilt.transport.headers.Authorization
Should return: Bearer bilt_live_... Update token :openclaw config set mcpServers.bilt.transport.headers.Authorization \ "Bearer bilt_live_NEW_TOKEN" openclaw gateway restart
Check network :Monitor latency :openclaw stats --server bilt
CLI Commands Configuration # View all MCP servers openclaw config get mcpServers # View Bilt config openclaw config get mcpServers.bilt # Update token openclaw config set mcpServers.bilt.transport.headers.Authorization \ "Bearer bilt_live_NEW_TOKEN" # Enable/disable server openclaw config set mcpServers.bilt.enabled true
Monitoring # Check gateway status openclaw gateway status # View logs openclaw logs --follow # View specific server logs openclaw logs --server bilt # Check tool usage stats openclaw stats --tool bilt_send_message
Management # Restart gateway openclaw gateway restart # Stop gateway openclaw gateway stop # Start gateway openclaw gateway start # Update OpenClaw openclaw update
Advanced Usage Webhook Integration OpenClaw can trigger webhooks on Bilt events:
{ "mcpServers" : { "bilt" : { "transport" : { "..." }, "webhooks" : { "onSuccess" : "https://your-app.com/webhook/build-complete" , "onError" : "https://your-app.com/webhook/build-failed" } } } }
Custom Prompts Define custom prompts for Bilt:
{ "mcpServers" : { "bilt" : { "transport" : { "..." }, "prompts" : { "create-app" : "Use Bilt to create a {type} native mobile application with {features}" , "deploy" : "Deploy {project} to production using Bilt" } } } }
Logging Configure detailed logging:
{ "mcpServers" : { "bilt" : { "transport" : { "..." }, "logging" : { "level" : "debug" , "file" : "~/.openclaw/logs/bilt.log" } } } }
Next Steps 