Back to Browse
About
Deploy and manage Bult apps from AI coding agents.
Security Report
5.2
Moderate5.2Moderate RiskThis is a well-structured MCP server for the Bult cloud hosting platform with proper authentication, secure credential handling, and appropriate permissions for its purpose. The server requires API token authentication via environment variables, implements all tool operations through an authenticated HTTP client, and includes proper error handling. No critical vulnerabilities or malicious patterns detected. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.
7 files analyzed · 7 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Base URL of the Bult.ai API.
Environment variable: BULT_API_URL
Bult API token used to authenticate requests.Required
Environment variable: BULT_API_TOKEN
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-bultcloud-mcp-server": {
"env": {
"BULT_API_URL": "your-bult-api-url-here",
"BULT_API_TOKEN": "your-bult-api-token-here"
},
"args": [
"-y",
"@bultcloud/mcp-server"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
@bultcloud/mcp-server
Official Model Context Protocol (MCP) server for Bult. It lets MCP clients manage Bult projects, services, volumes, routes, templates, deployments, logs, and builds through the Bult API.
Demo
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.
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.
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.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
80.0K
Stars
4
Installs
6.5
Security
No ratings yet
Local
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
80.0K
Stars
4
Installs
5.3
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
137
Stars
499
Installs
8.0
Security
4.8
Local