# MCP

> MCP is a freemium MCP server for developer tools. Let AI agents read and drive a running React Native or Flutter app through Buoy devtools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $30 a month
- **Platforms:** CLI, macOS, iOS, Android
- **Website:** https://buoy.gg/buoy/latest/docs/mcp
- **Repository:** https://github.com/buoy-gg/buoy
- **MCP Registry name:** io.github.Buoy-gg/mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-16

## About

Instead of reading logs after the fact, the agent works against a live app on a device or simulator. Free accounts get screen description, taps, swipes, typing, step flows, screenshots, recordings, route navigation and reload, console logs, network request lists without bodies, and a triage summary. Buoy Optimize speed tests and a simulator farm are included with no cap; paid plans add state, storage, request bodies and reasons a screen is slow.

It needs a Buoy account signed in on both the app and the computer (buoy login does both), Node.js 18 or newer, and a running app with Buoy devtools open. iOS control needs Xcode and Android needs adb. Everything is documented as working with React Native today, with Flutter and others in beta and some capabilities React Native only. A web variant for driving Chrome ships in the same package.

A bundled buoy-optimize skill scaffolds variants of a render-heavy feature, benchmarks each on a real device and keeps the fastest.

## Features

- **Live app reading:** Agents see network, storage, routes, console and state of the running app.
- **Device control:** Tap, swipe, type, pinch and run flows.
- **Benchmarking:** Speed tests and a simulator farm via Buoy Optimize.
- **Screenshots and recordings:** Capture components and screen recordings.
- **Doctor tool:** buoy_doctor diagnoses Buoy itself.
- **Free and Pro tiers:** Free covers basics; paid adds state, storage and bodies.
- **Web variant:** Drive Chrome with the web mode in the same package.

## Good for

- Have an agent reproduce and debug a React Native bug
- Confirm a fix by driving the UI after a change
- Benchmark competing implementations on a real device
- Read network and storage while testing
- Record steps for a bug report

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp -- npx -y @buoy-gg/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@buoy-gg/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@buoy-gg/mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@buoy-gg/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@buoy-gg/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@buoy-gg/mcp"
      ]
    }
  }
}
```

## Tools

- `describe_screen`: Describe what is on screen
- `native_inspect`: Inspect native UI
- `tap_element`: Tap an element
- `native_tap`: Native tap
- `native_swipe`: Native swipe
- `native_type`: Type text
- `native_pinch`: Pinch gesture
- `run_flow`: Run steps in a row
- `screenshot_component`: Screenshot a component
- `screen_recording`: Record the screen
- `device_control`: Work the device
- `reload_app`: Reload the app
- `navigate`: Navigate to a route
- `get_routes`: List routes
- `get_console`: Read logs
- `get_network_requests`: List network requests
- `get_triage`: Quick summary of app state
- `buoy_doctor`: Diagnose Buoy setup problems
- `run_benchmark_batch`: Run speed tests
- `get_js_thread_top`: JS thread busy totals

## FAQ

### What do I need first?

A Buoy account signed in on the app and computer, Node.js 18+, and a running app with Buoy devtools open.

### Does it work with Flutter?

Yes, in debug builds, though some features are React Native only and Flutter is in beta.

### What does the free plan include?

Screen reading, taps and flows, logs, network request lists and Optimize speed tests.

### What does paid add?

Full MCP with state, storage, request bodies and why a screen is slow.

### Is MCP free?

MCP has a free plan, with paid plans for more usage or features. Paid plans start at $30 a month.

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

Run this command in your terminal: claude mcp add mcp -- npx -y @buoy-gg/mcp

### What are the best alternatives to MCP?

The closest alternatives to MCP 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/mcp-mwenoi2v
