call
Runs a catalog-defined session tool with an arguments object, enabling coding agents to act on live app screens and capture repeatable test lines.
Instructions
Run one tool of a session by name, with its arguments as an object: call {tool: "tap", args: {target: "n42"}, session: ""}. The session's catalog (from open_session or tools) names the tools and their arguments. Actions report what changed on screen and the test line that repeats them; node ids are valid only for the newest observation.
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": {
"tool": "<tool>"
},
"name": "call"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| args | No | The tool's arguments; omit for a tool without any | |
| tool | Yes | A catalog tool name, e.g. "observe", "tap", "locate", "screenshot" | |
| session | No | Session id from open_session; may be omitted only while one session is open |