@sonenta/mcp

@sonenta/mcp

Model Context Protocol server for Sonenta translation management — pure TypeScript, no Python, no uv, no bundled wheel. Runs on Node ≥18.

Wires Claude Desktop and other MCP clients into your Sonenta project's keys, translations, accessibility surfaces, source-health, and glossary tools — plus agent-observability tools (session_start / annotate / human_needed / session_end) that surface an agent's run as a live, timestamped thread in the Sonenta dashboard, and prompt-library reads (list_prompts / resolve_prompt) so agents can discover and reuse the project's curated prompts. propose_translation(s) carry ICU/CLDR plural_forms, and plural_categories returns the plural categories a language requires (babel-authoritative).

The launcher sends agent-identity headers on every request — X-Agent-Name / X-Agent-Type / X-Agent-Version (from SONENTA_AGENT_NAME / SONENTA_AGENT_TYPE / SONENTA_AGENT_VERSION, all optional) — so the backend can auto-open a live observability session even for agents that never call session_start. X-MCP-Session-Id is a per-process run id before session_start (the backend opens then adopts a single coarse session on it), then the returned session id (echoed), reverting to the run id after session_end — so each subagent's captured mutations route to its own session and concurrent subagents stay distinct.

Use

Auto-wired by sonenta init / sonenta agents add. Manual .mcp.json:

{
  "mcpServers": {
    "verbumia": {
      "command": "npx",
      "args": ["-y", "@sonenta/mcp"],
      "env": { "SONENTA_API_KEY": "<mcp:* key>", "SONENTA_PROJECTS": "<uuid,…>" }
    }
  }
}

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).