@babelize/mcp 1.0.2 → 1.0.4

package/README.md

@@ -88,14 +88,74 @@ Add to `.opencode.json`:
 
 ## Available Tools
 
+### Scanning (no API key required)
+
+| Tool | Description |
+|------|-------------|
+| `babelize_scan` | Scan a local directory for hardcoded strings |
+| `babelize_scan_strings` | Extract translatable strings from a code snippet |
+
+### Projects
+
+| Tool | Description |
+|------|-------------|
+| `babelize_project_list` | List all translation projects |
+| `babelize_project_get` | Get details of a specific project |
+| `babelize_project_create` | Create a new translation project |
+| `babelize_project_language_add` | Add a language to a project |
+| `babelize_project_language_remove` | Remove a language from a project |
+| `babelize_project_sync` | Trigger repository sync |
+| `babelize_project_download` | Download translated project files as ZIP |
+
+### Translation Runs
+
+| Tool | Description |
+|------|-------------|
+| `babelize_run` | Start a translation pipeline run |
+| `babelize_status` | Check status of a translation run |
+| `babelize_babel_list` | List translation runs (babels) |
+| `babelize_babel_get` | Get detailed babel run info and logs |
+
+### Languages
+
+| Tool | Description |
+|------|-------------|
+| `babelize_language_list` | List all supported languages |
+| `babelize_language_codes` | Look up language code mappings (ISO ↔ FLORES-200) |
+
+### Analysis
+
 | Tool | Description |
 |------|-------------|
-| `babelize_scan` | Scan a local directory for hardcoded strings. No API key required. |
-| `babelize_scan_strings` | Extract translatable strings from a code snippet. No API key required. |
-| `babelize_run` | Start a translation pipeline run for target languages. Requires API key. |
-| `babelize_status` | Check the status of a running translation. Requires API key. |
-| `babelize_glossary_get` | List glossary entries for a project. Requires API key. |
-| `babelize_glossary_set` | Add or update terms in the translation glossary. Requires API key. |
+| `babelize_engine_analyze` | Analyze source code for i18n readiness and framework detection |
+
+### Translation Quality
+
+| Tool | Description |
+|------|-------------|
+| `babelize_tm_get` | List translation memory entries for a project |
+| `babelize_tm_set` | Add a translation memory entry |
+| `babelize_tm_export` | Export translation memory as TMX |
+| `babelize_glossary_get` | List glossary entries for a project |
+| `babelize_glossary_set` | Add or update a glossary entry |
+| `babelize_glossary_delete` | Delete a glossary entry |
+| `babelize_glossary_import` | Bulk import glossary entries from CSV |
+| `babelize_glossary_export` | Export glossary entries as CSV |
+
+### Team & Deploy
+
+| Tool | Description |
+|------|-------------|
+| `babelize_member_list` | List project members |
+| `babelize_invitation_send` | Send a team invitation |
+| `babelize_pr_raise` | Create a GitHub Pull Request with translations |
+
+### Account
+
+| Tool | Description |
+|------|-------------|
+| `babelize_me` | Get current user profile and credits |
+| `babelize_provider_tokens_list` | List connected BYOK translation provider tokens |
 
 ## Configuration
 
@@ -113,6 +173,47 @@ The server resolves configuration in this priority order:
 | `--api-url` / `BABELIZE_API_URL` | API base URL | `https://api.babelize.co/api` |
 | `--api-base` | API base path (without `/api` suffix) | — |
 
+## Workflow Examples
+
+### Translate a GitHub project in one command
+
+Ask your AI agent:
+
+> "Translate my-project to French and Spanish."
+
+The agent will:
+1. `babelize_project_list` — find your project
+2. `babelize_project_language_add` — add French + Spanish
+3. `babelize_run_and_wait` — start + wait for completion
+4. `babelize_project_download` — download the translated ZIP
+
+### Translate local code without GitHub
+
+> "Scan my local project and translate it to German."
+
+1. `babelize_scan` — find all hardcoded strings (no API key needed)
+2. `babelize_project_create` — create a project (no GitHub URL)
+3. `babelize_project_language_add` — add German
+4. `babelize_run_and_wait` — translate and wait
+5. `babelize_project_download` — get the translated files
+
+### Check translation quality
+
+> "Review the translation quality for my project."
+
+1. `babelize_tm_get` — check translation memory entries
+2. `babelize_glossary_get` — review glossary for consistent terminology
+3. `babelize_babel_get` — inspect detailed run logs
+4. `babelize_glossary_set` — add missing glossary entries for consistent translations
+
+### Audit i18n readiness
+
+> "Scan my codebase for i18n issues."
+
+1. `babelize_scan` — detect all hardcoded strings (free, no API key)
+2. `babelize_scan_strings` — test specific code snippets for translatable patterns
+3. `babelize_engine_analyze` — analyze framework and i18n library usage
+
 ## Links
 
 - [Website](https://babelize.co)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babelize/mcp",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "MCP (Model Context Protocol) server for Babelize AI-powered i18n — let AI coding agents translate your apps",
   "keywords": [
     "babelize",
@@ -38,12 +38,16 @@
     "prepublishOnly": "npm test && npm run typecheck"
   },
   "dependencies": {
+    "@babel/parser": "^7.28.5",
+    "@babel/traverse": "^7.28.5",
+    "@babel/types": "^7.28.5",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "axios": "^1.15.2",
     "zod": "^3.24.0"
   },
   "devDependencies": {
     "@jest/globals": "^30.2.0",
+    "@types/babel__traverse": "^7.28.0",
     "@types/jest": "^30.0.0",
     "@types/node": "^22.0.0",
     "jest": "^30.2.0",