Local API & CLI Reference
Download Client & CLILocal API & CLI Documentation
The local desktop engine listens on http://127.0.0.1:9112, exposing Playwright CDP and CLI automation.
Local API Endpoint
http://127.0.0.1:9112
Auth Header
Authorization: Bearer mdk_*
Automation Protocol
Playwright · connectOverCDP
Local API & mdk CLI Concurrency OverviewCompare all plans →
Free · $0 Forever
Single-window debugging (1 concurrent)
Solo · $79 Founding Pass
Unlimited concurrent windows + local API create
Pro $9/mo · Team $29/mo
Unlimited concurrency + cross-device sync
Local Loopback Only
chromium.connectOverCDP(wsEndpoint)
import { chromium } from 'playwright'
const res = await fetch('http://127.0.0.1:9112/api/v1/browser/start', {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({ serialNumber: 1, cdp: true }),
})
const { wsEndpoint } = await res.json()
const browser = await chromium.connectOverCDP(wsEndpoint)| HTTP Method | Endpoint Path | Description |
|---|---|---|
| GET | /api/v1/status | Engine status, quota counts, and local kernel version |
| POST | /api/v1/browser/start | Launch profile and return CDP wsEndpoint (Free single window) |
| POST | /api/v1/browser/stop | Stop running window and persist session snapshot |
| GET | /api/v1/browser/active | List active window sessions and debug endpoints |
| POST | /api/v1/browser/arrange | Tile or cascade desktop browser windows in one call |
| GET / POST | /api/v1/browser/check | Execute or read 6-dimension environment self-check results |
| GET / POST / DELETE | /api/v1/profiles | List profiles, create via API (Pro+), or manage recycle bin |
| GET / POST / DELETE | /api/v1/proxies | Manage proxy pool, latency checks, and sealed credentials |
| GET / POST / DELETE | /api/v1/groups | Manage workspace groups and ordering |
| GET / POST / PATCH / DELETE | /api/v1/extensions | Manage Chrome extension catalog and default mounts |