Skip to content

Quickstart

You’ll have your first session running in under a minute.

Sign in with Google. The free tier is self-serve — no waitlist, no credit card. (Per our self-serve, no-waitlist policy.)

In Settings → API keys, click Create key. Copy the value — it begins with kifas_live_ and is shown exactly once.

Terminal window
npm install -g @kifas/mcp
# or, in a project:
bun add @kifas/mcp

Add this block to .cursor/mcp.json, claude_desktop_config.json, or your client’s equivalent:

{
"mcpServers": {
"kifas": {
"command": "npx",
"args": ["-y", "@kifas/mcp"],
"env": { "KIFAS_API_KEY": "kifas_live_..." }
}
}
}

Sign in (top-right) and click Run. We spin up a real cloud browser, navigate it, and stream console.log back to you.

// 5-line example. Calls happen in your browser → docs.kifas.io →
// sandbox-runner → mcp.kifas.io → Browserless. The API key is brokered
// server-side by the docs site; it never reaches the snippet.
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: 'docs-quickstart', version: '0.1.0' })
await client.connect(transport)

const session = await client.callTool({
name: 'kifas.session.create',
arguments: { browser: 'chromium' },
})
console.log('session:', session)

const navigated = await client.callTool({
name: 'kifas.session.navigate',
arguments: { session_id: (session as { session_id: string }).session_id, url: 'https://example.com' },
})
console.log('navigated:', navigated)

Sign in at app.kifas.io to run snippets against a real cloud session.