MDK Logo
Guides

Gateway how-to guides

Task guides for running and extending the MDK Gateway

Overview

The Gateway wraps @tetherto/mdk-client to deliver an HTTP interface for your frontend. These guides cover how to run it and extend it with the plugin system. Agents can reach MDK over MCP through the standalone @tetherto/mdk-mcp package.

If Gateway, Kernel, or plugin are unfamiliar, read terminology first. For the full developer model — extension, data access, auth design — read the Gateway concept page.

Choose a guide

GoalGuide
Start the Gateway for the first timeRun the Gateway
Use built-in plugins or build your ownGateway plugins
Stop Kernel, Gateway, and Workers cleanlyTear down MDK services
Operator in the loop: submit and approve write actionsSubmit and approve write actions

Next steps

Run the supported Worker fleet with mock devices

Boot multiple backend Workers as supervised PM2 or Docker processes, each connected to mock hardware

Run the Gateway

Start the MDK Gateway programmatically, as a standalone process, or connected to a remote Kernel over HRPC

On this page

OverviewChoose a guideNext steps