Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.bult.ai/llms.txt

Use this file to discover all available pages before exploring further.

The MCP Server exposes platform capabilities through the Model Context Protocol (MCP), enabling AI agents and MCP-compatible clients to interact with Bult in a structured and secure way.

​
Overview

The MCP Server acts as a bridge between platform and AI tools such as:
  • Claude Desktop
  • Cursor
  • Any MCP-compatible agent framework
It allows agents to perform actions on Bult without direct integration complexity.

​
Features

  • 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.

​
Installation

​
Requirements

  • Node.js 18 or newer.
  • Bult API token.
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.
VariableRequiredDescription
BULT_API_URLYesBult API base URL, https://api.bult.ai.
BULT_API_TOKENYesAPI token used for Bearer authentication.

​
MCP Integration

​
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://api.bult.ai",
        "BULT_API_TOKEN": "your-token"
      }
    }
  }
}

​
Claude Code

Using npx: 
claude mcp add bult \
  -e BULT_API_URL=https://api.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://api.bult.ai \
  --env BULT_API_TOKEN=your-token \
  bult \
  -- npx -y @bultcloud/mcp-server

​
Available Tools

Refer to the repository for currently available tools. More tools will be added as the platform evolves.

​
Contributing

Contributions are welcome. Please open issues or pull requests on GitHub: https://github.com/bultcloud/mcp-server