# Ubriot

> Ubriot is an MCP server for developer tools. Trigger builds, ship to stores, roll back OTA channels and diagnose failures by chat. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Starting price:** $29 a month
- **Platforms:** CLI, API
- **Website:** https://ubriot.dev/mcp
- **MCP Registry name:** dev.ubriot/ubriot
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Twenty tools are grouped into apps and setup, builds, store submission, OTA and release health, push, and diagnosis. An assistant can register an app, queue an iOS or Android build on a chosen branch, read its logs, and then queue the finished build for TestFlight or Google Play. Apple and Google still run their own review.

A single release-health tool reads backend uptime and open release watches, sets the monitored health URL, or rolls back the last release on a channel. Publishing an OTA update itself is not done by the server; it returns the exact ubriot command to run on the machine that holds the app source.

Two tools, failure diagnosis and release-note generation, call OpenAI and need an OPENAI_API_KEY. The other 18 talk only to the Ubriot API. The server runs over stdio via npx on Node 18 or later and authenticates with an API key created in the Ubriot dashboard.

## Features

- **Build control:** Queue, inspect, list and cancel iOS and Android builds, and fetch raw logs.
- **Store submission:** Queue builds for TestFlight and Google Play.
- **OTA rollback:** Roll back the last release on a channel and check release health.
- **Failure diagnosis:** Turns failed build logs into a root cause and a step-by-step fix.
- **Release notes:** Writes store release notes from commits with tone and length per store.
- **Build analytics:** Reports success rate, duration percentiles, queue time and top apps over a date range.

## Good for

- Ship an iOS build from main and submit it to TestFlight
- Find out why the last Android build failed
- Check whether an app is missing credentials before release
- Roll back a JavaScript-only fix if health drops
- Write App Store and Play notes from recent commits

## Install

### Claude Code (Terminal)

```sh
claude mcp add ubriot --env UBRIOT_TOKEN='<UBRIOT_TOKEN>' --env UBRIOT_PASSWORD='<UBRIOT_PASSWORD>' --env UBRIOT_PUSH_SERVER_KEY='<UBRIOT_PUSH_SERVER_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' -- npx -y ubriot-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ubriot": {
      "command": "npx",
      "args": [
        "-y",
        "ubriot-mcp"
      ],
      "env": {
        "UBRIOT_TOKEN": "<UBRIOT_TOKEN>",
        "UBRIOT_PASSWORD": "<UBRIOT_PASSWORD>",
        "UBRIOT_PUSH_SERVER_KEY": "<UBRIOT_PUSH_SERVER_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ubriot": {
      "command": "npx",
      "args": [
        "-y",
        "ubriot-mcp"
      ],
      "env": {
        "UBRIOT_TOKEN": "<UBRIOT_TOKEN>",
        "UBRIOT_PASSWORD": "<UBRIOT_PASSWORD>",
        "UBRIOT_PUSH_SERVER_KEY": "<UBRIOT_PUSH_SERVER_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "ubriot": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ubriot-mcp"
      ],
      "env": {
        "UBRIOT_TOKEN": "<UBRIOT_TOKEN>",
        "UBRIOT_PASSWORD": "<UBRIOT_PASSWORD>",
        "UBRIOT_PUSH_SERVER_KEY": "<UBRIOT_PUSH_SERVER_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ubriot": {
      "command": "npx",
      "args": [
        "-y",
        "ubriot-mcp"
      ],
      "env": {
        "UBRIOT_TOKEN": "<UBRIOT_TOKEN>",
        "UBRIOT_PASSWORD": "<UBRIOT_PASSWORD>",
        "UBRIOT_PUSH_SERVER_KEY": "<UBRIOT_PUSH_SERVER_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ubriot": {
      "command": "npx",
      "args": [
        "-y",
        "ubriot-mcp"
      ],
      "env": {
        "UBRIOT_TOKEN": "<UBRIOT_TOKEN>",
        "UBRIOT_PASSWORD": "<UBRIOT_PASSWORD>",
        "UBRIOT_PUSH_SERVER_KEY": "<UBRIOT_PUSH_SERVER_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}
```

## Tools

- `ubriot_list_apps`: Lists release apps in the workspace.
- `ubriot_trigger_build`: Queues an iOS or Android build.
- `ubriot_build_status`: Reports build status and submission state.
- `ubriot_list_builds`: Lists recent builds.
- `ubriot_submit_testflight`: Queues an iOS build for TestFlight.
- `ubriot_submit_google_play`: Queues an Android build for Google Play.
- `ubriot_publish_ota`: Returns the command to publish an OTA update.
- `ubriot_release_health`: Reads health, sets monitoring or rolls back a channel.
- `ubriot_send_push`: Sends a push notification to an app's devices.
- `ubriot_diagnose_failure`: Explains a failed build and how to fix it.
- `ubriot_generate_release_notes`: Writes release notes from commits.
- `ubriot_build_analytics`: Aggregates build statistics.
- `ubriot_app_readiness`: Checks which credentials or settings are missing.
- `ubriot_setup_git_webhook`: Rotates the git webhook secret.

## FAQ

### Do I need an OpenAI key?

Only for ubriot_diagnose_failure and ubriot_generate_release_notes. The other 18 tools work without it.

### How is it installed?

Add npx ubriot-mcp@latest to your client config with UBRIOT_TOKEN set to an API key from the dashboard. Node 18 or newer is required.

### Can it publish OTA updates itself?

No. It returns the command to run with the ubriot CLI in the app folder.

### Does it work with a staging backend?

Yes, set UBRIOT_API_BASE to your API base URL.

### Is Ubriot free?

Ubriot is a paid product with a free trial. Paid plans start at $29 a month.

### How do I add Ubriot to Claude Code?

Run this command in your terminal: claude mcp add ubriot --env UBRIOT_TOKEN='<UBRIOT_TOKEN>' --env UBRIOT_PASSWORD='<UBRIOT_PASSWORD>' --env UBRIOT_PUSH_SERVER_KEY='<UBRIOT_PUSH_SERVER_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' -- npx -y ubriot-mcp

### What are the best alternatives to Ubriot?

The closest alternatives to Ubriot are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/ubriot
