kifas.session.press_key
kifas.session.press_key
Section titled “kifas.session.press_key”Press one key. Mobile sessions: a system key (back/home/menu/volume_up/volume_down/enter). Browser sessions: Enter, Tab, Escape, ArrowUp/Down/Left/Right, Backspace, Delete, Home, End, PageUp, PageDown or Space, sent to the focused element — or to the element named by ref, selector or role+name, which is focused first. The result reports signals (screen_changed on mobile, the page changes on a browser) so you do not need a screenshot to find out.
Required scopes: session:create
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
session_id |
string |
yes | — | |
key |
"back"` | `"home"` | `"menu"` | `"volume_up"` | `"volume_down"` | `"enter"` | `"Enter"` | `"Tab"` | `"Escape"` | `"ArrowUp"` | `"ArrowDown"` | `"ArrowLeft"` | `"ArrowRight"` | `"Backspace"` | `"Delete"` | `"Home"` | `"End"` | `"PageUp"` | `"PageDown"` | `"Space" |
yes | — | |
selector |
string |
no | — | |
ref |
string |
no | — | |
role |
string |
no | — | |
name |
string |
no | — | |
within |
object |
no | — | |
nth |
integer |
no | — | |
max_wait_ms |
integer |
no | — |
Returns
Section titled “Returns”{ "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "signals": { "type": "object", "properties": { "url_before": { "type": "string" }, "url_after": { "type": "string" }, "scroll_y_before": { "type": "number" }, "scroll_y_after": { "type": "number" }, "settled_ms": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "settled_reason": { "type": "string", "enum": [ "quiet", "steady", "timeout" ] }, "dom_mutation_count": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "screen_change_count": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "screen_changed": { "type": "boolean" }, "effect_unverified_reason": { "type": "string" }, "console_errors": { "default": [], "type": "array", "items": { "type": "string" } }, "http_statuses": { "default": [], "type": "array", "items": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "element_found": { "type": "boolean" }, "check": { "type": "object", "properties": { "kind": { "type": "string" }, "pass": { "type": "boolean" }, "reason": { "type": "string", "maxLength": 2000 }, "cached": { "type": "boolean" }, "unavailable": { "type": "boolean" } }, "required": [ "kind", "pass", "reason" ], "additionalProperties": false } }, "required": [ "settled_ms", "console_errors", "http_statuses" ], "additionalProperties": false } }, "required": [ "ok" ], "additionalProperties": false}Code samples
Section titled “Code samples”TypeScript (Anthropic MCP SDK)
import { Client } from '@modelcontextprotocol/sdk/client/index.js'import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamable-http.js'
const transport = new StreamableHTTPClientTransport( new URL('https://mcp.kifas.io/'), { requestInit: { headers: { Authorization: `Bearer ${process.env.KIFAS_API_KEY}` }, }, },)const client = new Client({ name: 'demo', version: '0.1.0' })await client.connect(transport)
const result = await client.callTool({ name: 'kifas.session.press_key', arguments: { "session_id": "00000000-0000-0000-0000-000000000000", "key": "" },})console.log(result)Python (httpx, raw JSON-RPC)
import osimport httpx
resp = httpx.post( "https://mcp.kifas.io/", headers={ "Authorization": f"Bearer {os.environ['KIFAS_API_KEY']}", "Content-Type": "application/json", }, json={ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "kifas.session.press_key", "arguments": { "session_id": "00000000-0000-0000-0000-000000000000", "key": "" }, }, },)print(resp.json())curl
curl https://mcp.kifas.io/ \ -H "Authorization: Bearer $KIFAS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "kifas.session.press_key", "arguments": { "session_id": "00000000-0000-0000-0000-000000000000", "key": "" } }}'Raw JSON-RPC body
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "kifas.session.press_key", "arguments": { "session_id": "00000000-0000-0000-0000-000000000000", "key": "" } }}Try it
Section titled “Try it”Want to try kifas.session.press_key? Sign in to the dashboard and run it against a real session.