Skip to content
Sonenta

How it works

From prompt to release, without leaving your editor.

Your keys live in Sonenta. Your coding agent reads and writes them over MCP. The CDN delivers them to your apps. Here are the four steps, with the real code.

The whole path

  1. Your repository
  2. Your agent
  3. MCP
  4. Sonenta
  5. CDN
  6. Your apps

1. Install the SDK

One package per framework. Keys called without a translation show up in the dashboard during development, with nothing for you to instrument.

# React (web)
npm i @sonenta/react-i18next

# Next.js · Vue · Svelte · Astro
npm i @sonenta/next
npm i @sonenta/vue-i18n
npm i @sonenta/svelte-i18n
npm i @sonenta/astro

2. Wire up the agent

sonenta init writes the project configuration and a block into CLAUDE.md or AGENTS.md. The MCP server is then declared in your client, in five lines of JSON. The same block works for Claude Code, Cursor and Claude Desktop.

{
  "mcpServers": {
    "sonenta": {
      "command": "npx",
      "args": ["-y", "@sonenta/mcp"],
      "env": {
        "SONENTA_API_KEY": "snt_live_<prefix>.<secret>",
        "SONENTA_PROJECTS": "<uuid1>,<uuid2>"
      }
    }
  }
}
MCP

3. Let the agent translate

You describe the intent. The agent picks its tools, reads the glossary and the context, handles only untranslated keys, and proposes. It runs on your machine: the everyday flow spends no credits.

Tool trace, an example

list_untranslated_keys  namespace=checkout  language_code=es
glossary_list · project_context_get
propose_translations_bulk
publish_cdn

4. Publish

A release builds one JSON per language and namespace, and the CDN serves it. Your apps load the new bundle with no redeploy, and with no trip through the stores on mobile.

# depuis la CLI
sonenta releases

# ou depuis l'agent, via MCP
publish_cdn
CLI

What stays with you

  • Your application code.
  • The agent, running on your machine.
  • Your API keys and your choice of model.

What Sonenta keeps

  • Keys and translations.
  • The glossary and the project context, versioned.
  • Versions and releases.

The five Claude Code agents

sonenta agents add installs specialised agents into your repository. Each one has its own scope and its own documentation page.

What you can leave out

  • The dashboard is optional if you work alone: the CLI and MCP cover the whole flow.
  • The end-user evaluation and in-context editing add-ons are optional and billed separately.
  • Approval before publishing is off by default, and is enabled per project.
Start for free See pricing