1 · Require it (dev only)

Droost is a local development tool — the same class as Devel. Keep it out of production requires.

composer require --dev drupal/droost drupal/mcp_server:^2.0@alpha

2 · Enable, and wire your editor automatically

One command: droost:install detects DDEV, registers the MCP server with supported editors, and writes an AGENTS.md the agent reads first.

ddev drush en droost -y
ddev drush droost:install

3 · Or wire any MCP client by hand

Droost is one STDIO command — ddev drush mcp:server — so any MCP-capable client can drive it. The three most common:

{
  "mcpServers": {
    "droost": {
      "command": "ddev",
      "args": ["drush", "mcp:server"]
    }
  }
}

# ~/.codex/config.toml
[mcp_servers.droost]
command = "ddev"
args = ["drush", "mcp:server"]

{
  "mcpServers": {
    "droost": {
      "command": "ddev",
      "args": ["drush", "mcp:server"]
    }
  }
}

4 · Opt into writes when ready

Everything is read-only until an operator flips a flag. The running server caches it, so reload the MCP server after changing it — in both directions.

ddev drush config:set droost.settings allow_destructive --input-format=yaml true
# ...build things...
ddev drush config:set droost.settings allow_destructive --input-format=yaml false

Starting fresh? Use the recipe

droost_cms turns a brand-new Drupal CMS project into the full agent platform: Droost with every composer, UI Patterns 2, this Tailwind + daisyUI theme, a shipped SDC display pattern, and the site-building playbook. This very site is one.

• Create

  a fresh Drupal CMS project
• Require

  the droost_cms recipe
• Apply

  one php:eval line
• Build

  point your agent at it

composer create-project drupal/cms my-site && cd my-site
composer require cweagans/composer-patches drupal/droost:1.0.x-dev \
  drupal/mcp_server:^2.0@alpha drupal/droost_cms:@dev
# add the canvas #3561618 patch block (see the recipe README), then:
ddev drush php:eval '\Drupal\Core\Recipe\RecipeRunner::processRecipe(
  \Drupal\Core\Recipe\Recipe::createFromDirectory("recipes/droost_cms"));'
ddev drush cr