drupal-mcp-connector 2.15.1 → 2.16.0

package/.agents/commands/drupal-codegen-diff.md

@@ -0,0 +1,17 @@
+---
+description: "Compare the live graphql_compose schema to the last gqcc:generate snapshot (`drush graphql-compose-codegen:diff`). Requires the module and drushSsh. Missing command fails loud. If allowedCommands is set, include graphql-compose-codegen:diff."
+argument-hint: "[site] [bundles] [skipFields]"
+---
+
+Call the MCP tool `drupal_codegen_diff`.
+
+Compare the live graphql_compose schema to the last gqcc:generate snapshot (`drush graphql-compose-codegen:diff`). Requires the module and drushSsh. Missing command fails loud. If allowedCommands is set, include graphql-compose-codegen:diff.
+
+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).
+- `bundles` (array (pass as JSON)): Node/paragraph bundle ids. Omit for every bundle graphql_compose exposes.
+- `skipFields` (array (pass as JSON)): Extra field machine names to exclude from the scaffold.
+
+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-codegen-generate.md

@@ -0,0 +1,17 @@
+---
+description: "Return TypeScript/GraphQL scaffold artefacts from graphql_compose_codegen as text (`drush graphql-compose-codegen:generate --dry-run`). Never writes on the Drupal host (no --output-dir). Copy artefacts locally. Requires the module and drushSsh. Missing command fails loud. If allowedCommands is set, include graphql-compose-codegen:generate."
+argument-hint: "[site] [bundles] [skipFields]"
+---
+
+Call the MCP tool `drupal_codegen_generate`.
+
+Return TypeScript/GraphQL scaffold artefacts from graphql_compose_codegen as text (`drush graphql-compose-codegen:generate --dry-run`). Never writes on the Drupal host (no --output-dir). Copy artefacts locally. Requires the module and drushSsh. Missing command fails loud. If allowedCommands is set, include graphql-compose-codegen:generate.
+
+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).
+- `bundles` (array (pass as JSON)): Node/paragraph bundle ids. Omit for every bundle graphql_compose exposes.
+- `skipFields` (array (pass as JSON)): Extra field machine names to exclude from the scaffold.
+
+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-codegen-inspect.md

@@ -0,0 +1,17 @@
+---
+description: "List node and paragraph bundles and extra fields from graphql_compose_codegen (`drush graphql-compose-codegen:inspect`). Requires the module and drushSsh. Missing command fails loud. If allowedCommands is set, include graphql-compose-codegen:inspect. Does not write files."
+argument-hint: "[site] [bundles] [skipFields]"
+---
+
+Call the MCP tool `drupal_codegen_inspect`.
+
+List node and paragraph bundles and extra fields from graphql_compose_codegen (`drush graphql-compose-codegen:inspect`). Requires the module and drushSsh. Missing command fails loud. If allowedCommands is set, include graphql-compose-codegen:inspect. Does not write files.
+
+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).
+- `bundles` (array (pass as JSON)): Node/paragraph bundle ids. Omit for every bundle graphql_compose exposes.
+- `skipFields` (array (pass as JSON)): Extra field machine names to exclude from the scaffold.
+
+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-content-by-moderation-state.md

@@ -1,11 +1,11 @@
 ---
-description: "List nodes of a content type currently in a given moderation state (e.g. what is in 'draft' or 'needs_review'). Stock JSON:API cannot filter the computed moderation_state field; when the site rejects that filter the tool samples recent nodes client-side and marks the result approximate, instead of returning Drupal's 500."
-argument-hint: "<type> <state> [site] [limit] [offset]"
+description: "List nodes of a content type currently in a given moderation state (e.g. what is in 'draft' or 'needs_review'). Pass langcode to match that translation via Sentinel inventory (the editorial work queue). Omit langcode for default-language JSON:API / sampled behavior. Stock JSON:API cannot filter the computed moderation_state field; when the site rejects that filter the tool samples recent nodes client-side and marks the result approximate, instead of returning Drupal's 500."
+argument-hint: "<type> <state> [site] [langcode] [limit] [offset]"
 ---
 
 Call the MCP tool `drupal_content_by_moderation_state`.
 
-List nodes of a content type currently in a given moderation state (e.g. what is in 'draft' or 'needs_review'). Stock JSON:API cannot filter the computed moderation_state field; when the site rejects that filter the tool samples recent nodes client-side and marks the result approximate, instead of returning Drupal's 500.
+List nodes of a content type currently in a given moderation state (e.g. what is in 'draft' or 'needs_review'). Pass langcode to match that translation via Sentinel inventory (the editorial work queue). Omit langcode for default-language JSON:API / sampled behavior. Stock JSON:API cannot filter the computed moderation_state field; when the site rejects that filter the tool samples recent nodes client-side and marks the result approximate, instead of returning Drupal's 500.
 
 Parse the arguments supplied with this command into this tool's parameters:
 
@@ -15,6 +15,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).
+- `langcode` (string): Match this translation (e.g. 'es'). Requires Sentinel. Omit for default-language listing.
 - `limit` (number)
 - `offset` (number)
 

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

@@ -1,11 +1,11 @@
 ---
-description: "Introspect the fields of a Drupal entity type + bundle: returns a per-field list of { name, type, kind, cardinality?, approximate }. Read-only. Built on schema SAMPLING (an existing entity), so results are approximate — only populated fields are visible and required/cardinality/allowedValues are inferred from value shape. Authoritative field metadata comes from the Drush bridge (Field API). Use this before creating/updating entities to learn field names."
+description: "Introspect the fields of a Drupal entity type + bundle: returns a per-field list of { name, type, kind, cardinality?, translatable?, approximate }. Read-only. Built on schema SAMPLING (an existing entity), so results are approximate — only populated fields are visible and required/cardinality/allowedValues are inferred from value shape. When JSON:API field_config is readable, translatable is copied from Field API; omitted means unknown, not false. Authoritative field metadata comes from the Drush bridge (Field API). Use this before creating/updating entities to learn field names."
 argument-hint: "<site> [type] [entityType] [bundle]"
 ---
 
 Call the MCP tool `drupal_describe_fields`.
 
-Introspect the fields of a Drupal entity type + bundle: returns a per-field list of { name, type, kind, cardinality?, approximate }. Read-only. Built on schema SAMPLING (an existing entity), so results are approximate — only populated fields are visible and required/cardinality/allowedValues are inferred from value shape. Authoritative field metadata comes from the Drush bridge (Field API). Use this before creating/updating entities to learn field names.
+Introspect the fields of a Drupal entity type + bundle: returns a per-field list of { name, type, kind, cardinality?, translatable?, approximate }. Read-only. Built on schema SAMPLING (an existing entity), so results are approximate — only populated fields are visible and required/cardinality/allowedValues are inferred from value shape. When JSON:API field_config is readable, translatable is copied from Field API; omitted means unknown, not false. Authoritative field metadata comes from the Drush bridge (Field API). Use this before creating/updating entities to learn field names.
 
 Parse the arguments supplied with this command into this tool's parameters:
 

package/.agents/commands/drupal-get-node.md

@@ -1,11 +1,11 @@
 ---
-description: "Fetch a single Drupal content node by UUID and content type. Returns title, body, status, path alias, and all attributes. Pass langcode to read a working translation draft via Sentinel (distinct from published English)."
-argument-hint: "<type> <id> [site] [langcode]"
+description: "Fetch a single Drupal content node by UUID and content type. Returns title, body, status, path alias, and all attributes. Pass langcode to read a working translation draft via Sentinel (distinct from published English). Pass includeComponents true to attach pinned paragraph translations under `components` (default false)."
+argument-hint: "<type> <id> [site] [langcode] [includeComponents]"
 ---
 
 Call the MCP tool `drupal_get_node`.
 
-Fetch a single Drupal content node by UUID and content type. Returns title, body, status, path alias, and all attributes. Pass langcode to read a working translation draft via Sentinel (distinct from published English).
+Fetch a single Drupal content node by UUID and content type. Returns title, body, status, path alias, and all attributes. Pass langcode to read a working translation draft via Sentinel (distinct from published English). Pass includeComponents true to attach pinned paragraph translations under `components` (default false).
 
 Parse the arguments supplied with this command into this tool's parameters:
 
@@ -16,5 +16,6 @@ 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).
 - `langcode` (string): Target language (e.g. 'es') to read the unpublished working translation instead of the default language.
+- `includeComponents` (boolean (true/false)): If true, include pinned paragraph translations under `components` (empty array when the host has no ERR fields). Default false so existing callers are unchanged.
 
 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-get-taxonomy-term.md

@@ -1,11 +1,11 @@
 ---
-description: "Fetch a single taxonomy term by UUID."
-argument-hint: "<vocabulary> <id> [site]"
+description: "Fetch a single taxonomy term by UUID. Pass langcode to request that translation; omit for the default language. JSON:API must negotiate language or the tool errors if a different language is served."
+argument-hint: "<vocabulary> <id> [site] [langcode]"
 ---
 
 Call the MCP tool `drupal_get_taxonomy_term`.
 
-Fetch a single taxonomy term by UUID.
+Fetch a single taxonomy term by UUID. Pass langcode to request that translation; omit for the default language. JSON:API must negotiate language or the tool errors if a different language is served.
 
 Parse the arguments supplied with this command into this tool's parameters:
 
@@ -15,5 +15,6 @@ 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).
+- `langcode` (string): Translation language (e.g. 'es'). Omit for the default language.
 
 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-revisions.md

@@ -1,11 +1,11 @@
 ---
-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."
+description: "Surface the latest default and working node revisions. When the core working-copy alias is absent or echoes live, consult Sentinel translation inventory; workingCopy then includes source and language-specific translations instead of a misleading aggregate status. Continue an unpublished translation with explicit langcode. 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]"
 ---
 
 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.
+Surface the latest default and working node revisions. When the core working-copy alias is absent or echoes live, consult Sentinel translation inventory; workingCopy then includes source and language-specific translations instead of a misleading aggregate status. Continue an unpublished translation with explicit langcode. 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 arguments supplied with this command into this tool's parameters:
 

package/.agents/commands/drupal-list-translations.md

@@ -1,11 +1,11 @@
 ---
-description: "List live and working translation langcodes for a Drupal node or paragraph. Uses Sentinel's translation inventory when available (live default revision vs unpublished working draft). Core JSON:API alone serves one language and cannot prove others are absent. Defaults to node."
+description: "List live and working translation langcodes for a Drupal node or paragraph. Uses Sentinel's translation inventory when available (live default revision vs unpublished working draft), including core content_translation_outdated and source when the server sends them. Core JSON:API alone serves one language and cannot prove others are absent. Defaults to node."
 argument-hint: "<type> <id> [site] [entityType]"
 ---
 
 Call the MCP tool `drupal_list_translations`.
 
-List live and working translation langcodes for a Drupal node or paragraph. Uses Sentinel's translation inventory when available (live default revision vs unpublished working draft). Core JSON:API alone serves one language and cannot prove others are absent. Defaults to node.
+List live and working translation langcodes for a Drupal node or paragraph. Uses Sentinel's translation inventory when available (live default revision vs unpublished working draft), including core content_translation_outdated and source when the server sends them. Core JSON:API alone serves one language and cannot prove others are absent. Defaults to node.
 
 Parse the arguments supplied with this command into this tool's parameters:
 

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

@@ -1,18 +1,17 @@
 ---
-description: "Report content distribution by language for a content type and flag languages lagging the most-populated language — a multilingual coverage signal."
-argument-hint: "[site] [type] [gapThreshold] [sampleSize]"
+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]"
 ---
 
 Call the MCP tool `drupal_report_translation_coverage`.
 
-Report content distribution by language for a content type and flag languages lagging the most-populated language — a multilingual coverage signal.
+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.
 
 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)
-- `gapThreshold` (number): Flag languages below this fraction of the top language
-- `sampleSize` (number)
+- `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-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] [sampleSize]"
+argument-hint: "[site] [type] [days] [states] [langcode] [sampleSize]"
 ---
 
 Call the MCP tool `drupal_report_workflow_bottlenecks`.
@@ -14,6 +14,7 @@ Parse the arguments supplied with this command into this tool's parameters:
 - `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.
 - `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-set-moderation-state.md

@@ -1,11 +1,11 @@
 ---
-description: "Transition a content node to a moderation state (content_moderation), e.g. 'draft', 'needs_review', 'published', 'archived'. Governed write."
-argument-hint: "<type> <id> <state> [site]"
+description: "Transition a content node to a moderation state (content_moderation), e.g. 'draft', 'needs_review', 'published', 'archived'. Governed write. Pass langcode to change one translation via Sentinel; omit it for the default-language / shared-state write. If moderation_state is not translatable, a langcode write is refused."
+argument-hint: "<type> <id> <state> [site] [langcode]"
 ---
 
 Call the MCP tool `drupal_set_moderation_state`.
 
-Transition a content node to a moderation state (content_moderation), e.g. 'draft', 'needs_review', 'published', 'archived'. Governed write.
+Transition a content node to a moderation state (content_moderation), e.g. 'draft', 'needs_review', 'published', 'archived'. Governed write. Pass langcode to change one translation via Sentinel; omit it for the default-language / shared-state write. If moderation_state is not translatable, a langcode write is refused.
 
 Parse the arguments supplied with this command into this tool's parameters:
 
@@ -16,5 +16,6 @@ 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).
+- `langcode` (string): Target translation (e.g. 'es'). Omit for the default language. Requires Sentinel.
 
 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-update-menu-link.md

@@ -1,6 +1,6 @@
 ---
 description: "Update a custom menu link by UUID (rename, re-weight, re-target, re-parent, enable/disable). Only the fields you pass change. The link's enabled state is preserved across edits — an unrelated change will not disable a live link — unless you pass 'enabled' explicitly. Checked against the site security config."
-argument-hint: "<id> [site] [title] [link] [menu] [weight] [parent] [enabled]"
+argument-hint: "<id> [site] [title] [link] [menu] [weight] [parent] [enabled] [langcode]"
 ---
 
 Call the MCP tool `drupal_update_menu_link`.
@@ -20,5 +20,6 @@ Parse the arguments supplied with this command into this tool's parameters:
 - `weight` (number): New ordering weight. Omit to leave unchanged.
 - `parent` (string): New parent link plugin id (e.g. 'menu_link_content:<uuid>'), or '' for top level. Omit to leave unchanged.
 - `enabled` (boolean (true/false)): Enable/disable the link. Omit to preserve the current state.
+- `langcode` (string): Existing translation to update (e.g. 'es'). Omit for the default language. Does not create a missing translation.
 
 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-update-node.md

@@ -1,11 +1,11 @@
 ---
-description: "Update an existing node. Only include fields you want to change. For moderated content types, use moderationState (e.g. 'published') rather than status. When the target is published and moderated and you omit moderationState, the connector defaults the write to moderation_state 'draft' (forward revision) so live default revisions are not mutated by accident. Pass langcode to continue an unpublished working translation (Sentinel X-MCP-Draft-Langcode); this does not PATCH canonical langcode and will not create a missing translation — use drupal_create_translation first. Entity-reference fields go in `relationships`, not `fields`. Paragraph / ERR identifiers are resolved to include meta.target_revision_id before PATCH; the write fails if any ref cannot be resolved (an unresolved identifier persists as an empty field). On moderated targets a non-saving PATCH preflight runs first — including on dryRun — against the same URL the write will hit. An addressable node draft uses Sentinel's governed draft endpoint with live/working revision preconditions (#166); dryRun uses that same target. workingCopy:null from drupal_list_revisions is not proof the node is writable (possiblyPatchBlocked / #201). Preflight here does not un-orphan paragraphs already created; probe the host before creating dependents."
+description: "Update an existing node. Only include fields you want to change. For moderated content types, use moderationState (e.g. 'published') rather than status. When the target is published and moderated and you omit moderationState, the connector defaults the write to moderation_state 'draft' (forward revision) so live default revisions are not mutated by accident. Pass langcode to continue an unpublished working translation (Sentinel X-MCP-Draft-Langcode); this does not PATCH canonical langcode and will not create a missing translation — use drupal_create_translation first. Entity-reference fields go in `relationships`, not `fields`. Paragraph / ERR identifiers are resolved to include meta.target_revision_id before PATCH; the write fails if any ref cannot be resolved (an unresolved identifier persists as an empty field). On moderated targets a non-saving PATCH preflight runs first — including on dryRun — against the same URL the write will hit. Existing node drafts use Sentinel's governed draft endpoint with verified live/working revision preconditions; translation-only drafts are discovered through Sentinel inventory (#297). Pass explicit langcode to continue an unpublished translation. Published languages are not converted into drafts; dryRun uses the same target. workingCopy:null from drupal_list_revisions is not proof the node is writable (possiblyPatchBlocked / #201). Preflight here does not un-orphan paragraphs already created; probe the host before creating dependents."
 argument-hint: "<type> <id> [site] [title] [body] [summary] [format] [status] [moderationState] [langcode] [fields] [relationships] [dryRun] [returning]"
 ---
 
 Call the MCP tool `drupal_update_node`.
 
-Update an existing node. Only include fields you want to change. For moderated content types, use moderationState (e.g. 'published') rather than status. When the target is published and moderated and you omit moderationState, the connector defaults the write to moderation_state 'draft' (forward revision) so live default revisions are not mutated by accident. Pass langcode to continue an unpublished working translation (Sentinel X-MCP-Draft-Langcode); this does not PATCH canonical langcode and will not create a missing translation — use drupal_create_translation first. Entity-reference fields go in `relationships`, not `fields`. Paragraph / ERR identifiers are resolved to include meta.target_revision_id before PATCH; the write fails if any ref cannot be resolved (an unresolved identifier persists as an empty field). On moderated targets a non-saving PATCH preflight runs first — including on dryRun — against the same URL the write will hit. An addressable node draft uses Sentinel's governed draft endpoint with live/working revision preconditions (#166); dryRun uses that same target. workingCopy:null from drupal_list_revisions is not proof the node is writable (possiblyPatchBlocked / #201). Preflight here does not un-orphan paragraphs already created; probe the host before creating dependents.
+Update an existing node. Only include fields you want to change. For moderated content types, use moderationState (e.g. 'published') rather than status. When the target is published and moderated and you omit moderationState, the connector defaults the write to moderation_state 'draft' (forward revision) so live default revisions are not mutated by accident. Pass langcode to continue an unpublished working translation (Sentinel X-MCP-Draft-Langcode); this does not PATCH canonical langcode and will not create a missing translation — use drupal_create_translation first. Entity-reference fields go in `relationships`, not `fields`. Paragraph / ERR identifiers are resolved to include meta.target_revision_id before PATCH; the write fails if any ref cannot be resolved (an unresolved identifier persists as an empty field). On moderated targets a non-saving PATCH preflight runs first — including on dryRun — against the same URL the write will hit. Existing node drafts use Sentinel's governed draft endpoint with verified live/working revision preconditions; translation-only drafts are discovered through Sentinel inventory (#297). Pass explicit langcode to continue an unpublished translation. Published languages are not converted into drafts; dryRun uses the same target. workingCopy:null from drupal_list_revisions is not proof the node is writable (possiblyPatchBlocked / #201). Preflight here does not un-orphan paragraphs already created; probe the host before creating dependents.
 
 Parse the arguments supplied with this command into this tool's parameters:
 

package/.agents/commands/drupal-update-taxonomy-term.md

@@ -1,11 +1,11 @@
 ---
-description: "Update an existing taxonomy term's name, description, or weight."
-argument-hint: "<vocabulary> <id> [site] [name] [description] [weight]"
+description: "Update an existing taxonomy term's name, description, or weight. Pass langcode to update an existing translation; this does not create a missing translation."
+argument-hint: "<vocabulary> <id> [site] [name] [description] [weight] [langcode]"
 ---
 
 Call the MCP tool `drupal_update_taxonomy_term`.
 
-Update an existing taxonomy term's name, description, or weight.
+Update an existing taxonomy term's name, description, or weight. Pass langcode to update an existing translation; this does not create a missing translation.
 
 Parse the arguments supplied with this command into this tool's parameters:
 
@@ -18,5 +18,6 @@ Parse the arguments supplied with this command into this tool's parameters:
 - `name` (string)
 - `description` (string)
 - `weight` (number)
+- `langcode` (string): Existing translation to update (e.g. 'es'). Omit for the default language.
 
 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,55 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.16.0] - 2026-09-11
+
+### Added
+- **Optional graphql_compose_codegen tools (#308).**
+  `drupal_codegen_inspect`, `drupal_codegen_diff`, and `drupal_codegen_generate`
+  call `drush graphql-compose-codegen:*` over the existing SSH bridge.
+  Generate is `--dry-run` only (artefacts as text; no `--output-dir`).
+  Missing module or unknown command fails loud. If `allowedCommands` is set,
+  the matching `graphql-compose-codegen:*` subcommand must be listed.
+- **Field `translatable`, taxonomy/menu `langcode`, and composed node reads (#303).**
+  `drupal_describe_fields` copies Field API `translatable` when JSON:API
+  `field_config` is readable (omitted means unknown). Taxonomy get/update and
+  menu-link update accept optional `langcode` (existing translations only).
+  `drupal_get_node` accepts `includeComponents` (default false) to attach
+  pinned paragraph translations.
+- **Optional `langcode` on the editorial queue (#303).**
+  `drupal_content_by_moderation_state` and `drupal_set_moderation_state` accept
+  a translation language. Omitting it keeps the previous default-language
+  behavior. A langcode write uses Sentinel's draft-translation surface (no
+  canonical `langcode` PATCH). A langcode list uses the translation inventory;
+  without Sentinel the result is `unavailable`. `drupal_report_workflow_bottlenecks`
+  has the same optional filter.
+
+### Changed
+- **`drupal_list_translations` passes through core outdated/source (#303).**
+  When Sentinel sends `content_translation_outdated` / `content_translation_source`,
+  those keys appear on each row. They are omitted when absent.
+- **`drupal_report_translation_coverage` uses Sentinel inventory (#303).**
+  Per-node missing non-default language and outdated flags replace the
+  default-language histogram. Without Sentinel the report is `unavailable`
+  rather than a misleading 100% default-language chart.
+- **Public product name is Drupal MCP Connector (#301).** Document titles and
+  the MCP handshake `serverInfo.title` now use the title-case product name.
+  The machine identifiers are unchanged: npm package, GitHub repo, binaries,
+  `X-MCP-Client`, log prefixes, and `serverInfo.name` remain
+  `drupal-mcp-connector`.
+
+## [2.15.2] - 2026-09-11
+
+### Fixed
+- **Discover and continue translation-only forward revisions (#297).** When core's
+  working-copy alias is absent or echoes live, node revision listing and guarded
+  updates consult Sentinel's translation inventory. Existing unpublished languages
+  continue through the governed endpoint with explicit language and live/working
+  preconditions. Published languages and ambiguous multilingual edits remain refused.
+  Permission and transport failures stop discovery rather than becoming “no draft”.
+  Update responses preserve the saved translation instead of replacing it with live
+  English. An unresolved revision conflict no longer prescribes revision surgery.
+
 ## [2.15.1] - 2026-09-10
 
 ### Fixed
@@ -1571,6 +1620,8 @@ The connector is now **dual-protocol**: every tool runs against an abstract back
 - User tools gained explicit PII-access assertions.
 - Whole tree lint-clean (`npm run lint`) with object-injection sinks rewritten to safe lookups.
 
+[2.16.0]: https://github.com/Wilkes-Liberty/drupal-mcp-connector/releases/tag/v2.16.0
+[2.15.2]: https://github.com/Wilkes-Liberty/drupal-mcp-connector/releases/tag/v2.15.2
 [2.15.1]: https://github.com/Wilkes-Liberty/drupal-mcp-connector/releases/tag/v2.15.1
 [2.15.0]: https://github.com/Wilkes-Liberty/drupal-mcp-connector/releases/tag/v2.15.0
 [2.14.2]: https://github.com/Wilkes-Liberty/drupal-mcp-connector/releases/tag/v2.14.2

package/README.md

@@ -1,6 +1,6 @@
-# drupal-mcp-connector
+# Drupal MCP Connector
 
-> A secure, multi-site Model Context Protocol (MCP) connector for Drupal — dual-protocol JSON:API and GraphQL access, governed draft translations, content tools, audit reports, and an SSH Drush bridge.
+> Drupal MCP Connector — multi-site MCP server for Drupal with JSON:API and GraphQL, governed writes, draft translations, content tools, audit reports, and an SSH Drush bridge.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D20-green)](https://nodejs.org)
@@ -15,7 +15,7 @@ Built by **[Jeremy Michael Cerda](https://www.drupal.org/u/jmcerda)** (opensourc
 
 ## What It Does
 
-`drupal-mcp-connector` connects any [Model Context Protocol](https://modelcontextprotocol.io) client to one or more Drupal sites. It exposes Drupal content and configuration as a set of MCP **tools**, **resources**, and **prompts**, so an MCP client can read, audit, and (where permitted) write content through structured, governed operations instead of the admin UI:
+**Drupal MCP Connector** (`drupal-mcp-connector`) connects any [Model Context Protocol](https://modelcontextprotocol.io) client to one or more Drupal sites. It exposes Drupal content and configuration as a set of MCP **tools**, **resources**, and **prompts**, so an MCP client can read, audit, and (where permitted) write content through structured, governed operations instead of the admin UI:
 
 ```
 "Find all articles missing a meta description and list them."

package/bin/drupal-mcp-agent.js

@@ -25,7 +25,7 @@ import { readFileSync } from "node:fs";
 import { connect as netConnect } from "node:net";
 import { connect as tlsConnect } from "node:tls";
 import process from "node:process";
-import { CLIENT_VERSION, listSiteNames, loadConfig } from "../src/lib/config.js";
+import { CLIENT_VERSION, SERVER_INFO, listSiteNames, loadConfig } from "../src/lib/config.js";
 import { callTool, listResolvableSiteConfigs } from "../src/lib/dispatch.js";
 import { filterDiscoverableTools } from "../src/lib/governance.js";
 import {
@@ -110,7 +110,7 @@ async function discoverableTools() {
 }
 
 const surface = {
-  serverInfo: { name: "drupal-mcp-connector", version: CLIENT_VERSION },
+  serverInfo: SERVER_INFO,
   tools: {
     definitions: allDefinitions,
     list: discoverableTools,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "drupal-mcp-connector",
-  "version": "2.15.1",
-  "description": "A secure, multi-site Model Context Protocol (MCP) connector for Drupal — dual-protocol JSON:API and GraphQL access, governed draft translations, content tools, audit reports, and an SSH Drush bridge.",
+  "version": "2.16.0",
+  "description": "Drupal MCP Connector — multi-site MCP server for Drupal with JSON:API and GraphQL, governed writes, draft translations, content tools, audit reports, and an SSH Drush bridge.",
   "type": "module",
   "main": "src/index.js",
   "bin": {

package/scripts/generate-commands.js

@@ -134,7 +134,7 @@ export function renderCodexSkillMarkdown(definitions = allDefinitions) {
     "---",
     `name: ${yamlString(CODEX_SKILL_NAME)}`,
     `description: ${yamlString(
-      "Use Drupal MCP tools (drupal_*) via drupal-mcp-connector to read or write Drupal content, media, taxonomy, reports, and config. Trigger when the user asks to work with a Drupal site over MCP.",
+      "Use Drupal MCP tools (drupal_*) via Drupal MCP Connector (drupal-mcp-connector) to read or write Drupal content, media, taxonomy, reports, and config. Trigger when the user asks to work with a Drupal site over MCP.",
     )}`,
     "---",
     "",
@@ -161,7 +161,7 @@ export function renderCodexToolsReference(definitions = allDefinitions) {
   const lines = [
     "# Drupal MCP tools",
     "",
-    "Protocol tool names for `drupal-mcp-connector`. Call these via MCP; do not invent REST paths.",
+    "Protocol tool names for Drupal MCP Connector. Call these via MCP; do not invent REST paths.",
     "",
   ];
   for (const def of definitions) {

package/src/index.js

@@ -33,7 +33,7 @@ import { createMcpHandler } from "@modelcontextprotocol/server";
 import { serveStdio } from "@modelcontextprotocol/server/stdio";
 import { toNodeHandler } from "@modelcontextprotocol/node";
 
-import { listSiteNames, getTlsConfig, loadConfig, CLIENT_VERSION } from "./lib/config.js";
+import { listSiteNames, getTlsConfig, loadConfig, CLIENT_VERSION, SERVER_INFO } from "./lib/config.js";
 import { loadLocalSecrets, secretLoadFatalMessage, secretTableMismatchMessage } from "./lib/load-secrets.js";
 import {
   makeBearerCheck,
@@ -291,7 +291,7 @@ function getPromptMessages(name, args) {
 // ---------------------------------------------------------------------------
 
 const buildConnectorServer = createConnectorServerFactory({
-  serverInfo: { name: "drupal-mcp-connector", version: CLIENT_VERSION },
+  serverInfo: SERVER_INFO,
   tools: {
     definitions: allDefinitions,
     list: discoverableTools,

package/src/lib/backends/jsonapi.js

@@ -32,6 +32,38 @@ const INTERNAL_ATTR_RE = /^drupal_internal__/;
 const COUNT_PAGE_SIZE = 50;
 const COUNT_MAX_RECORDS = 1000;
 
+/**
+ * JSON:API language headers. Drupal negotiates Content-Language / Accept-Language
+ * when URL prefixes are not used on /jsonapi.
+ * @param {?string} langcode
+ * @returns {object}
+ */
+function languageFetchOptions(langcode) {
+  if (!langcode) return {};
+  return { headers: { "Content-Language": langcode, "Accept-Language": langcode } };
+}
+
+/**
+ * Fail if JSON:API served a different language than requested.
+ * @param {?object} entity
+ * @param {?string} langcode
+ */
+function assertServedLanguage(entity, langcode) {
+  if (!langcode || !entity) return;
+  if (!entity.langcode) {
+    throw new Error(
+      `JSON:API did not report a language for requested langcode "${langcode}". ` +
+      "The translation may not exist, or this backend does not negotiate language.",
+    );
+  }
+  if (entity.langcode !== langcode) {
+    throw new Error(
+      `JSON:API served language "${entity.langcode}" for requested langcode "${langcode}". ` +
+      "The translation may not exist, or this site does not negotiate JSON:API by language.",
+    );
+  }
+}
+
 /**
  * Whether a JSON:API collection document advertises another page.
  * `links.next` may be a string href or a `{ href }` link object.
@@ -358,14 +390,16 @@ export class JsonApiBackend extends Backend {
    * @param {{entityType: string, bundle: string, id: string, resourceVersion?: string}} ref
    * @returns {Promise<?import("../canonical.js").CanonicalEntity>} Entity, or null.
    */
-  async getEntity({ entityType, bundle, id, resourceVersion }) {
+  async getEntity({ entityType, bundle, id, resourceVersion, langcode }) {
     validateUuid(id);
     let path = `${this.resourcePath(entityType, bundle)}/${encodeURIComponent(id)}`;
     if (resourceVersion) {
       path += `?resourceVersion=${encodeURIComponent(resourceVersion)}`;
     }
-    const data = await drupalFetch(this.site, path);
-    return data?.data ? this.toCanonical(data.data) : null;
+    const data = await drupalFetch(this.site, path, languageFetchOptions(langcode));
+    const entity = data?.data ? this.toCanonical(data.data) : null;
+    assertServedLanguage(entity, langcode);
+    return entity;
   }
 
   /**
@@ -478,14 +512,15 @@ export class JsonApiBackend extends Backend {
    * @param {object} attributes Entity attributes (may include `status`).
    * @returns {Promise<object>} The JSON:API response body.
    */
-  async writeWithModerationFallback(path, method, buildPayload, attributes) {
+  async writeWithModerationFallback(path, method, buildPayload, attributes, langcode) {
+    const lang = languageFetchOptions(langcode);
     try {
-      return await drupalFetch(this.site, path, { method, body: JSON.stringify(buildPayload(attributes)) });
+      return await drupalFetch(this.site, path, { method, body: JSON.stringify(buildPayload(attributes)), ...lang });
     } catch (err) {
       if (!isModeratedStatusError(err) || !("status" in attributes)) throw err;
       const withoutStatus = { ...attributes };
       delete withoutStatus.status;
-      return drupalFetch(this.site, path, { method, body: JSON.stringify(buildPayload(withoutStatus)) });
+      return drupalFetch(this.site, path, { method, body: JSON.stringify(buildPayload(withoutStatus)), ...lang });
     }
   }
 
@@ -515,7 +550,7 @@ export class JsonApiBackend extends Backend {
    *   canonical default (#166 / Drupal #2795279).
    * @returns {Promise<import("../canonical.js").CanonicalEntity>} The updated entity.
    */
-  async updateEntity({ entityType, bundle, id, attributes = {}, relationships, resourceVersion }) {
+  async updateEntity({ entityType, bundle, id, attributes = {}, relationships, resourceVersion, langcode }) {
     validateUuid(id);
     const buildPayload = (attrs) => {
       const payload = { data: { type: `${entityType}--${bundle}`, id, attributes: attrs } };
@@ -527,8 +562,10 @@ export class JsonApiBackend extends Backend {
     if (resourceVersion) {
       path += `?resourceVersion=${encodeURIComponent(resourceVersion)}`;
     }
-    const data = await this.writeWithModerationFallback(path, "PATCH", buildPayload, attributes);
-    return this.toCanonical(data.data);
+    const data = await this.writeWithModerationFallback(path, "PATCH", buildPayload, attributes, langcode);
+    const entity = this.toCanonical(data.data);
+    assertServedLanguage(entity, langcode);
+    return entity;
   }
 
   /**
@@ -704,6 +741,45 @@ export class JsonApiBackend extends Backend {
    * @param {{entityType: string, bundle: string, fieldName: string}} ref
    * @returns {Promise<?{fieldName: string, fieldType: ?string, allowedFormats: string[]}>}
    */
+  /**
+   * Map of field machine name → translatable from JSON:API field_config.
+   * Base fields (title, moderation_state) are omitted unless exposed as
+   * base_field_override. Missing keys must not be treated as false.
+   * @param {string} entityType
+   * @param {string} bundle
+   * @returns {Promise<Object<string, boolean>>}
+   */
+  async listFieldTranslatability(entityType, bundle) {
+    validateMachineName(entityType, "entityType");
+    validateMachineName(bundle, "bundle");
+    const map = new Map();
+    const params = new URLSearchParams();
+    params.set("filter[entity_type]", entityType);
+    params.set("filter[bundle]", bundle);
+    params.set("page[limit]", "50");
+    const ingest = (rows) => {
+      for (const row of rows) {
+        const name = row?.attributes?.field_name;
+        if (typeof name === "string" && typeof row.attributes?.translatable === "boolean") {
+          map.set(name, row.attributes.translatable);
+        }
+      }
+    };
+    try {
+      const data = await drupalFetch(this.site, `/jsonapi/field_config/field_config?${params}`);
+      ingest(Array.isArray(data?.data) ? data.data : []);
+    } catch {
+      // field_config may be unexposed.
+    }
+    try {
+      const data = await drupalFetch(this.site, `/jsonapi/base_field_override/base_field_override?${params}`);
+      ingest(Array.isArray(data?.data) ? data.data : []);
+    } catch {
+      // base_field_override is often not JSON:API-exposed.
+    }
+    return Object.fromEntries(map);
+  }
+
   async getFieldDefinition({ entityType, bundle, fieldName }) {
     validateMachineName(entityType, "entityType");
     validateMachineName(bundle, "bundle");