Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 19 additions & 1 deletion docs/modules/ai/pages/mcp/ai-plugin-mcp-ref.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ This reference covers `automate` plugin version 1.9.0. For newer changes, see th

== MCP tools

The plugin exposes 30 MCP tools across 5 domains.
The plugin exposes 31 MCP tools across 5 domains.

=== Devices

Expand Down Expand Up @@ -48,6 +48,9 @@ The plugin exposes 30 MCP tools across 5 domains.

|`terminateSession`
|Stop a running test session.

|`startNativeSession`
|Start a native automation session with XCUITest, UIAutomator, or GameDriver. Upload the app and the test runner to Kobiton Store first, then pass their `kobiton-store:` identifiers. This books a device and starts a billable session.
|===

=== Apps
Expand Down Expand Up @@ -136,6 +139,20 @@ A test case is a saved, replayable sequence of steps created from a completed se
|Return your organization's settings, including the live remediation flag that determines what happens when a test run execution hits a blocker.
|===

== AI tool attribution

Kobiton records which AI tool made each MCP call, and stores that name on sessions started with `startNativeSession`. The server resolves the name from the request itself, so no tool accepts it as an argument and no prompt or skill has to supply it.

The server checks, in order:

. The `X-AI-Tool-Name` header, when your MCP server configuration sets it.
. The `User-Agent` sent by your AI assistant, when the header is absent.
. `Unknown`, when neither identifies a recognized tool.

An unrecognized value never fails a call. The call runs normally and Kobiton records the tool as `Unknown`.

Set `X-AI-Tool-Name` to attribute your calls explicitly. The Codex CLI and Cursor CLI setup guides already include this header in their MCP configuration examples. See xref:mcp/install-local-ai-plugin.adoc[Install and configure local plugin] and xref:mcp/cursor-cli.adoc[Kobiton for Cursor CLI].

== Skills

The plugin ships five guided skills.
Expand Down Expand Up @@ -350,6 +367,7 @@ Stop test run 8891
....
Show running sessions
Get details for session 12345
Start a UIAutomator session on a Pixel 8 with my uploaded app and test runner
Download logs from the last failed session
Stop session 12345
....
Loading