Operator agent how-to guides
Task guides for running MDK's conversational operator agent, standalone or behind the Gateway
Overview
@tetherto/mdk-agent is a conversational operator agent that answers plain-language questions about a mining fleet, calls
fleet tools over MCP, and gates writes behind human approval. What the agent is and how it fits the stack
covers the concepts; these guides cover running it.
If Gateway, Kernel, or plugin are unfamiliar, read terminology first.
Choose a guide
| Goal | Guide |
|---|---|
| Run the agent as a standalone CLI, for local development or evaluation | backend/core/agent/README.md |
| Deploy the agent behind the Gateway as a chat API for an operator UI | Deploy the agent behind the Gateway |
| Expose a plugin's own routes to the agent as tools | Expose data to the agent |