MCP Tools
move_translation_key
Move a key from one layer to another, carrying every locale that defines it — promoting an app-layer key to a shared layer once a second app needs it, or demoting a shared key that turned out to be app-specific. Call discover first: layerGraph.shared names the layers more than one app consumes. Writes nothing at all if the target layer already holds the key with a different value in any locale; if it holds the same value, that locale is deduplicated instead. Use dryRun to preview the plan.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
fromLayer | string | yes | Layer the key lives in today, from discover. Example: "app-admin". |
toLayer | string | yes | Layer to move it to, from discover. Example: "root". Must differ from fromLayer — to rename within one layer, use rename_translation_key. |
key | string | yes | Dot-separated key path to move. Example: "calendar.views.save". |
newKey | string | no | Key path in the target layer, when the move also renames it. Example: "common.actions.save". Defaults to the same path. |
dryRun | boolean | no | When true, returns the plan without writing any files. Default: false. |
projectDir | string | no | Absolute path to the project root. Defaults to I18N_PROJECT_DIR, then server cwd. |
Every tool is advertised by the-i18n-mcp and listed on the MCP tools overview.