← All toolsSystem & Hardwarebluetooth_managerAll editions

CONNECT_DEVICE

Connect to a Bluetooth device by MAC address or name.

Parameters

NameTypeRequiredDescription
macstring—MAC address of the device
namestring—Device name (used on macOS if MAC unknown)

How to use it

You normally trigger this by describing what you want in chat — the agent selects CONNECT_DEVICE automatically. For example:

Try saying
“use bluetooth manager to connect …”

In a workflow

As a step in a multi-step workflow DAG:

json
{
  "id": "s1",
  "agent": "bluetooth_manager",
  "action": "CONNECT_DEVICE",
  "args": {
    "mac": "…",
    "name": "…"
  },
  "depends_on": [],
  "outputs": []
}

Direct call

For scripting, call it directly via POST /execute_tool. Every tool returns { success, message, data }.

bash
curl -X POST http://127.0.0.1:8000/execute_tool \
  -H "Content-Type: application/json" \
  -d '{"tool_name":"CONNECT_DEVICE","args":{"mac":"…","name":"…"}}'

Part of the bluetooth_manager plugin. Browse the full Plugin & Tool Catalog or the relevant feature guide.