Local API & CLI Reference

Local API & CLI Documentation

The local desktop engine listens on http://127.0.0.1:9112, exposing Playwright CDP and CLI automation.

Download Client & CLI
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 MethodEndpoint PathDescription
GET/api/v1/statusEngine status, quota counts, and local kernel version
POST/api/v1/browser/startLaunch profile and return CDP wsEndpoint (Free single window)
POST/api/v1/browser/stopStop running window and persist session snapshot
GET/api/v1/browser/activeList active window sessions and debug endpoints
POST/api/v1/browser/arrangeTile or cascade desktop browser windows in one call
GET / POST/api/v1/browser/checkExecute or read 6-dimension environment self-check results
GET / POST / DELETE/api/v1/profilesList profiles, create via API (Pro+), or manage recycle bin
GET / POST / DELETE/api/v1/proxiesManage proxy pool, latency checks, and sealed credentials
GET / POST / DELETE/api/v1/groupsManage workspace groups and ordering
GET / POST / PATCH / DELETE/api/v1/extensionsManage Chrome extension catalog and default mounts