drupal-mcp-connector 1.6.0 → 1.8.0

package/.claude/commands/drupal-audit-config-best-practices.md

@@ -0,0 +1,16 @@
+---
+description: "Lint key configuration for production-readiness and security: on-screen error display, CSS/JS aggregation, anonymous page cache, open user registration, missing 404/403 pages, and insecure file uploads. Severity-ranked. Requires config-read access and the server-tool bridge."
+argument-hint: "[site]"
+allowed-tools: mcp__drupal__drupal_audit_config_best_practices
+---
+
+Call the `mcp__drupal__drupal_audit_config_best_practices` MCP tool.
+
+Lint key configuration for production-readiness and security: on-screen error display, CSS/JS aggregation, anonymous page cache, open user registration, missing 404/403 pages, and insecure file uploads. Severity-ranked. Requires config-read access and the server-tool bridge.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Optional:**
+- `site` (string): omit for the default site
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-audit-site-health.md

@@ -0,0 +1,19 @@
+---
+description: "Composite site-health dashboard: runs a battery of content, link, and configuration audits and rolls them into one scored report with a letter grade. Each section degrades independently — gated/errored sections are recorded, not fatal. Read-only."
+argument-hint: "[site] [type] [sampleSize] [sections]"
+allowed-tools: mcp__drupal__drupal_audit_site_health
+---
+
+Call the `mcp__drupal__drupal_audit_site_health` MCP tool.
+
+Composite site-health dashboard: runs a battery of content, link, and configuration audits and rolls them into one scored report with a letter grade. Each section degrades independently — gated/errored sections are recorded, not fatal. Read-only.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Optional:**
+- `site` (string): omit for the default site
+- `type` (string): Primary content type for content/link sections (default: article)
+- `sampleSize` (number): Per-section scan cap (kept small for a fast roll-up)
+- `sections` (array (pass as JSON)): Subset of sections to run (default: all). Available: content_summary, stale_content, seo_audit, accessibility, duplicate_content, readability, pii_exposure, broken_links, redirect_health, alias_coverage, log_404, config_best_practices, module_audit, permission_audit
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-block-user.md

@@ -0,0 +1,20 @@
+---
+description: "Block or unblock a Drupal user account without deleting it."
+argument-hint: "<id> [site] [block]"
+allowed-tools: mcp__drupal__drupal_block_user
+---
+
+Call the `mcp__drupal__drupal_block_user` MCP tool.
+
+Block or unblock a Drupal user account without deleting it.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `id` (string): User UUID
+
+**Optional:**
+- `site` (string): omit for the default site
+- `block` (boolean (true/false)): true = block, false = unblock
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-bulk-create.md

@@ -0,0 +1,21 @@
+---
+description: "Create many entities of a single type + bundle in one call. Permission is checked once; each item is created independently, so the batch continues past individual failures (partial success). Returns per-item { index, success, id | error } and a summary { created, failed }. Writes default to unpublished/draft."
+argument-hint: "<entityType> <bundle> <items> [site]"
+allowed-tools: mcp__drupal__drupal_bulk_create
+---
+
+Call the `mcp__drupal__drupal_bulk_create` MCP tool.
+
+Create many entities of a single type + bundle in one call. Permission is checked once; each item is created independently, so the batch continues past individual failures (partial success). Returns per-item { index, success, id | error } and a summary { created, failed }. Writes default to unpublished/draft.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `entityType` (string): Entity type machine name, e.g. 'node', 'taxonomy_term'
+- `bundle` (string): Bundle machine name, e.g. 'article'
+- `items` (array (pass as JSON)): Entities to create. Each is { attributes?, relationships? }.
+
+**Optional:**
+- `site` (string): omit for the default site
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-bulk-update.md

@@ -0,0 +1,21 @@
+---
+description: "Update many entities of a single type + bundle in one call. Permission is checked once; each item is updated independently, so the batch continues past individual failures (partial success). Each item requires an 'id' (UUID); items missing an id are reported as per-item failures. Returns per-item { index, success, id | error } and a summary { updated, failed }."
+argument-hint: "<entityType> <bundle> <items> [site]"
+allowed-tools: mcp__drupal__drupal_bulk_update
+---
+
+Call the `mcp__drupal__drupal_bulk_update` MCP tool.
+
+Update many entities of a single type + bundle in one call. Permission is checked once; each item is updated independently, so the batch continues past individual failures (partial success). Each item requires an 'id' (UUID); items missing an id are reported as per-item failures. Returns per-item { index, success, id | error } and a summary { updated, failed }.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `entityType` (string): Entity type machine name
+- `bundle` (string): Bundle machine name
+- `items` (array (pass as JSON)): Entities to update. Each is { id, attributes?, relationships? }.
+
+**Optional:**
+- `site` (string): omit for the default site
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-config-get.md

@@ -0,0 +1,19 @@
+---
+description: "Read a single Drupal configuration object by name (e.g. \"system.site\") via the governed server-side config tool. Requires config read access."
+argument-hint: "<name> [site]"
+allowed-tools: mcp__drupal__drupal_config_get
+---
+
+Call the `mcp__drupal__drupal_config_get` MCP tool.
+
+Read a single Drupal configuration object by name (e.g. "system.site") via the governed server-side config tool. Requires config read access.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `name` (string)
+
+**Optional:**
+- `site` (string): omit for the default site
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-config-list.md

@@ -0,0 +1,17 @@
+---
+description: "List Drupal configuration object names, optionally filtered by a name prefix, via the governed server-side config tool. Requires config read access."
+argument-hint: "[site] [prefix]"
+allowed-tools: mcp__drupal__drupal_config_list
+---
+
+Call the `mcp__drupal__drupal_config_list` MCP tool.
+
+List Drupal configuration object names, optionally filtered by a name prefix, via the governed server-side config tool. Requires config read access.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Optional:**
+- `site` (string): omit for the default site
+- `prefix` (string)
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-config-set.md

@@ -0,0 +1,20 @@
+---
+description: "Set a Drupal configuration value via the governed server-side config tool. Audited and gated server-side; requires the config-editor (Developer) tier. Then export to YAML for a PR."
+argument-hint: "<name> <value> [site]"
+allowed-tools: mcp__drupal__drupal_config_set
+---
+
+Call the `mcp__drupal__drupal_config_set` MCP tool.
+
+Set a Drupal configuration value via the governed server-side config tool. Audited and gated server-side; requires the config-editor (Developer) tier. Then export to YAML for a PR.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `name` (string)
+- `value` (object (pass as JSON)): A map of top-level config keys to their new values (e.g. { "slogan": "Information Technology" }). Other keys in the object are preserved server-side.
+
+**Optional:**
+- `site` (string): omit for the default site
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-content-by-moderation-state.md

@@ -0,0 +1,22 @@
+---
+description: "List nodes of a content type currently in a given moderation state (e.g. what is in 'draft' or 'needs_review')."
+argument-hint: "<type> <state> [site] [limit] [offset]"
+allowed-tools: mcp__drupal__drupal_content_by_moderation_state
+---
+
+Call the `mcp__drupal__drupal_content_by_moderation_state` MCP tool.
+
+List nodes of a content type currently in a given moderation state (e.g. what is in 'draft' or 'needs_review').
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `type` (string): Content type machine name
+- `state` (string): Moderation state machine name
+
+**Optional:**
+- `site` (string): omit for the default site
+- `limit` (number)
+- `offset` (number)
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-create-block.md

@@ -0,0 +1,21 @@
+---
+description: "Create a custom content block of a given block type (bundle). 'info' is the administrative label; 'body' is optional rendered HTML. Checked against the site security config."
+argument-hint: "<type> <info> [site] [body]"
+allowed-tools: mcp__drupal__drupal_create_block
+---
+
+Call the `mcp__drupal__drupal_create_block` MCP tool.
+
+Create a custom content block of a given block type (bundle). 'info' is the administrative label; 'body' is optional rendered HTML. Checked against the site security config.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `type` (string): Block type (bundle) machine name, e.g. 'basic'
+- `info` (string): Administrative label / block description
+
+**Optional:**
+- `site` (string): omit for the default site
+- `body` (string): Block body HTML (optional)
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-create-media.md

@@ -0,0 +1,22 @@
+---
+description: "Create a media entity. For remote video (YouTube/Vimeo), pass the URL via fields.field_media_oembed_video. For file-based media, use drupal_upload_file first to get a file UUID, then pass it in fields."
+argument-hint: "<type> <name> [site] [status] [fields]"
+allowed-tools: mcp__drupal__drupal_create_media
+---
+
+Call the `mcp__drupal__drupal_create_media` MCP tool.
+
+Create a media entity. For remote video (YouTube/Vimeo), pass the URL via fields.field_media_oembed_video. For file-based media, use drupal_upload_file first to get a file UUID, then pass it in fields.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `type` (string): Media type machine name
+- `name` (string): Media entity name / label
+
+**Optional:**
+- `site` (string): omit for the default site
+- `status` (boolean (true/false))
+- `fields` (object (pass as JSON)): Additional field values — include the source field (e.g. field_media_oembed_video: 'https://youtu.be/...')
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-create-menu-link.md

@@ -0,0 +1,24 @@
+---
+description: "Create a custom menu link, enabled by default so it renders immediately. The link target is a Drupal URI such as 'internal:/about', 'entity:node/42', or an absolute 'https://…' URL — prefer 'entity:node/<id>' when linking to a node (avoids the alias-resolution 'path inaccessible' race). Set 'parent' (a parent link plugin id like 'menu_link_content:<uuid>') to nest the link, and 'enabled: false' to create it disabled. Checked against the site security config."
+argument-hint: "<title> <link> <menu> [site] [weight] [parent] [enabled]"
+allowed-tools: mcp__drupal__drupal_create_menu_link
+---
+
+Call the `mcp__drupal__drupal_create_menu_link` MCP tool.
+
+Create a custom menu link, enabled by default so it renders immediately. The link target is a Drupal URI such as 'internal:/about', 'entity:node/42', or an absolute 'https://…' URL — prefer 'entity:node/<id>' when linking to a node (avoids the alias-resolution 'path inaccessible' race). Set 'parent' (a parent link plugin id like 'menu_link_content:<uuid>') to nest the link, and 'enabled: false' to create it disabled. Checked against the site security config.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `title` (string): Link label shown in the menu
+- `link` (string): Target URI, e.g. 'entity:node/42', 'internal:/about', or 'https://example.com'
+- `menu` (string): Menu machine name to place the link in, e.g. 'main' or 'footer'
+
+**Optional:**
+- `site` (string): omit for the default site
+- `weight` (number): Ordering weight within the menu (lower sorts first)
+- `parent` (string): Parent link plugin id to nest under, e.g. 'menu_link_content:<uuid>'. Omit for a top-level link.
+- `enabled` (boolean (true/false)): Whether the link is enabled (renders). Defaults to true.
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-create-node.md

@@ -0,0 +1,28 @@
+---
+description: "Create a new content node. Returns the new node UUID, integer ID, and URL. For content types under an editorial (content_moderation) workflow, set moderationState (e.g. 'draft'/'published') instead of status. Entity-reference fields (taxonomy terms, related content, media) go in `relationships`, not `fields`."
+argument-hint: "<type> <title> [site] [body] [summary] [status] [moderationState] [fields] [relationships] [dryRun] [returning]"
+allowed-tools: mcp__drupal__drupal_create_node
+---
+
+Call the `mcp__drupal__drupal_create_node` MCP tool.
+
+Create a new content node. Returns the new node UUID, integer ID, and URL. For content types under an editorial (content_moderation) workflow, set moderationState (e.g. 'draft'/'published') instead of status. Entity-reference fields (taxonomy terms, related content, media) go in `relationships`, not `fields`.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `type` (string): Content type machine name
+- `title` (string)
+
+**Optional:**
+- `site` (string): omit for the default site
+- `body` (string): Body field HTML
+- `summary` (string): Body summary / teaser
+- `status` (boolean (true/false)): Published flag for NON-moderated types. true to publish immediately. Ignored if moderationState is set; on a moderated type it is dropped automatically.
+- `moderationState` (string): Moderation state for content_moderation types, e.g. 'draft' or 'published'. Takes precedence over status.
+- `fields` (object (pass as JSON)): Scalar/attribute field values keyed by Drupal machine name. Do NOT put entity-reference fields here — Drupal rejects them as attributes; use `relationships`.
+- `relationships` (object (pass as JSON)): Entity-reference fields as JSON:API relationships, keyed by field machine name. Single-value: { field_resource_type: { data: { type: 'taxonomy_term--resource_type', id: '<uuid>' } } }. Multi-value: { field_tags: { data: [{ type: 'taxonomy_term--tags', id: '<uuid>' }] } }.
+- `dryRun` (boolean (true/false)): Validate and return a preview of the write without committing.
+- `returning` (string): Response verbosity. "full" (default) returns the complete saved entity; "minimal" returns just identity + state (id, type, bundle, title, status, changed, url) — much smaller, recommended for bulk writes where the echoed body would dominate the response.
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-create-paragraph.md

@@ -0,0 +1,20 @@
+---
+description: "Create a Paragraph entity of a given paragraph type (bundle). Paragraphs are content fragments that are NOT standalone — they must be referenced by a host entity's paragraph / Entity Reference Revisions field. Returns the created paragraph plus `relationshipData` ({ type: 'paragraph--<bundle>', id: <uuid> }) to drop into a host field's relationships via drupal_entity_update / drupal_update_node. Use drupal_get_entity_schema (entityType 'paragraph', the bundle) first to discover fields. Governed by the site security policy."
+argument-hint: "<paragraphType> [site] [attributes]"
+allowed-tools: mcp__drupal__drupal_create_paragraph
+---
+
+Call the `mcp__drupal__drupal_create_paragraph` MCP tool.
+
+Create a Paragraph entity of a given paragraph type (bundle). Paragraphs are content fragments that are NOT standalone — they must be referenced by a host entity's paragraph / Entity Reference Revisions field. Returns the created paragraph plus `relationshipData` ({ type: 'paragraph--<bundle>', id: <uuid> }) to drop into a host field's relationships via drupal_entity_update / drupal_update_node. Use drupal_get_entity_schema (entityType 'paragraph', the bundle) first to discover fields. Governed by the site security policy.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `paragraphType` (string): Paragraph type / bundle machine name, e.g. 'text', 'image', 'cta'
+
+**Optional:**
+- `site` (string): Named site (omit for default)
+- `attributes` (object (pass as JSON)): Paragraph field values keyed by Drupal machine name, e.g. { field_body: { value: '<p>..</p>', format: 'full_html' } }
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-create-redirect.md

@@ -0,0 +1,22 @@
+---
+description: "Create an active URL redirect (contrib Redirect module). The redirect serves its 301 (or chosen code) immediately: 'source' is the old path (a leading slash is fine — it is normalized to the module's stored, slash-less form so the redirect actually matches and fires), and 'target' is the destination as a path ('/new'), an 'entity:node/ID', or an absolute URL. status_code defaults to 301; pass 302 for a temporary redirect. Governed by the site security policy (needs redirect write / 'administer redirects')."
+argument-hint: "<source> <target> [site] [statusCode] [language]"
+allowed-tools: mcp__drupal__drupal_create_redirect
+---
+
+Call the `mcp__drupal__drupal_create_redirect` MCP tool.
+
+Create an active URL redirect (contrib Redirect module). The redirect serves its 301 (or chosen code) immediately: 'source' is the old path (a leading slash is fine — it is normalized to the module's stored, slash-less form so the redirect actually matches and fires), and 'target' is the destination as a path ('/new'), an 'entity:node/ID', or an absolute URL. status_code defaults to 301; pass 302 for a temporary redirect. Governed by the site security policy (needs redirect write / 'administer redirects').
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `source` (string): Source/old path to redirect from, e.g. '/old-slug'. Leading slash optional.
+- `target` (string): Destination: a path ('/new-slug'), 'entity:node/42', or an absolute 'https://…' URL.
+
+**Optional:**
+- `site` (string): Named site (omit for default)
+- `statusCode` (number): HTTP redirect status code. 301 (permanent, default) or 302 (temporary); 303/307/308 also accepted.
+- `language` (string): Langcode the redirect applies to. Defaults to 'und' (all languages).
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-create-taxonomy-term.md

@@ -0,0 +1,23 @@
+---
+description: "Create a new taxonomy term in a vocabulary."
+argument-hint: "<vocabulary> <name> [site] [description] [weight] [parentId]"
+allowed-tools: mcp__drupal__drupal_create_taxonomy_term
+---
+
+Call the `mcp__drupal__drupal_create_taxonomy_term` MCP tool.
+
+Create a new taxonomy term in a vocabulary.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `vocabulary` (string)
+- `name` (string)
+
+**Optional:**
+- `site` (string): omit for the default site
+- `description` (string)
+- `weight` (number)
+- `parentId` (string): UUID of parent term (for hierarchical vocabularies)
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-create-translation.md

@@ -0,0 +1,23 @@
+---
+description: "Create or replace a translation of a Drupal entity for a target language (governed write). Sets the given langcode plus the supplied translated field values. Requires the content_translation module enabled and the bundle configured as translatable; otherwise Drupal rejects the write. Defaults to node."
+argument-hint: "<type> <id> <langcode> [site] [entityType] [attributes]"
+allowed-tools: mcp__drupal__drupal_create_translation
+---
+
+Call the `mcp__drupal__drupal_create_translation` MCP tool.
+
+Create or replace a translation of a Drupal entity for a target language (governed write). Sets the given langcode plus the supplied translated field values. Requires the content_translation module enabled and the bundle configured as translatable; otherwise Drupal rejects the write. Defaults to node.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `type` (string): Bundle machine name, e.g. 'article'
+- `id` (string): Entity UUID
+- `langcode` (string): Target language code, e.g. 'de', 'fr', 'pt_br'
+
+**Optional:**
+- `site` (string): omit for the default site
+- `entityType` (string): Entity type machine name. Default: 'node'.
+- `attributes` (object (pass as JSON)): Translated field values keyed by Drupal machine name
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-create-user.md

@@ -0,0 +1,24 @@
+---
+description: "Create a new Drupal user account with optional roles and password."
+argument-hint: "<name> <mail> [site] [password] [status] [roles] [timezone]"
+allowed-tools: mcp__drupal__drupal_create_user
+---
+
+Call the `mcp__drupal__drupal_create_user` MCP tool.
+
+Create a new Drupal user account with optional roles and password.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `name` (string): Username
+- `mail` (string): Email address
+
+**Optional:**
+- `site` (string): omit for the default site
+- `password` (string): Initial password (plaintext — sent over HTTPS)
+- `status` (boolean (true/false)): true = active (default)
+- `roles` (array (pass as JSON)): Role UUIDs to assign
+- `timezone` (string)
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-delete-media.md

@@ -0,0 +1,22 @@
+---
+description: "Delete a media entity. Does not delete the underlying File entity. Confirm with the user before calling."
+argument-hint: "<type> <id> [site]"
+allowed-tools: mcp__drupal__drupal_delete_media
+---
+
+Call the `mcp__drupal__drupal_delete_media` MCP tool.
+
+Delete a media entity. Does not delete the underlying File entity. Confirm with the user before calling.
+
+> ⚠ **Destructive** — this permanently changes or deletes data. Confirm with the user before calling.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `type` (string)
+- `id` (string)
+
+**Optional:**
+- `site` (string): omit for the default site
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-delete-node.md

@@ -0,0 +1,23 @@
+---
+description: "Permanently delete a node. Irreversible — confirm with the user before calling."
+argument-hint: "<type> <id> [site] [dryRun]"
+allowed-tools: mcp__drupal__drupal_delete_node
+---
+
+Call the `mcp__drupal__drupal_delete_node` MCP tool.
+
+Permanently delete a node. Irreversible — confirm with the user before calling.
+
+> ⚠ **Destructive** — this permanently changes or deletes data. Confirm with the user before calling.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `type` (string)
+- `id` (string): Node UUID
+
+**Optional:**
+- `site` (string): omit for the default site
+- `dryRun` (boolean (true/false)): Validate and return a preview of the delete without committing.
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-delete-taxonomy-term.md

@@ -0,0 +1,22 @@
+---
+description: "Delete a taxonomy term. Confirm with the user before calling."
+argument-hint: "<vocabulary> <id> [site]"
+allowed-tools: mcp__drupal__drupal_delete_taxonomy_term
+---
+
+Call the `mcp__drupal__drupal_delete_taxonomy_term` MCP tool.
+
+Delete a taxonomy term. Confirm with the user before calling.
+
+> ⚠ **Destructive** — this permanently changes or deletes data. Confirm with the user before calling.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `vocabulary` (string)
+- `id` (string)
+
+**Optional:**
+- `site` (string): omit for the default site
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-describe-fields.md

@@ -0,0 +1,21 @@
+---
+description: "Introspect the fields of a Drupal entity type + bundle: returns a per-field list of { name, type, kind, cardinality?, approximate }. Read-only. Built on schema SAMPLING (an existing entity), so results are approximate — only populated fields are visible and required/cardinality/allowedValues are inferred from value shape. Authoritative field metadata comes from the Drush bridge (Field API). Use this before creating/updating entities to learn field names."
+argument-hint: "<site> [type] [entityType] [bundle]"
+allowed-tools: mcp__drupal__drupal_describe_fields
+---
+
+Call the `mcp__drupal__drupal_describe_fields` MCP tool.
+
+Introspect the fields of a Drupal entity type + bundle: returns a per-field list of { name, type, kind, cardinality?, approximate }. Read-only. Built on schema SAMPLING (an existing entity), so results are approximate — only populated fields are visible and required/cardinality/allowedValues are inferred from value shape. Authoritative field metadata comes from the Drush bridge (Field API). Use this before creating/updating entities to learn field names.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `site` (string): Configured site name.
+
+**Optional:**
+- `type` (string): Entity type machine name, e.g. 'node', 'taxonomy_term', 'user', 'media'. Alias: `entityType` (as used by the sibling tools).
+- `entityType` (string): Alias for `type` — accepted for parity with get_entity_schema / entity_create / entity_update / resolve_reference.
+- `bundle` (string): Bundle machine name, e.g. 'article'. Defaults to the entity type for single-bundle types (e.g. 'user').
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-drush-cache-rebuild.md

@@ -0,0 +1,16 @@
+---
+description: "Run `drush cache:rebuild` via SSH. Clears all Drupal caches. Requires drushSsh config and write access."
+argument-hint: "[site]"
+allowed-tools: mcp__drupal__drupal_drush_cache_rebuild
+---
+
+Call the `mcp__drupal__drupal_drush_cache_rebuild` MCP tool.
+
+Run `drush cache:rebuild` via SSH. Clears all Drupal caches. Requires drushSsh config and write access.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Optional:**
+- `site` (string): omit for the default site
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-drush-config-export.md

@@ -0,0 +1,16 @@
+---
+description: "Export active configuration to the sync directory. Requires write access."
+argument-hint: "[site]"
+allowed-tools: mcp__drupal__drupal_drush_config_export
+---
+
+Call the `mcp__drupal__drupal_drush_config_export` MCP tool.
+
+Export active configuration to the sync directory. Requires write access.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Optional:**
+- `site` (string): omit for the default site
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-drush-config-import.md

@@ -0,0 +1,16 @@
+---
+description: "Import configuration from the sync directory into the database. Requires write access. Confirm with user before running on production."
+argument-hint: "[site]"
+allowed-tools: mcp__drupal__drupal_drush_config_import
+---
+
+Call the `mcp__drupal__drupal_drush_config_import` MCP tool.
+
+Import configuration from the sync directory into the database. Requires write access. Confirm with user before running on production.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Optional:**
+- `site` (string): omit for the default site
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-drush-config-status.md

@@ -0,0 +1,16 @@
+---
+description: "Check if active config is in sync with the sync directory. Returns out-of-sync items if any."
+argument-hint: "[site]"
+allowed-tools: mcp__drupal__drupal_drush_config_status
+---
+
+Call the `mcp__drupal__drupal_drush_config_status` MCP tool.
+
+Check if active config is in sync with the sync directory. Returns out-of-sync items if any.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Optional:**
+- `site` (string): omit for the default site
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-drush-cron.md

@@ -0,0 +1,16 @@
+---
+description: "Run Drupal cron via `drush cron`."
+argument-hint: "[site]"
+allowed-tools: mcp__drupal__drupal_drush_cron
+---
+
+Call the `mcp__drupal__drupal_drush_cron` MCP tool.
+
+Run Drupal cron via `drush cron`.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Optional:**
+- `site` (string): omit for the default site
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.

package/.claude/commands/drupal-drush-module-disable.md

@@ -0,0 +1,21 @@
+---
+description: "Uninstall a Drupal module. Irreversible for module-stored data. Confirm with user."
+argument-hint: "<moduleName> [site]"
+allowed-tools: mcp__drupal__drupal_drush_module_disable
+---
+
+Call the `mcp__drupal__drupal_drush_module_disable` MCP tool.
+
+Uninstall a Drupal module. Irreversible for module-stored data. Confirm with user.
+
+> ⚠ **Destructive** — this permanently changes or deletes data. Confirm with the user before calling.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `moduleName` (string)
+
+**Optional:**
+- `site` (string): omit for the default site
+
+If a required parameter is missing from `$ARGUMENTS`, ask before calling — do not invent values. Coerce each value to its JSON type (booleans → true/false, numbers → numeric, object/array → parse JSON), then make the single tool call and summarize the result.