Skip to main content

​
Available Tools

Bilt MCP Server provides 7 tools that enable AI agents to autonomously create, build, and deploy native mobile applications.

bilt_list_projects

List all projects for authenticated user

bilt_get_project

Get detailed project information

bilt_create_project

Create a new project

bilt_get_session

Get current session and workflow status

bilt_send_message

Send build instructions or answer agent questions

bilt_cancel_workflow

Cancel running workflows

bilt_get_messages

Retrieve conversation history

​
Tool Categories

​
Project Management

Tools for creating and managing native mobile application projects.
  • bilt_list_projects - Discover existing projects
  • bilt_get_project - Get project details and status
  • bilt_create_project - Initialize new projects

​
Workflow Execution

Tools for building and deploying native mobile applications.
  • bilt_send_message - Execute build/deploy actions or answer clarification questions
  • bilt_get_session - Monitor queued/running workflow progress and preview URLs
  • bilt_get_messages - Review conversation history
bilt_send_message may return status: "queued" when another workflow is already running. Use bilt_get_session with the same projectId until hasActiveWorkflows is false before sending unrelated follow-up work.

​
Workflow Control

Tools for managing long-running operations.
  • bilt_cancel_workflow - Stop unwanted operations

​
Common Patterns

​
Pattern 1: Create and Deploy

​
Pattern 2: Modify Existing

​
Pattern 3: Debug and Fix

​
Tool Selection Guide

When to use:
  • Agent doesn’t know what projects exist
  • Need to find a specific project
  • Listing all user projects
Tools:
  • bilt_list_projects - Get all projects
  • bilt_get_project - Get specific project details

​
Authentication

All tools require authentication via Bearer token:
Tokens are configured at the MCP client level, not per-tool invocation.

​
Rate Limits

​
number
default:"100"
100 requests per minute per API key
​
object
Response includes rate limit headers:
  • X-RateLimit-Limit: Total limit
  • X-RateLimit-Remaining: Remaining requests
  • X-RateLimit-Reset: Unix timestamp for reset
Exceeding rate limits returns 429 Too Many Requests. Wait for the reset time before retrying.

​
Error Handling

All tools use JSON-RPC 2.0 error responses:
​
string
required
Always "2.0"
​
string | number | null
required
Matches the request ID, or null when the request could not be parsed
​
object
required
JSON-RPC error object

​
Common Error Codes

​
Next Steps

Tool Reference

Detailed docs for each tool