drupal-mcp-connector 2.26.0 → 3.0.0

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

@@ -11,7 +11,7 @@ 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): Primary content type for content/link sections (default: article)
+- `type` (string): Content type for the content/link sections. Omit it and those sections are reported unavailable; site-wide sections still run.
 - `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
 

package/.agents/commands/drupal-report-accessibility-audit.md

@@ -1,6 +1,6 @@
 ---
 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]"
+argument-hint: "<type> [site] [sampleSize]"
 ---
 
 Call the MCP tool `drupal_report_accessibility_audit`.
@@ -9,9 +9,11 @@ Accessibility audit for body content: images without alt text, inline H1 tags, n
 
 Parse the arguments supplied with this command into this tool's parameters:
 
+**Required:**
+- `type` (string): Content type machine name (required; see drupal_list_content_types)
+
 **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

@@ -1,6 +1,6 @@
 ---
 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]"
+argument-hint: "<type> [site] [sampleSize]"
 ---
 
 Call the MCP tool `drupal_report_alias_coverage`.
@@ -9,9 +9,11 @@ URL-alias coverage for a content type: nodes whose canonical URL is still /node/
 
 Parse the arguments supplied with this command into this tool's parameters:
 
+**Required:**
+- `type` (string): Content type machine name (required; see drupal_list_content_types)
+
 **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

@@ -1,6 +1,6 @@
 ---
 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]"
+argument-hint: "<type> [site] [sampleSize]"
 ---
 
 Call the MCP tool `drupal_report_broken_embeds`.
@@ -9,9 +9,11 @@ Scan published body content for embedded entities (media/entity embeds) and repo
 
 Parse the arguments supplied with this command into this tool's parameters:
 
+**Required:**
+- `type` (string): Content type machine name (required; see drupal_list_content_types)
+
 **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-links.md

@@ -1,6 +1,6 @@
 ---
 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]"
+argument-hint: "<type> [site] [sampleSize] [checkLive] [includeExternal]"
 ---
 
 Call the MCP tool `drupal_report_broken_links`.
@@ -9,9 +9,11 @@ Inventory links in published body content (internal/external/images), aggregate
 
 Parse the arguments supplied with this command into this tool's parameters:
 
+**Required:**
+- `type` (string): Content type machine name (required; see drupal_list_content_types)
+
 **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
 - `checkLive` (boolean (true/false)): Perform live HTTP checks (off by default)
 - `includeExternal` (boolean (true/false)): When checkLive, also check allowlisted external hosts

package/.agents/commands/drupal-report-content-by-author.md

@@ -1,6 +1,6 @@
 ---
 description: "Count nodes per author for a given content type. Returns author UUIDs and counts sorted by most prolific."
-argument-hint: "[site] [type] [limit]"
+argument-hint: "<type> [site] [limit]"
 ---
 
 Call the MCP tool `drupal_report_content_by_author`.
@@ -9,9 +9,11 @@ Count nodes per author for a given content type. Returns author UUIDs and counts
 
 Parse the arguments supplied with this command into this tool's parameters:
 
+**Required:**
+- `type` (string): Content type machine name (required; see drupal_list_content_types)
+
 **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-duplicate-content.md

@@ -1,6 +1,6 @@
 ---
 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]"
+argument-hint: "<type> [site] [sampleSize]"
 ---
 
 Call the MCP tool `drupal_report_duplicate_content`.
@@ -9,9 +9,11 @@ Find duplicate / near-duplicate titles within a content type (normalized title g
 
 Parse the arguments supplied with this command into this tool's parameters:
 
+**Required:**
+- `type` (string): Content type machine name (required; see drupal_list_content_types)
+
 **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-missing-field.md

@@ -1,6 +1,6 @@
 ---
 description: "Find entities of a content type where a given field is empty (e.g. a missing meta description, image, or summary). Works for scalar fields and entity-reference fields. Sampling-bounded — flags 'approximate' when the scan is capped. An absent field is not an empty one: JSON:API leaves out a field this account may not view. When the field is absent from every sampled entity the result is `notVisible: true` with no findings (the field may be denied to this account, not exist on the bundle, or be misspelled) instead of every entity counted as missing. Otherwise each finding has `reason` 'empty' (key present, no value) or 'absent' (key missing, possibly access-denied)."
-argument-hint: "<field> [site] [type] [sampleSize]"
+argument-hint: "<type> <field> [site] [sampleSize]"
 ---
 
 Call the MCP tool `drupal_report_missing_field`.
@@ -10,11 +10,11 @@ Find entities of a content type where a given field is empty (e.g. a missing met
 Parse the arguments supplied with this command into this tool's parameters:
 
 **Required:**
+- `type` (string): Content type machine name (required; see drupal_list_content_types)
 - `field` (string): Field machine name to check for emptiness, e.g. 'field_meta_description', 'field_image'
 
 **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 machine name (default: article)
 - `sampleSize` (number): Max entities 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-orphan-pages.md

@@ -1,6 +1,6 @@
 ---
 description: "Find published pages with no inbound internal links from other sampled pages — content islands. Best-effort over the sampled set."
-argument-hint: "[site] [type] [sampleSize]"
+argument-hint: "<type> [site] [sampleSize]"
 ---
 
 Call the MCP tool `drupal_report_orphan_pages`.
@@ -9,9 +9,11 @@ Find published pages with no inbound internal links from other sampled pages —
 
 Parse the arguments supplied with this command into this tool's parameters:
 
+**Required:**
+- `type` (string): Content type machine name (required; see drupal_list_content_types)
+
 **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-orphaned-references.md

@@ -1,6 +1,6 @@
 ---
 description: "Find entities whose entity-reference fields point at targets that no longer exist (orphaned references). Best-effort: samples entities and probes each distinct referenced target via JSON:API. A 404 (or unaddressable ref) is an orphan; 401/403 and connector policy denials are counted as unverifiable, not missing. uid/revision_uid are skipped when the policy denies user. Flags 'approximate' when sampling-bounded."
-argument-hint: "[site] [type] [sampleSize]"
+argument-hint: "<type> [site] [sampleSize]"
 ---
 
 Call the MCP tool `drupal_report_orphaned_references`.
@@ -9,9 +9,11 @@ Find entities whose entity-reference fields point at targets that no longer exis
 
 Parse the arguments supplied with this command into this tool's parameters:
 
+**Required:**
+- `type` (string): Content type machine name (required; see drupal_list_content_types)
+
 **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 machine name to scan (default: article)
 - `sampleSize` (number): Max entities to scan for broken references
 
 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-pii-exposure.md

@@ -1,6 +1,6 @@
 ---
 description: "Scan published body content for accidentally exposed PII (emails, US SSNs, phone numbers). Matched values are masked in the output so the report itself doesn't leak data."
-argument-hint: "[site] [type] [sampleSize] [kinds]"
+argument-hint: "<type> [site] [sampleSize] [kinds]"
 ---
 
 Call the MCP tool `drupal_report_pii_exposure`.
@@ -9,9 +9,11 @@ Scan published body content for accidentally exposed PII (emails, US SSNs, phone
 
 Parse the arguments supplied with this command into this tool's parameters:
 
+**Required:**
+- `type` (string): Content type machine name (required; see drupal_list_content_types)
+
 **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)
 - `kinds` (array (pass as JSON)): PII kinds to scan (default: all)
 

package/.agents/commands/drupal-report-readability.md

@@ -1,6 +1,6 @@
 ---
 description: "Score body readability (Flesch Reading Ease) for a content type and flag hard-to-read content and structural issues (no H2 subheadings, multiple H1s)."
-argument-hint: "[site] [type] [sampleSize] [hardThreshold]"
+argument-hint: "<type> [site] [sampleSize] [hardThreshold]"
 ---
 
 Call the MCP tool `drupal_report_readability`.
@@ -9,9 +9,11 @@ Score body readability (Flesch Reading Ease) for a content type and flag hard-to
 
 Parse the arguments supplied with this command into this tool's parameters:
 
+**Required:**
+- `type` (string): Content type machine name (required; see drupal_list_content_types)
+
 **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)
 - `hardThreshold` (number): Flag content scoring below this
 

package/.agents/commands/drupal-report-recently-published.md

@@ -11,7 +11,7 @@ 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)
+- `type` (string): Content type machine name. Omit to read every node bundle (results merged, newest first; unreadable bundles listed in bundleErrors).
 - `limit` (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-revision-hotspots.md

@@ -1,6 +1,6 @@
 ---
 description: "Find nodes with the most revision activity — useful for spotting churn or content that needs editorial process review. Requires Drupal 9.3+ JSON:API revisions."
-argument-hint: "[site] [type] [limit]"
+argument-hint: "<type> [site] [limit]"
 ---
 
 Call the MCP tool `drupal_report_revision_hotspots`.
@@ -9,9 +9,11 @@ Find nodes with the most revision activity — useful for spotting churn or cont
 
 Parse the arguments supplied with this command into this tool's parameters:
 
+**Required:**
+- `type` (string): Content type machine name (required; see drupal_list_content_types)
+
 **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)
 
 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-scheduled-content.md

@@ -1,17 +1,17 @@
 ---
-description: "Report content with Scheduler publish/unpublish dates set, split into pending (future) and overdue (past, action not run). Gated when scheduler fields aren't exposed."
+description: "Report content with Scheduler publish/unpublish dates set, split into pending (future) and overdue (past, action not run). Omit type to scan every node bundle in one call (one row per bundle in byContentType). A bundle is gated only when sampled nodes carry no publish_on/unpublish_on key at all; fields that exist but are empty report pending 0 / overdue 0. A bundle with no nodes reports zero counts with schedulerFields 'unknown'."
 argument-hint: "[site] [type] [sampleSize]"
 ---
 
 Call the MCP tool `drupal_report_scheduled_content`.
 
-Report content with Scheduler publish/unpublish dates set, split into pending (future) and overdue (past, action not run). Gated when scheduler fields aren't exposed.
+Report content with Scheduler publish/unpublish dates set, split into pending (future) and overdue (past, action not run). Omit type to scan every node bundle in one call (one row per bundle in byContentType). A bundle is gated only when sampled nodes carry no publish_on/unpublish_on key at all; fields that exist but are empty report pending 0 / overdue 0. A bundle with no nodes reports zero counts with schedulerFields 'unknown'.
 
 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)
+- `type` (string): Content type machine name. Omit to scan every node bundle.
+- `sampleSize` (number): Max nodes to scan per content type
 
 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-seo-audit.md

@@ -1,6 +1,6 @@
 ---
 description: "SEO audit for a content type: missing meta descriptions, title length issues, and thin content (under 300 words). Returns node lists for each issue category. Meta descriptions use the rendered Metatag output via GraphQL when available (reported as `metaSource`); when no description source is readable it reports the meta check as unavailable rather than a false zero."
-argument-hint: "[site] [type] [sampleSize]"
+argument-hint: "<type> [site] [sampleSize]"
 ---
 
 Call the MCP tool `drupal_report_seo_audit`.
@@ -9,9 +9,11 @@ SEO audit for a content type: missing meta descriptions, title length issues, an
 
 Parse the arguments supplied with this command into this tool's parameters:
 
+**Required:**
+- `type` (string): Content type machine name (required; see drupal_list_content_types)
+
 **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-seo-meta-coverage.md

@@ -1,6 +1,6 @@
 ---
 description: "Report structured-meta (SEO) coverage for a content type: how many sampled nodes populate each meta field (metatag, meta description). Complements drupal_report_seo_audit with explicit per-field coverage. Reads scalar and entity-reference fields. A field absent from every sampled node has `present: false` and `coverage: null` (unknown, not 0), and is listed in `notVisible` when you named it. When none of the checked fields is visible, no node is flagged and `nodesMissingAllMeta` is null: JSON:API leaves out a field this account may not view."
-argument-hint: "[site] [type] [fields] [sampleSize]"
+argument-hint: "<type> [site] [fields] [sampleSize]"
 ---
 
 Call the MCP tool `drupal_report_seo_meta_coverage`.
@@ -9,9 +9,11 @@ Report structured-meta (SEO) coverage for a content type: how many sampled nodes
 
 Parse the arguments supplied with this command into this tool's parameters:
 
+**Required:**
+- `type` (string): Content type machine name (required; see drupal_list_content_types)
+
 **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)
 - `fields` (array (pass as JSON)): Meta field machine names to check
 - `sampleSize` (number)
 

package/.agents/commands/drupal-report-stale-content.md

@@ -1,6 +1,6 @@
 ---
 description: "Find content that hasn't been updated in N days. Returns a sorted list with titles, status, and days-since-update."
-argument-hint: "[site] [type] [days] [status] [limit]"
+argument-hint: "<type> [site] [days] [status] [limit]"
 ---
 
 Call the MCP tool `drupal_report_stale_content`.
@@ -9,9 +9,11 @@ Find content that hasn't been updated in N days. Returns a sorted list with titl
 
 Parse the arguments supplied with this command into this tool's parameters:
 
+**Required:**
+- `type` (string): Content type machine name (required; see drupal_list_content_types)
+
 **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)
 - `days` (number): Stale threshold in days
 - `status` (boolean (true/false)): Filter by publish status
 - `limit` (number)

package/.agents/commands/drupal-report-taxonomy-usage.md

@@ -1,6 +1,6 @@
 ---
 description: "Count how many nodes use each term in a vocabulary. Identifies over-used, under-used, and orphaned terms."
-argument-hint: "<vocabulary> [site] [contentType] [referenceField] [limit]"
+argument-hint: "<vocabulary> <contentType> [site] [referenceField] [limit]"
 ---
 
 Call the MCP tool `drupal_report_taxonomy_usage`.
@@ -11,10 +11,10 @@ Parse the arguments supplied with this command into this tool's parameters:
 
 **Required:**
 - `vocabulary` (string): Vocabulary machine name, e.g. 'tags', 'category'
+- `contentType` (string): Content type machine name (required; see drupal_list_content_types)
 
 **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).
-- `contentType` (string): Content type to count references from (default: article)
 - `referenceField` (string): Field referencing the vocabulary (default: field_{vocabulary})
 - `limit` (number)
 

package/.agents/commands/drupal-report-translation-coverage.md

@@ -1,6 +1,6 @@
 ---
 description: "Per-node translation coverage from Sentinel's inventory (missing non-default language, outdated core flag, language counts). Without Sentinel the report is unavailable — JSON:API only shows the default language, so a histogram would be misleading."
-argument-hint: "[site] [type] [sampleSize]"
+argument-hint: "<type> [site] [sampleSize]"
 ---
 
 Call the MCP tool `drupal_report_translation_coverage`.
@@ -9,9 +9,11 @@ Per-node translation coverage from Sentinel's inventory (missing non-default lan
 
 Parse the arguments supplied with this command into this tool's parameters:
 
+**Required:**
+- `type` (string): Content type machine name (required; see drupal_list_content_types)
+
 **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 inventory
 
 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-unpublished.md

@@ -11,7 +11,7 @@ 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 machine name (default: article)
+- `type` (string): Content type machine name. Omit to read every node bundle (results merged, newest first; unreadable bundles listed in bundleErrors).
 - `limit` (number): Max unpublished nodes to return
 
 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-workflow-bottlenecks.md

@@ -1,6 +1,6 @@
 ---
 description: "Find content stuck in a non-published moderation state (draft/needs_review) beyond N days — editorial bottlenecks. Reads moderation_state; gated when content_moderation isn't exposed."
-argument-hint: "[site] [type] [days] [states] [langcode] [sampleSize]"
+argument-hint: "<type> [site] [days] [states] [langcode] [sampleSize]"
 ---
 
 Call the MCP tool `drupal_report_workflow_bottlenecks`.
@@ -9,9 +9,11 @@ Find content stuck in a non-published moderation state (draft/needs_review) beyo
 
 Parse the arguments supplied with this command into this tool's parameters:
 
+**Required:**
+- `type` (string): Content type machine name (required; see drupal_list_content_types)
+
 **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)
 - `days` (number): Days-in-state threshold
 - `states` (array (pass as JSON)): Moderation states to treat as bottlenecks
 - `langcode` (string): Limit to this translation (Sentinel inventory). Omit for the default-language field on each node.

package/.agents/commands/drupal-schedule-publish.md

@@ -1,11 +1,11 @@
 ---
-description: "Schedule a content node to publish and/or unpublish at a future time using the Drupal Scheduler module. Sets the publish_on and unpublish_on fields on the node. On a bundle under Content Moderation, also set publishState / unpublishState (written as publish_state / unpublish_state) — dates alone never go live. Requires the Scheduler module to be installed and enabled for the content type, with the publish_on / unpublish_on fields present on the bundle — otherwise the call fails with a clear capability error. Moderated bundles additionally need Scheduler Content Moderation Integration; when those state fields exist, the matching state is required whenever a date is set. Timestamps accept ISO 8601 (e.g. '2026-07-01T12:00:00Z') or a Unix epoch and are passed through unchanged. Provide at least one of publishOn or unpublishOn."
+description: "Schedule a content node to publish and/or unpublish at a future time using the Drupal Scheduler module. Sets the publish_on and unpublish_on fields on the node. Provide at least one of publishOn or unpublishOn. Moderated bundles (Content Moderation) also need a target state: pass publishState / unpublishState (moderation state machine names, e.g. 'published', 'archived'), written as publish_state / unpublish_state. These fields exist only when the Scheduler Content Moderation Integration module is enabled. When the bundle exposes a state field and its date is set without the state, the call fails, because Drupal would accept a schedule that never runs. When a moderated bundle has no state field, the dates are written and the result carries a warning. Whether this account may schedule a given transition is decided by the site (Drupal validation and MCP Sentinel policy), not the connector; a refusal returns the site's reason verbatim. Without the Scheduler module on the content type, the call fails with a capability error. Timestamps accept ISO 8601 (e.g. '2026-07-01T12:00:00Z') or a Unix epoch and are passed through unchanged."
 argument-hint: "<type> <id> [site] [publishOn] [unpublishOn] [publishState] [unpublishState]"
 ---
 
 Call the MCP tool `drupal_schedule_publish`.
 
-Schedule a content node to publish and/or unpublish at a future time using the Drupal Scheduler module. Sets the publish_on and unpublish_on fields on the node. On a bundle under Content Moderation, also set publishState / unpublishState (written as publish_state / unpublish_state) — dates alone never go live. Requires the Scheduler module to be installed and enabled for the content type, with the publish_on / unpublish_on fields present on the bundle — otherwise the call fails with a clear capability error. Moderated bundles additionally need Scheduler Content Moderation Integration; when those state fields exist, the matching state is required whenever a date is set. Timestamps accept ISO 8601 (e.g. '2026-07-01T12:00:00Z') or a Unix epoch and are passed through unchanged. Provide at least one of publishOn or unpublishOn.
+Schedule a content node to publish and/or unpublish at a future time using the Drupal Scheduler module. Sets the publish_on and unpublish_on fields on the node. Provide at least one of publishOn or unpublishOn. Moderated bundles (Content Moderation) also need a target state: pass publishState / unpublishState (moderation state machine names, e.g. 'published', 'archived'), written as publish_state / unpublish_state. These fields exist only when the Scheduler Content Moderation Integration module is enabled. When the bundle exposes a state field and its date is set without the state, the call fails, because Drupal would accept a schedule that never runs. When a moderated bundle has no state field, the dates are written and the result carries a warning. Whether this account may schedule a given transition is decided by the site (Drupal validation and MCP Sentinel policy), not the connector; a refusal returns the site's reason verbatim. Without the Scheduler module on the content type, the call fails with a capability error. Timestamps accept ISO 8601 (e.g. '2026-07-01T12:00:00Z') or a Unix epoch and are passed through unchanged.
 
 Parse the arguments supplied with this command into this tool's parameters:
 
@@ -17,7 +17,7 @@ Parse the arguments supplied with this command into this tool's parameters:
 - `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).
 - `publishOn` (string): When to publish — ISO 8601 datetime or Unix epoch. Sets the Scheduler publish_on field.
 - `unpublishOn` (string): When to unpublish — ISO 8601 datetime or Unix epoch. Sets the Scheduler unpublish_on field.
-- `publishState` (string): Moderation state to enter at publishOn (e.g. 'published'). Required on moderated bundles when publishOn is set.
-- `unpublishState` (string): Moderation state to enter at unpublishOn (e.g. 'draft'). Required on moderated bundles when unpublishOn is set.
+- `publishState` (string): Moderation state machine name to enter at publishOn (e.g. 'published'). Written as publish_state. Required when publishOn is set and the bundle has a publish_state field.
+- `unpublishState` (string): Moderation state machine name to enter at unpublishOn (e.g. 'archived'). Written as unpublish_state. Required when unpublishOn is set and the bundle has an unpublish_state field.
 
 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-search-content.md

@@ -14,7 +14,7 @@ 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): Limit to this content type (default: article)
+- `type` (string): Content type machine name. Omit to search every node bundle (merged, newest first); if any bundle cannot be read the search fails and names it.
 - `status` (boolean (true/false)): Filter by publish status
 - `limit` (number)
 

package/.agents/commands/drupal-search.md

@@ -14,7 +14,7 @@ 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 machine name (default: article)
+- `type` (string): Content type machine name. Omit to search every node bundle (merged, newest first); if any bundle cannot be read the search fails and names it.
 - `limit` (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/CHANGELOG.md

@@ -7,6 +7,52 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.0.0] - 2026-10-01
+
+### Fixed
+- **`drupal_schedule_publish` site refusals (#402).** A 422 such as
+  `publish_state: You do not have access to transition from Draft to
+  Published` was rewritten as "Scheduler fields are not available", because
+  any message naming a Scheduler field counted as a missing field. Only the
+  "The attribute X does not exist on the Y resource type" form counts now. Other 4xx refusals,
+  including MCP Sentinel denials, return the site's reason verbatim with the
+  HTTP status.
+- **`drupal_schedule_publish` no longer refuses on its own (#402).** A
+  moderated bundle without `publish_state` / `unpublish_state` is written and
+  the result carries a warning; Drupal and Sentinel decide. A date without
+  its state is still refused when the bundle has the state field, since
+  Drupal accepts that schedule and it never runs. That check now also applies
+  when `moderation_state` is not visible to the account.
+- **`drupal_report_scheduled_content` on an empty bundle (#403).** A bundle
+  with no nodes reports pending 0 / overdue 0 with `schedulerFields:
+  "unknown"` instead of `gated: true`. A gated bundle that hit the sample cap
+  keeps `approximate: true`.
+- **`listContentTypes` read only the first 50 node types (JSON:API).** It
+  now follows `links.next`, so all-bundle scans and
+  `drupal_report_content_summary` see every content type.
+
+### Changed
+- **No node tool defaults to the `article` bundle any more (#403).** On a
+  site without that bundle the old default returned a 404 or scanned nothing.
+  - Require `type`: `drupal_report_duplicate_content`, `_workflow_bottlenecks`,
+    `_translation_coverage`, `_readability`, `_orphan_pages`, `_pii_exposure`,
+    `_seo_meta_coverage`, `_stale_content`, `_content_by_author`,
+    `_revision_hotspots`, `_seo_audit`, `_accessibility_audit`,
+    `_broken_links`, `_alias_coverage`, `_broken_embeds`, `_missing_field` and
+    `_orphaned_references`. `drupal_report_taxonomy_usage` requires
+    `contentType`. The error points to `drupal_list_content_types`.
+  - Scan every node bundle when `type` is omitted:
+    `drupal_report_scheduled_content` (one row per bundle in `byContentType`),
+    `drupal_report_recently_published` and `drupal_report_unpublished`
+    (merged newest first; unreadable bundles in `bundleErrors`), and
+    `drupal_search` / `drupal_search_content` (merged newest first; a bundle
+    that cannot be read fails the search and is named).
+  - `drupal_audit_site_health` without `type` reports its content-type
+    sections as unavailable and still runs the site-wide ones.
+- **Local operator files stay untracked.** `config/config.*.json` is ignored
+  except `config/config.example.json`. One-off `scripts/*-staging.mjs`
+  loaders are ignored too.
+
 ## [2.26.0] - 2026-10-01
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drupal-mcp-connector",
-  "version": "2.26.0",
+  "version": "3.0.0",
   "description": "Multi-site MCP server for Drupal over JSON:API and GraphQL, with governed writes and an SSH Drush bridge. init writes a stdio or Tailscale client config from a transport preset. doctor checks reachability, auth, and readiness, and reports version skew. A timestamp gap on a published revision no longer blocks the next draft.",
   "type": "module",
   "main": "src/index.js",

package/src/lib/backends/jsonapi.js

@@ -20,6 +20,9 @@ import {
 } from "../canonical.js";
 import { isPositiveNid, normalizeAlias, PATH_ALIAS_ENTITY_TYPE } from "../path-alias.js";
 
+/** Most node_type pages read by listContentTypes (50 per page). */
+const CONTENT_TYPE_MAX_PAGES = 20;
+
 // Drupal exposes internal identifiers under drupal_internal__* attributes.
 // They are dropped from canonical `fields` except for the identifiers that
 // governed read/write workflows explicitly need.
@@ -666,13 +669,22 @@ export class JsonApiBackend extends Backend {
    * @returns {Promise<Array<{id: string, label: string, description: ?string}>>}
    */
   async listContentTypes() {
-    // page[limit]=50 is an intentional cap; matches Drupal JSON:API's default page size.
-    const data = await drupalFetch(this.site, "/jsonapi/node_type/node_type?page[limit]=50");
-    return (data.data || []).map((ct) => ({
-      id: ct.attributes.drupal_internal__type,
-      label: ct.attributes.name,
-      description: ct.attributes.description ?? null,
-    }));
+    // JSON:API caps a page at 50. Follow `links.next` so callers that scan
+    // every bundle see them all (#403); stop after a fixed number of pages.
+    const out = [];
+    for (let page = 0, offset = 0; page < CONTENT_TYPE_MAX_PAGES; page += 1, offset += 50) {
+      const data = await drupalFetch(this.site, `/jsonapi/node_type/node_type?page[limit]=50&page[offset]=${offset}`);
+      const rows = data.data || [];
+      for (const ct of rows) {
+        out.push({
+          id: ct.attributes.drupal_internal__type,
+          label: ct.attributes.name,
+          description: ct.attributes.description ?? null,
+        });
+      }
+      if (!data.links?.next || rows.length === 0) break;
+    }
+    return out;
   }
 
   /**