@sonenta/mcp 0.21.2 → 0.21.3

package/README.md

@@ -18,7 +18,7 @@ runs the bundled `sonenta-mcp` directly.
       "env": {
         "SONENTA_API_KEY": "vrb_live_<prefix>.<secret>",
         "SONENTA_PROJECTS": "<project_uuid>",
-        "SONENTA_BASE_URL": "https://api.sonenta.dev"
+        "SONENTA_BASE_URL": "https://api.sonenta.com"
       }
     }
   }
@@ -64,7 +64,7 @@ Stdio is fully passthrough so the MCP JSON-RPC framing is preserved.
 | Var                  | Required | Default                     | Notes                                                  |
 |----------------------|----------|-----------------------------|--------------------------------------------------------|
 | `SONENTA_API_KEY`   | yes      |                             | Bearer ApiKey token. `SONENTA_TOKEN` accepted (back-compat) |
-| `SONENTA_BASE_URL`  | no       | `https://api.sonenta.dev`   | Self-host / staging override. `SONENTA_API_BASE` accepted (back-compat) |
+| `SONENTA_BASE_URL`  | no       | `https://api.sonenta.com`   | Self-host / staging override. `SONENTA_API_BASE` accepted (back-compat) |
 | `SONENTA_PROJECTS`  | no       | (LLM picks per call)        | CSV of project UUIDs. When >1, the LLM MUST pass `project_uuid` per call. |
 | `SONENTA_PROJECT`   | no       | (legacy)                    | Singular fallback for v0.10.x users. Ignored when `SONENTA_PROJECTS` is set (warns). |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sonenta/mcp",
-  "version": "0.21.2",
+  "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",

package/python/README.md

@@ -57,7 +57,7 @@ Single-project setup:
       "env": {
         "SONENTA_API_KEY": "vrb_live_<prefix>.<secret>",
         "SONENTA_PROJECTS": "<project_uuid>",
-        "SONENTA_BASE_URL": "https://api.sonenta.dev"
+        "SONENTA_BASE_URL": "https://api.sonenta.com"
       }
     }
   }
@@ -83,7 +83,7 @@ Restart Claude Desktop. Tools show up in the prompt UI.
 | `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.dev`      | Override for self-host or staging (`SONENTA_API_BASE` also accepted, back-compat)         |
+| `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

package/python/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sonenta-mcp"
-version = "0.21.2"
+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"

package/python/verbumia_mcp/__init__.py

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

package/python/verbumia_mcp/config.py

@@ -15,7 +15,7 @@ import os
 import sys
 from dataclasses import dataclass
 
-DEFAULT_API_BASE = "https://api.sonenta.dev"
+DEFAULT_API_BASE = "https://api.sonenta.com"
 
 
 @dataclass(frozen=True)

package/python/verbumia_mcp/tools.py

@@ -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 = {