mcp · buoy-gg — Claude Code MCP server: drive a live React Native app
Lets an AI agent read and control a running React Native or Flutter app through Buoy devtools. Useful when you want requests, caches or state inspected inside the app itself.
claude mcp add mcp -- npx -y @buoy-gg/mcpWhat mcp does
The server hooks your agent into a Buoy session — a set of tools that sit inside the app. The agent can look at network calls, storage, query caches, routes, renders and performance, and it can change them while the app runs. The same session also opens in Buoy Desktop, or you can use Ask Buoy from inside the app.
It starts with npx -y @buoy-gg/mcp. You need a development build and a Buoy account, Free or Pro. Without the account the session never comes up, so check that first.
Tools are installed one at a time: Network, Storage, Time Machine, Scenarios, Clock, Lifecycle, Location, Permissions, React Query, Routes, Redux, Zustand, Jotai and more. A manual setup begins with the core package and Network, then a sign-in through npx --package=@buoy-gg/core buoy login. Flutter has its own debug-build setup.
What it helps with
- inspect network requests from a running app
- edit cached data and force an error state
- rewind app state to an earlier point
- switch environments and sign in as a customer
- spot wasted re-renders and slow frames
Example prompts for the agent
- Connect to the running app and show the latest network requests
- Replace the React Query cache entry and trigger the error screen
- Rewind the app state one step and show what changed
How to install mcp
Platform CLI
claude mcp add mcp -- npx -y @buoy-gg/mcpPlatform CLI
codex mcp add buoy-gg-mcp -- npx -y @buoy-gg/mcpConfig file
{
"mcpServers": {
"buoy-gg-mcp": {
"command": "npx",
"args": [
"-y",
"@buoy-gg/mcp"
]
}
}
}Config file
{
"servers": {
"buoy-gg-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@buoy-gg/mcp"
]
}
}
}Platform CLI
gemini mcp add buoy-gg-mcp npx -y @buoy-gg/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp
How do I install mcp in Claude Code?
Run claude mcp add mcp -- npx -y @buoy-gg/mcp. A second name works too: claude mcp add buoy-gg-mcp -- npx -y @buoy-gg/mcp.
What does mcp do?
It connects an AI agent to a running React Native or Flutter app through Buoy devtools, so the agent can read and change requests, storage, caches, routes and renders.
What is required for the MCP server to work?
A development build of the app and a Buoy account, either Free or Pro.
Similar MCP servers
Everything for Mobile →mcp by other authors comes first.
