@sonenta/mcp 0.21.1 → 0.21.3

package/README.md

@@ -5,7 +5,7 @@ other Model Context Protocol clients into your translation project.
 
 This npm package **bundles the Python MCP server source** (no PyPI
 download). The launcher picks the best Python runtime on your host and
-runs the bundled `verbumia_mcp` directly.
+runs the bundled `sonenta-mcp` directly.
 
 ## Use it from Claude Desktop
 
@@ -48,11 +48,11 @@ become callable from your prompt.
 The npm tarball ships the Python sources under `python/` plus a pre-built
 wheel under `python/dist/`. The Node bin tries these in order:
 
-1. **`uvx --from <bundled_wheel> verbumia-mcp`** — fastest, ephemeral
+1. **`uvx --from <bundled_wheel> sonenta-mcp`** — fastest, ephemeral
    venv. Recommended.
-2. **`uv run --project <bundled_dir> verbumia-mcp`** — uv-managed,
+2. **`uv run --project <bundled_dir> sonenta-mcp`** — uv-managed,
    resolves deps from `pyproject.toml`.
-3. **`pipx run --spec <bundled_wheel> verbumia-mcp`** — pipx-managed.
+3. **`pipx run --spec <bundled_wheel> sonenta-mcp`** — pipx-managed.
 4. **Ad-hoc venv at `~/.sonenta/mcp-venv-<wheelhash>/`** — last-resort
    fallback that requires only `python3 >= 3.12`. Slow first run, fast
    thereafter.
@@ -81,7 +81,7 @@ One of:
 ```bash
 npx -y @sonenta/mcp --self-check
 # -> @sonenta/mcp launchers detected: uvx, uv, python3
-# -> @sonenta/mcp bundled wheel: <node_modules>/.../python/dist/verbumia_mcp-…whl
+# -> @sonenta/mcp bundled wheel: <node_modules>/.../python/dist/sonenta_mcp-…whl
 ```
 
 ## License

package/bin/sonenta-mcp.js

@@ -6,8 +6,8 @@
  * (no PyPI dependency). Spawns it via the first available Python launcher:
  *
  *   1. uvx --from <bundled_wheel>  — fastest, ephemeral venv
- *   2. uv run --project <bundled_dir> verbumia-mcp  — uv-managed
- *   3. pipx run --spec <bundled_wheel> verbumia-mcp  — pipx-managed
+ *   2. uv run --project <bundled_dir> sonenta-mcp  — uv-managed
+ *   3. pipx run --spec <bundled_wheel> sonenta-mcp  — pipx-managed
  *   4. python3 + ad-hoc venv  — last-resort, slowest first run
  *
  * Stdio is fully passthrough so the MCP JSON-RPC framing is preserved.
@@ -40,7 +40,7 @@ function runInherit(cmd, args) {
 
 function tryUvx(passthroughArgs) {
   if (!which("uvx") || !BUNDLED_WHEEL) return false;
-  runInherit("uvx", ["--from", BUNDLED_WHEEL, "verbumia-mcp", ...passthroughArgs]);
+  runInherit("uvx", ["--from", BUNDLED_WHEEL, "sonenta-mcp", ...passthroughArgs]);
   return true;
 }
 
@@ -48,7 +48,7 @@ function tryUvRun(passthroughArgs) {
   if (!which("uv")) return false;
   runInherit(
     "uv",
-    ["run", "--project", BUNDLED_PY_DIR, "verbumia-mcp", ...passthroughArgs],
+    ["run", "--project", BUNDLED_PY_DIR, "sonenta-mcp", ...passthroughArgs],
   );
   return true;
 }
@@ -57,16 +57,16 @@ function tryPipxRun(passthroughArgs) {
   if (!which("pipx") || !BUNDLED_WHEEL) return false;
   runInherit(
     "pipx",
-    ["run", "--spec", BUNDLED_WHEEL, "verbumia-mcp", ...passthroughArgs],
+    ["run", "--spec", BUNDLED_WHEEL, "sonenta-mcp", ...passthroughArgs],
   );
   return true;
 }
 
 /**
  * Last-resort fallback: bootstrap an ad-hoc venv under
- * ~/.verbumia/mcp-venv-<wheelhash> and reuse it on subsequent runs. Slow
+ * ~/.sonenta/mcp-venv-<wheelhash> and reuse it on subsequent runs. Slow
  * first run; subsequent runs reuse the venv (keyed by wheel sha so a
- * future verbumia-mcp version triggers a fresh venv automatically).
+ * future sonenta-mcp version triggers a fresh venv automatically).
  */
 function tryAdhocVenv(passthroughArgs) {
   if (!which("python3") || !BUNDLED_WHEEL) return false;
@@ -75,10 +75,10 @@ function tryAdhocVenv(passthroughArgs) {
     .update(fs.readFileSync(BUNDLED_WHEEL))
     .digest("hex")
     .slice(0, 12);
-  const venvRoot = path.join(os.homedir(), ".verbumia", "mcp-venv-" + wheelHash);
+  const venvRoot = path.join(os.homedir(), ".sonenta", "mcp-venv-" + wheelHash);
   const venvBin = path.join(venvRoot, "bin");
   const venvPy = path.join(venvBin, "python");
-  const venvEntry = path.join(venvBin, "verbumia-mcp");
+  const venvEntry = path.join(venvBin, "sonenta-mcp");
 
   if (!fs.existsSync(venvEntry)) {
     process.stderr.write(

package/package.json

@@ -1,21 +1,20 @@
 {
   "name": "@sonenta/mcp",
-  "version": "0.21.1",
+  "version": "0.21.3",
   "description": "MCP server for Sonenta translation management \u2014 wires Claude Desktop and other MCP clients into your project's keys, missing-key feed, and translation drafts.",
   "license": "MIT",
   "homepage": "https://sonenta.com",
   "repository": {
     "type": "git",
-    "url": "https://github.com/verbumia/verbumia-tools.git",
+    "url": "https://github.com/sonenta/tools.git",
     "directory": "mcp/npm"
   },
   "bugs": {
-    "url": "https://github.com/verbumia/verbumia-tools/issues"
+    "url": "https://github.com/sonenta/tools/issues"
   },
   "keywords": [
     "mcp",
     "sonenta",
-    "verbumia",
     "i18n",
     "translations",
     "claude",
@@ -37,6 +36,6 @@
   ],
   "scripts": {
     "test": "node bin/sonenta-mcp.js --self-check",
-    "prepublishOnly": "cd python && uv build && rm -f dist/verbumia_mcp-*.tar.gz && printf '' > dist/.npmignore"
+    "prepublishOnly": "cd python && uv build && rm -f dist/*.tar.gz && printf '' > dist/.npmignore"
   }
 }

package/python/README.md

@@ -1,6 +1,6 @@
-# Verbumia MCP server
+# Sonenta MCP server
 
-Model Context Protocol server for [Verbumia](https://verbumia.ca) — exposes
+Model Context Protocol server for [Sonenta](https://sonenta.com) — exposes
 your translation project to Claude Desktop and other MCP clients.
 
 ## Status
@@ -33,13 +33,13 @@ the precise scope on the key.
 
 ```bash
 # Recommended (zero-install, used by Claude Desktop's mcp.json):
-npx -y @verbumia/mcp
+npx -y @sonenta/mcp
 
 # Or from PyPI:
-pipx install verbumia-mcp
+pipx install sonenta-mcp
 ```
 
-A Homebrew tap (`brew install verbumia/tap/verbumia-mcp`) is coming once we
+A Homebrew tap (`brew install sonenta/tap/sonenta-mcp`) is coming once we
 publish to npm.
 
 ## Configure (Claude Desktop)
@@ -51,13 +51,13 @@ Single-project setup:
 ```json
 {
   "mcpServers": {
-    "verbumia": {
+    "sonenta": {
       "command": "npx",
-      "args": ["-y", "@verbumia/mcp"],
+      "args": ["-y", "@sonenta/mcp"],
       "env": {
-        "VERBUMIA_API_KEY": "vrb_live_<prefix>.<secret>",
-        "VERBUMIA_PROJECTS": "<project_uuid>",
-        "VERBUMIA_BASE_URL": "https://api.verbumia.dev"
+        "SONENTA_API_KEY": "vrb_live_<prefix>.<secret>",
+        "SONENTA_PROJECTS": "<project_uuid>",
+        "SONENTA_BASE_URL": "https://api.sonenta.com"
       }
     }
   }
@@ -69,8 +69,8 @@ Multi-project setup (v0.11+) — comma-separate the UUIDs and Claude will pass
 
 ```json
 "env": {
-  "VERBUMIA_API_KEY": "vrb_live_<prefix>.<secret>",
-  "VERBUMIA_PROJECTS": "01993a..,01993b..,01993c.."
+  "SONENTA_API_KEY": "vrb_live_<prefix>.<secret>",
+  "SONENTA_PROJECTS": "01993a..,01993b..,01993c.."
 }
 ```
 
@@ -80,10 +80,15 @@ Restart Claude Desktop. Tools show up in the prompt UI.
 
 | Variable             | Required | Default                        | Description                                                                                |
 |----------------------|----------|--------------------------------|--------------------------------------------------------------------------------------------|
-| `VERBUMIA_API_KEY`   | yes      |                                | API key from Org Settings → API Keys (`VERBUMIA_TOKEN` also accepted, back-compat)         |
-| `VERBUMIA_PROJECTS`  | no       | (LLM passes per call)          | CSV of project UUIDs. When >1, the LLM MUST pass `project_uuid` on each tool call.         |
-| `VERBUMIA_PROJECT`   | no       | (legacy)                       | Singular fallback for v0.10.x users. Ignored when `VERBUMIA_PROJECTS` is set (warns).      |
-| `VERBUMIA_BASE_URL`  | no       | `https://api.verbumia.dev`      | Override for self-host or staging (`VERBUMIA_API_BASE` also accepted, back-compat)         |
+| `SONENTA_API_KEY`   | yes      |                                | API key from Org Settings → API Keys (`SONENTA_TOKEN` also accepted, back-compat)         |
+| `SONENTA_PROJECTS`  | no       | (LLM passes per call)          | CSV of project UUIDs. When >1, the LLM MUST pass `project_uuid` on each tool call.         |
+| `SONENTA_PROJECT`   | no       | (legacy)                       | Singular fallback for v0.10.x users. Ignored when `SONENTA_PROJECTS` is set (warns).      |
+| `SONENTA_BASE_URL`  | no       | `https://api.sonenta.com`      | Override for self-host or staging (`SONENTA_API_BASE` also accepted, back-compat)         |
+
+> Migrating from `verbumia-mcp`? The legacy `VERBUMIA_API_KEY` / `VERBUMIA_TOKEN`
+> / `VERBUMIA_PROJECTS` / `VERBUMIA_BASE_URL` env vars are still accepted, so
+> existing MCP client configs keep working — switch to the `SONENTA_*` names
+> when convenient.
 
 The token format is `vrb_live_<prefix>.<secret>` and must carry the `mcp:*`
 scope. For the `project_context_*` tools, also grant `project:read` and/or
@@ -92,7 +97,7 @@ above. Treat the token like any other secret — keychain or `.env`, never
 commit.
 
 If your API key is pinned to a single project (its `project_uuid` is set
-server-side), listing additional UUIDs in `VERBUMIA_PROJECTS` will surface
+server-side), listing additional UUIDs in `SONENTA_PROJECTS` will surface
 as a `403 API key is scoped to a different project` from the backend on
 any call targeting one of the others.
 
@@ -101,7 +106,7 @@ any call targeting one of the others.
 ```bash
 cd mcp
 uv sync
-uv run verbumia-mcp        # stdio transport — pipe MCP frames over stdin/stdout
+uv run sonenta-mcp        # stdio transport — pipe MCP frames over stdin/stdout
 ```
 
 ## License

package/python/pyproject.toml

@@ -1,12 +1,12 @@
 [project]
-name = "verbumia-mcp"
-version = "0.21.1"
-description = "Model Context Protocol server for Verbumia — list projects, missing keys, propose translations from Claude Desktop and other MCP clients."
+name = "sonenta-mcp"
+version = "0.21.3"
+description = "Model Context Protocol server for Sonenta — list projects, missing keys, propose translations from Claude Desktop and other MCP clients."
 readme = "README.md"
 requires-python = ">=3.12,<3.14"
 license = { text = "MIT" }
-authors = [{ name = "Verbumia" }]
-keywords = ["mcp", "verbumia", "i18n", "translations", "claude"]
+authors = [{ name = "Sonenta" }]
+keywords = ["mcp", "sonenta", "i18n", "translations", "claude"]
 classifiers = [
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3.12",
@@ -19,13 +19,13 @@ dependencies = [
 ]
 
 [project.scripts]
-verbumia-mcp = "verbumia_mcp.__main__:main"
+sonenta-mcp = "verbumia_mcp.__main__:main"
 
 [project.urls]
-Homepage = "https://verbumia.ca"
-Documentation = "https://verbumia.ca/docs/mcp/setup"
-Source = "https://github.com/verbumia/verbumia-tools"
-Issues = "https://github.com/verbumia/verbumia-tools/issues"
+Homepage = "https://sonenta.com"
+Documentation = "https://sonenta.com/docs/mcp/setup"
+Source = "https://github.com/sonenta/tools"
+Issues = "https://github.com/sonenta/tools/issues"
 
 [dependency-groups]
 dev = [

package/python/verbumia_mcp/__init__.py

@@ -1,3 +1,3 @@
-"""Verbumia MCP server (MIT)."""
+"""Sonenta MCP server (MIT)."""
 
-__version__ = "0.21.1"
+__version__ = "0.21.3"

package/python/verbumia_mcp/__main__.py

@@ -1,4 +1,4 @@
-"""Entrypoint for `verbumia-mcp` (and `python -m verbumia_mcp`)."""
+"""Entrypoint for `sonenta-mcp` (and `python -m verbumia_mcp`)."""
 
 from __future__ import annotations
 
@@ -15,7 +15,7 @@ def main() -> None:
         sys.exit(130)
     except RuntimeError as exc:
         # Configuration errors (missing token, etc.) — print a friendly hint.
-        print(f"verbumia-mcp: {exc}", file=sys.stderr)
+        print(f"sonenta-mcp: {exc}", file=sys.stderr)
         sys.exit(2)
 
 

package/python/verbumia_mcp/client.py

@@ -1,4 +1,4 @@
-"""Async HTTP client wrapping the Verbumia REST API.
+"""Async HTTP client wrapping the Sonenta REST API.
 
 The MCP tools are thin adapters over this client — they translate MCP
 arguments to API calls and shape the response. Authentication is the
@@ -21,7 +21,7 @@ class VerbumiaApiError(Exception):
     def __init__(self, status: int, body: str | dict[str, Any]) -> None:
         self.status = status
         self.body = body
-        super().__init__(f"Verbumia API error {status}: {body}")
+        super().__init__(f"Sonenta API error {status}: {body}")
 
 
 class VerbumiaClient:

package/python/verbumia_mcp/server.py

@@ -46,20 +46,20 @@ async def _preflight(client: VerbumiaClient) -> None:
     """
     try:
         await client.get("/v1/mcp/projects", params={"limit": 1})
-        _info(f"verbumia-mcp: connected to {client.config.api_base}")
+        _info(f"sonenta-mcp: connected to {client.config.api_base}")
     except VerbumiaApiError as exc:
         if exc.status == 401:
             raise RuntimeError(
-                "SONENTA_API_KEY was rejected (401). Verify the key in Verbumia → "
+                "SONENTA_API_KEY was rejected (401). Verify the key in Sonenta → "
                 "Org Settings → API Keys; new keys are shown once on creation."
             ) from exc
         if exc.status == 403:
             raise RuntimeError(
                 "API key lacks the `mcp:*` scope (403). Issue a key with mcp:* in "
-                "Verbumia → Org Settings → API Keys."
+                "Sonenta → Org Settings → API Keys."
             ) from exc
         raise RuntimeError(
-            f"Verbumia API rejected the connectivity probe ({exc.status}): {exc.body}"
+            f"Sonenta API rejected the connectivity probe ({exc.status}): {exc.body}"
         ) from exc
     except Exception as exc:
         raise RuntimeError(
@@ -70,8 +70,8 @@ async def _preflight(client: VerbumiaClient) -> None:
 
 async def run() -> None:
     config = load_config()
-    _info(f"verbumia-mcp {__version__} starting (api={config.api_base})")
-    server: Server = Server("verbumia")
+    _info(f"sonenta-mcp {__version__} starting (api={config.api_base})")
+    server: Server = Server("sonenta")
 
     async with _client_for(config) as client:
         await _preflight(client)
@@ -81,7 +81,7 @@ async def run() -> None:
                 read_stream,
                 write_stream,
                 InitializationOptions(
-                    server_name="verbumia",
+                    server_name="sonenta",
                     server_version=__version__,
                     capabilities=ServerCapabilities(tools=ToolsCapability(listChanged=False)),
                 ),

package/python/verbumia_mcp/tools.py

@@ -208,7 +208,7 @@ def register(server: Server, client: VerbumiaClient) -> tuple[Any, Any]:
             Tool(
                 name="list_projects",
                 description=(
-                    "List projects accessible to the configured Verbumia API key. "
+                    "List projects accessible to the configured Sonenta API key. "
                     "Project-scoped keys return a single project; org-scoped keys "
                     "return all projects in the org."
                 ),
@@ -239,6 +239,40 @@ def register(server: Server, client: VerbumiaClient) -> tuple[Any, Any]:
                     "additionalProperties": False,
                 },
             ),
+            Tool(
+                name="distribution_info",
+                description=(
+                    "Get the project's CDN distribution status: the public CDN base "
+                    "URL + bundle URL template, the production version, which "
+                    "(language, namespace) bundles are currently published, and any "
+                    "gaps (bundles not yet published). Use to see what client SDKs "
+                    "can fetch right now."
+                ),
+                inputSchema={
+                    "type": "object",
+                    "properties": {
+                        "project_uuid": {
+                            "type": "string",
+                            "description": "Project UUID. Required when multiple projects are configured (SONENTA_PROJECTS); defaults to the single configured project otherwise.",
+                        }
+                    },
+                    "additionalProperties": False,
+                },
+            ),
+            Tool(
+                name="sonenta_guide",
+                description=(
+                    "Get the Sonenta usage guide: a concise, up-to-date overview of "
+                    "how this Sonenta instance works — core concepts, the translation "
+                    "workflow, how to publish to the CDN, and the available MCP tools. "
+                    "Takes no arguments. Call this first when unsure how to use Sonenta."
+                ),
+                inputSchema={
+                    "type": "object",
+                    "properties": {},
+                    "additionalProperties": False,
+                },
+            ),
             Tool(
                 name="list_keys",
                 description=(
@@ -1814,6 +1848,15 @@ def register(server: Server, client: VerbumiaClient) -> tuple[Any, Any]:
                 project_uuid = _project_uuid(args, client)
                 data = await client.get(f"/v1/mcp/projects/{project_uuid}")
                 return _text(data)
+            if name == "distribution_info":
+                project_uuid = _project_uuid(args, client)
+                data = await client.get(
+                    f"/v1/mcp/projects/{project_uuid}/distribution"
+                )
+                return _text(data)
+            if name == "sonenta_guide":
+                data = await client.get("/v1/mcp/guide")
+                return _text(data)
             if name == "list_keys":
                 project_uuid = _project_uuid(args, client)
                 params = {