{
  "markdown": "# @bultcloud/mcp-server\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\nOfficial Model Context Protocol (MCP) server for [Bult.ai](https://bult.ai),\na DevOps platform and cloud hosting Platform-as-a-Service for deploying apps,\nGitHub repositories, Docker images, databases, and services with AI agents.\n\nUse Bult MCP with Claude Desktop, Claude Code, Cursor, Codex, and other\nMCP-compatible clients to deploy apps, manage cloud infrastructure, inspect\nlogs, and troubleshoot deployments through the Bult API.\n\n## Demo\n\n![Bult MCP demo](assets/bult-mcp-demo.gif)\n\n## Features\n\n- Deploy GitHub repositories, Docker images, databases, and app services from\n  MCP-compatible AI agents.\n- Project lifecycle tools: list, inspect, create, update, delete, deploy, start,\n  stop, and discard changes.\n- Service management for daemon and database services, including Docker image and\n  Git-based deployments.\n- Persistent volumes, route/domain mappings, templates, service logs, and build\n  history.\n- MCP tool annotations for read-only, idempotent, and destructive operations\n  where supported.\n- Works over stdio with Claude Desktop, Claude Code, Cursor, Google Antigravity and other MCP-compatible\n  clients.\n\n## When to use Bult MCP\n\nUse Bult MCP when you want an AI coding agent to deploy and operate cloud\nhosting resources for you. Common workflows include deploying a GitHub repo from\nCursor, deploying the current project from Claude Code, launching a Docker image,\ncreating a database service, adding a public route, checking build logs, and\ndebugging failed deployments.\n\n## Requirements\n\n- Node.js 18 or newer.\n- Bult API token.\n\n## Installation\n\nIf you install the package globally, use the `bult-mcp` binary:\n\n```bash\nnpm install -g @bultcloud/mcp-server\nbult-mcp\n```\n\nYou can also run it with `npx` from MCP client configs:\n\n```bash\nnpx -y @bultcloud/mcp-server\n```\n\n## Configuration\n\nThe server reads its configuration from environment variables.\n\n| Variable | Required | Description |\n| --- | --- | --- |\n| `BULT_API_URL` | Yes | Bult API base URL, `https://app.bult.ai`. |\n| `BULT_API_TOKEN` | Yes | API token used for Bearer authentication. |\n\nThe server exits during startup if either variable is missing.\n\n## MCP Client Setup\n\n### Claude Desktop\n\nAdd the server to `claude_desktop_config.json`.\n\nUsing `npx`:\n\n```json\n{\n  \"mcpServers\": {\n    \"bult\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bultcloud/mcp-server\"],\n      \"env\": {\n        \"BULT_API_URL\": \"https://app.bult.ai\",\n        \"BULT_API_TOKEN\": \"your-token\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\nUsing `npx`:\n\n```bash\nclaude mcp add bult \\\n  -e BULT_API_URL=https://app.bult.ai \\\n  -e BULT_API_TOKEN=your-token \\\n  -- npx -y @bultcloud/mcp-server\n```\n\n### Codex CLI\n\nUsing `npx`:\n\n```bash\ncodex mcp add \\\n  --env BULT_API_URL=https://app.bult.ai \\\n  --env BULT_API_TOKEN=your-token \\\n  bult \\\n  -- npx -y @bultcloud/mcp-server\n```\n\n## Available Tools\n\n### Projects\n\n| Tool | Description |\n| --- | --- |\n| `list-projects` | List all projects in the workspace. |\n| `get-project` | Get a project overview with services, volumes, and routes. |\n| `create-project` | Create a new project. |\n| `update-project` | Update a project name. |\n| `delete-project` | Delete a project and all of its resources. |\n| `deploy-project` | Deploy project changes and create a version snapshot. |\n| `control-project` | Start, stop, or discard project changes. |\n\n### Services\n\n| Tool | Description |\n| --- | --- |\n| `list-services` | List all services in a project. |\n| `get-service` | Get service details and configuration. |\n| `create-service` | Create a daemon or database service. |\n| `update-service` | Update service configuration. |\n| `delete-service` | Delete a service. |\n| `control-service` | Start, stop, or rebuild a service. |\n\n### Volumes\n\n| Tool | Description |\n| --- | --- |\n| `create-volume` | Create a persistent storage volume. |\n| `update-volume` | Update a volume name or size. |\n| `delete-volume` | Delete a volume. |\n| `wipe-volume` | Irreversibly wipe all data from a volume. |\n\n### Routes\n\n| Tool | Description |\n| --- | --- |\n| `create-route` | Create a domain or path mapping for a service. |\n| `update-route` | Update route configuration. |\n| `delete-route` | Delete a route. |\n\n### Templates\n\n| Tool | Description |\n| --- | --- |\n| `list-templates` | List available project templates. |\n| `apply-template` | Apply a template to a project. |\n\n### Logs and Builds\n\n| Tool | Description |\n| --- | --- |\n| `get-service-logs` | Read service logs with cursor-based pagination. |\n| `list-builds` | List build history for a service. |\n\n## Example Prompts\n\n- Deploy this GitHub repo to Bult and give me the public URL.\n- Deploy the current project to Bult.\n- Check why my deployment failed.\n- Show the latest logs for my app.\n- Set DATABASE_URL and restart the service.\n- Deploy this Docker image to Bult.\n- List my Bult projects and services.\n\n## Development\n\n```bash\nnpm run dev      # run with tsx, no build step\nnpm run build    # compile TypeScript to dist/\nnpm run lint     # type-check without emitting files\n```\n\nProject layout:\n\n```text\nsrc/index.ts          MCP server entrypoint\nsrc/client.ts         Bult API client\nsrc/tools/*.ts        MCP tool registrations by resource type\n```\n\n## Security\n\n`BULT_API_TOKEN` grants access to your Bult resources. Keep it out of\nsource control, shell history, issue reports, and screenshots. Prefer scoped or\nrotatable tokens when available.\n\nSome tools can create, delete, deploy, stop, or wipe resources. Review tool calls\nfrom your MCP client before approving destructive actions.\n\n## Privacy Policy\n\nThis MCP server connects your MCP client to Bult.ai using the API token you\nprovide. Requests are sent to Bult.ai to perform actions such as listing\nprojects, deploying services, managing routes and volumes, and reading logs.\n\nThe server does not store your API token. Tokens are passed through your MCP\nclient configuration or extension settings. For Bult.ai data handling practices,\nsee the [Bult.ai Privacy Policy](https://bult.ai/privacy-policy).\n\n## Contributing\n\nIssues and pull requests are welcome at\n[github.com/bultcloud/mcp-server](https://github.com/bultcloud/mcp-server).\n\nBefore opening a pull request, run:\n\n```bash\nnpm run lint\nnpm run build\n```\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n",
  "bytes": 6397,
  "sha": "edfcee6b82b2b73e39671d4ec9f4f9e1e9bc2886d79ff46dd8d3a96e8879d320",
  "repo_slug": "bultcloud/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_bultcloud_mcp_server_39d63f8d/readme"
}