Skip to main content

​
Available Tools

Bilt MCP Server provides 8 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 workflow session status

bilt_send_message

Send build/deploy instructions

bilt_resume_workflow

Resume paused workflows

bilt_cancel_workflow

Cancel running workflows

bilt_get_messages

Retrieve workflow message 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
  • bilt_get_session - Monitor workflow progress
  • bilt_get_messages - Review build logs

​
Workflow Control

Tools for managing long-running operations.
  • bilt_resume_workflow - Continue interrupted builds
  • 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: 
{
  "Authorization": "Bearer bilt_live_YOUR_TOKEN_HERE"
}
Tokens are configured at the MCP client level, not per-tool invocation.

​
Rate Limits

​
limit
number
default:"100"
100 requests per minute per API key
​
headers
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 standardized error responses:
​
error
string
Human-readable error message
​
details
object
Additional error context (validation errors, etc.)

​
Common Error Codes

CodeMeaningSolution
400Bad RequestCheck parameter format
401UnauthorizedVerify API token
403ForbiddenCheck project ownership
404Not FoundVerify project/session ID
429Rate LimitedWait and retry
500Server ErrorContact support

​
Next Steps

Tool Reference

Detailed docs for each tool