kifas.session.create
kifas.session.create
Section titled “kifas.session.create”Acquire a cloud session asynchronously. Returns { session_id, status: “acquiring” } immediately (status “queued” with a plain-language message when an Android emulator request waits for a device); callers poll kifas.session.status until status becomes “ready” or “failed”. Browser path acquires Browserless on demand at WSS /connect; mobile path dispatches an AWS Device Farm android-mobile session (130-250s wall-clock). Subsequent kifas.session.* tools reference the session_id.
Required scopes: session:create
Parameters
Section titled “Parameters”This tool takes no parameters.
Returns
Section titled “Returns”{ "type": "object", "properties": { "session_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "status": { "type": "string", "enum": [ "queued", "acquiring", "ready", "failed" ] }, "connect_url": { "type": "string", "format": "uri" }, "expires_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "error": { "type": "string" }, "message": { "type": "string" }, "queue": { "type": "object", "properties": { "reason": { "type": "string", "enum": [ "device", "starting_devices", "org_limit", "at_capacity" ] }, "position": { "anyOf": [ { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "org_running": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "org_limit": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "typical_wait_s": { "anyOf": [ { "type": "array", "items": [ { "type": "number" }, { "type": "number" } ], "additionalItems": false, "minItems": 2, "maxItems": 2 }, { "type": "null" } ] }, "gives_up_at": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, { "type": "null" } ] } }, "required": [ "reason", "position", "org_running", "org_limit", "typical_wait_s", "gives_up_at" ], "additionalProperties": false } }, "required": [ "session_id", "status" ], "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.create', arguments: {},})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.create", "arguments": {}, }, },)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.create", "arguments": {} }}'Raw JSON-RPC body
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "kifas.session.create", "arguments": {} }}Try it
Section titled “Try it”Want to try kifas.session.create? Sign in to the dashboard and run it against a real session.