# Buoy MCP server

> Read and drive a running React Native or Flutter app from your AI agent through Buoy's in-app devtools.

- Listing: https://mcp.tc/i/buoy
- Connect: this is a local (stdio) server; install it on your machine (see Install). The listing link is a page, not an MCP endpoint.
- Type: local (stdio)
- Auth: no API key needed
- Category: [Developer Tools](https://mcp.tc/c/developer-tools)
- Vendor: Buoy LLC
- Homepage: <https://buoy.gg/buoy/latest/docs/mcp>
- Repository: <https://github.com/Buoy-gg/buoy>
- Package: npm `@buoy-gg/mcp`

## About

Buoy connects AI agents to a running React Native or Flutter app through its in-app devtools. An agent can inspect network requests, storage and app state, take screenshots, and quit, open or reinstall the app on an iOS Simulator or Android.

The server runs locally over stdio from the npm package @buoy-gg/mcp. Your app needs the Buoy core and @buoy-gg/external-sync in a development build, and a Free or Pro Buoy account. A free account gets the basic MCP tools and Pro adds the full set.

## What it can do

- List and read network requests with headers and bodies
- Pin or save network requests
- Take full-screen or per-component screenshots
- Quit, launch and reinstall the app on iOS Simulator or Android
- Start an iOS Simulator
- Read live app state and storage from a running app

## Example prompts

- "List the latest network requests from my running app and show any that failed."
- "Read the full response body of the most recent login request."
- "Take a screenshot of the current screen in the iOS Simulator."
- "Reinstall the app as a fresh user and relaunch it."

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport stdio buoy -- npx -y @buoy-gg/mcp
```

2. Start Claude Code and type `/mcp`. **buoy** should show as connected.

Add `--scope user` to make it available in every project.

### Claude Desktop

1. Open **Settings → Developer → Edit Config**. It opens `claude_desktop_config.json`. Add:

`claude_desktop_config.json`:

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

2. Save the file and restart Claude Desktop.

Needs Node.js on your computer. The file lives in `~/Library/Application Support/Claude/` on macOS and `%APPDATA%\Claude\` on Windows.

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=buoy&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBidW95LWdnL21jcCJdfQ%3D%3D>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

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

Needs Node.js on your computer.

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=buoy&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40buoy-gg%2Fmcp%22%5D%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"buoy","type":"stdio","command":"npx","args":["-y","@buoy-gg/mcp"]}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

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

Needs Node.js on your computer.

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

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

2. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf.

### Codex

```bash
codex mcp add buoy -- npx -y @buoy-gg/mcp
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

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

Needs Node.js on your computer.

### Gemini CLI

```bash
gemini mcp add buoy npx -- -y @buoy-gg/mcp
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients that start local servers accept this shape:

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

Zed puts servers under `context_servers` in its settings, with the same `command`, `args` and `env` fields.

Needs Node.js on your computer.

## Recent changes

- 2026-11-17 23:27 UTC: New version 7.0.99 (was 7.0.98), read from npm. Source: automatic check.
- 2026-11-16 20:26 UTC: New version 7.0.95 (was 7.0.93), read from npm. Source: automatic check.
- 2026-11-12 02:31 UTC: New version 7.0.93 (was 7.0.92), read from npm. Source: automatic check.
- 2026-11-10 23:26 UTC: New version 7.0.89 (was 7.0.88), read from npm. Source: automatic check.
- 2026-11-09 17:29 UTC: New version 7.0.88 (was 7.0.87), read from npm. Source: automatic check.

More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/buoy#history (Atom feed: https://mcp.tc/i/buoy/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review.

## Details

- Server version: 7.0.99
- Last checked: 2026-10-12
- Listed: 2026-10-12
- Updated: 2026-10-12

---
Source: https://mcp.tc/i/buoy (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report
