drupal-mcp-connector 1.6.0 → 1.7.0

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

@@ -0,0 +1,17 @@
+---
+description: "List Drupal modules. Filter by enabled or disabled status."
+argument-hint: "[site] [status]"
+allowed-tools: mcp__drupal__drupal_drush_module_list
+---
+
+Call the `mcp__drupal__drupal_drush_module_list` MCP tool.
+
+List Drupal modules. Filter by enabled or disabled status.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Optional:**
+- `site` (string): omit for the default site
+- `status` (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-drush-security-updates.md

@@ -0,0 +1,16 @@
+---
+description: "List modules with known security advisories via `drush pm:security`."
+argument-hint: "[site]"
+allowed-tools: mcp__drupal__drupal_drush_security_updates
+---
+
+Call the `mcp__drupal__drupal_drush_security_updates` MCP tool.
+
+List modules with known security advisories via `drush pm:security`.
+
+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-sql-query.md

@@ -0,0 +1,19 @@
+---
+description: "Run a read-only SQL query (SELECT, SHOW, DESCRIBE, EXPLAIN only) via Drush. Write queries are blocked by the security layer."
+argument-hint: "<query> [site]"
+allowed-tools: mcp__drupal__drupal_drush_sql_query
+---
+
+Call the `mcp__drupal__drupal_drush_sql_query` MCP tool.
+
+Run a read-only SQL query (SELECT, SHOW, DESCRIBE, EXPLAIN only) via Drush. Write queries are blocked by the security layer.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `query` (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-drush-status.md

@@ -0,0 +1,16 @@
+---
+description: "Get Drupal site status via `drush status` — version, DB, file paths, active config."
+argument-hint: "[site]"
+allowed-tools: mcp__drupal__drupal_drush_status
+---
+
+Call the `mcp__drupal__drupal_drush_status` MCP tool.
+
+Get Drupal site status via `drush status` — version, DB, file paths, active config.
+
+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-updatedb.md

@@ -0,0 +1,16 @@
+---
+description: "Run pending database updates via `drush updatedb`. Always run after deploying module updates."
+argument-hint: "[site]"
+allowed-tools: mcp__drupal__drupal_drush_updatedb
+---
+
+Call the `mcp__drupal__drupal_drush_updatedb` MCP tool.
+
+Run pending database updates via `drush updatedb`. Always run after deploying module updates.
+
+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-user-create.md

@@ -0,0 +1,22 @@
+---
+description: "Create a Drupal user and optionally assign roles. Requires write access."
+argument-hint: "<name> <mail> <password> [site] [roles]"
+allowed-tools: mcp__drupal__drupal_drush_user_create
+---
+
+Call the `mcp__drupal__drupal_drush_user_create` MCP tool.
+
+Create a Drupal user and optionally assign roles. Requires write access.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `name` (string)
+- `mail` (string)
+- `password` (string)
+
+**Optional:**
+- `site` (string): omit for the default site
+- `roles` (array (pass as JSON))
+
+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-user-list.md

@@ -0,0 +1,19 @@
+---
+description: "List Drupal users via Drush. Filter by active/blocked status or role."
+argument-hint: "[site] [status] [role] [limit]"
+allowed-tools: mcp__drupal__drupal_drush_user_list
+---
+
+Call the `mcp__drupal__drupal_drush_user_list` MCP tool.
+
+List Drupal users via Drush. Filter by active/blocked status or role.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Optional:**
+- `site` (string): omit for the default site
+- `status` (string)
+- `role` (string)
+- `limit` (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-drush-watchdog.md

@@ -0,0 +1,19 @@
+---
+description: "Fetch recent Drupal watchdog/dblog entries. Filter by type or severity level."
+argument-hint: "[site] [type] [severity] [limit]"
+allowed-tools: mcp__drupal__drupal_drush_watchdog
+---
+
+Call the `mcp__drupal__drupal_drush_watchdog` MCP tool.
+
+Fetch recent Drupal watchdog/dblog entries. Filter by type or severity level.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Optional:**
+- `site` (string): omit for the default site
+- `type` (string)
+- `severity` (string)
+- `limit` (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-entity-create.md

@@ -0,0 +1,23 @@
+---
+description: "Create an entity of any Drupal entity type and bundle. Use drupal_get_entity_schema first to know what fields are available. All operations checked against security config."
+argument-hint: "<entityType> <bundle> [site] [attributes] [relationships] [dryRun]"
+allowed-tools: mcp__drupal__drupal_entity_create
+---
+
+Call the `mcp__drupal__drupal_entity_create` MCP tool.
+
+Create an entity of any Drupal entity type and bundle. Use drupal_get_entity_schema first to know what fields are available. All operations checked against security config.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `entityType` (string)
+- `bundle` (string)
+
+**Optional:**
+- `site` (string): omit for the default site
+- `attributes` (object (pass as JSON)): Field values keyed by Drupal machine name
+- `relationships` (object (pass as JSON)): Relationship data keyed by field name
+- `dryRun` (boolean (true/false)): Validate and return a preview of the create 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-entity-delete.md

@@ -0,0 +1,24 @@
+---
+description: "Delete an entity of any Drupal entity type. Requires allowDestructive = true in security config. Confirm with the user before calling."
+argument-hint: "<entityType> <bundle> <id> [site] [dryRun]"
+allowed-tools: mcp__drupal__drupal_entity_delete
+---
+
+Call the `mcp__drupal__drupal_entity_delete` MCP tool.
+
+Delete an entity of any Drupal entity type. Requires allowDestructive = true in security config. 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:**
+- `entityType` (string)
+- `bundle` (string)
+- `id` (string)
+
+**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-entity-get.md

@@ -0,0 +1,22 @@
+---
+description: "Fetch a single entity of any Drupal entity type by UUID."
+argument-hint: "<entityType> <bundle> <id> [site] [include]"
+allowed-tools: mcp__drupal__drupal_entity_get
+---
+
+Call the `mcp__drupal__drupal_entity_get` MCP tool.
+
+Fetch a single entity of any Drupal entity type by UUID.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `entityType` (string)
+- `bundle` (string)
+- `id` (string): Entity UUID
+
+**Optional:**
+- `site` (string): omit for the default site
+- `include` (array (pass as JSON)): Relationship field names to sideload
+
+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-entity-list.md

@@ -0,0 +1,25 @@
+---
+description: "List entities of any Drupal entity type and bundle. Supports structured filters, sorting, pagination, and relationship includes. Use drupal_list_entity_types first to discover available types."
+argument-hint: "<entityType> <bundle> [site] [filters] [sort] [include] [limit] [offset]"
+allowed-tools: mcp__drupal__drupal_entity_list
+---
+
+Call the `mcp__drupal__drupal_entity_list` MCP tool.
+
+List entities of any Drupal entity type and bundle. Supports structured filters, sorting, pagination, and relationship includes. Use drupal_list_entity_types first to discover available types.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `entityType` (string): Entity type machine name, e.g. 'paragraph', 'block_content', 'commerce_product'
+- `bundle` (string): Bundle machine name
+
+**Optional:**
+- `site` (string): omit for the default site
+- `filters` (array (pass as JSON)): Structured filters: [{ field, op, value }]
+- `sort` (array (pass as JSON)): Sort specs: [{ field, dir }]
+- `include` (array (pass as JSON)): Relationship field names to sideload
+- `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-entity-update.md

@@ -0,0 +1,24 @@
+---
+description: "Update an existing entity of any Drupal entity type. Only include attributes/relationships you want to change."
+argument-hint: "<entityType> <bundle> <id> [site] [attributes] [relationships] [dryRun]"
+allowed-tools: mcp__drupal__drupal_entity_update
+---
+
+Call the `mcp__drupal__drupal_entity_update` MCP tool.
+
+Update an existing entity of any Drupal entity type. Only include attributes/relationships you want to change.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `entityType` (string)
+- `bundle` (string)
+- `id` (string)
+
+**Optional:**
+- `site` (string): omit for the default site
+- `attributes` (object (pass as JSON))
+- `relationships` (object (pass as JSON))
+- `dryRun` (boolean (true/false)): Validate and return a preview of the update 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-find-orphaned-media.md

@@ -0,0 +1,18 @@
+---
+description: "Find media entities not referenced by any content. Useful for storage cleanup audits."
+argument-hint: "[site] [type] [limit]"
+allowed-tools: mcp__drupal__drupal_find_orphaned_media
+---
+
+Call the `mcp__drupal__drupal_find_orphaned_media` MCP tool.
+
+Find media entities not referenced by any content. Useful for storage cleanup audits.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Optional:**
+- `site` (string): omit for the default site
+- `type` (string): Media type to check (default: image)
+- `limit` (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-get-entity-schema.md

@@ -0,0 +1,20 @@
+---
+description: "Inspect the fields and relationships available on any Drupal entity type + bundle. Run this before creating or updating entities to know what fields are available."
+argument-hint: "<entityType> <bundle> [site]"
+allowed-tools: mcp__drupal__drupal_get_entity_schema
+---
+
+Call the `mcp__drupal__drupal_get_entity_schema` MCP tool.
+
+Inspect the fields and relationships available on any Drupal entity type + bundle. Run this before creating or updating entities to know what fields are available.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `entityType` (string): e.g. 'node', 'paragraph', 'commerce_product', 'block_content'
+- `bundle` (string): e.g. 'article', 'text', 'default'
+
+**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-get-media.md

@@ -0,0 +1,20 @@
+---
+description: "Fetch a single media entity by UUID and media type."
+argument-hint: "<type> <id> [site]"
+allowed-tools: mcp__drupal__drupal_get_media
+---
+
+Call the `mcp__drupal__drupal_get_media` MCP tool.
+
+Fetch a single media entity by UUID and media type.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `type` (string)
+- `id` (string): Media entity UUID
+
+**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-get-node.md

@@ -0,0 +1,20 @@
+---
+description: "Fetch a single Drupal content node by UUID and content type. Returns title, body, status, path alias, and all attributes."
+argument-hint: "<type> <id> [site]"
+allowed-tools: mcp__drupal__drupal_get_node
+---
+
+Call the `mcp__drupal__drupal_get_node` MCP tool.
+
+Fetch a single Drupal content node by UUID and content type. Returns title, body, status, path alias, and all attributes.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `type` (string): Content type machine name, e.g. 'article'
+- `id` (string): Node UUID
+
+**Optional:**
+- `site` (string): Named site (omit for default)
+
+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-get-paragraph.md

@@ -0,0 +1,20 @@
+---
+description: "Fetch a single Paragraph entity by paragraph type (bundle) and UUID. Returns the redacted paragraph plus a `ref` ({ type: 'paragraph--<bundle>', id }) you can use to embed it in a host entity's paragraph / ERR field. Note: paragraphs are referenced (by target_id + target_revision_id in the entity API, or by UUID over JSON:API) from a host field rather than queried standalone in production. Governed by the site security policy."
+argument-hint: "<paragraphType> <id> [site]"
+allowed-tools: mcp__drupal__drupal_get_paragraph
+---
+
+Call the `mcp__drupal__drupal_get_paragraph` MCP tool.
+
+Fetch a single Paragraph entity by paragraph type (bundle) and UUID. Returns the redacted paragraph plus a `ref` ({ type: 'paragraph--<bundle>', id }) you can use to embed it in a host entity's paragraph / ERR field. Note: paragraphs are referenced (by target_id + target_revision_id in the entity API, or by UUID over JSON:API) from a host field rather than queried standalone in production. Governed by the site security policy.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `paragraphType` (string): Paragraph type / bundle machine name
+- `id` (string): Paragraph UUID
+
+**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-get-revision.md

@@ -0,0 +1,21 @@
+---
+description: "Fetch a single revision of a content node by version id or alias. `version` may be a numeric vid (e.g. 42), an explicit 'id:<vid>', or the relative aliases 'rel:latest-version' / 'rel:working-copy'. Read-only; attributes are redacted per security policy."
+argument-hint: "<type> <id> <version> [site]"
+allowed-tools: mcp__drupal__drupal_get_revision
+---
+
+Call the `mcp__drupal__drupal_get_revision` MCP tool.
+
+Fetch a single revision of a content node by version id or alias. `version` may be a numeric vid (e.g. 42), an explicit 'id:<vid>', or the relative aliases 'rel:latest-version' / 'rel:working-copy'. Read-only; attributes are redacted per security policy.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `type` (string): Content type machine name
+- `id` (string): Node UUID
+- `version` (string): Numeric vid, 'id:<vid>', 'rel:latest-version', or 'rel:working-copy'.
+
+**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-get-taxonomy-term.md

@@ -0,0 +1,20 @@
+---
+description: "Fetch a single taxonomy term by UUID."
+argument-hint: "<vocabulary> <id> [site]"
+allowed-tools: mcp__drupal__drupal_get_taxonomy_term
+---
+
+Call the `mcp__drupal__drupal_get_taxonomy_term` MCP tool.
+
+Fetch a single taxonomy term by UUID.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `vocabulary` (string)
+- `id` (string): Term UUID
+
+**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-get-taxonomy-terms.md

@@ -0,0 +1,21 @@
+---
+description: "List all terms in a taxonomy vocabulary, sorted by name."
+argument-hint: "<vocabulary> [site] [limit] [offset]"
+allowed-tools: mcp__drupal__drupal_get_taxonomy_terms
+---
+
+Call the `mcp__drupal__drupal_get_taxonomy_terms` MCP tool.
+
+List all terms in a taxonomy vocabulary, sorted by name.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `vocabulary` (string): Vocabulary machine name, e.g. 'tags'
+
+**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-get-user-by-name.md

@@ -0,0 +1,19 @@
+---
+description: "Look up a Drupal user by their exact username."
+argument-hint: "<name> [site]"
+allowed-tools: mcp__drupal__drupal_get_user_by_name
+---
+
+Call the `mcp__drupal__drupal_get_user_by_name` MCP tool.
+
+Look up a Drupal user by their exact username.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `name` (string): Drupal username (exact match)
+
+**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-get-user.md

@@ -0,0 +1,19 @@
+---
+description: "Fetch a single Drupal user account by UUID, including their assigned roles."
+argument-hint: "<id> [site]"
+allowed-tools: mcp__drupal__drupal_get_user
+---
+
+Call the `mcp__drupal__drupal_get_user` MCP tool.
+
+Fetch a single Drupal user account by UUID, including their assigned roles.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `id` (string): User UUID
+
+**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-graphql-introspect.md

@@ -0,0 +1,17 @@
+---
+description: "Introspect the Drupal GraphQL schema. Omit typeName for a full schema overview; provide typeName to get detailed fields and args for a specific type."
+argument-hint: "[site] [typeName]"
+allowed-tools: mcp__drupal__drupal_graphql_introspect
+---
+
+Call the `mcp__drupal__drupal_graphql_introspect` MCP tool.
+
+Introspect the Drupal GraphQL schema. Omit typeName for a full schema overview; provide typeName to get detailed fields and args for a specific type.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Optional:**
+- `site` (string): omit for the default site
+- `typeName` (string): Name of a specific GraphQL type to inspect in detail (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-graphql.md

@@ -0,0 +1,40 @@
+---
+description: "Execute a GraphQL query against a Drupal site. Requires the GraphQL Compose module (drupal.org/project/graphql_compose), which exposes a read-only schema; mutations are gated by \"allowGraphqlMutations\". Use drupal_graphql_introspect first to discover available types and fields. Example query: query GetArticle($id: String!) { nodeById(id: $id) { title ... on NodeArticle { body { value } } } } Example mutation (only if your GraphQL Compose schema enables mutations): mutation CreateArticle($title: String!, $body: String!) { createNodeArticle(data: { title: $title, body: { value: $body, format: \"full_html\" } }) { entity { title uuid } errors { message } } }"
+argument-hint: "<query> [site] [variables] [operationName]"
+allowed-tools: mcp__drupal__drupal_graphql
+---
+
+Call the `mcp__drupal__drupal_graphql` MCP tool.
+
+Execute a GraphQL query against a Drupal site.
+Requires the GraphQL Compose module (drupal.org/project/graphql_compose), which
+exposes a read-only schema; mutations are gated by "allowGraphqlMutations".
+Use drupal_graphql_introspect first to discover available types and fields.
+
+Example query:
+  query GetArticle($id: String!) {
+    nodeById(id: $id) {
+      title
+      ... on NodeArticle { body { value } }
+    }
+  }
+
+Example mutation (only if your GraphQL Compose schema enables mutations):
+  mutation CreateArticle($title: String!, $body: String!) {
+    createNodeArticle(data: { title: $title, body: { value: $body, format: "full_html" } }) {
+      entity { title uuid }
+      errors { message }
+    }
+  }
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Required:**
+- `query` (string): GraphQL query or mutation string
+
+**Optional:**
+- `site` (string): Named site (omit for default)
+- `variables` (object (pass as JSON)): Variables to pass with the query
+- `operationName` (string): Operation name (for multi-operation documents)
+
+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-list-blocks.md

@@ -0,0 +1,20 @@
+---
+description: "List custom content blocks (block_content entities), optionally scoped to a single block type (bundle). Returns each block's admin label (info) and body. Does not list code/plugin-defined blocks."
+argument-hint: "[site] [type] [limit] [offset] [sort]"
+allowed-tools: mcp__drupal__drupal_list_blocks
+---
+
+Call the `mcp__drupal__drupal_list_blocks` MCP tool.
+
+List custom content blocks (block_content entities), optionally scoped to a single block type (bundle). Returns each block's admin label (info) and body. Does not list code/plugin-defined blocks.
+
+Parse the request in `$ARGUMENTS` into this tool's parameters:
+
+**Optional:**
+- `site` (string): omit for the default site
+- `type` (string): Block type (bundle) machine name to filter by, e.g. 'basic'. Omit to list all custom blocks.
+- `limit` (number)
+- `offset` (number)
+- `sort` (array (pass as JSON)): Sort specs: [{ field, dir }]. Defaults to info asc.
+
+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-list-content-types.md

@@ -0,0 +1,16 @@
+---
+description: "List all content types defined on this Drupal site with their machine names and descriptions."
+argument-hint: "[site]"
+allowed-tools: mcp__drupal__drupal_list_content_types
+---
+
+Call the `mcp__drupal__drupal_list_content_types` MCP tool.
+
+List all content types defined on this Drupal site with their machine names and descriptions.
+
+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-list-entity-types.md

@@ -0,0 +1,16 @@
+---
+description: "Discover all JSON:API resource types (entity types + bundles) exposed by this Drupal site, filtered to only those your security config allows. Run this before working with an unfamiliar entity type."
+argument-hint: "[site]"
+allowed-tools: mcp__drupal__drupal_list_entity_types
+---
+
+Call the `mcp__drupal__drupal_list_entity_types` MCP tool.
+
+Discover all JSON:API resource types (entity types + bundles) exposed by this Drupal site, filtered to only those your security config allows. Run this before working with an unfamiliar entity type.
+
+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-list-media-types.md

@@ -0,0 +1,16 @@
+---
+description: "List all media types defined on this Drupal site (image, document, remote_video, audio, etc.)."
+argument-hint: "[site]"
+allowed-tools: mcp__drupal__drupal_list_media_types
+---
+
+Call the `mcp__drupal__drupal_list_media_types` MCP tool.
+
+List all media types defined on this Drupal site (image, document, remote_video, audio, etc.).
+
+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.