MCP Tools

MCP Tools connects Drupal to AI assistants (Claude, Cursor, Windsurf) via the Model Context Protocol. Describe what you want in plain English - the AI handles the Drupal work.

Example

You: "Create a blog with articles, categories, tags, and an editor role"
AI:  Creates the content type, taxonomies, fields, role, and permissions

Quick Start

1. Install:
   
   composer require drupal/mcp_tools

drush en mcp_tools -y
2. Configure: Visit /admin/config/services/mcp-tools and choose a preset:
   • Development: Full access, no rate limiting
   • Staging: Config-only mode, rate limited, audit logging
   • Production: Read-only mode, strict limits, full audit trail
3. Connect your AI tool: See transport options below

Option A: STDIO Transport (Recommended for Local)

Enable the STDIO module:

drush en mcp_tools_stdio -y

Generate config automatically:

drush mcp-tools:client-config > .mcp.json

Detects DDEV/Lando environments and outputs ready-to-use config. Use --scope=read for read-only.

Claude Code (run from your Drupal directory):

cd /path/to/drupal
claude mcp add --scope project drupal -- drush mcp-tools:serve --quiet --uid=1 --scope=read,write

Or add .mcp.json to your Drupal project root:

{
  "mcpServers": {
    "drupal": {
      "command": "drush",
      "args": ["mcp-tools:serve", "--quiet", "--uid=1", "--scope=read,write"]
    }
  }
}

Option B: HTTP Transport (Remote/Docker)

Enable the remote module:

drush en mcp_tools_remote -y

Configure execution user: Visit /admin/config/services/mcp-tools/remote

• Quick setup: Check "Use site admin (uid 1)" — simple for development
• Production: Click "Create MCP Executor Account" for a dedicated service account

Generate an API key:

drush mcp-tools:remote-key-create --label="Claude" --scopes=read,write

Copy the key shown (it's only displayed once).

Claude Code one-liner:

claude mcp add drupal http://localhost:8080/_mcp_tools --transport http -H "Authorization: Bearer YOUR_API_KEY"

Or add to .mcp.json:

{
  "mcpServers": {
    "drupal": {
      "type": "http",
      "url": "http://localhost:8080/_mcp_tools",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Manage keys at /admin/config/services/mcp-tools/remote or via drush mcp-tools:remote-key-list.

The tool library also works through MCP Server 2.x via its Tool Bridge, or with no MCP server at all - as plain Tool API plugins for ECA and AI Agents (via the mcp_tools_ai submodule).

What's Included

226 tools across 36 optional submodules:

• Site Building: Content types, fields, taxonomies, roles, permissions, menus
• Content: Create/edit/publish nodes, media, bulk operations
• Translations: Read translatable content in document order, create complete linked translations, update single languages — paragraphs-aware
• Views & Layout: Views, blocks, Layout Builder, image styles
• Admin: Cache, cron, config management, security audits

Security

• Scoped access (read/write/admin per connection)
• Read-only and config-only modes
• Rate limiting and audit logging
• Destructive operations require explicit confirmation; unknown tool parameters are rejected, not silently dropped
• Designed for local development - remote access is optional

Requirements

• Drupal 10.3+ or 11
• Tool API module
• PHP 8.3+

Links

GitHub ·
Client Integrations ·
Issue Queue