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

# MCP

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:

```shellscript theme={null}
npm install -g @bultcloud/mcp-server
bult-mcp
```

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

```shellscript theme={null}
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://api.bult.ai`. |
| `BULT_API_TOKEN` | Yes          | API token used for Bearer authentication. |

***

## MCP Integration

### Claude Desktop

Add the server to `claude_desktop_config.json`.

Using `npx`:

```json theme={null}
{
  "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`:

```text theme={null}
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`:

```text theme={null}
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](https://github.com/bultcloud/mcp-server#available-tools) 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](https://github.com/bultcloud/mcp-server)