MCP Tools
list_namespaces
List the translation key tree grouped by namespace prefix, with a count per namespace node. Use this to explore the available keys without guessing path prefixes. limit counts top-level namespace nodes across the scanned layers, each of which brings its whole subtree; totalNamespaces counts them all, whatever the limit let through.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
layer | string | no | Layer name to filter by (e.g., "root", "app-admin"). If omitted or "*", scans all layers. Call discover to list the layers. |
locale | string | no | Locale code to read from (e.g., "en", "en-US"). Defaults to the project default locale. Keys are the same across locales, so one is enough. |
limit | integer | no | Maximum number of top-level namespaces to return. Default: 100 for a tool call, unlimited at a terminal. When the cap applies the result carries truncated: true and nextOffset — call again with offset set to that value for the next page, or narrow the request instead. |
offset | integer | no | Number of top-level namespaces to skip before returning any. Default: 0. Pass the nextOffset of a truncated result to continue where it stopped. |
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 |
|---|---|---|
layers | Record<string, object> | One entry per scanned layer. Alias layers are skipped. |
totalNamespaces | integer | Top-level namespaces across every scanned layer, before limit. A namespace brings its whole subtree, so this is what limit counts. |
truncated | boolean | True when limit cut the result short. The totals still count everything. |
nextOffset | integer | The offset to pass to continue where this result stopped. Present only when truncated. |
message | string | The step to take next — how to continue a capped read. Present when there is one. |
Behavior Hints
A host reads these to decide whether a call needs your confirmation first.
| Hint | Value |
|---|---|
readOnlyHint | true |
openWorldHint | false |