Skip to content
Expo Agent Kit

Let Cursor, Antigravity or Windsurf drive your React Native app

expo-mcp-bridge speaks the Model Context Protocol, so any MCP-capable editor agent can use it. Once connected, the agent can see the screen of your running Expo app, press buttons, fill forms, scroll lists, and read console errors and network requests — on a real phone.

1. Install and mount

npx expo install expo-mcp-bridge react-native-view-shot

Add <AgentBridge router={router} /> as the last child of app/_layout.tsx — see Installation.

2. Add the MCP server to your editor

Cursor

npx expo-mcp-bridge init --cursor

This writes .cursor/mcp.json. Reload Cursor and enable the expo-app server in its MCP settings.

Antigravity, Windsurf, Cline and other MCP clients

Add this to the client's MCP settings:

{
  "mcpServers": {
    "expo-app": { "command": "npx", "args": ["expo-mcp-bridge"] }
  }
}
On Windows use "command": "cmd", "args": ["/c", "npx", "expo-mcp-bridge"].

npx expo-mcp-bridge init also adds an expo-app-control section to AGENTS.md, which Antigravity, Cursor and Codex read for project instructions — it explains how to use the tools efficiently.

3. Run the app and ask

npx expo start

Open the app on your phone on the same Wi-Fi, then ask the agent something like “Check the checkout flow with an expired card and tell me what the user sees.”

What the agent can do

  • Read the visible screen as a compact outline with stable refs (app_snapshot)
  • Tap, type, scroll, toggle, navigate and wait (app_tap, app_type, app_batch and more)
  • Take screenshots, including whole scrollable pages (app_screenshot)
  • Read logs, JS errors and network requests (app_logs, app_network)
  • Press volume, back and home on Android (device_key)

Full list: tools reference.