verbumia-mcp 0.10.0

Model Context Protocol server for Verbumia — list projects, missing keys, propose translations from Claude Desktop and other MCP clients.

Verbumia MCP server

Model Context Protocol server for Verbumia — exposes your translation project to Claude Desktop and other MCP clients.

Status

Eleven tools wired: 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.

Install

# Recommended (zero-install, used by Claude Desktop's mcp.json):
npx -y @verbumia/mcp

# Or from PyPI:
pipx install verbumia-mcp

A Homebrew tap (brew install verbumia/tap/verbumia-mcp) is coming once we publish to npm.

Configure (Claude Desktop)

Open Settings → Developer → Edit Config, then:

{
  "mcpServers": {
    "verbumia": {
      "command": "npx",
      "args": ["-y", "@verbumia/mcp"],
      "env": {
        "VERBUMIA_TOKEN": "vrb_live_<prefix>.<secret>",
        "VERBUMIA_PROJECT": "<project_uuid>",
        "VERBUMIA_API_BASE": "https://api.verbumia.ca"
      }
    }
  }
}

Restart Claude Desktop. Tools show up in the prompt UI.

Environment

Variable	Required	Default	Description
VERBUMIA_TOKEN	yes		API key from Org Settings → API Keys
VERBUMIA_PROJECT	no	(LLM passes per call)	Default project context
VERBUMIA_API_BASE	no	https://api.verbumia.ca	Override for self-host or staging

The token format is vrb_live_<prefix>.<secret> and must carry the mcp:* scope. Treat it like any other secret — keychain or .env, never commit.

Local development

cd mcp
uv sync
uv run verbumia-mcp        # stdio transport — pipe MCP frames over stdin/stdout

License

MIT.