drupal-mcp-connector 2.7.3 → 2.8.0

package/{.claude → .agents}/commands/drupal-governance-status.md

@@ -1,16 +1,15 @@
 ---
 description: "Report each configured site's source-governance condition. Always probes GET /drupal-mcp/readiness (even when this client does not require governance) and surfaces the server's reason verbatim. Never reports ok:true unless that check ran. Callable even while governed paths are denied — this is the diagnostic for that denial."
 argument-hint: "[site]"
-allowed-tools: mcp__drupal__drupal_governance_status
 ---
 
-Call the `mcp__drupal__drupal_governance_status` MCP tool.
+Call the MCP tool `drupal_governance_status`.
 
 Report each configured site's source-governance condition. Always probes GET /drupal-mcp/readiness (even when this client does not require governance) and surfaces the server's reason verbatim. Never reports ok:true unless that check ran. Callable even while governed paths are denied — this is the diagnostic for that denial.
 
-Parse the request in `$ARGUMENTS` into this tool's parameters:
+Parse the arguments supplied with this command into this tool's parameters:
 
 **Optional:**
-- `site` (string): omit for the default site
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
 
-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.
+If a required parameter is missing, 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/.agents/commands/drupal-graphql-introspect.md

@@ -0,0 +1,16 @@
+---
+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. Requires security.allowGraphql (off outside the development preset by default)."
+argument-hint: "[site] [typeName]"
+---
+
+Call the MCP tool `drupal_graphql_introspect`.
+
+Introspect the Drupal GraphQL schema. Omit typeName for a full schema overview; provide typeName to get detailed fields and args for a specific type. Requires security.allowGraphql (off outside the development preset by default).
+
+Parse the arguments supplied with this command into this tool's parameters:
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+- `typeName` (string): Name of a specific GraphQL type to inspect in detail (optional)
+
+If a required parameter is missing, 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 → .agents}/commands/drupal-graphql.md

@@ -1,10 +1,9 @@
 ---
 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. GraphQL is off unless security.allowGraphql is true (development preset only by default) because raw results bypass entity allowlists and field redaction. Mutations also require 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.
+Call the MCP tool `drupal_graphql`.
 
 Execute a GraphQL query against a Drupal site.
 Requires the GraphQL Compose module (drupal.org/project/graphql_compose), which
@@ -29,14 +28,14 @@ Example mutation (only if your GraphQL Compose schema enables mutations):
     }
   }
 
-Parse the request in `$ARGUMENTS` into this tool's parameters:
+Parse the arguments supplied with this command into this tool's parameters:
 
 **Required:**
 - `query` (string): GraphQL query or mutation string
 
 **Optional:**
-- `site` (string): Named site (omit for default)
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
 - `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.
+If a required parameter is missing, 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 → .agents}/commands/drupal-list-blocks.md

@@ -1,20 +1,19 @@
 ---
 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.
+Call the MCP tool `drupal_list_blocks`.
 
 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:
+Parse the arguments supplied with this command into this tool's parameters:
 
 **Optional:**
-- `site` (string): omit for the default site
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
 - `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.
+If a required parameter is missing, 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/.agents/commands/drupal-list-content-types.md

@@ -0,0 +1,15 @@
+---
+description: "List all content types defined on this Drupal site with their machine names and descriptions."
+argument-hint: "[site]"
+---
+
+Call the MCP tool `drupal_list_content_types`.
+
+List all content types defined on this Drupal site with their machine names and descriptions.
+
+Parse the arguments supplied with this command into this tool's parameters:
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+
+If a required parameter is missing, 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/.agents/commands/drupal-list-entity-types.md

@@ -0,0 +1,15 @@
+---
+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]"
+---
+
+Call the MCP tool `drupal_list_entity_types`.
+
+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 arguments supplied with this command into this tool's parameters:
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+
+If a required parameter is missing, 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/.agents/commands/drupal-list-media-types.md

@@ -0,0 +1,15 @@
+---
+description: "List all media types defined on this Drupal site (image, document, remote_video, audio, etc.)."
+argument-hint: "[site]"
+---
+
+Call the MCP tool `drupal_list_media_types`.
+
+List all media types defined on this Drupal site (image, document, remote_video, audio, etc.).
+
+Parse the arguments supplied with this command into this tool's parameters:
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+
+If a required parameter is missing, 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/.agents/commands/drupal-list-media.md

@@ -0,0 +1,20 @@
+---
+description: "List media entities by type. Supports filtering by name substring and publish status."
+argument-hint: "[site] [type] [status] [name] [limit] [offset]"
+---
+
+Call the MCP tool `drupal_list_media`.
+
+List media entities by type. Supports filtering by name substring and publish status.
+
+Parse the arguments supplied with this command into this tool's parameters:
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+- `type` (string): Media type machine name, e.g. 'image', 'document', 'remote_video'
+- `status` (boolean (true/false))
+- `name` (string): Filter by name substring
+- `limit` (number)
+- `offset` (number)
+
+If a required parameter is missing, 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 → .agents}/commands/drupal-list-menu-links.md

@@ -1,20 +1,19 @@
 ---
 description: "List custom (content) menu links, optionally scoped to a single menu (e.g. 'main', 'footer'). Returns each link's title, target URI, menu, and weight. Note: this lists editable menu_link_content entities, not code-defined static links."
 argument-hint: "[site] [menu] [limit] [offset] [sort]"
-allowed-tools: mcp__drupal__drupal_list_menu_links
 ---
 
-Call the `mcp__drupal__drupal_list_menu_links` MCP tool.
+Call the MCP tool `drupal_list_menu_links`.
 
 List custom (content) menu links, optionally scoped to a single menu (e.g. 'main', 'footer'). Returns each link's title, target URI, menu, and weight. Note: this lists editable menu_link_content entities, not code-defined static links.
 
-Parse the request in `$ARGUMENTS` into this tool's parameters:
+Parse the arguments supplied with this command into this tool's parameters:
 
 **Optional:**
-- `site` (string): Named site (omit for default)
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
 - `menu` (string): Menu machine name to filter by, e.g. 'main', 'footer', 'admin'. Omit to list links across all menus.
 - `limit` (number)
 - `offset` (number)
 - `sort` (array (pass as JSON)): Sort specs: [{ field, dir }]. Defaults to weight 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.
+If a required parameter is missing, 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/.agents/commands/drupal-list-moderation-states.md

@@ -0,0 +1,19 @@
+---
+description: "List the moderation states observed on a content type's content (best-effort; authoritative transitions require the Drush bridge)."
+argument-hint: "<type> [site] [sample]"
+---
+
+Call the MCP tool `drupal_list_moderation_states`.
+
+List the moderation states observed on a content type's content (best-effort; authoritative transitions require the Drush bridge).
+
+Parse the arguments supplied with this command into this tool's parameters:
+
+**Required:**
+- `type` (string): Content type machine name
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+- `sample` (number): How many recent items to sample
+
+If a required parameter is missing, 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 → .agents}/commands/drupal-list-nodes.md

@@ -1,24 +1,23 @@
 ---
 description: "List nodes of a given content type. Supports status filtering, pagination, sorting, and structured filter descriptors."
 argument-hint: "<type> [site] [status] [limit] [offset] [filters] [sort]"
-allowed-tools: mcp__drupal__drupal_list_nodes
 ---
 
-Call the `mcp__drupal__drupal_list_nodes` MCP tool.
+Call the MCP tool `drupal_list_nodes`.
 
 List nodes of a given content type. Supports status filtering, pagination, sorting, and structured filter descriptors.
 
-Parse the request in `$ARGUMENTS` into this tool's parameters:
+Parse the arguments supplied with this command into this tool's parameters:
 
 **Required:**
 - `type` (string): Content type machine name
 
 **Optional:**
-- `site` (string): omit for the default site
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
 - `status` (boolean (true/false)): true = published only, false = unpublished only, omit = all
 - `limit` (number)
 - `offset` (number)
 - `filters` (array (pass as JSON)): Structured filters: [{ field, op, value }]. op: eq|neq|gt|gte|lt|lte|contains|in|isNull
 - `sort` (array (pass as JSON)): Sort specs: [{ field, dir }] where dir is 'asc'|'desc'
 
-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.
+If a required parameter is missing, 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 → .agents}/commands/drupal-list-revisions.md

@@ -1,20 +1,19 @@
 ---
 description: "Surface the addressable revisions of a content node: the latest default revision and the working-copy (forward) revision, with their version ids and links. workingCopy: null is not an all-clear — Drupal core can still reject PATCH when a revision row sits above the default without a content_moderation working copy (#201). The payload includes possiblyPatchBlocked (true when default changed is later than its revision_timestamp) plus changed and revisionTimestamp on latestVersion. Probe the host (this flag, then dryRun on the update) before creating dependent paragraphs. NOTE: JSON:API cannot enumerate full chronological revision history. Full history enumeration requires the Drush bridge."
 argument-hint: "<type> <id> [site]"
-allowed-tools: mcp__drupal__drupal_list_revisions
 ---
 
-Call the `mcp__drupal__drupal_list_revisions` MCP tool.
+Call the MCP tool `drupal_list_revisions`.
 
 Surface the addressable revisions of a content node: the latest default revision and the working-copy (forward) revision, with their version ids and links. workingCopy: null is not an all-clear — Drupal core can still reject PATCH when a revision row sits above the default without a content_moderation working copy (#201). The payload includes possiblyPatchBlocked (true when default changed is later than its revision_timestamp) plus changed and revisionTimestamp on latestVersion. Probe the host (this flag, then dryRun on the update) before creating dependent paragraphs. NOTE: JSON:API cannot enumerate full chronological revision history. Full history enumeration requires the Drush bridge.
 
-Parse the request in `$ARGUMENTS` into this tool's parameters:
+Parse the arguments supplied with this command 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)
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
 
-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.
+If a required parameter is missing, 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/.agents/commands/drupal-list-roles.md

@@ -0,0 +1,15 @@
+---
+description: "List all user roles defined on this Drupal site."
+argument-hint: "[site]"
+---
+
+Call the MCP tool `drupal_list_roles`.
+
+List all user roles defined on this Drupal site.
+
+Parse the arguments supplied with this command into this tool's parameters:
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+
+If a required parameter is missing, 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 → .agents}/commands/drupal-list-sites.md

@@ -1,10 +1,9 @@
 ---
 description: "List the Drupal sites this principal may address. Each target includes the authoritative site name and base URL."
-allowed-tools: mcp__drupal__drupal_list_sites
 ---
 
-Call the `mcp__drupal__drupal_list_sites` MCP tool.
+Call the MCP tool `drupal_list_sites`.
 
 List the Drupal sites this principal may address. Each target includes the authoritative site name and base URL.
 
-This tool takes no arguments — call it directly (ignore `$ARGUMENTS`).
+This tool takes no arguments — call it directly.

package/{.claude → .agents}/commands/drupal-list-translations.md

@@ -1,21 +1,20 @@
 ---
 description: "List the translation langcode(s) for a Drupal entity (multilingual / content_translation). Reports the language(s) observable on the resource. Core JSON:API serves one language per resource and does not enumerate all translations — see the returned note. Defaults to node."
 argument-hint: "<type> <id> [site] [entityType]"
-allowed-tools: mcp__drupal__drupal_list_translations
 ---
 
-Call the `mcp__drupal__drupal_list_translations` MCP tool.
+Call the MCP tool `drupal_list_translations`.
 
 List the translation langcode(s) for a Drupal entity (multilingual / content_translation). Reports the language(s) observable on the resource. Core JSON:API serves one language per resource and does not enumerate all translations — see the returned note. Defaults to node.
 
-Parse the request in `$ARGUMENTS` into this tool's parameters:
+Parse the arguments supplied with this command into this tool's parameters:
 
 **Required:**
 - `type` (string): Bundle machine name, e.g. 'article'
 - `id` (string): Entity UUID
 
 **Optional:**
-- `site` (string): Named site (omit for default)
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
 - `entityType` (string): Entity type machine name. Default: 'node'.
 
-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.
+If a required parameter is missing, 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/.agents/commands/drupal-list-users.md

@@ -0,0 +1,19 @@
+---
+description: "List Drupal user accounts. Filter by active/blocked status or by role machine name."
+argument-hint: "[site] [status] [role] [limit] [offset]"
+---
+
+Call the MCP tool `drupal_list_users`.
+
+List Drupal user accounts. Filter by active/blocked status or by role machine name.
+
+Parse the arguments supplied with this command into this tool's parameters:
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+- `status` (boolean (true/false)): true = active only, false = blocked only
+- `role` (string): Filter by role machine name, e.g. 'editor'
+- `limit` (number)
+- `offset` (number)
+
+If a required parameter is missing, 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/.agents/commands/drupal-list-vocabularies.md

@@ -0,0 +1,15 @@
+---
+description: "List all taxonomy vocabularies defined on this Drupal site."
+argument-hint: "[site]"
+---
+
+Call the MCP tool `drupal_list_vocabularies`.
+
+List all taxonomy vocabularies defined on this Drupal site.
+
+Parse the arguments supplied with this command into this tool's parameters:
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+
+If a required parameter is missing, 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/.agents/commands/drupal-mcp-whoami.md

@@ -0,0 +1,15 @@
+---
+description: "Report the agent's effective governance tier, security preset, OAuth scopes, and capabilities (read/write/delete/config/publish) for a site. No credentials, no backend call."
+argument-hint: "[site]"
+---
+
+Call the MCP tool `drupal_mcp_whoami`.
+
+Report the agent's effective governance tier, security preset, OAuth scopes, and capabilities (read/write/delete/config/publish) for a site. No credentials, no backend call.
+
+Parse the arguments supplied with this command into this tool's parameters:
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+
+If a required parameter is missing, 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/.agents/commands/drupal-report-404-log.md

@@ -0,0 +1,16 @@
+---
+description: "Aggregate Drupal 'page not found' (404) log events into the top missing URLs ranked by hit count — the redirect-candidate list. Self-sufficient via the connector's drush watchdog bridge; returns an 'unavailable' payload when drush isn't configured for the site."
+argument-hint: "[site] [limit]"
+---
+
+Call the MCP tool `drupal_report_404_log`.
+
+Aggregate Drupal 'page not found' (404) log events into the top missing URLs ranked by hit count — the redirect-candidate list. Self-sufficient via the connector's drush watchdog bridge; returns an 'unavailable' payload when drush isn't configured for the site.
+
+Parse the arguments supplied with this command into this tool's parameters:
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+- `limit` (number): Max distinct missing paths to return (max 200)
+
+If a required parameter is missing, 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/.agents/commands/drupal-report-accessibility-audit.md

@@ -0,0 +1,17 @@
+---
+description: "Accessibility audit for body content: images without alt text, inline H1 tags, non-descriptive link text ('click here', 'read more'), and tables without captions."
+argument-hint: "[site] [type] [sampleSize]"
+---
+
+Call the MCP tool `drupal_report_accessibility_audit`.
+
+Accessibility audit for body content: images without alt text, inline H1 tags, non-descriptive link text ('click here', 'read more'), and tables without captions.
+
+Parse the arguments supplied with this command into this tool's parameters:
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+- `type` (string): Content type (default: article)
+- `sampleSize` (number)
+
+If a required parameter is missing, 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/.agents/commands/drupal-report-alias-coverage.md

@@ -0,0 +1,17 @@
+---
+description: "URL-alias coverage for a content type: nodes whose canonical URL is still /node/N (no alias / pathauto gap), plus conflicting aliases (one alias mapped to multiple system paths) when the path_alias entity is exposed."
+argument-hint: "[site] [type] [sampleSize]"
+---
+
+Call the MCP tool `drupal_report_alias_coverage`.
+
+URL-alias coverage for a content type: nodes whose canonical URL is still /node/N (no alias / pathauto gap), plus conflicting aliases (one alias mapped to multiple system paths) when the path_alias entity is exposed.
+
+Parse the arguments supplied with this command into this tool's parameters:
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+- `type` (string): Content type (default: article)
+- `sampleSize` (number): Max nodes to scan
+
+If a required parameter is missing, 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/.agents/commands/drupal-report-broken-embeds.md

@@ -0,0 +1,17 @@
+---
+description: "Scan published body content for embedded entities (media/entity embeds) and report usage by type, flagging embeds with a missing/malformed data-entity-uuid. Full target-existence verification is gated on a future server-tool."
+argument-hint: "[site] [type] [sampleSize]"
+---
+
+Call the MCP tool `drupal_report_broken_embeds`.
+
+Scan published body content for embedded entities (media/entity embeds) and report usage by type, flagging embeds with a missing/malformed data-entity-uuid. Full target-existence verification is gated on a future server-tool.
+
+Parse the arguments supplied with this command into this tool's parameters:
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+- `type` (string): Content type (default: article)
+- `sampleSize` (number): Max nodes to scan
+
+If a required parameter is missing, 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 → .agents}/commands/drupal-report-broken-links.md

@@ -1,20 +1,19 @@
 ---
 description: "Inventory links in published body content (internal/external/images), aggregate external hosts, and flag malformed hrefs. With checkLive:true, verifies links via bounded, SSRF-guarded outbound HTTP (internal always; external only if includeExternal and host-allowlisted). No network egress unless checkLive is set."
 argument-hint: "[site] [type] [sampleSize] [checkLive] [includeExternal]"
-allowed-tools: mcp__drupal__drupal_report_broken_links
 ---
 
-Call the `mcp__drupal__drupal_report_broken_links` MCP tool.
+Call the MCP tool `drupal_report_broken_links`.
 
 Inventory links in published body content (internal/external/images), aggregate external hosts, and flag malformed hrefs. With checkLive:true, verifies links via bounded, SSRF-guarded outbound HTTP (internal always; external only if includeExternal and host-allowlisted). No network egress unless checkLive is set.
 
-Parse the request in `$ARGUMENTS` into this tool's parameters:
+Parse the arguments supplied with this command into this tool's parameters:
 
 **Optional:**
-- `site` (string): omit for the default site
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
 - `type` (string): Content type (default: article)
 - `sampleSize` (number): Max nodes to scan
 - `checkLive` (boolean (true/false)): Perform live HTTP checks (off by default)
 - `includeExternal` (boolean (true/false)): When checkLive, also check allowlisted external hosts
 
-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.
+If a required parameter is missing, 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/.agents/commands/drupal-report-cache-config.md

@@ -0,0 +1,15 @@
+---
+description: "Report the site's cache posture (CSS/JS aggregation, anonymous page-cache max-age) from system.performance with plain recommendations. Reads config via the connector's drush bridge (or the governed config server-tool when configured); requires config-read access."
+argument-hint: "[site]"
+---
+
+Call the MCP tool `drupal_report_cache_config`.
+
+Report the site's cache posture (CSS/JS aggregation, anonymous page-cache max-age) from system.performance with plain recommendations. Reads config via the connector's drush bridge (or the governed config server-tool when configured); requires config-read access.
+
+Parse the arguments supplied with this command into this tool's parameters:
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+
+If a required parameter is missing, 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/.agents/commands/drupal-report-config-drift.md

@@ -0,0 +1,15 @@
+---
+description: "Report whether active configuration matches the sync directory, as an added/changed/removed breakdown. Self-sufficient via the connector's drush bridge (drush config:status); returns 'unavailable' when drush isn't configured for the site."
+argument-hint: "[site]"
+---
+
+Call the MCP tool `drupal_report_config_drift`.
+
+Report whether active configuration matches the sync directory, as an added/changed/removed breakdown. Self-sufficient via the connector's drush bridge (drush config:status); returns 'unavailable' when drush isn't configured for the site.
+
+Parse the arguments supplied with this command into this tool's parameters:
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+
+If a required parameter is missing, 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/.agents/commands/drupal-report-content-by-author.md

@@ -0,0 +1,17 @@
+---
+description: "Count nodes per author for a given content type. Returns author UUIDs and counts sorted by most prolific."
+argument-hint: "[site] [type] [limit]"
+---
+
+Call the MCP tool `drupal_report_content_by_author`.
+
+Count nodes per author for a given content type. Returns author UUIDs and counts sorted by most prolific.
+
+Parse the arguments supplied with this command into this tool's parameters:
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+- `type` (string): Content type (default: article)
+- `limit` (number): Max nodes to scan
+
+If a required parameter is missing, 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/.agents/commands/drupal-report-content-summary.md

@@ -0,0 +1,15 @@
+---
+description: "High-level content inventory: total node counts by type and status (published/unpublished). Good first step for any site audit."
+argument-hint: "[site]"
+---
+
+Call the MCP tool `drupal_report_content_summary`.
+
+High-level content inventory: total node counts by type and status (published/unpublished). Good first step for any site audit.
+
+Parse the arguments supplied with this command into this tool's parameters:
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+
+If a required parameter is missing, 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/.agents/commands/drupal-report-duplicate-content.md

@@ -0,0 +1,17 @@
+---
+description: "Find duplicate / near-duplicate titles within a content type (normalized title grouping). Surfaces accidental re-publishing and content cannibalization."
+argument-hint: "[site] [type] [sampleSize]"
+---
+
+Call the MCP tool `drupal_report_duplicate_content`.
+
+Find duplicate / near-duplicate titles within a content type (normalized title grouping). Surfaces accidental re-publishing and content cannibalization.
+
+Parse the arguments supplied with this command into this tool's parameters:
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+- `type` (string): Content type (default: article)
+- `sampleSize` (number): Max nodes to scan
+
+If a required parameter is missing, 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/.agents/commands/drupal-report-field-completeness.md

@@ -0,0 +1,20 @@
+---
+description: "Score how completely optional fields are filled in for a content type. Finds nodes missing summaries, images, meta descriptions, tags, etc."
+argument-hint: "<type> [site] [fields] [sampleSize]"
+---
+
+Call the MCP tool `drupal_report_field_completeness`.
+
+Score how completely optional fields are filled in for a content type. Finds nodes missing summaries, images, meta descriptions, tags, etc.
+
+Parse the arguments supplied with this command into this tool's parameters:
+
+**Required:**
+- `type` (string): Content type machine name
+
+**Optional:**
+- `site` (string): Named site from connector config. Omit only on reads: multi-site configs fall back to defaultSite (often local/dev, not production). Writes require an explicit site when more than one site is configured. Every response includes `_target` { name, baseUrl, source } (`hint` when you passed site, `default` when you did not).
+- `fields` (array (pass as JSON)): Field machine names to check. Defaults to common SEO/editorial fields.
+- `sampleSize` (number): Max nodes to scan
+
+If a required parameter is missing, 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.