adb_tunnel_open
Open a managed host-to-device or device-to-host tunnel, auto-selecting a free host port for forward connections and returning an ID for later cleanup.
Instructions
Open a managed tunnel between host and device. Higher-level convenience wrapper over adb_forward / adb_reverse: auto-picks a free host port when one isn't specified (forward only), returns an opaque tunnel ID for later close, and registers cleanup so the tunnel is removed on server exit. Direction 'forward' = host port forwards TO device service; 'reverse' = device port forwards TO host service.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"direction": "<direction>",
"deviceSpec": "<deviceSpec>"
},
"name": "adb_tunnel_open"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| device | No | Device serial | |
| hostSpec | No | Host-side spec, e.g., 'tcp:8080'. For 'forward' direction: omit to auto-pick a free host port. For 'reverse' direction: required (can't auto-pick device-side ports without an extra probe call). | |
| direction | Yes | 'forward' (host → device) or 'reverse' (device → host) | |
| deviceSpec | Yes | Device-side spec, e.g., 'tcp:3000' or 'localabstract:app_socket' |