Quickstart
You’ll have your first session running in under a minute.
1. Sign up
Section titled “1. Sign up”Sign in with Google. The free tier is self-serve — no waitlist, no credit card. (Per our self-serve, no-waitlist policy.)
2. Mint an API key
Section titled “2. Mint an API key”In Settings → API keys, click Create key. Copy the value — it begins with
kifas_live_ and is shown exactly once.
3. Install @kifas/mcp
Section titled “3. Install @kifas/mcp”npm install -g @kifas/mcp# or, in a project:bun add @kifas/mcp4. Wire your MCP client
Section titled “4. Wire your MCP client”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_..." } } }}5. Run a snippet right here
Section titled “5. Run a snippet right here”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.
What’s next
Section titled “What’s next”- Browse the 17 MCP tools
- Use Playwright directly without the MCP layer
- Concepts → Sessions