bult-mcp-server
OfficialThis server lets you deploy and manage cloud hosting infrastructure on Bult.ai directly from MCP-compatible AI agents (Claude, Cursor, Codex, etc.).
Projects: List, create, update, delete, deploy, and control lifecycle (start/stop/discard changes) for projects.
Services: Create daemon services (from GitHub repos or Docker images) or database services (PostgreSQL, Redis, MySQL, MongoDB); list, inspect, update, delete, start, stop, and rebuild them.
Volumes: Create, update, delete, and wipe persistent storage volumes.
Routes & Domains: Create, update, and delete public URL routes or custom domain mappings for deployed services.
Templates: List available app/database templates and apply them to spin up preconfigured services, databases, volumes, and routes.
Logs & Build History: Retrieve service logs with cursor-based pagination and list build history to debug deployments and inspect build status.
Configuration: Set up via environment variables for the Bult API URL and API token.
@bultcloud/mcp-server
Official Model Context Protocol (MCP) server for Bult.ai, a DevOps platform and cloud hosting Platform-as-a-Service for deploying apps, GitHub repositories, Docker images, databases, and services with AI agents.
Use Bult MCP with Claude Desktop, Claude Code, Cursor, Codex, and other MCP-compatible clients to deploy apps, manage cloud infrastructure, inspect logs, and troubleshoot deployments through the Bult API.
Demo

Related MCP server: Coolify MCP Server
Features
Deploy GitHub repositories, Docker images, databases, and app services from MCP-compatible AI agents.
Project lifecycle tools: list, inspect, create, update, delete, deploy, start, stop, and discard changes.
Service management for daemon and database services, including Docker image and Git-based deployments.
Persistent volumes, route/domain mappings, templates, service logs, and build history.
MCP tool annotations for read-only, idempotent, and destructive operations where supported.
Works over stdio with Claude Desktop, Claude Code, Cursor, Google Antigravity and other MCP-compatible clients.
When to use Bult MCP
Use Bult MCP when you want an AI coding agent to deploy and operate cloud hosting resources for you. Common workflows include deploying a GitHub repo from Cursor, deploying the current project from Claude Code, launching a Docker image, creating a database service, adding a public route, checking build logs, and debugging failed deployments.
Requirements
Node.js 18 or newer.
Bult API token.
Installation
If you install the package globally, use the bult-mcp binary:
npm install -g @bultcloud/mcp-server
bult-mcpYou can also run it with npx from MCP client configs:
npx -y @bultcloud/mcp-serverConfiguration
The server reads its configuration from environment variables.
Variable | Required | Description |
| Yes | Bult API base URL, |
| Yes | API token used for Bearer authentication. |
The server exits during startup if either variable is missing.
MCP Client Setup
Claude Desktop
Add the server to claude_desktop_config.json.
Using npx:
{
"mcpServers": {
"bult": {
"command": "npx",
"args": ["-y", "@bultcloud/mcp-server"],
"env": {
"BULT_API_URL": "https://app.bult.ai",
"BULT_API_TOKEN": "your-token"
}
}
}
}Claude Code
Using npx:
claude mcp add bult \
-e BULT_API_URL=https://app.bult.ai \
-e BULT_API_TOKEN=your-token \
-- npx -y @bultcloud/mcp-serverCodex CLI
Using npx:
codex mcp add \
--env BULT_API_URL=https://app.bult.ai \
--env BULT_API_TOKEN=your-token \
bult \
-- npx -y @bultcloud/mcp-serverAvailable Tools
Projects
Tool | Description |
| List all projects in the workspace. |
| Get a project overview with services, volumes, and routes. |
| Create a new project. |
| Update a project name. |
| Delete a project and all of its resources. |
| Deploy project changes and create a version snapshot. |
| Start, stop, or discard project changes. |
Services
Tool | Description |
| List all services in a project. |
| Get service details and configuration. |
| Create a daemon or database service. |
| Update service configuration. |
| Delete a service. |
| Start, stop, or rebuild a service. |
Volumes
Tool | Description |
| Create a persistent storage volume. |
| Update a volume name or size. |
| Delete a volume. |
| Irreversibly wipe all data from a volume. |
Routes
Tool | Description |
| Create a domain or path mapping for a service. |
| Update route configuration. |
| Delete a route. |
Templates
Tool | Description |
| List available project templates. |
| Apply a template to a project. |
Logs and Builds
Tool | Description |
| Read service logs with cursor-based pagination. |
| List build history for a service. |
Example Prompts
Deploy this GitHub repo to Bult and give me the public URL.
Deploy the current project to Bult.
Check why my deployment failed.
Show the latest logs for my app.
Set DATABASE_URL and restart the service.
Deploy this Docker image to Bult.
List my Bult projects and services.
Development
npm run dev # run with tsx, no build step
npm run build # compile TypeScript to dist/
npm run lint # type-check without emitting filesProject layout:
src/index.ts MCP server entrypoint
src/client.ts Bult API client
src/tools/*.ts MCP tool registrations by resource typeSecurity
BULT_API_TOKEN grants access to your Bult resources. Keep it out of
source control, shell history, issue reports, and screenshots. Prefer scoped or
rotatable tokens when available.
Some tools can create, delete, deploy, stop, or wipe resources. Review tool calls from your MCP client before approving destructive actions.
Privacy Policy
This MCP server connects your MCP client to Bult.ai using the API token you provide. Requests are sent to Bult.ai to perform actions such as listing projects, deploying services, managing routes and volumes, and reading logs.
The server does not store your API token. Tokens are passed through your MCP client configuration or extension settings. For Bult.ai data handling practices, see the Bult.ai Privacy Policy.
Contributing
Issues and pull requests are welcome at github.com/bultcloud/mcp-server.
Before opening a pull request, run:
npm run lint
npm run buildLicense
This project is licensed under the MIT License.
Available Tools
24 toolsapply-templateA
Apply a Bult template to a project, creating preconfigured services, databases, volumes, routes, and deployable cloud hosting resources.
Inputs: project_id (required), template_id (required).
control-projectA
Control a Bult project lifecycle by starting services, stopping cloud hosting resources, or discarding pending deployment changes.
Inputs: project_id (required), action (required).
control-serviceA
Control a Bult service lifecycle: start it, stop it, or rebuild it after deployment, Docker image, GitHub repository, or environment variable changes.
Inputs: service_id (required), action (required).
create-projectC
Create a new Bult project for cloud hosting deployments from GitHub repositories, Docker images, templates, or databases.
Inputs: name (required).
create-routeC
Create a Bult public route, generated URL, or custom domain mapping for a deployed service port.
Inputs: project_id (required), service_id (required), port (required), domain, +1 more.
create-serviceA
Create a Bult.ai service. Supports daemon apps from a GitHub repository or Docker image, plus PostgreSQL, Redis, MySQL, and MongoDB database services.
Inputs: project_id (required), name (required), config (required).
create-volumeB
Create a persistent storage volume in a Bult project for deployed apps, databases, and cloud hosting services.
Inputs: project_id (required), name (required), size (required).
delete-projectADestructive
Delete a Bult project and all related cloud hosting resources, including services, routes, volumes, deployments, and public URLs.
Inputs: project_id (required).
delete-routeBDestructive
Delete a Bult public route or custom domain mapping from a deployed service.
Inputs: route_id (required).
delete-serviceADestructive
Delete a Bult service and remove its cloud hosting deployment resources.
Inputs: service_id (required).
delete-volumeADestructive
Delete a Bult persistent volume used by a deployed service or database.
Inputs: volume_id (required).
deploy-projectB
Deploy pending Bult project changes, create a version snapshot, and make updated app services available on their public URLs.
Inputs: project_id (required), commit_message.
get-projectARead-only
Get a Bult project overview, including services, volumes, routes, deployment status, and public URL information.
Inputs: project_id (required).
get-serviceARead-only
Get Bult service details including deployment configuration, environment variables, ports, status, logs context, and public URL routing data.
Inputs: service_id (required).
get-service-logsARead-only
Get Bult service logs with cursor-based pagination for debugging failed deployments, build errors, runtime issues, and cloud hosting status.
Inputs: service_id (required), cursor.
list-buildsBRead-only
List Bult service build and deployment history to inspect build status, failures, source revisions, and recent deploy activity.
Inputs: service_id (required).
list-projectsARead-only
List Bult.ai hosting projects in the workspace so an AI agent can choose where to deploy, inspect status, or manage services.
Inputs: no named parameters.
list-servicesBRead-only
List services in a Bult project, including app, database, GitHub repository, Docker image, and cloud hosting deployment targets.
Inputs: project_id (required).
list-templatesARead-only
List available Bult app and database templates for fast cloud hosting setup and one-click deployments.
Inputs: no named parameters.
update-projectBIdempotent
Update a Bult project name to keep deployment and hosting workspaces organized.
Inputs: project_id (required), name (required).
update-routeBIdempotent
Update a Bult route configuration, including public URL path, custom domain, service target, and exposed port.
Inputs: route_id (required), service_id (required), port (required), domain, +1 more.
update-serviceAIdempotent
Update a Bult service configuration, including deployment source, Docker image or GitHub repository settings, ports, files, and environment variables.
Inputs: service_id (required), name (required), config (required).
update-volumeBIdempotent
Update a Bult persistent volume name or size for app storage and database hosting needs.
Inputs: volume_id (required), name (required), size.
wipe-volumeADestructive
Irreversibly wipe all data from a Bult persistent volume used by cloud apps or databases.
Inputs: volume_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 24 tools
Each tool targets a distinct resource or action: project, service, route, volume, template, build, logs, control, deploy. No overlapping purposes; descriptions clearly differentiate them.
All tools follow a consistent verb_noun pattern in snake_case (e.g., create-project, get-service-logs, wipe-volume). Minor variations like 'apply-template' still adhere to the convention.
24 tools cover the full lifecycle of Bult cloud resources (CRUD + deploy, control, logs, builds, templates). The count is well-scoped for the domain without being excessive.
The tool surface provides complete CRUD for projects, services, routes, and volumes, plus essential operational tools (deploy, control, logs, builds, templates). No obvious gaps for managing cloud hosting.
Maintenance
Related MCP Connectors
Build, deploy and manage MaShop e-commerce projects from Claude, Cursor or any MCP client.
Deploy static sites and connect custom domains from Claude, Cursor, or any MCP agent.
Build, validate, deploy — HTTP APIs, cron jobs, webhooks and MCP tools — from your AI client.
Deploy and manage Jade Hosting projects from AI clients. Jade account and OAuth required.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables management of Railway.app infrastructure through natural language, allowing users to deploy services, manage environment variables, monitor deployments, and configure projects directly from MCP clients like Claude.38MIT
- AlicenseNot gradedqualityDmaintenanceEnables natural language management of Coolify self-hosted PaaS, including applications, databases, deployments, servers, and environment variables via MCP.MIT
- AlicenseNot gradedqualityCmaintenanceEnables managing a self-hosted Coolify PaaS from Claude, Cursor, or any MCP client through 45 tools for deploying, rolling back, debugging, and operating applications, databases, services, projects, and environments in plain English. Destructive operations pause for human confirmation and secrets stay masked.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI coding assistants to deploy and manage compatible web apps, isolated Postgres databases, and project file storage, while inspecting build logs, runtime errors, and usage through an OAuth-authenticated remote MCP connection.MIT