Skip to main content
Glama
bult-mcp-server

bult-mcp-server

Official
by bultcloud

@bultcloud/mcp-server

License: MIT

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

Bult MCP 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-mcp

You can also run it with npx from MCP client configs:

npx -y @bultcloud/mcp-server

Configuration

The server reads its configuration from environment variables.

Variable

Required

Description

BULT_API_URL

Yes

Bult API base URL, https://app.bult.ai.

BULT_API_TOKEN

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-server

Codex 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-server

Available Tools

Projects

Tool

Description

list-projects

List all projects in the workspace.

get-project

Get a project overview with services, volumes, and routes.

create-project

Create a new project.

update-project

Update a project name.

delete-project

Delete a project and all of its resources.

deploy-project

Deploy project changes and create a version snapshot.

control-project

Start, stop, or discard project changes.

Services

Tool

Description

list-services

List all services in a project.

get-service

Get service details and configuration.

create-service

Create a daemon or database service.

update-service

Update service configuration.

delete-service

Delete a service.

control-service

Start, stop, or rebuild a service.

Volumes

Tool

Description

create-volume

Create a persistent storage volume.

update-volume

Update a volume name or size.

delete-volume

Delete a volume.

wipe-volume

Irreversibly wipe all data from a volume.

Routes

Tool

Description

create-route

Create a domain or path mapping for a service.

update-route

Update route configuration.

delete-route

Delete a route.

Templates

Tool

Description

list-templates

List available project templates.

apply-template

Apply a template to a project.

Logs and Builds

Tool

Description

get-service-logs

Read service logs with cursor-based pagination.

list-builds

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 files

Project layout:

src/index.ts          MCP server entrypoint
src/client.ts         Bult API client
src/tools/*.ts        MCP tool registrations by resource type

Security

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 build

License

This project is licensed under the MIT License.

Available Tools

24 tools
apply-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-projectA
Destructive

Delete a Bult project and all related cloud hosting resources, including services, routes, volumes, deployments, and public URLs.

Inputs: project_id (required).

delete-routeB
Destructive

Delete a Bult public route or custom domain mapping from a deployed service.

Inputs: route_id (required).

delete-serviceA
Destructive

Delete a Bult service and remove its cloud hosting deployment resources.

Inputs: service_id (required).

delete-volumeA
Destructive

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-projectA
Read-only

Get a Bult project overview, including services, volumes, routes, deployment status, and public URL information.

Inputs: project_id (required).

get-serviceA
Read-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-logsA
Read-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-buildsB
Read-only

List Bult service build and deployment history to inspect build status, failures, source revisions, and recent deploy activity.

Inputs: service_id (required).

list-projectsA
Read-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-servicesB
Read-only

List services in a Bult project, including app, database, GitHub repository, Docker image, and cloud hosting deployment targets.

Inputs: project_id (required).

list-templatesA
Read-only

List available Bult app and database templates for fast cloud hosting setup and one-click deployments.

Inputs: no named parameters.

update-projectB
Idempotent

Update a Bult project name to keep deployment and hosting workspaces organized.

Inputs: project_id (required), name (required).

update-routeB
Idempotent

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-serviceA
Idempotent

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-volumeB
Idempotent

Update a Bult persistent volume name or size for app storage and database hosting needs.

Inputs: volume_id (required), name (required), size.

wipe-volumeA
Destructive

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

    A3.8/5.0

    Scored across 24 tools

    Disambiguation5/5

    Each tool targets a distinct resource or action: project, service, route, volume, template, build, logs, control, deploy. No overlapping purposes; descriptions clearly differentiate them.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      38
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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