Cursor Setup

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

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

Setup Options

You can configure Bilt MCP in two ways:

Project-specific (Recommended) - Only available in specific projects
Global - Available in all projects

Project-Specific Setup (Recommended)

Step 1: Create Config Directory

In your project root:

macOS/Linux
Windows

mkdir -p .cursor

mkdir .cursor

Step 2: Create Config File

Create .cursor/mcp_config.json:

macOS/Linux
Windows

nano .cursor/mcp_config.json

notepad .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

macOS/Linux
Windows

~/.cursor/mcp_config.json

%USERPROFILE%\.cursor\mcp_config.json

Step 2: Edit Config

macOS/Linux
Windows

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

mkdir -Force "$env:USERPROFILE\.cursor"
notepad "$env:USERPROFILE\.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 (7 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

Environment Variables (Recommended)

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:

macOS/Linux
Windows

# Add to ~/.zshrc or ~/.bashrc
export BILT_API_TOKEN="bilt_live_YOUR_TOKEN"

# Reload
source ~/.zshrc

# Launch Cursor from terminal
cursor .

# Set permanently
setx BILT_API_TOKEN "bilt_live_YOUR_TOKEN"

# Restart 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

Tools not appearing

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”

401 Unauthorized

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/health

Should return: {"status":"ok"}Regenerate token: Go to bilt.me/settings/api-keys

Connection timeout

Check internet:

ping mcp.bilt.me

Check firewall: Ensure HTTPS (port 443) is allowedTry different network: Test on mobile hotspot or different WiFi

Cursor not loading config

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}"
        }
      }
    }
  }
}

​Overview

​Platform Support

​Prerequisites

​Setup Options

​Project-Specific Setup (Recommended)

​Step 1: Create Config Directory

​Step 2: Create Config File

​Step 3: Add Bilt Configuration

​Step 4: Reload Cursor

​Global Setup

​Step 1: Locate Global Config

​Step 2: Edit Config

​Step 3: Add Configuration

​Step 4: Restart Cursor

​Verification

​Check Tool Availability

​Test a Tool

​Configuration Options

​Environment Variables (Recommended)

​Multiple Environments

​Team Configuration

​Using Bilt in Cursor

​Natural Language Integration

​Code Generation + Deployment

​Iterative Development

​Cursor-Specific Features

​AI Chat Integration

​Inline Suggestions

​Terminal Integration

​Troubleshooting

​Best Practices

​.gitignore Template

​Keyboard Shortcuts

​Advanced Usage

​Custom Workspace Settings

​Multi-Project Setup

​Next Steps

API Reference

Cursor Docs

Overview

Platform Support

Prerequisites

Setup Options

Project-Specific Setup (Recommended)

Step 1: Create Config Directory

Step 2: Create Config File

Step 3: Add Bilt Configuration

Step 4: Reload Cursor

Global Setup

Step 1: Locate Global Config

Step 2: Edit Config

Step 3: Add Configuration

Step 4: Restart Cursor

Verification

Check Tool Availability

Test a Tool

Configuration Options

Environment Variables (Recommended)

Multiple Environments

Team Configuration

Using Bilt in Cursor

Natural Language Integration

Code Generation + Deployment

Iterative Development

Cursor-Specific Features

AI Chat Integration

Inline Suggestions

Terminal Integration

Troubleshooting

Best Practices

.gitignore Template

Keyboard Shortcuts

Advanced Usage

Custom Workspace Settings

Multi-Project Setup

Next Steps