MCP

Official

by sonenta

MCP server for Sonenta translation management: keys, translations, a11y, and source-health tools.

Install

Configuration

Environment variables

SONENTA_API_KEYsecret

Sonenta API key (mcp:* scope). If omitted, the server reads it from ~/.sonenta/credentials (run `sonenta login`). Legacy SONENTA_TOKEN / VERBUMIA_API_KEY / VERBUMIA_TOKEN are also accepted.

SONENTA_API_BASEdefault https://api.sonenta.dev

API host. Defaults to https://api.sonenta.dev.

SONENTA_PROJECTS

Comma-separated project UUIDs to scope the server to. Optional; use SONENTA_PROJECT for a single project.

SONENTA_AGENT_NAME

Optional agent identity — a short run name that groups this session's work in the Sonenta dashboard.

SONENTA_AGENT_TYPE

Optional agent identity — the agent kind (e.g. sonenta-i18n, sonenta-a11y).

SONENTA_AGENT_VERSION

Optional agent identity — the agent version. Defaults to the server's own version when unset.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sonenta/mcp@0.44.0"
      ],
      "env": {
        "SONENTA_API_KEY": "<YOUR_SONENTA_API_KEY>",
        "SONENTA_API_BASE": "https://api.sonenta.dev",
        "SONENTA_PROJECTS": "<YOUR_SONENTA_PROJECTS>",
        "SONENTA_AGENT_NAME": "<YOUR_SONENTA_AGENT_NAME>",
        "SONENTA_AGENT_TYPE": "<YOUR_SONENTA_AGENT_TYPE>",
        "SONENTA_AGENT_VERSION": "<YOUR_SONENTA_AGENT_VERSION>"
      }
    }
  }
}