bilt_create_project

Overview

Creates a new project in your Bilt account. This is typically the first step in any app development workflow.

Projects are automatically associated with your API token’s user account.

Parameters

string

required

Project name.

Max length: 255 characters
Example: "my-todo-app"

string

Human-readable project description.

Max length: 1000 characters
Example: "A simple todo list application with user authentication"

string

default:"private"

Project visibility setting.

Options: "public" or "private"
Default: "private"
public: Visible to others, can be shared
private: Only visible to you

Response

string

required

Unique project identifier (UUID format)

string

required

Project name as provided

string

Project description (null if not provided)

string

required

Project visibility: "public" or "private"

string

required

ISO 8601 timestamp of creation

string

required

ISO 8601 timestamp of last update

Example Usage

{
  "name": "todo-app",
  "description": "A todo list with authentication and dark mode",
  "visibility": "public"
}

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "todo-app",
  "description": "A todo list with authentication and dark mode",
  "visibility": "public",
  "createdAt": "2026-02-10T15:30:00.000Z",
  "updatedAt": "2026-02-10T15:30:00.000Z"
}

Agent Workflow Example

Agent creates project

User: "Create a new project called 'landing-page'"

Agent uses bilt_create_project with:
{
  "name": "landing-page"
}

Agent receives project ID

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "landing-page",
  "visibility": "public"
}

Agent proceeds to build

Agent: "Created project 'landing-page' (550e8400-e29b-41d4-a716-446655440000).
       Ready to start building. What features would you like?"

User: "Add a hero section, features grid, and contact form"

Agent uses bilt_send_message to build features...

Best Practices

Use descriptive names

Choose clear, specific project names that indicate the app’s purpose.✅ Good: "ecommerce-dashboard", "blog-cms", "todo-app"❌ Avoid: "test", "project1", "app"

Include descriptions for complex projects

Add descriptions when the project name alone doesn’t fully convey the scope.

{
  "name": "social-analytics",
  "description": "Social media analytics dashboard with real-time metrics, trend analysis, and competitor tracking"
}

Choose visibility deliberately

Projects default to private. Set "public" only when you want the project discoverable or shareable.

Store project IDs

Save the returned id for subsequent operations:

Created project: 550e8400-e29b-41d4-a716-446655440000
Use this ID for all future operations on this project.

Error Handling

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Missing required parameter: name"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32001,
    "message": "Authentication failed - invalid or expired API key"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32005,
    "message": "Rate limit exceeded - please slow down requests"
  }
}

Rate Limits

Limit10 projects created per hour

Total ProjectsUp to 100 active projects per account (free tier)

Contact support@bilt.me for higher limits on paid plans

bilt_list_projects

View all projects

bilt_get_project

Get project details

bilt_send_message

Start building

Next Steps

After creating a project:

Get a session - Use bilt_get_session
Send build instructions - Use bilt_send_message
Monitor progress - Check status with bilt_get_messages
Deploy - Send deployment message when ready

Get Started

Client Setup

Tools Reference

bilt_create_project

Overview

Parameters

Response

Example Usage

Agent Workflow Example

Best Practices

Error Handling

Rate Limits

bilt_list_projects

bilt_get_project

bilt_send_message

Next Steps

​Overview

​Parameters

​Response

​Example Usage

​Agent Workflow Example

​Best Practices

​Error Handling

​Rate Limits

​Related Tools

bilt_list_projects

bilt_get_project

bilt_send_message

​Next Steps

Overview

Parameters

Response

Example Usage

Agent Workflow Example

Best Practices

Error Handling

Rate Limits

Related Tools

Next Steps