Skip to content

kifas.session.swipe

Swipe gesture on a mobile session. Either “direction” or (fromRef + toRef), not both. “direction” is the direction your FINGER moves, which is the opposite of the direction the content travels: “up” reveals content further DOWN the page or list, “down” reveals content ABOVE. The gesture is inset from the screen edges so it cannot trigger the system notification shade or navigation bar. The result reports signals.screen_changed — whether the screen differs afterwards — so you do not need a screenshot to find out.

Required scopes: session:create

Name Type Required Default Description
session_id string yes —
direction "up"` | `"down"` | `"left"` | `"right" no —
pixels integer no —
fromRef string no —
toRef string no —
{
"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
}
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.swipe',
arguments: {
"session_id": "00000000-0000-0000-0000-000000000000"
},
})
console.log(result)
Python (httpx, raw JSON-RPC)
import os
import 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.swipe",
"arguments": {
"session_id": "00000000-0000-0000-0000-000000000000"
},
},
},
)
print(resp.json())
curl
Terminal window
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.swipe",
"arguments": {
"session_id": "00000000-0000-0000-0000-000000000000"
}
}
}'
Raw JSON-RPC body
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "kifas.session.swipe",
"arguments": {
"session_id": "00000000-0000-0000-0000-000000000000"
}
}
}

Want to try kifas.session.swipe? Sign in to the dashboard and run it against a real session.

Try in Kifas →