steward

A self-hosted Discord administration service that coding agents control through MCP.

TypeScriptNode.jsMCPSQLiteDiscord.jsDocker
Source on GitHub

Project overview

Steward turns declarative YAML blueprints into reviewable Discord server changes. An authenticated MCP interface exposes administration tools; stable resource bindings in SQLite support repeatable plans, operation journals and drift checks. It executes structured operations through Discord’s official bot API rather than embedding a language model.

What it does

Describe a server

  • YAML blueprints for channels, roles and permissions
  • Dry-run plans before applying changes

Make operations traceable

  • SQLite resource bindings and operation journals
  • Drift detection and post-apply verification

Agent integration

  • Authenticated MCP over Streamable HTTP
  • Credential scopes and guild restrictions

Inside the project

The dashboard screenshots are taken from the Steward README. The blueprint planning screenshots show a capture-only MCP integration viewer using Steward's server and blueprint engine with simulated Discord data.

Dashboard overview

Dashboard overview

Gateway status, connected servers, available operations and system health

 Role inventory

Role inventory

Role inventory with hierarchy, access and blueprint keys

 Channel inventory

Channel inventory

Channel inventory with type, access and blueprint keys

 Blueprint editor

Blueprint editor

Blueprint editor with the current server exported as YAML

 AI request inbox

AI request inbox

AI request inbox for queuing requests to a connected agent

 MCP blueprint planning preview

MCP blueprint planning preview

 Verified simulated blueprint application

Verified simulated blueprint application

Technologies & implementation

Technology stack

  • TypeScript · Node.js
  • Model Context Protocol / Streamable HTTP
  • Discord.js · Discord official bot API
  • SQLite / better-sqlite3
  • Zod · YAML
  • Vitest · Docker