@langapi/mcp-server 1.0.0

package/dist/locale-detection/patterns.js

@@ -0,0 +1,135 @@
+/**
+ * Framework-specific patterns for detecting i18n locale files
+ */
+export const FRAMEWORK_PATTERNS = {
+    "next-intl": {
+        configFiles: [
+            "next.config.js",
+            "next.config.mjs",
+            "next.config.ts",
+            "i18n.ts",
+            "i18n.js",
+            "src/i18n.ts",
+            "src/i18n.js",
+        ],
+        localeGlobs: [
+            "messages/*.json",
+            "messages/*/*.json",
+            "locales/*.json",
+            "locales/*/*.json",
+            "src/messages/*.json",
+            "src/locales/*.json",
+        ],
+        configPattern: /next-intl|createNextIntlPlugin|NextIntlClientProvider/,
+    },
+    i18next: {
+        configFiles: [
+            "i18n.js",
+            "i18n.ts",
+            "i18next.config.js",
+            "i18next.config.ts",
+            "next-i18next.config.js",
+            "src/i18n/index.ts",
+            "src/i18n/index.js",
+        ],
+        localeGlobs: [
+            "public/locales/*/*.json",
+            "locales/*/*.json",
+            "src/locales/*/*.json",
+            "translations/*/*.json",
+        ],
+        configPattern: /i18next|next-i18next|react-i18next/,
+    },
+    "react-intl": {
+        configFiles: ["src/i18n/index.ts", "src/i18n/index.js", "src/i18n.ts"],
+        localeGlobs: [
+            "src/lang/*.json",
+            "src/locales/*.json",
+            "lang/*.json",
+            "compiled-lang/*.json",
+        ],
+        configPattern: /react-intl|IntlProvider|formatMessage/,
+    },
+    generic: {
+        configFiles: [],
+        localeGlobs: [
+            "locales/*.json",
+            "translations/*.json",
+            "i18n/*.json",
+            "lang/*.json",
+            "messages/*.json",
+            "src/locales/*.json",
+            "src/translations/*.json",
+            "src/i18n/*.json",
+            "public/locales/*.json",
+        ],
+    },
+};
+/**
+ * Common language codes
+ */
+export const COMMON_LANGUAGE_CODES = [
+    "en",
+    "de",
+    "fr",
+    "es",
+    "it",
+    "pt",
+    "nl",
+    "pl",
+    "ru",
+    "ja",
+    "ko",
+    "zh",
+    "ar",
+    "hi",
+    "tr",
+    "sv",
+    "da",
+    "no",
+    "fi",
+    "cs",
+    "hu",
+    "ro",
+    "bg",
+    "uk",
+    "he",
+    "th",
+    "vi",
+    "id",
+    "ms",
+    "el",
+    "sk",
+    "hr",
+    "sl",
+    "lt",
+    "lv",
+    "et",
+    // With regions
+    "en-US",
+    "en-GB",
+    "en-AU",
+    "pt-BR",
+    "pt-PT",
+    "zh-CN",
+    "zh-TW",
+    "es-ES",
+    "es-MX",
+    "fr-FR",
+    "fr-CA",
+    "de-DE",
+    "de-AT",
+    "de-CH",
+];
+/**
+ * Check if a string looks like a language code
+ */
+export function isLikelyLanguageCode(str) {
+    // Check exact match first
+    if (COMMON_LANGUAGE_CODES.includes(str)) {
+        return true;
+    }
+    // Check pattern: 2 lowercase letters, optionally followed by - and more
+    return /^[a-z]{2}(-[A-Z]{2})?$/.test(str);
+}
+//# sourceMappingURL=patterns.js.map

package/dist/locale-detection/patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.js","sourceRoot":"","sources":["../../src/locale-detection/patterns.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,MAAM,CAAC,MAAM,kBAAkB,GAAqC;IAClE,WAAW,EAAE;QACX,WAAW,EAAE;YACX,gBAAgB;YAChB,iBAAiB;YACjB,gBAAgB;YAChB,SAAS;YACT,SAAS;YACT,aAAa;YACb,aAAa;SACd;QACD,WAAW,EAAE;YACX,iBAAiB;YACjB,mBAAmB;YACnB,gBAAgB;YAChB,kBAAkB;YAClB,qBAAqB;YACrB,oBAAoB;SACrB;QACD,aAAa,EAAE,uDAAuD;KACvE;IACD,OAAO,EAAE;QACP,WAAW,EAAE;YACX,SAAS;YACT,SAAS;YACT,mBAAmB;YACnB,mBAAmB;YACnB,wBAAwB;YACxB,mBAAmB;YACnB,mBAAmB;SACpB;QACD,WAAW,EAAE;YACX,yBAAyB;YACzB,kBAAkB;YAClB,sBAAsB;YACtB,uBAAuB;SACxB;QACD,aAAa,EAAE,oCAAoC;KACpD;IACD,YAAY,EAAE;QACZ,WAAW,EAAE,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,aAAa,CAAC;QACtE,WAAW,EAAE;YACX,iBAAiB;YACjB,oBAAoB;YACpB,aAAa;YACb,sBAAsB;SACvB;QACD,aAAa,EAAE,uCAAuC;KACvD;IACD,OAAO,EAAE;QACP,WAAW,EAAE,EAAE;QACf,WAAW,EAAE;YACX,gBAAgB;YAChB,qBAAqB;YACrB,aAAa;YACb,aAAa;YACb,iBAAiB;YACjB,oBAAoB;YACpB,yBAAyB;YACzB,iBAAiB;YACjB,uBAAuB;SACxB;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,eAAe;IACf,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;CACR,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,0BAA0B;IAC1B,IAAI,qBAAqB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,wEAAwE;IACxE,OAAO,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP Server setup for LangAPI
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Create and configure the MCP server
+ */
+export declare function createServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAaxC"}

package/dist/server.js

@@ -0,0 +1,24 @@
+/**
+ * MCP Server setup for LangAPI
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerListLocalLocales } from "./tools/list-local-locales.js";
+import { registerGetTranslationStatus } from "./tools/get-translation-status.js";
+import { registerSyncTranslations } from "./tools/sync-translations.js";
+import { registerGetDiff } from "./tools/get-diff.js";
+/**
+ * Create and configure the MCP server
+ */
+export function createServer() {
+    const server = new McpServer({
+        name: "langapi-mcp-server",
+        version: "1.0.0",
+    });
+    // Register all tools
+    registerListLocalLocales(server);
+    registerGetTranslationStatus(server);
+    registerSyncTranslations(server);
+    registerGetDiff(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,qBAAqB;IACrB,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/get-diff.d.ts

@@ -0,0 +1,23 @@
+/**
+ * get_diff MCP Tool
+ * Compare source locale against sync cache to identify new/changed/removed keys
+ */
+import { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+declare const GetDiffSchema: z.ZodObject<{
+    source_lang: z.ZodString;
+    project_path: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    source_lang: string;
+    project_path?: string | undefined;
+}, {
+    source_lang: string;
+    project_path?: string | undefined;
+}>;
+export type GetDiffInput = z.infer<typeof GetDiffSchema>;
+/**
+ * Register the get_diff tool with the MCP server
+ */
+export declare function registerGetDiff(server: McpServer): void;
+export {};
+//# sourceMappingURL=get-diff.d.ts.map

package/dist/tools/get-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-diff.d.ts","sourceRoot":"","sources":["../../src/tools/get-diff.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,QAAA,MAAM,aAAa;;;;;;;;;EAMjB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAuCzD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiFvD"}

package/dist/tools/get-diff.js

@@ -0,0 +1,88 @@
+/**
+ * get_diff MCP Tool
+ * Compare source locale against sync cache to identify new/changed/removed keys
+ */
+import { z } from "zod";
+import { readFile } from "fs/promises";
+import { detectLocales } from "../locale-detection/index.js";
+import { flattenJson, parseJsonSafe } from "../utils/json-parser.js";
+import { languageCodeSchema } from "../utils/validation.js";
+import { readSyncCache, getFullDiff } from "../utils/sync-cache.js";
+// Input schema
+const GetDiffSchema = z.object({
+    source_lang: languageCodeSchema.describe("Source language code (e.g., 'en', 'pt-BR')"),
+    project_path: z
+        .string()
+        .optional()
+        .describe("Root path of the project. Defaults to current working directory."),
+});
+/**
+ * Register the get_diff tool with the MCP server
+ */
+export function registerGetDiff(server) {
+    server.tool("get_diff", "Compare current source locale content against the sync cache to see what's new, changed, unchanged, or removed since the last sync.", GetDiffSchema.shape, async (args) => {
+        const input = GetDiffSchema.parse(args);
+        const projectPath = input.project_path || process.cwd();
+        // Detect locales
+        const detection = await detectLocales(projectPath, false);
+        // Find source locale
+        const sourceLocale = detection.locales.find((l) => l.lang === input.source_lang);
+        if (!sourceLocale) {
+            const output = {
+                success: false,
+                error: {
+                    code: "SOURCE_NOT_FOUND",
+                    message: `Source language '${input.source_lang}' not found in project`,
+                },
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+            };
+        }
+        // Read and parse source files
+        const sourceContent = {};
+        for (const file of sourceLocale.files) {
+            const content = await readFile(file.path, "utf-8");
+            const parsed = parseJsonSafe(content);
+            if (parsed) {
+                Object.assign(sourceContent, parsed);
+            }
+        }
+        // Flatten source content
+        const flatContent = flattenJson(sourceContent);
+        // Read cache
+        const cachedContent = await readSyncCache(projectPath, input.source_lang);
+        // Get full diff
+        const diff = getFullDiff(flatContent, cachedContent);
+        const totalCached = cachedContent ? Object.keys(cachedContent).length : 0;
+        const output = {
+            success: true,
+            cache_exists: cachedContent !== null,
+            diff: {
+                new_keys: diff.newKeys,
+                changed_keys: diff.changedKeys.map((c) => ({
+                    key: c.key,
+                    old_value: c.oldValue,
+                    new_value: c.newValue,
+                })),
+                unchanged_keys: diff.unchangedKeys,
+                removed_keys: diff.removedKeys,
+            },
+            summary: {
+                total_current: flatContent.length,
+                total_cached: totalCached,
+                new_count: diff.newKeys.length,
+                changed_count: diff.changedKeys.length,
+                unchanged_count: diff.unchangedKeys.length,
+                removed_count: diff.removedKeys.length,
+            },
+            message: cachedContent
+                ? `Found ${diff.newKeys.length} new, ${diff.changedKeys.length} changed, ${diff.unchangedKeys.length} unchanged, ${diff.removedKeys.length} removed keys.`
+                : `No sync cache found. All ${flatContent.length} keys will be treated as new on first sync.`,
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=get-diff.js.map

package/dist/tools/get-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-diff.js","sourceRoot":"","sources":["../../src/tools/get-diff.ts"],"names":[],"mappings":"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"}

package/dist/tools/get-translation-status.d.ts

@@ -0,0 +1,47 @@
+/**
+ * get_translation_status MCP Tool
+ * Compare source locale against targets to identify missing/outdated keys
+ */
+import { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+declare const GetTranslationStatusSchema: z.ZodObject<{
+    source_lang: z.ZodString;
+    target_langs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    project_path: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    source_lang: string;
+    project_path?: string | undefined;
+    target_langs?: string[] | undefined;
+}, {
+    source_lang: string;
+    project_path?: string | undefined;
+    target_langs?: string[] | undefined;
+}>;
+export type GetTranslationStatusInput = z.infer<typeof GetTranslationStatusSchema>;
+interface TargetStatus {
+    lang: string;
+    status: "synced" | "outdated" | "missing";
+    keys: {
+        total: number;
+        missing: string[];
+        extra: string[];
+    };
+}
+interface CostEstimate {
+    words_to_translate: number;
+    credits_required: number;
+    current_balance?: number;
+    balance_after_sync?: number;
+}
+export interface GetTranslationStatusOutput {
+    source_lang: string;
+    source_keys: number;
+    targets: TargetStatus[];
+    cost_estimate: CostEstimate | null;
+}
+/**
+ * Register the get_translation_status tool with the MCP server
+ */
+export declare function registerGetTranslationStatus(server: McpServer): void;
+export {};
+//# sourceMappingURL=get-translation-status.d.ts.map

package/dist/tools/get-translation-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-translation-status.d.ts","sourceRoot":"","sources":["../../src/tools/get-translation-status.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,QAAA,MAAM,0BAA0B;;;;;;;;;;;;EAY9B,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAGnF,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAC1C,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH;AAED,UAAU,YAAY;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,aAAa,EAAE,YAAY,GAAG,IAAI,CAAC;CACpC;AAkBD;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwKpE"}

package/dist/tools/get-translation-status.js

@@ -0,0 +1,176 @@
+/**
+ * get_translation_status MCP Tool
+ * Compare source locale against targets to identify missing/outdated keys
+ */
+import { z } from "zod";
+import { readFile } from "fs/promises";
+import { detectLocales } from "../locale-detection/index.js";
+import { getAllKeys, parseJsonSafe, flattenJson } from "../utils/json-parser.js";
+import { LangAPIClient } from "../api/client.js";
+import { languageCodeSchema } from "../utils/validation.js";
+// Input schema
+const GetTranslationStatusSchema = z.object({
+    source_lang: languageCodeSchema.describe("Source language code (e.g., 'en', 'pt-BR')"),
+    target_langs: z
+        .array(languageCodeSchema)
+        .optional()
+        .describe("Target language codes. If not provided, all detected locales except source will be used."),
+    project_path: z
+        .string()
+        .optional()
+        .describe("Root path of the project. Defaults to current working directory."),
+});
+/**
+ * Count words in translation values (excluding template variables)
+ */
+function countWords(text) {
+    // Remove template variables like {{name}}, {count}, %s, %d, ${var}
+    const cleaned = text
+        .replace(/\{\{[^}]+\}\}/g, "")
+        .replace(/\{[^}]+\}/g, "")
+        .replace(/%[sd]/g, "")
+        .replace(/\$\{[^}]+\}/g, "");
+    // Count words
+    const words = cleaned.trim().split(/\s+/).filter((w) => w.length > 0);
+    return words.length;
+}
+/**
+ * Register the get_translation_status tool with the MCP server
+ */
+export function registerGetTranslationStatus(server) {
+    server.tool("get_translation_status", "Compare source locale against target locales to identify missing/outdated keys and estimate translation costs.", GetTranslationStatusSchema.shape, async (args) => {
+        const input = GetTranslationStatusSchema.parse(args);
+        const projectPath = input.project_path || process.cwd();
+        // Detect locales
+        const detection = await detectLocales(projectPath, true);
+        // Find source locale
+        const sourceLocale = detection.locales.find((l) => l.lang === input.source_lang);
+        if (!sourceLocale) {
+            throw new Error(`Source language '${input.source_lang}' not found in project`);
+        }
+        // Read and parse source files
+        const sourceContent = {};
+        for (const file of sourceLocale.files) {
+            const content = await readFile(file.path, "utf-8");
+            const parsed = parseJsonSafe(content);
+            if (parsed) {
+                Object.assign(sourceContent, parsed);
+            }
+        }
+        const sourceKeys = getAllKeys(sourceContent);
+        const sourceKeySet = new Set(sourceKeys);
+        // Determine target languages
+        let targetLangs = input.target_langs;
+        if (!targetLangs || targetLangs.length === 0) {
+            targetLangs = detection.locales
+                .filter((l) => l.lang !== input.source_lang)
+                .map((l) => l.lang);
+        }
+        // Compare with each target
+        const targets = [];
+        let totalMissingKeys = [];
+        for (const targetLang of targetLangs) {
+            const targetLocale = detection.locales.find((l) => l.lang === targetLang);
+            if (!targetLocale) {
+                // Target language doesn't exist
+                targets.push({
+                    lang: targetLang,
+                    status: "missing",
+                    keys: {
+                        total: 0,
+                        missing: sourceKeys,
+                        extra: [],
+                    },
+                });
+                totalMissingKeys.push(...sourceKeys);
+                continue;
+            }
+            // Read and parse target files
+            const targetContent = {};
+            for (const file of targetLocale.files) {
+                try {
+                    const content = await readFile(file.path, "utf-8");
+                    const parsed = parseJsonSafe(content);
+                    if (parsed) {
+                        Object.assign(targetContent, parsed);
+                    }
+                }
+                catch {
+                    // Ignore read errors
+                }
+            }
+            const targetKeys = getAllKeys(targetContent);
+            const targetKeySet = new Set(targetKeys);
+            // Find missing and extra keys
+            const missing = sourceKeys.filter((k) => !targetKeySet.has(k));
+            const extra = targetKeys.filter((k) => !sourceKeySet.has(k));
+            const status = missing.length === 0 && extra.length === 0
+                ? "synced"
+                : missing.length > 0
+                    ? "outdated"
+                    : "synced";
+            targets.push({
+                lang: targetLang,
+                status,
+                keys: {
+                    total: targetKeys.length,
+                    missing,
+                    extra,
+                },
+            });
+            totalMissingKeys.push(...missing);
+        }
+        // Estimate cost locally
+        let costEstimate = null;
+        // Calculate words to translate from source content
+        const flatSource = flattenJson(sourceContent);
+        const missingKeySet = new Set(totalMissingKeys);
+        const itemsToTranslate = flatSource.filter((item) => missingKeySet.has(item.key));
+        const wordsToTranslate = itemsToTranslate.reduce((sum, item) => sum + countWords(item.value), 0);
+        // credits = words * number of target languages
+        const creditsRequired = wordsToTranslate * targetLangs.length;
+        costEstimate = {
+            words_to_translate: wordsToTranslate,
+            credits_required: creditsRequired,
+        };
+        // Get accurate estimate from server if API key is configured
+        if (LangAPIClient.canCreate()) {
+            try {
+                const client = LangAPIClient.create();
+                const response = await client.sync({
+                    source_lang: input.source_lang,
+                    target_langs: targetLangs,
+                    content: flatSource,
+                    dry_run: true,
+                });
+                if (response.success && "delta" in response) {
+                    // This is a SyncDryRunResponse
+                    costEstimate = {
+                        words_to_translate: response.cost.wordsToTranslate,
+                        credits_required: response.cost.creditsRequired,
+                        current_balance: response.cost.currentBalance,
+                        balance_after_sync: response.cost.balanceAfterSync,
+                    };
+                }
+            }
+            catch {
+                // Fall back to local estimate
+            }
+        }
+        const output = {
+            source_lang: input.source_lang,
+            source_keys: sourceKeys.length,
+            targets,
+            cost_estimate: costEstimate,
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(output, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=get-translation-status.js.map

package/dist/tools/get-translation-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-translation-status.js","sourceRoot":"","sources":["../../src/tools/get-translation-status.ts"],"names":[],"mappings":"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"}

package/dist/tools/list-local-locales.d.ts

@@ -0,0 +1,39 @@
+/**
+ * list_local_locales MCP Tool
+ * Scans project for locale JSON files and detects i18n framework
+ */
+import { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+declare const ListLocalLocalesSchema: z.ZodObject<{
+    project_path: z.ZodOptional<z.ZodString>;
+    include_key_count: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    include_key_count: boolean;
+    project_path?: string | undefined;
+}, {
+    project_path?: string | undefined;
+    include_key_count?: boolean | undefined;
+}>;
+export type ListLocalLocalesInput = z.infer<typeof ListLocalLocalesSchema>;
+export interface ListLocalLocalesOutput {
+    framework: string;
+    confidence: "high" | "medium" | "low";
+    source_lang: string | null;
+    locales_path: string | null;
+    locales: Array<{
+        lang: string;
+        files: Array<{
+            path: string;
+            namespace: string | null;
+            key_count: number;
+        }>;
+        total_keys: number;
+    }>;
+    config_file: string | null;
+}
+/**
+ * Register the list_local_locales tool with the MCP server
+ */
+export declare function registerListLocalLocales(server: McpServer): void;
+export {};
+//# sourceMappingURL=list-local-locales.d.ts.map

package/dist/tools/list-local-locales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-local-locales.d.ts","sourceRoot":"","sources":["../../src/tools/list-local-locales.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,QAAA,MAAM,sBAAsB;;;;;;;;;EAW1B,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAG3E,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,KAAK,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;YACzB,SAAS,EAAE,MAAM,CAAC;SACnB,CAAC,CAAC;QACH,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsChE"}

package/dist/tools/list-local-locales.js

@@ -0,0 +1,52 @@
+/**
+ * list_local_locales MCP Tool
+ * Scans project for locale JSON files and detects i18n framework
+ */
+import { z } from "zod";
+import { detectLocales } from "../locale-detection/index.js";
+// Input schema
+const ListLocalLocalesSchema = z.object({
+    project_path: z
+        .string()
+        .optional()
+        .describe("Root path of the project to scan. Defaults to current working directory."),
+    include_key_count: z
+        .boolean()
+        .default(true)
+        .describe("Whether to count keys in each locale file"),
+});
+/**
+ * Register the list_local_locales tool with the MCP server
+ */
+export function registerListLocalLocales(server) {
+    server.tool("list_local_locales", "Scan project for locale JSON files, detect i18n framework (next-intl, i18next, react-intl, generic), and return structured information about available translations.", ListLocalLocalesSchema.shape, async (args) => {
+        const input = ListLocalLocalesSchema.parse(args);
+        const projectPath = input.project_path || process.cwd();
+        const result = await detectLocales(projectPath, input.include_key_count);
+        const output = {
+            framework: result.framework,
+            confidence: result.confidence,
+            source_lang: result.sourceLang,
+            locales_path: result.localesPath,
+            locales: result.locales.map((locale) => ({
+                lang: locale.lang,
+                files: locale.files.map((file) => ({
+                    path: file.relativePath,
+                    namespace: file.namespace,
+                    key_count: file.keyCount,
+                })),
+                total_keys: locale.totalKeys,
+            })),
+            config_file: result.configFile,
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(output, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=list-local-locales.js.map

package/dist/tools/list-local-locales.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-local-locales.js","sourceRoot":"","sources":["../../src/tools/list-local-locales.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,eAAe;AACf,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,0EAA0E,CAC3E;IACH,iBAAiB,EAAE,CAAC;SACjB,OAAO,EAAE;SACT,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,2CAA2C,CAAC;CACzD,CAAC,CAAC;AAsBH;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,sKAAsK,EACtK,sBAAsB,CAAC,KAAK,EAC5B,KAAK,EAAE,IAAI,EAA+D,EAAE;QAC1E,MAAM,KAAK,GAAG,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,WAAW,GAAG,KAAK,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAExD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAEzE,MAAM,MAAM,GAA2B;YACrC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,WAAW,EAAE,MAAM,CAAC,UAAU;YAC9B,YAAY,EAAE,MAAM,CAAC,WAAW;YAChC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBACvC,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;oBACjC,IAAI,EAAE,IAAI,CAAC,YAAY;oBACvB,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,SAAS,EAAE,IAAI,CAAC,QAAQ;iBACzB,CAAC,CAAC;gBACH,UAAU,EAAE,MAAM,CAAC,SAAS;aAC7B,CAAC,CAAC;YACH,WAAW,EAAE,MAAM,CAAC,UAAU;SAC/B,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}