Documentation

Local MCP

On this page

TL;DR
With workstation running, copy URL from Capabilities → Local MCP (default http://127.0.0.1:9866/mcp) into Cursor or WorkBuddy.

Local MCP

Prerequisites

  1. iDeviceFarm workstation running
  2. At least one online device on Devices
  3. MCP-capable client (Cursor, WorkBuddy, …)

Marketing overview: AI integration.

URL

http://127.0.0.1:9866/mcp

Use the URL shown in the UI if the port differs.

Cursor

Merge into .cursor/mcp.json or ~/.cursor/mcp.json, then reload MCP:

{
  "mcpServers": {
    "devicefarm-agent": {
      "url": "http://127.0.0.1:9866/mcp"
    }
  }
}

WorkBuddy

Merge into ~/.workbuddy/mcp.json with type: "http":

{
  "mcpServers": {
    "devicefarm-agent": {
      "type": "http",
      "url": "http://127.0.0.1:9866/mcp"
    }
  }
}

Tools (orchestration)

Tool Description
list_devices Enrolled synced devices
list_device_groups Groups incl. _ungrouped
list_devices_by_groups Union by group IDs
list_workflows Local workflow summaries

These are query/orchestration tools; deep execution stays in workstation chat/workflows.

Verify

Reload client → ask to list devices → should match Devices.

Troubleshooting

Symptom Fix
Connection refused Workstation up; correct URL; localhost not blocked
Empty tools Enroll devices; workflows exist locally