@intlpullhq/mcp-server

IntlPull MCP Server

Model Context Protocol (MCP) server for IntlPull - AI-powered internationalization and translation management platform.

Features

• 40+ MCP Tools for complete i18n workflow automation
• AI Translation via IntlPull's backend (Gemini, OpenAI, DeepL - based on your plan)
• Branch Management - Git-like workflow for translation versions
• OTA (Over-The-Air) releases for instant translation updates
• Translation Memory and Glossary support
• Platform Overrides - iOS, Android, Web-specific translations
• Import/Export - JSON, YAML, XLIFF, PO, CSV, Android XML, iOS Strings
• Email Templates - Localized email template management
• Webhooks - CI/CD integration for automated workflows

Quick Start

Installation

npm install -g @intlpullhq/mcp-server
# or
npx @intlpullhq/mcp-server

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "intlpull": {
      "command": "npx",
      "args": ["-y", "@intlpullhq/mcp-server"],
      "env": {
        "INTLPULL_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code Configuration

Add to your project's .mcp.json:

{
  "mcpServers": {
    "intlpull": {
      "command": "npx",
      "args": ["-y", "@intlpullhq/mcp-server"],
      "env": {
        "INTLPULL_API_KEY": "your-api-key"
      }
    }
  }
}

Environment Variables

Variable	Description	Required
INTLPULL_API_KEY	IntlPull API key (get from dashboard)	Yes
INTLPULL_API_URL	Custom API URL (defaults to https://api.intlpull.com)	No
INTLPULL_USE_MOCK	Enable demo mode with mock translations	No

Available Tools

Translation Management

Tool	Description
translate_strings	Translate array of strings with AI
translate_file	Translate entire JSON/YAML files
list_languages	Get supported language codes
get_translation_status	Project translation progress
search_translations	Search across all translations

Branch Management (Git-like Workflow)

Tool	Description
get_branch_info	Current branch and translation strategy
set_branch_strategy	Configure per-branch or merged translations
list_branch_translations	Files specific to current branch
merge_branch_translations	Merge translations between branches

Platform Configuration

Tool	Description
get_platform_info	Current platform settings
set_platform	Set active platform (ios/android/web)
set_platform_override	Platform-specific translation overrides
configure_platform	Platform export format configuration

Import & Export

Tool	Description
import_translations	Import from JSON, YAML, XLIFF, PO, CSV
import_preview	Preview changes before importing
import_history	Recent import operations
download_translations	Export in any supported format

OTA (Over-The-Air) Releases

Tool	Description
publish_ota_release	Publish translations for instant updates
list_ota_releases	View release history
get_ota_manifest	Get manifest for client SDKs
pin_ota_version	Pin clients to specific version
delete_ota_release	Remove a release

Translation Memory & Glossary

Tool	Description
tm_search	Search translation memory
tm_add	Add entries to translation memory
tm_stats	Translation memory statistics
glossary_lookup	Look up glossary terms
glossary_check_text	Check text against glossary

Email Templates

Tool	Description
email_templates_list	List localized email templates
email_templates_pull	Download templates as HTML
email_templates_push	Upload local HTML templates
email_templates_status	Sync status comparison

Document Translation

Tool	Description
list_documents	List documents in project
upload_document	Upload document for translation
download_document	Download translated document
get_document	Get document details

Webhooks & Events

Tool	Description
register_webhook	Register CI/CD webhook
unregister_webhook	Remove webhook
list_webhooks	View registered webhooks
test_webhook	Send test event
get_recent_events	View recent events

Project Management

Tool	Description
create_project	Create new IntlPull project
add_languages	Add languages to project
detect_translation_files	Scan directory for i18n files
migrate_translations	Migrate existing translations

MCP Resources

Resource	Description
intlpull://languages	Supported language codes and names
intlpull://config	Current project configuration

Supported Languages

30+ languages including: English, Spanish, French, German, Italian, Portuguese, Russian, Japanese, Korean, Chinese (Simplified & Traditional), Arabic, Hindi, Dutch, Swedish, Danish, Finnish, Norwegian, Turkish, Thai, Vietnamese, Indonesian, Malay, Czech, Greek, Hebrew, Hungarian, Romanian, Ukrainian, Polish.

Supported File Formats

• JSON - Flat and nested structures
• YAML - Configuration-style translations
• XLIFF - Industry standard exchange format
• PO/POT - GNU gettext format
• CSV - Spreadsheet import/export
• Android XML - strings.xml format
• iOS Strings - .strings and .stringsdict

Example Usage

Translate strings with AI

Use translate_strings to translate these keys to Spanish:
- "welcome.title": "Welcome to our app"
- "welcome.subtitle": "Get started in minutes"

Check translation progress

Use get_translation_status to see how complete the French translations are

Publish OTA release

Use publish_ota_release to deploy the latest translations to production

Documentation

• IntlPull Documentation
• API Reference
• MCP Integration Guide

Support

• GitHub Issues
• Discord Community
• Email: [e-mail]

License

MIT License - see LICENSE for details.