@sonenta/mcp 0.34.1 → 0.36.0

package/README.md

@@ -1,89 +1,24 @@
 # @sonenta/mcp
 
-MCP server for [Sonenta](https://sonenta.com) — wires Claude Desktop and
-other Model Context Protocol clients into your translation project.
+Model Context Protocol server for **Sonenta** translation management — **pure TypeScript**, no Python, no `uv`, no bundled wheel. Runs on Node ≥18.
 
-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 `sonenta-mcp` directly.
+Wires Claude Desktop and other MCP clients into your Sonenta project's keys, translations, accessibility surfaces, source-health, and glossary tools.
 
-## Use it from Claude Desktop
+## Use
+
+Auto-wired by `sonenta init` / `sonenta agents add`. Manual `.mcp.json`:
 
 ```json
 {
   "mcpServers": {
-    "sonenta": {
+    "verbumia": {
       "command": "npx",
       "args": ["-y", "@sonenta/mcp"],
-      "env": {
-        "SONENTA_API_KEY": "vrb_live_<prefix>.<secret>",
-        "SONENTA_PROJECTS": "<project_uuid>",
-        "SONENTA_BASE_URL": "https://api.sonenta.dev"
-      }
+      "env": { "SONENTA_API_KEY": "<mcp:* key>", "SONENTA_PROJECTS": "<uuid,…>" }
     }
   }
 }
 ```
 
-For **multiple projects** (v0.11+), comma-separate the UUIDs in
-`SONENTA_PROJECTS`. The LLM then has to pass `project_uuid` on every tool
-call:
-
-```json
-"env": {
-  "SONENTA_API_KEY": "vrb_live_<prefix>.<secret>",
-  "SONENTA_PROJECTS": "01993a..,01993b..,01993c.."
-}
-```
-
-Restart Claude Desktop. All thirteen Sonenta tools (`list_projects`,
-`get_project_info`, `list_keys`, `list_untranslated_keys`,
-`list_missing_keys`, `missing_keys_stats`, `acknowledge_missing_keys`,
-`create_key`, `propose_translation`, `publish_cdn`,
-`validate_translations`, `project_context_get`, `project_context_set`)
-become callable from your prompt.
-
-## How the launcher works
-
-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> sonenta-mcp`** — fastest, ephemeral
-   venv. Recommended.
-2. **`uv run --project <bundled_dir> sonenta-mcp`** — uv-managed,
-   resolves deps from `pyproject.toml`.
-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.
-
-Stdio is fully passthrough so the MCP JSON-RPC framing is preserved.
-
-## Environment variables (canonical)
-
-| Var                  | Required | Default                     | Notes                                                  |
-|----------------------|----------|-----------------------------|--------------------------------------------------------|
-| `SONENTA_API_KEY`   | yes*    |                             | Bearer ApiKey token. `SONENTA_TOKEN` accepted (back-compat). *Optional if you ran `sonenta login` — the server reads `~/.sonenta/credentials`. |
-| `SONENTA_BASE_URL`  | no       | `https://api.sonenta.dev`   | 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). |
-
-## Requirements
-
-One of:
-
-- **uv** (recommended, https://docs.astral.sh/uv/)
-- **pipx** (https://pipx.pypa.io/)
-- **python3 >= 3.12** (for the venv fallback)
-
-## Self-check
-
-```bash
-npx -y @sonenta/mcp --self-check
-# -> @sonenta/mcp launchers detected: uvx, uv, python3
-# -> @sonenta/mcp bundled wheel: <node_modules>/.../python/dist/sonenta_mcp-…whl
-```
-
-## License
-
-MIT.
+Env: `SONENTA_API_KEY` / `SONENTA_BASE_URL` (default `https://api.sonenta.dev`) / `SONENTA_PROJECTS`
+(legacy `VERBUMIA_*` accepted). With no key set, the server reads `~/.sonenta/credentials` (from `sonenta login`).