MCP Tools
remove_translations
Remove one or more translation keys from ALL locale files in the given layer. Use dryRun to preview the changes before applying them.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
layer | string | yes | Layer name from discover (e.g., "root", "app-admin"). The keys are removed from ALL locale files in this layer. |
keys | string[] | yes | Dot-separated key paths to remove from every locale file in the layer. Example: "common.actions.delete", "auth.errors.expired". |
dryRun | boolean | no | Return a preview of what would be removed without writing any files. Default: false. |
projectDir | string | no | Absolute path to the project root. Defaults to I18N_PROJECT_DIR, then server cwd. Example: "/home/user/my-app". |
Result
| Field | Type | Description |
|---|---|---|
dryRun | boolean | True when nothing was removed because a preview was asked for. Absent otherwise. |
wouldRemove | object[] | What a dry run would remove. Present only with dryRun. |
removed | string[] | Dot-path keys removed from at least one locale file. Absent on a dry run. |
removedPerLocale | string[] | One "locale:key" entry per file-level removal. Absent on a dry run. |
notFound | string[] | Requested keys no locale file of the layer defined. Absent when every key existed. |
filesWritten | integer | Number of locale files changed on disk. Absent on a dry run. |
summary | object | Counts of what the run did. Absent on a dry run. |
message | string | The step to take next, as the surface the call ran on phrases it. Present only when there is no summary to carry it. |
Behavior Hints
A host reads these to decide whether a call needs your confirmation first.
| Hint | Value |
|---|---|
readOnlyHint | false |
destructiveHint | true |
idempotentHint | true |
openWorldHint | false |
Paired CLI Command
The same operation runs from a terminal as the-i18n-cli remove, whose page documents its flags.