@sonenta/mcp 0.21.3 → 0.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sonenta/mcp",
-  "version": "0.21.3",
+  "version": "0.22.0",
   "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/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sonenta-mcp"
-version = "0.21.3"
+version = "0.22.0"
 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.3"
+__version__ = "0.22.0"

package/python/verbumia_mcp/tools.py

@@ -1535,6 +1535,79 @@ def register(server: Server, client: VerbumiaClient) -> tuple[Any, Any]:
                     "additionalProperties": False,
                 },
             ),
+            Tool(
+                name="recommend_surfaces",
+                description=(
+                    "Read-only per-key A11Y SURFACE RECOMMENDATIONS (#2): for each key, "
+                    "the a11y surfaces implied by its semantic TYPE, derived from the "
+                    "backend's authoritative key.type -> treatment mapping "
+                    "(A11Y_TREATMENTS_BY_TYPE) — the single source of truth; do NOT "
+                    "reimplement the mapping in the client. Returns {project_uuid, "
+                    "version_uuid, active_a11y_surfaces[], keys_scanned, keys_with_gaps, "
+                    "gaps_by_surface{surface:int}, items:[{key_uuid, key_name, "
+                    "namespace_slug, type, base_role (visible_text|alt_text|"
+                    "accessible_name), recommended_surfaces:[{surface, active, "
+                    "present_in_source}], has_gap}]}. A recommended surface that is "
+                    "active && !present_in_source is a config-satisfied GAP to AUTHOR — "
+                    "hand the actual text off to sonenta-a11y (set_a11y_variant), this "
+                    "tool only tells you WHERE. DEVICE surfaces are not included here. "
+                    "Defaults to the production version."
+                ),
+                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.",
+                        },
+                        "version_id": {
+                            "type": "string",
+                            "description": "Optional version UUID; defaults to the production version.",
+                        },
+                        "namespace_id": {
+                            "type": "string",
+                            "description": "Optional namespace UUID to scope the scan.",
+                        },
+                        "key_id": {
+                            "type": "string",
+                            "description": "Optional single key UUID to scope the scan.",
+                        },
+                        "only_gaps": {
+                            "type": "boolean",
+                            "description": "When true, return only keys that have a gap (has_gap=true).",
+                        },
+                    },
+                    "additionalProperties": False,
+                },
+            ),
+            Tool(
+                name="surface_coverage",
+                description=(
+                    "Read-only COVERAGE BY SURFACE (#3): per active surface, how complete "
+                    "it is. Returns {project_uuid, version_uuid, languages[], keys_total, "
+                    "surfaces:[{surface, label, kind, meaning, eligible_keys, "
+                    "eligible_cells, present_cells, pct, by_language:[{code, eligible, "
+                    "present, pct}]}]}. The `meaning` field tells you how to read `pct`: "
+                    "'a11y_completeness' for a11y surfaces (eligible = type-relevant keys; "
+                    "pct = real fill of NEEDED a11y gaps), 'override_density' for device "
+                    "surfaces (un-overridden cells fall back to the base value — that is "
+                    "NOT broken, just un-customized). Defaults to the production version."
+                ),
+                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.",
+                        },
+                        "version_id": {
+                            "type": "string",
+                            "description": "Optional version UUID; defaults to the production version.",
+                        },
+                    },
+                    "additionalProperties": False,
+                },
+            ),
             Tool(
                 name="get_variants",
                 description=(
@@ -2339,6 +2412,29 @@ def register(server: Server, client: VerbumiaClient) -> tuple[Any, Any]:
                     return _err("slug is required")
                 await client.delete(f"/v1/mcp/projects/{project_uuid}/surfaces/{slug}")
                 return _text({"deleted": True, "slug": slug})
+            if name == "recommend_surfaces":
+                project_uuid = _project_uuid(args, client)
+                params: dict[str, Any] = {}
+                for opt in ("version_id", "namespace_id", "key_id"):
+                    if args.get(opt):
+                        params[opt] = args[opt]
+                if args.get("only_gaps"):
+                    params["only_gaps"] = "true"
+                data = await client.get(
+                    f"/v1/mcp/projects/{project_uuid}/recommend-surfaces",
+                    params=params,
+                )
+                return _text(data)
+            if name == "surface_coverage":
+                project_uuid = _project_uuid(args, client)
+                params: dict[str, Any] = {}
+                if args.get("version_id"):
+                    params["version_id"] = args["version_id"]
+                data = await client.get(
+                    f"/v1/mcp/projects/{project_uuid}/surface-coverage",
+                    params=params,
+                )
+                return _text(data)
             if name == "get_variants":
                 project_uuid = _project_uuid(args, client)
                 key_uuid = args.get("key_uuid")