MCP Quickstart

Use Bilt from your favorite AI client. AI agents can create projects, build apps, and deploy — all through natural language via MCP (Model Context Protocol). Estimated time: 5 minutes By the end of this guide, your AI client will be connected to Bilt with all 7 MCP tools available, ready to build and deploy apps from chat.

Prerequisites

MCP clientClaude Desktop, OpenClaw, Cursor, or any MCP-compatible client

Bilt API tokenFree account at bilt.me/sign-up

Step 1: Get your API token

Go to bilt.me/sign-up

Generate an API key

Navigate to Settings → API Keys in your dashboard

Copy the token

Your token looks like: bilt_live_abc123...

Save this token. It’s only shown once. Never commit it to version control.

Step 2: Configure your client

Claude Desktop
OpenClaw
Cursor
Other clients

macOS

Edit: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Edit: %APPDATA%\Claude\claude_desktop_config.json

Configuration

{
  "mcpServers": {
    "bilt": {
      "transport": {
        "type": "sse",
        "url": "https://mcp.bilt.me/mcp/sse",
        "headers": {
          "Authorization": "Bearer bilt_live_YOUR_TOKEN_HERE"
        }
      }
    }
  }
}

Replace YOUR_TOKEN_HERE with your actual API token.

Edit: ~/.openclaw/openclaw.json

{
  "mcpServers": {
    "bilt": {
      "transport": {
        "type": "sse",
        "url": "https://mcp.bilt.me/mcp/sse",
        "headers": {
          "Authorization": "Bearer bilt_live_YOUR_TOKEN_HERE"
        }
      }
    }
  }
}

Restart OpenClaw:

openclaw gateway restart

Create .cursor/mcp_config.json in your project directory:

{
  "mcpServers": {
    "bilt": {
      "transport": {
        "type": "sse",
        "url": "https://mcp.bilt.me/mcp/sse",
        "headers": {
          "Authorization": "Bearer bilt_live_YOUR_TOKEN_HERE"
        }
      }
    }
  }
}

Reload: Cmd/Ctrl + Shift + P → "Reload Window"

Use these connection details for any MCP-compatible client:

Server URL: https://mcp.bilt.me/mcp/sse
Transport: SSE (Server-Sent Events)
Auth: Bearer token in Authorization header
Token format: Bearer bilt_live_...

See Other Clients for detailed instructions.

Step 3: Verify the connection

After restarting your client, check that Bilt is connected:

What MCP servers are available?

Connected MCP servers:
- bilt (7 tools available)
  • bilt_list_projects
  • bilt_get_project
  • bilt_create_project
  • bilt_get_session
  • bilt_send_message
  • bilt_cancel_workflow
  • bilt_get_messages

If you see all 7 tools, you’re connected.

Step 4: Build your first app

Try this in your AI client:

Create a project

Use Bilt to create a new project called "my-first-app"

Build features

Build a todo list app with add, delete, and mark complete

Deploy

Deploy my-first-app to production

Your agent handles the full flow — creating the project, sending build instructions, monitoring progress, and returning a live preview URL.

If bilt_send_message returns status: "queued", the request was accepted but has not started yet. Ask the agent to call bilt_get_session for the same project until hasActiveWorkflows is false before sending unrelated follow-up work.

Troubleshooting

Tools not appearing

Verify the config file path is correct for your OS
Check JSON syntax (use a validator)
Fully restart the client (quit and reopen)
Check client logs for connection errors

401 Unauthorized

Token must start with bilt_live_
Check for extra spaces in the config
Regenerate at bilt.me → Settings → API Keys

Connection timeout

Check internet connectivity
Ensure firewall allows HTTPS (port 443)
Test manually:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://mcp.bilt.me/health

Rate limit errors

Current limit: 60 requests/minute. Wait 60 seconds and retry. Contact support for higher limits.

Get Started

Client Setup

Tools Reference

MCP Quickstart

Prerequisites

Step 1: Get your API token

Step 2: Configure your client

macOS

Windows

Configuration

Step 3: Verify the connection

Step 4: Build your first app

Troubleshooting

Next steps

API Reference

Integration guides

​Prerequisites

​Step 1: Get your API token

​Step 2: Configure your client

​macOS

​Windows

​Configuration

​Step 3: Verify the connection

​Step 4: Build your first app

​Troubleshooting

​Next steps

API Reference

Integration guides

Prerequisites

Step 1: Get your API token

Step 2: Configure your client

macOS

Windows

Configuration

Step 3: Verify the connection

Step 4: Build your first app

Troubleshooting

Next steps