Skip to main content

MCP Tool Reference

MCP exposes five tools: tool_list, tool_info, tool_call, skill_list, and skill_read, for business-tool names, usage definitions, business calls, the Skill catalog, and Skill document reading. The directory is optional navigation. Business queries, changes, and device actions all use tool_call, with tool required. Call known tools directly; Skill documents and references are read on demand. args is an optional object containing business parameters.

ToolDescriptionEffect
tool_listReturn business tool names, optionally filtered by category.Read-only
tool_infoReturn descriptions, parameter schemas, and effects for selected tools without executing business operations.Read-only
tool_callCall a business tool to query, modify, or operate devices.Depends on business tool
skill_listReturn bundled Skill names, descriptions, and reading and download hints.Read-only
skill_readRead a Skill main file or reference file, with pagination.Read-only

Call Examples​

  • tool_list({}): Returns version and the sorted tools name list.
  • tool_list({category:"devices"}): Filters tool names by category.
  • tool_info({tools:"backend_list_devices"}): Describes the usage of one tool without executing it.
  • tool_info({tools:["backend_list_devices","device_get_status"]}): Describes multiple requested tools without executing them. Returns a tools array, each item containing the internal ID tool, description, inputSchema (for tool_call.args), and readOnly. tools accepts a nonempty string or a nonempty array of strings, with no fixed batch-size limit.
  • tool_call({tool:"backend_list_devices",args:{limit:10}}): Calls a known tool directly to read the needed device list.
  • skill_list({}): Lists Skill names, descriptions, and readCall hints.
  • skill_read({skill:"xxtlancontrol"}): Reads the main Skill directly when its name is known; path defaults to SKILL.md.
  • skill_read({skill:"xxtlancontrol",path:"references/tasks.md"}): Reads a workflow using a relative link from the main Skill; cursor / maxBytes provide pagination.

Application call hints readCall, infoCall, and listCall use {name,args}; name selects a public MCP tool. Skill IDs are returned as skills[].skill in the catalog and data.skill in read results.

Each skill_list entry provides downloadUrl, a complete URL on the current control center for the full Skill ZIP. skill_read returns the selected file as text and also includes the whole Skill package download link. The ZIP contains the main instructions, references, and any bundled scripts, templates, and assets. For download only, catalog metadata is enough; use an existing link directly without reading the text or listing again.

When names are unknown, browse tool_list by category. When parameters are unclear, fetch the needed definitions together with tool_info, then use tool_call. Known tools can be called directly without listing or reading definitions first.

After a batch operation returns a task ID, query its status and failed items. Reconnect MCP after updating the control center.

Run a device shell command​

In MCP settings, turn on Allow shell commands on devices and save to run shell commands on a device. This switch is off by default. Turning it off and saving hides the tool in all MCP sessions and rejects new calls.

command is a full command line of up to 16384 characters, executed by the device shell with -c. The result includes the exit code, stdout, stderr and a path notice for roothide shells.

The default command timeout is 10 seconds. Set timeoutMs for longer commands (for example, 300000 for 5 minutes) and allow enough time in the MCP client. The controller renews aux at startup and exchanges heartbeats with the device every 30 seconds. After the last task finishes, aux exits after 180 seconds of inactivity.

{"tool":"device_run_shell_command","args":{"udid":"DEVICE_UDID","command":"df -h"}}