Which integrations are available for this server?

Provides support for Apple iOS/macOS localization files (.strings, .xcstrings, .stringsdict) for translation management and syncing. Provides support for i18next framework locale files, enabling automatic detection and translation of missing keys via LangAPI.

How do I use @langapi/mcp-server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@@langapi/mcp-server What translation keys are missing in German?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

@langapi/mcp-server

by TedyHub

Overview Schema Related Servers Score Discussions

TypeScript

Local

@langapi/mcp-server

MCP (Model Context Protocol) server for LangAPI - AI-powered translation management for i18n projects.

This package enables AI assistants like Claude, Cursor, and VS Code extensions to manage translations in your project programmatically.

Quick Start

# 1. Get your API key at https://langapi.io (1,000 free credits)

# 2. Add to your AI tool (example for Claude Desktop on macOS):
# Edit ~/Library/Application Support/Claude/claude_desktop_config.json

# 3. Start chatting:
# "Scan my project for translations"
# "What keys are missing in German?"
# "Sync all translations"

Features

Locale Detection: Automatically detect i18n framework (next-intl, i18next, react-intl, iOS/macOS) and locale files
Translation Status: Compare source and target locales to find missing translations
Sync Translations: Translate missing keys via LangAPI with credit-based billing
Dry Run Mode: Preview changes and costs before syncing (enabled by default)
Format Preservation: Maintains JSON formatting when writing translated files
Delta Detection: Only translate new/changed keys, saving up to 90% on costs
Apple Localization: Support for iOS/macOS .strings, .xcstrings, and .stringsdict files

Installation

npm install @langapi/mcp-server

Or use directly with npx (recommended):

npx @langapi/mcp-server

Setup by Tool

Claude Desktop

Config file locations:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Configuration:

{
  "mcpServers": {
    "langapi": {
      "command": "npx",
      "args": ["@langapi/mcp-server"],
      "env": {
        "LANGAPI_API_KEY": "your-api-key-here"
      }
    }
  }
}

After editing, restart Claude Desktop for changes to take effect.

Claude Code (CLI)

Option 1: CLI command (quickest)

# Add to current project (stored in .mcp.json)
claude mcp add langapi \
  --env LANGAPI_API_KEY=your-api-key-here \
  -- npx -y @langapi/mcp-server

Option 2: Project-level config (recommended for teams)

Create .mcp.json in your project root:

{
  "mcpServers": {
    "langapi": {
      "command": "npx",
      "args": ["@langapi/mcp-server"],
      "env": {
        "LANGAPI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Option 3: User-level config

Add to ~/.claude.json:

{
  "mcpServers": {
    "langapi": {
      "command": "npx",
      "args": ["@langapi/mcp-server"],
      "env": {
        "LANGAPI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Option 4: Environment variable

export LANGAPI_API_KEY="your-api-key-here"

Then the MCP server will pick it up automatically.

Verify connection:

# List configured servers
claude mcp list

# Check server status inside Claude Code
/mcp

Remove server:

claude mcp remove langapi

Cursor

Config file locations:

Project-level: .cursor/mcp.json in your project root
Global: ~/.cursor/mcp.json

Configuration:

{
  "mcpServers": {
    "langapi": {
      "command": "npx",
      "args": ["@langapi/mcp-server"],
      "env": {
        "LANGAPI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Alternative: Via UI

Open Cursor Settings (Cmd/Ctrl + ,)
Search for "MCP"
Click "Edit in settings.json"
Add the configuration above

VS Code with Cline

Install the Cline extension
Create .vscode/cline_mcp_settings.json in your project:

{
  "mcpServers": {
    "langapi": {
      "command": "npx",
      "args": ["@langapi/mcp-server"],
      "env": {
        "LANGAPI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Reload VS Code window (Cmd/Ctrl + Shift + P > "Reload Window")

VS Code with Roo Code

Install the Roo Code extension
Create .vscode/mcp.json in your project:

{
  "mcpServers": {
    "langapi": {
      "command": "npx",
      "args": ["@langapi/mcp-server"],
      "env": {
        "LANGAPI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Reload VS Code window

Windsurf

Config file: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "langapi": {
      "command": "npx",
      "args": ["@langapi/mcp-server"],
      "env": {
        "LANGAPI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Restart Windsurf after editing.

Environment Variables

Variable	Required	Description
`LANGAPI_API_KEY`	Yes	Your LangAPI API key (get one at langapi.io)
`LANGAPI_API_URL`	No	Custom API URL (default: `https://api.langapi.io`)

MCP Tools

`list_local_locales`

Scan your project for locale JSON files and detect the i18n framework.

Input:

{
  "project_path": "/path/to/project",  // optional, defaults to cwd
  "include_key_count": true            // optional, default: true
}

Output:

{
  "framework": "next-intl",
  "confidence": "high",
  "source_lang": "en",
  "locales_path": "messages",
  "locales": [
    {
      "lang": "en",
      "files": [{ "path": "messages/en.json", "namespace": null, "key_count": 150 }],
      "total_keys": 150
    },
    {
      "lang": "de",
      "files": [{ "path": "messages/de.json", "namespace": null, "key_count": 120 }],
      "total_keys": 120
    }
  ],
  "config_file": "i18n.ts"
}

`get_translation_status`

Compare source locale against targets to identify missing keys and estimate costs.

Input:

{
  "source_lang": "en",
  "target_langs": ["de", "fr"],        // optional, all non-source by default
  "project_path": "/path/to/project"   // optional
}

Output:

{
  "source_lang": "en",
  "source_keys": 150,
  "targets": [
    {
      "lang": "de",
      "status": "outdated",
      "keys": { "total": 120, "missing": ["new.key1", "new.key2"], "extra": [] }
    }
  ],
  "cost_estimate": {
    "words_to_translate": 45,
    "credits_required": 90,
    "current_balance": 1000,
    "balance_after_sync": 910
  }
}

`sync_translations`

Sync translations via the LangAPI API. Default is dry_run=true for safety.

Input:

{
  "source_lang": "en",
  "target_langs": ["de", "fr"],
  "dry_run": true,                     // default: true (preview mode)
  "project_path": "/path/to/project",  // optional
  "write_to_files": true,              // optional, default: true
  "skip_keys": ["key.to.skip"]         // optional, keys to exclude
}

Output (dry_run=true):

{
  "success": true,
  "dry_run": true,
  "delta": {
    "new_keys": ["new.key1", "new.key2"],
    "changed_keys": [],
    "total_keys_to_sync": 2
  },
  "cost": {
    "words_to_translate": 45,
    "credits_required": 90,
    "current_balance": 1000,
    "balance_after_sync": 910
  },
  "message": "Preview: 2 keys to sync, 90 credits required. Run with dry_run=false to execute."
}

Output (dry_run=false):

{
  "success": true,
  "dry_run": false,
  "results": [
    { "language": "de", "translated_count": 2, "file_written": "messages/de.json" },
    { "language": "fr", "translated_count": 2, "file_written": "messages/fr.json" }
  ],
  "cost": {
    "credits_used": 90,
    "balance_after_sync": 1910
  },
  "message": "Sync complete. 4 keys translated across 2 languages. 90 credits used."
}

Prompt Examples

Scanning Your Project

"Scan my project for translations"
"What i18n framework am I using?"
"List all my locale files"
"How many translation keys do I have?"
"What languages are configured in my project?"

Checking Translation Status

"What translations are missing?"
"Compare English to all other languages"
"How many keys need to be translated for French?"
"Which languages are out of sync?"
"Show me the missing keys for German"
"How much will it cost to sync all languages?"

Preview Changes (Dry Run)

"Preview what would happen if I sync all languages"
"Do a dry run for French translations"
"Show me what keys will be translated"
"What's the cost estimate for syncing German?"
"Preview the sync without making changes"

Syncing Translations

"Sync all missing translations"
"Translate to German and French"
"Update all locale files with missing keys"
"Sync translations and write to files"
"Execute the translation sync"

Advanced Operations

"Are there any extra keys in German that aren't in English?"
"Skip the settings.* keys when syncing"
"Only sync the home.* and nav.* keys"
"Sync to Japanese but skip experimental features"

Complete Workflow Example

You: List the translations in my project

Claude: [Calls list_local_locales]
I found a next-intl project with English (150 keys) and German (120 keys) translations.

You: What translations are missing for German?

Claude: [Calls get_translation_status]
German is missing 30 keys. The sync would cost 85 credits (you have 1000 credits).

You: Sync the German translations

Claude: [Calls sync_translations with dry_run=true]
Preview: 30 keys will be translated, costing 85 credits. Should I proceed?

You: Yes, go ahead

Claude: [Calls sync_translations with dry_run=false]
Done! 30 keys translated. German file updated at messages/de.json.

Supported Frameworks

The server automatically detects these i18n frameworks:

Framework	Locale Patterns	Config Files
next-intl	`messages/.json`, `locales/.json`	`i18n.ts`, `next.config.js`
i18next	`public/locales//.json`, `locales//.json`	`i18next.config.js`, `i18n.js`
react-intl	`src/lang/.json`, `lang/.json`	`src/i18n.ts`
iOS/macOS	`.strings`, `.xcstrings`, `.stringsdict`	`Info.plist`
generic	Various common patterns	-

Troubleshooting

"MCP server not found"

Ensure npx is in your PATH
Try running npx @langapi/mcp-server manually to test
On Windows, you may need to use the full path to npx

"API key invalid" or "Unauthorized"

Verify your API key at langapi.io/dashboard
Check for extra spaces or quotes in your config
Ensure the key is set in the env section, not args

"No locale files found"

Check that your locale files match supported patterns (see Frameworks above)
Verify files are valid JSON
Try specifying project_path explicitly

"Permission denied" when writing files

Check file/directory write permissions
On macOS, ensure your terminal has disk access

Server not connecting

Restart your IDE/tool completely (not just reload)
Check the config file syntax (valid JSON?)
Look for error messages in your tool's developer console

Dry run works but execute fails

Check your credit balance at langapi.io
Verify network connectivity to api.langapi.io

Advanced Configuration

Multiple Projects

Use project-level config files (.mcp.json, .cursor/mcp.json) with different API keys per project.

Custom API URL

For self-hosted or enterprise deployments:

{
  "mcpServers": {
    "langapi": {
      "command": "npx",
      "args": ["@langapi/mcp-server"],
      "env": {
        "LANGAPI_API_KEY": "your-api-key",
        "LANGAPI_API_URL": "https://your-api-server.com"
      }
    }
  }
}

Credits & Billing

LangAPI uses a credit-based billing system:

1 credit = 1 word to translate
New users get 1,000 free credits
Top up with 100,000 credits for $15 (no subscription, no expiry)

Get your API key at langapi.io.

License

MIT

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/TedyHub/langapi-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server