MCP Quickstart

Bilt exposes seven MCP tools at https://mcp.bilt.me/mcp over Streamable HTTP. Copyable client configurations and the Bilt Builder agent skill are available in the public Bilt MCP repository.

1. Create an API key

Open Bilt API Keys, generate a key, and copy it. Keys begin with bilt_live_ and are shown once.

Treat the key like a password. Do not commit it or include it in support logs.

2. Configure your client

Claude Desktop
Cursor
OpenClaw
Other clients

Install Node.js 18 or newer, then add this to claude_desktop_config.json:

{
  "mcpServers": {
    "bilt": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.bilt.me/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${BILT_AUTH_HEADER}",
        "--body-timeout",
        "0"
      ],
      "env": {
        "BILT_AUTH_HEADER": "Bearer bilt_live_YOUR_TOKEN"
      }
    }
  }
}

Fully quit and reopen Claude Desktop. See Claude Desktop setup for file locations and the Windows npx.cmd workaround.

Add Bilt to your personal ~/.cursor/mcp.json:

{
  "mcpServers": {
    "bilt": {
      "url": "https://mcp.bilt.me/mcp",
      "headers": {
        "Authorization": "Bearer bilt_live_YOUR_TOKEN"
      }
    }
  }
}

Reload Cursor and open Settings → Tools & Integrations → MCP. See Cursor setup.

Add Bilt under mcp.servers in ~/.openclaw/openclaw.json:

{
  "mcp": {
    "servers": {
      "bilt": {
        "url": "https://mcp.bilt.me/mcp",
        "transport": "streamable-http",
        "headers": {
          "Authorization": "Bearer bilt_live_YOUR_TOKEN"
        },
        "connectionTimeoutMs": 10000,
        "requestTimeoutMs": 610000
      }
    }
  }
}

Run openclaw mcp doctor bilt --probe. See OpenClaw setup.

Use Streamable HTTP with:

URL: https://mcp.bilt.me/mcp
Header: Authorization: Bearer bilt_live_...
Accept: application/json, text/event-stream

If the client only supports local stdio servers, use the mcp-remote configuration from the Claude tab. See Other MCP clients.

3. Verify the tools

Your client should show these tools:

bilt_list_projects
bilt_get_project
bilt_create_project
bilt_get_session
bilt_send_message
bilt_cancel_workflow
bilt_get_messages

Start with a read-only check: “Use Bilt to list my projects.”

Migrating an older configuration

The legacy /mcp/sse endpoint has been removed. Change the URL to /mcp and select Streamable HTTP. Claude Desktop users must replace the old nested remote transport object with the mcp-remote stdio configuration above.

Troubleshooting

401 Unauthorized

Confirm the header contains Bearer followed by the complete bilt_live_... key. Regenerate the key if it may have been exposed or revoked.

Claude Desktop rejects the configuration

claude_desktop_config.json accepts a local command entry. It does not accept Bilt’s remote URL in a nested transport object. Use the mcp-remote configuration exactly as shown.

A long build disconnects

Keep --body-timeout 0 in mcp-remote, or configure a native client’s request timeout for at least 610 seconds. Bilt build requests can take up to ten minutes.

Get Started

Client Setup

Tools Reference

MCP Quickstart

1. Create an API key

2. Configure your client

3. Verify the tools

Migrating an older configuration

Troubleshooting

​1. Create an API key

​2. Configure your client

​3. Verify the tools

​Migrating an older configuration

​Troubleshooting

1. Create an API key

2. Configure your client

3. Verify the tools

Migrating an older configuration

Troubleshooting