MCP server

azbox-mcp-server lets a coding agent read your AZbox project without leaving the editor. It works with any MCP client — Claude Code, Cursor, Claude Desktop and others — and is open source (GitHub).

What it is for

Three things an agent editing your code keeps needing, answered from the project instead of guessed:

• “Which key holds ‘Proceed to checkout’ on the cart screen?”
• “What is still untranslated in French?”
• “Before I add checkout.total, is there already a key like it?”

What you need

• Node 18 or newer
• An API key. In the dashboard, open Settings → API keys and create one tied to the project the agent works on. An agent only ever needs to read that project, so there is no reason to give it the rest of the account. Copy the key when it is shown: it cannot be displayed again.

Setup

Claude Code

claude mcp add azbox --env AZBOX_TOKEN=azb_live_… -- npx -y azbox-mcp-server

Cursor

In ~/.cursor/mcp.json:

{
  "mcpServers": {
    "azbox": {
      "command": "npx",
      "args": ["-y", "azbox-mcp-server"],
      "env": { "AZBOX_TOKEN": "azb_live_…" }
    }
  }
}

Claude Desktop

The same block, in claude_desktop_config.json (on macOS, under ~/Library/Application Support/Claude/). Restart the app afterwards.

Any other client

Command npx -y azbox-mcp-server, with the key in the AZBOX_TOKEN environment variable. The server talks over stdio.

Tools

All six are read-only. Nothing this server does can change your project.

Tool	What it answers
azbox_list_projects	Which projects the key can see, and in which languages
azbox_get_project	A project’s name and its valid language codes
azbox_list_categories	How the project is organised
azbox_list_keywords	A page of keys and their translations
azbox_search_keywords	Which key holds this text, or which keys start with checkout.
azbox_find_untranslated	What is still missing in a language

Listings are paginated: they take limit and offset and report total_count, has_more and next_offset. A real project has thousands of keys, and dumping them all would leave the agent no room to work.

What it deliberately does not do

• It does not write. Keys are created in the dashboard or by importing a file.
• It does not translate. Machine translation happens in the dashboard, where you see the result before it ships.

Worth knowing

• The key you use in code is key. The API’s id field is an internal document identifier.
• translation is null when a key has no text yet in the language asked for.
• An empty language is not an error: the tool returns an empty list.
• Keys come back sorted, so repeated calls are stable.

Underneath, it uses the same REST API as the libraries. To also teach the agent how to integrate AZbox into code, add the skill for coding agents.