Skip to main content

​
Prerequisites

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

Bilt AccountFree account at bilt.me/sign-up

​
Step 1: Get Your API Token

1

Sign up

Create an account at bilt.me/sign-up
2

Generate API key

Navigate to Settings → API Keys in your dashboard
3

Copy token

Your token will look like: bilt_live_abc123...
Save this token! It’s only shown once. Keep it secure and never commit it to version control.

​
Step 2: Configure Your Client

​
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

​
Step 3: Verify Connection

After restarting your client, verify Bilt is connected: 
What MCP servers are available?
If you see all 8 Bilt tools, you’re ready to go!

​
Step 4: Create Your First App

Try this simple workflow to create and deploy your first app:
1

Create a project

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

Build features

Build a todo list with add, delete, and mark complete features
3

Deploy

Deploy my-first-app to production
4

Get URL

Your agent will return a live deployment URL like:
https://my-first-app-abc123.bilt.app

​
What Just Happened?

Behind the scenes, your AI agent:
  1. Created a project using bilt_create_project
  2. Sent build instructions using bilt_send_message
  3. Monitored progress via real-time SSE events
  4. Deployed the app using another bilt_send_message
  5. Retrieved the URL from the deployment response
All of this happened autonomously - no human intervention required! 🎉

​
Common Issues

Solution:
  1. Verify config file location is correct
  2. Check JSON syntax (use a JSON validator)
  3. Restart client completely (quit and reopen)
  4. Check client logs for errors
Solution:
  1. Verify token format: must start with bilt_live_
  2. Check for extra spaces in config
  3. Regenerate token at bilt.me/settings/api-keys
  4. Ensure token hasn’t expired
Solution:
  1. Check internet connection
  2. Verify firewall allows HTTPS (port 443)
  3. Test connection manually:
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://mcp.bilt.me/mcp/health
Solution:
  • Current limit: 100 requests/minute
  • Wait 60 seconds before retrying
  • Contact support for higher limits

​
Next Steps

Integration Guides

Detailed setup for specific clients

API Reference

Explore all 8 MCP tools

​
Need Help?

Discord

Community support

Email

Direct support