MCP Tools

MCP Tools

Every tool the-i18n-mcp advertises is listed below and documented on its own page, with the parameters and descriptions an MCP host receives.

Tools

ToolWhat it does
discoverDiscover i18n Setup
list_namespacesList Namespaces
get_translationsGet Translations
write_translationsWrite Translations
get_missing_translationsGet Missing Translations
get_translation_statusGet Translation Status
search_translationsSearch Translations
remove_translationsRemove Translations
move_translation_keyMove or Rename a Translation Key
translate_missingTranslate Missing
translate_keyTranslate Key
find_undefined_keysFind Used-But-Undefined Translation Keys
find_orphan_keysFind Orphan Translation Keys
find_duplicate_keysFind Duplicate Translation Keys Across Layers
scaffold_localeScaffold Locale

Paired CLI Commands

@the-i18n-kit/mcp depends on @the-i18n-kit/cli and calls the same functions the commands call, so a tool and the command it pairs with read the same project and return the same result. Where you run an operation from is a matter of who is driving.

A tool parameter and the flag that reaches it carry one name — targetLocales is --targetLocales, with the shorter spelling the CLI used before kept as an alias — so the command pages document the flags rather than these pages restating them.

Parameters Every Tool Accepts

projectDir appears on every tool.

What a Tool Returns

Every tool advertises an outputSchema and returns its result as structuredContent, so a host hands its model typed data rather than a JSON blob to parse. The same JSON is sent as a text block for hosts that read only that. Each tool page lists the top-level fields of its own result.

Diverting a Large Result

get_missing_translations, get_translation_status, search_translations, find_undefined_keys, find_orphan_keys, find_duplicate_keys accept outputFile. Given an absolute path, the tool writes its full JSON result there and returns a compact summary instead, so a result covering thousands of keys never enters the conversation.

Copyright © 2026