Quickstart

Get an API key from app.doksi.ai/devices/api-keys, then add the server to your MCP client.

Installation

claude mcp add doksi-device \
  --env DOKSI_API_KEY=your-api-key \
  -- npx -y @doksi/mcp-device

cursor --add-mcp '{"name":"doksi-device","command":"npx","args":["-y","@doksi/mcp-device"],"env":{"DOKSI_API_KEY":"your-api-key"}}'

code --add-mcp '{"name":"doksi-device","command":"npx","args":["-y","@doksi/mcp-device"],"env":{"DOKSI_API_KEY":"your-api-key"}}'

codex mcp add doksi-device \
  --env DOKSI_API_KEY=your-api-key \
  -- npx -y @doksi/mcp-device

{
  "mcpServers": {
    "doksi-device": {
      "command": "npx",
      "args": ["-y", "@doksi/mcp-device"],
      "env": { "DOKSI_API_KEY": "your-api-key" }
    }
  }
}

{
  "mcpServers": {
    "doksi-device": {
      "command": "npx",
      "args": ["-y", "@doksi/mcp-device"],
      "env": { "DOKSI_API_KEY": "your-api-key" }
    }
  }
}

Global install

Alternatively, install globally and reference doksi-device directly:

npm install -g @doksi/mcp-device

Verify the connection

Ask your agent:

Start a device session, take a screenshot, and tell me what's on screen.

The agent will call start_session, wait for boot (~90s), then use get_visual_state to capture the screen.

Examples

Install and smoke-test an app

Start a session, install the APK at /build/app-debug.apk, launch it, and take a screenshot.

End-to-end login flow

Open the app, type user@example.com into the email field, type password123 into the password field, tap Login, and check the network logs for the auth response.

Test under poor network conditions

Set network speed to GPRS, launch the app, navigate to the product listing, and check if images load or if errors appear in the logs.

Deep link verification

Open the deep link myapp://product/detail/98765 and screenshot to confirm the correct screen rendered.

Memory leak detection

Get memory usage of com.example.myapp before and after navigating the checkout flow 5 times. Compare the totals.

Dark mode regression

Enable dark mode, take a screenshot. Disable it, take another. Compare both for visual regressions.

OTP verification

Tap "Send verification code", simulate an SMS from +1234567890 with text Your code is 847291, enter the code, and confirm it was accepted.