Skip to content
MCP server

MCP

Let AI agents read and drive a running React Native or Flutter app through Buoy devtools

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, macOS, iOS
Runs
Locally
Version
7.0.41
Listing updated
1 day ago

About MCP

MCP is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@buoy-gg/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@buoy-gg/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (20)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Freemium, from $30 a month

Free forever for dev builds; Solo $30/mo, Business from $60/seat; 14-day trial

Prices change. Check buoy.gg before you buy.

MCP 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 to MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools