Skip to main content

​
Overview

Connect Bilt MCP Server to Cursor IDE to enable AI-powered native mobile application development with seamless code generation, building, and deployment capabilities.
Cursor natively supports MCP through project-level or global configuration files.

​
Platform Support

macOSFull support for macOS 11+

WindowsFull support for Windows 10+

LinuxFull support for all major distros

​
Prerequisites

  1. Cursor installed - Download from cursor.sh
  2. Bilt API token - Get one at bilt.me/sign-up

​
Setup Options

You can configure Bilt MCP in two ways:
  1. Project-specific (Recommended) - Only available in specific projects
  2. Global - Available in all projects

​
Step 1: Create Config Directory

In your project root: 
mkdir -p .cursor

​
Step 2: Create Config File

Create .cursor/mcp_config.json: 
nano .cursor/mcp_config.json

​
Step 3: Add Bilt 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 Bilt API token.

​
Step 4: Reload Cursor

Press Cmd/Ctrl + Shift + P → Type “Reload Window” → Enter

​
Global Setup

​
Step 1: Locate Global Config

~/.cursor/mcp_config.json

​
Step 2: Edit Config

mkdir -p ~/.cursor
nano ~/.cursor/mcp_config.json

​
Step 3: Add Configuration

Same JSON as project-specific setup: 
{
  "mcpServers": {
    "bilt": {
      "transport": {
        "type": "sse",
        "url": "https://mcp.bilt.me/mcp/sse",
        "headers": {
          "Authorization": "Bearer bilt_live_YOUR_TOKEN_HERE"
        }
      }
    }
  }
}

​
Step 4: Restart Cursor

Quit Cursor completely and reopen.

​
Verification

​
Check Tool Availability

In Cursor’s AI chat, ask: 
What MCP servers are available?
You should see: 
Available MCP servers:
- bilt (8 tools)

​
Test a Tool

Try creating a project: 
Use Bilt to create a test project called "hello-world"
Cursor should invoke bilt_create_project automatically.

​
Configuration Options

Store tokens securely using environment variables: 
{
  "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
source ~/.zshrc

# Launch Cursor from terminal
cursor .

​
Multiple Environments

Configure dev and production tokens: 
{
  "mcpServers": {
    "bilt-dev": {
      "transport": {
        "type": "sse",
        "url": "https://mcp.bilt.me/mcp/sse",
        "headers": {
          "Authorization": "Bearer ${BILT_DEV_TOKEN}"
        }
      }
    },
    "bilt-prod": {
      "transport": {
        "type": "sse",
        "url": "https://mcp.bilt.me/mcp/sse",
        "headers": {
          "Authorization": "Bearer ${BILT_PROD_TOKEN}"
        }
      }
    }
  }
}
Then specify which to use: 
Use bilt-dev to create a test app
Use bilt-prod to deploy to production

​
Team Configuration

Commit .cursor/mcp_config.json for team-wide access: 
{
  "mcpServers": {
    "bilt": {
      "transport": {
        "type": "sse",
        "url": "https://mcp.bilt.me/mcp/sse",
        "headers": {
          "Authorization": "Bearer ${BILT_API_TOKEN}"
        }
      }
    }
  }
}
Add to .gitignore: 
.cursor/mcp_config.local.json
Team members set their tokens: 
export BILT_API_TOKEN="their_token"

​
Using Bilt in Cursor

​
Natural Language Integration

Cursor automatically integrates Bilt tools into its AI workflow: 
You: "Create a React dashboard app using Bilt"

Cursor: [Recognizes Bilt tools]
[Runs: bilt_create_project]
✓ Created project 'react-dashboard'

[Runs: bilt_send_message]
✓ Building React dashboard with charts and tables

"Project created! Building now..."

​
Code Generation + Deployment

You: "Build this component and deploy it"

Cursor: [Generates code]
[Uses bilt_send_message to deploy]
✓ Deployed: https://react-dashboard-abc.bilt.app

"Your component is live!"

​
Iterative Development

You: "Add a dark mode toggle"

Cursor: [Uses bilt_send_message]
✓ Added dark mode toggle to navigation

You: "Deploy the changes"

Cursor: [Uses bilt_send_message with "deploy"]
✓ Deployed successfully

​
Cursor-Specific Features

​
AI Chat Integration

Bilt tools appear in Cursor’s AI chat automatically: 
@bilt create a todo app
@bilt add authentication
@bilt deploy to production

​
Inline Suggestions

When writing code, Cursor can suggest Bilt deployments: 
// Your code here
function TodoApp() {
  // ...
}

// Cursor suggestion: "Deploy this app with @bilt?"

​
Terminal Integration

Use Bilt commands in Cursor’s integrated terminal: 
# Cursor can execute these via AI
cursor-ai "Use Bilt to list my projects"
cursor-ai "Deploy my-app to production"

​
Troubleshooting

Check config location:Project-specific: project-root/.cursor/mcp_config.jsonGlobal: ~/.cursor/mcp_config.json or %USERPROFILE%\.cursor\mcp_config.jsonVerify JSON syntax:
# Use a JSON validator
cat .cursor/mcp_config.json | python -m json.tool
Reload window: Cmd/Ctrl + Shift + P → “Reload Window”
Check token format:
  • Must start with bilt_live_
  • No extra spaces
  • No quotes inside the Bearer string
Test token:
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://mcp.bilt.me/mcp/health
Should return: {"status":"ok"}Regenerate token: Go to bilt.me/settings/api-keys
Check internet:
ping mcp.bilt.me
Check firewall: Ensure HTTPS (port 443) is allowedTry different network: Test on mobile hotspot or different WiFi
Check file permissions:
ls -la .cursor/mcp_config.json
Should be readable by your user.Move to global config: If project-specific isn’t working, try global:
cp .cursor/mcp_config.json ~/.cursor/mcp_config.json

​
Best Practices

Use project-specificKeep configs isolated per project

Environment variablesNever commit tokens to git

Team sharingShare config structure, not tokens

Rotate tokensUpdate tokens every 90 days

​
.gitignore Template

Add to your .gitignore: 
# Cursor MCP configs with sensitive tokens
.cursor/mcp_config.local.json

# Keep team config template
!.cursor/mcp_config.json
Then in .cursor/mcp_config.json: 
{
  "mcpServers": {
    "bilt": {
      "transport": {
        "type": "sse",
        "url": "https://mcp.bilt.me/mcp/sse",
        "headers": {
          "Authorization": "Bearer ${BILT_API_TOKEN}"
        }
      }
    }
  }
}
Team members set their own tokens via env vars.

​
Keyboard Shortcuts

Reload WindowCmd/Ctrl + Shift + P → “Reload Window”

Open AI ChatCmd/Ctrl + L

SettingsCmd/Ctrl + ,

Command PaletteCmd/Ctrl + Shift + P

​
Advanced Usage

​
Custom Workspace Settings

Add to .vscode/settings.json: 
{
  "cursor.mcp.autoStart": true,
  "cursor.mcp.debug": false,
  "cursor.ai.suggestions.enabled": true
}

​
Multi-Project Setup

Different Bilt projects per workspace: 
{
  "mcpServers": {
    "bilt-frontend": {
      "transport": {
        "type": "sse",
        "url": "https://mcp.bilt.me/mcp/sse",
        "headers": {
          "Authorization": "Bearer ${BILT_FRONTEND_TOKEN}"
        }
      }
    },
    "bilt-backend": {
      "transport": {
        "type": "sse",
        "url": "https://mcp.bilt.me/mcp/sse",
        "headers": {
          "Authorization": "Bearer ${BILT_BACKEND_TOKEN}"
        }
      }
    }
  }
}

​
Next Steps

API Reference

Learn about all 8 Bilt tools

Cursor Docs

Learn more about Cursor