@yawlabs/bild-mcp

@yawlabs/bild-mcp

MCP server adapter for bild.sh — build servers + artifact hosting for all software.

One integration among many. bild-mcp exposes the bild REST API as MCP tools so AI agents can trigger builds, stream logs, and pull artifacts from MCP-capable clients.

Install

npx -y @yawlabs/bild-mcp

Configure

Add to your MCP client config:

{
  "mcpServers": {
    "bild": {
      "command": "npx",
      "args": ["-y", "@yawlabs/bild-mcp"],
      "env": {
        "BILD_TOKEN": "bild_pat_...",
        "BILD_SERVER": "https://bild.sh"
      }
    }
  }
}

BILD_TOKEN is required. BILD_SERVER is optional — defaults to https://bild.sh, override it to target a self-host instance. The env var names match the @yawlabs/bild CLI so one setting covers both.

Tools

• bild_whoami — list teams the PAT can access.
• bild_queue_build — queue a build (spec, optional teamSlug, arch).
• bild_get_build — fetch a build by id.
• bild_list_artifacts — list artifacts for a team (optional name, limit).
• bild_get_artifact — fetch a single artifact; blob kinds return a short-lived signed pullUrl.

Artifact push is intentionally out of scope for v0 — the signed-URL + binary PUT flow doesn't round-trip cleanly through a text tool surface. Use the bild CLI (bild artifacts push) for uploads.

License

Apache-2.0. See LICENSE.