# buildtree MCP server

> Upload Android and iOS builds to share install links, QR codes, and collect tester feedback through an AI coding agent.

- Repository: https://github.com/engineerdeep/buildtree-mcp
- Page: https://hostedmcp.org/servers/engineerdeep/buildtree-mcp
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 0.1.2

## Install

### Claude Code

```sh
claude mcp add --env 'BUILDTREE_TOKEN=<YOUR_BUILDTREE_TOKEN>' buildtree-mcp -- npx -y @buildtree/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "buildtree-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@buildtree/mcp"
      ],
      "env": {
        "BUILDTREE_TOKEN": "<YOUR_BUILDTREE_TOKEN>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "buildtree-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@buildtree/mcp"
      ],
      "env": {
        "BUILDTREE_TOKEN": "<YOUR_BUILDTREE_TOKEN>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"buildtree-mcp","type":"stdio","command":"npx","args":["-y","@buildtree/mcp"],"env":{"BUILDTREE_TOKEN":"<YOUR_BUILDTREE_TOKEN>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "buildtree-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@buildtree/mcp"
      ],
      "env": {
        "BUILDTREE_TOKEN": "<YOUR_BUILDTREE_TOKEN>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add buildtree-mcp --env 'BUILDTREE_TOKEN=<YOUR_BUILDTREE_TOKEN>' -- npx -y @buildtree/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.buildtree-mcp]
command = "npx"
args = ["-y", "@buildtree/mcp"]

[mcp_servers.buildtree-mcp.env]
BUILDTREE_TOKEN = "<YOUR_BUILDTREE_TOKEN>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'BUILDTREE_TOKEN=<YOUR_BUILDTREE_TOKEN>' buildtree-mcp npx -- -y @buildtree/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "buildtree-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@buildtree/mcp"
      ],
      "env": {
        "BUILDTREE_TOKEN": "<YOUR_BUILDTREE_TOKEN>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `BUILDTREE_TOKEN` | no | yes | API token from the buildtree dashboard (optional; the buildtree_login tool signs in interactively otherwise). |
| `BUILDTREE_API_URL` | no | no | API origin. Defaults to https://buildtree.sh. |

## Tools (6)

- `buildtree_whoami`
- `buildtree_detect_project`
- `buildtree_write_config`
- `buildtree_build`
- `buildtree_upload`
- `buildtree_list_feedback`

## FAQ

### What platforms does buildtree support?

It works with Expo, React Native, Flutter, and native Android and iOS applications.

### How can I use buildtree in CI?

In CI environments, you can set the BUILDTREE_TOKEN environment variable to an API token from your buildtree dashboard.

### Can the AI agent see tester feedback?

Yes, the server allows the agent to read tester feedback including screenshots.
