English Français العربية

Bult

السجل الرسمي أدوات المطورين

Deploy and manage Bult apps from AI coding agents.

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع Bult؟

  • Deploy GitHub repositories, Docker images, databases, and app services from
  • Project lifecycle tools: list, inspect, create, update, delete, deploy, start,
  • Service management for daemon and database services, including Docker image and
  • Persistent volumes, route/domain mappings, templates, service logs, and build
  • MCP tool annotations for read-only, idempotent, and destructive operations
  • Works over stdio with Claude Desktop, Claude Code, Cursor, Google Antigravity and other MCP-compatible

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @bultcloud/mcp-server
Claude Code 
claude mcp add bult -e 'BULT_API_URL=<BULT_API_URL>' -e 'BULT_API_TOKEN=<your bult_api_token>' -- npx -y @bultcloud/mcp-server@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "bult": {
            "command": "npx",
            "args": [
                "-y",
                "@bultcloud/mcp-server@1.0.1"
            ],
            "env": {
                "BULT_API_URL": "<BULT_API_URL>",
                "BULT_API_TOKEN": "<your bult_api_token>"
            }
        }
    }
}

متغيرات البيئة

  • BULT_API_URL إلزامي Base URL of the Bult.ai API.
  • BULT_API_TOKEN إلزامي سري Bult API token used to authenticate requests.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @bultcloud/mcp-server
  2. Demo
  3. Features
  4. When to use Bult MCP
  5. Requirements
  6. Installation
  7. Configuration
  8. MCP Client Setup
  9. Available Tools
  10. Example Prompts
  11. Development
  12. Security
  13. Privacy Policy
  14. Contributing
  15. License

@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

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.

VariableRequiredDescription
BULT_API_URLYesBult API base URL, https://app.bult.ai.
BULT_API_TOKENYesAPI 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
ToolDescription
list-projectsList all projects in the workspace.
get-projectGet a project overview with services, volumes, and routes.
create-projectCreate a new project.
update-projectUpdate a project name.
delete-projectDelete a project and all of its resources.
deploy-projectDeploy project changes and create a version snapshot.
control-projectStart, stop, or discard project changes.
Services
ToolDescription
list-servicesList all services in a project.
get-serviceGet service details and configuration.
create-serviceCreate a daemon or database service.
update-serviceUpdate service configuration.
delete-serviceDelete a service.
control-serviceStart, stop, or rebuild a service.
Volumes
ToolDescription
create-volumeCreate a persistent storage volume.
update-volumeUpdate a volume name or size.
delete-volumeDelete a volume.
wipe-volumeIrreversibly wipe all data from a volume.
Routes
ToolDescription
create-routeCreate a domain or path mapping for a service.
update-routeUpdate route configuration.
delete-routeDelete a route.
Templates
ToolDescription
list-templatesList available project templates.
apply-templateApply a template to a project.
Logs and Builds
ToolDescription
get-service-logsRead service logs with cursor-based pagination.
list-buildsList 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.

الأسئلة الشائعة

ما هو Bult؟

Deploy and manage Bult apps from AI coding agents.

كيف أثبّت Bult؟

يعمل على جهازك. في Claude Code: claude mcp add bult -e 'BULT_API_URL=<BULT_API_URL>' -e 'BULT_API_TOKEN=<your bult_api_token>' -- npx -y @bultcloud/mcp-server@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Bult إلى مفتاح API؟

نعم. يتطلب BULT_API_URL, BULT_API_TOKEN، وتضبطها في إعداداته.

هل Bult مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Bult؟

ينشره bultcloud. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.