# Phrase MCP for AI Agents AI Agent Connect > Phrase (Software Localization API) MCP lets you manage your localization projects, locales, and translation keys directly from your AI client. Instead of jumping between tabs, you can create keys, update translations, and organize locales using plain English. It's built for teams who need to keep their codebase and translation platform in sync without the manual overhead. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_CJZRjLhtihKrxCXUYOiAYLM4LrqyL5BaMjmw2ggp/ai-agent-connect - **Tags:** i18n, l10n, translation-management, software-localization, phrase-api ## Description Handling internationalization usually feels like a chore because it forces you to leave your code and jump into a different dashboard. You spend your time copy-pasting translation keys, verifying if a locale already exists, and manually updating project settings. This Connector changes the dynamic by bringing your Phrase account directly into your AI agent's workspace. You can tell your agent to set up a new project or create a batch of translation keys while you stay focused on the actual development work. It's about removing the friction of manual data entry. If you're looking for a way to manage your l10n workflow without constant context switching, this is how you do it. You'll find it in the Vinkius catalog alongside other tools designed to bridge the gap between your dev environment and your production data. Instead of a manual checklist, you get a conversational way to manage your translation pipeline. You can check project statuses, audit your keys, and sync your files without ever opening a new browser tab. It turns a multi-step admin task into a single sentence. Whether you are a developer trying to push a new string to production or a manager overseeing a massive multi-language rollout, this connection keeps your data consistent. It ensures that your codebase and your translation platform are always speaking the same language, which is the only way to maintain a high-quality user experience across the globe. ## Tools ### update_locale Edit the settings of an existing locale. This is useful for changing default languages. ### update_project Change project details. Use this to update the project name or description. ### list_translations View all translations for a project. This helps you see what's been completed. ### update_translation Change the content of a translation. This allows you to edit strings on the fly. ### create_key Create a new translation key in your project. This keeps your codebase and Phrase in sync. ### create_locale Add a new language or region to a specific project. This is useful for expanding your reach. ### create_project Set up a new localization project. Use this to start a new app or website. ### create_translation Add a new translation entry. This helps populate your content quickly. ### delete_key Remove an old translation key. Use this to clean up your project data. ### delete_locale Delete a locale you no longer need. This keeps your project list clean. ### delete_project Remove a project entirely. Use this when a project is decommissioned. ### download_file Get your translations in a specific format. This helps with local testing. ### get_key Fetch details for a specific key. Use this to check the status of a string. ### get_locale Get information about a specific locale. This helps you verify language settings. ### get_project Retrieve details for a specific project. Use this to check project status. ### list_keys View all translation keys for a project. This is great for auditing your content. ### list_locales See all locales currently in a project. Use this to check your language coverage. ### update_key Modify an existing translation key. Use this to rename keys in your project. ### upload_file Send a localization file to Phrase. This is the fastest way to bulk update keys. ### list_projects See all your localization projects. Use this to navigate your full workspace. ## Prompt Examples **Prompt:** ``` I need to add a new button to the mobile app. Can you create a translation key for 'Submit Order' in project_123? ``` **Response:** ``` I've created the translation key **Submit Order** in project **proj_123**. **Status:** - **Key Name:** `submit_order_btn` - **Project:** Mobile App - **Status:** Ready for translation ``` **Prompt:** ``` Show me all the languages we currently support for our web dashboard. ``` **Response:** ``` Here are the locales currently configured for your Web Dashboard project: | Language | Locale Code | Status | | :--- | :--- | :--- | | English | en-US | **Default** | | German | de-DE | Active | | Spanish | es-ES | Active | ``` **Prompt:** ``` I have a new project for a marketing site. Can you set up a new project called 'Marketing Site' and add English and French locales? ``` **Response:** ``` I've successfully set up your new project and locales. **Project Details:** - **Name:** Marketing Site - **ID:** `proj_mkt_99` **Locales Added:** - English (en-US) - French (fr-FR) ``` ## Capabilities ### Create translation keys Add new strings to your project directly through your AI client. ### Add new locales Expand your project to support new languages or regions instantly. ### Set up localization projects Build out new project structures using natural language commands. ### Update translations Modify existing translation content without leaving your workspace. ### Sync local files Upload or download translation files to keep your data in sync. ### Audit project content List and inspect all keys and translations within a project. ## Use Cases ### Adding new features A developer wants to add a login button. They ask the agent to `create_key` for the button text in the web project. ### Expanding to new markets A manager needs to add Spanish. They ask the agent to `create_locale` for es-ES in the mobile app project. ### Bulk updating content A writer has a CSV of new strings. They ask the agent to `upload_file` to push all changes to Phrase at once. ### Auditing status A lead needs to see what's done. They ask the agent to `list_translations` to check the progress of the German translation. ### Updating project info A product owner needs to rename a project. They ask the agent to `update_project` to change the name across the platform. ## Benefits - Stop copy-pasting keys by using `create_key` to add new strings directly through your agent. - Speed up project setup by using `create_project` and `create_locale` to build out your l10n structure. - Audit your content faster with `list_keys` and `list_translations` to see what's missing. - Keep your files updated by using `upload_file` and `download_file` to sync local data with Phrase. - Manage your project metadata easily with `update_project` and `update_locale` to stay organized. ## How It Works The bottom line is you get to manage your entire localization pipeline through a simple chat interface. 1. Connect your Phrase Access Token to the Connector. 2. Open your preferred AI client like Claude or Cursor. 3. Ask your agent to manage your project locales or keys. ## Frequently Asked Questions **Can I use Phrase MCP to create new translation keys?** Yes, you can ask your agent to create keys directly in your project. This helps keep your codebase and translation platform in sync without manual entry. **Does Phrase MCP work with Cursor?** Yes, it works with Cursor and other MCP-compatible clients, allowing you to manage your localization data right from your editor. **How do I add a new language to my project using Phrase MCP?** Just ask your agent to add a new locale to your specific project ID. It will handle the configuration for you instantly. **Can I download my translations using this Connector?** Yes, you can use the tool to download your translations in your preferred format, which is great for local testing and review. **Is Phrase MCP good for bulk updates?** Yes, you can use the upload tool to push files to Phrase quickly. This is the most efficient way to handle large batches of new content. **Can I manage multiple projects with Phrase MCP?** Yes, you can list and manage all your projects through the agent. It allows you to navigate your entire workspace through simple chat commands. **Can I list all translation keys for a specific project?** Yes! Use the `list_keys` tool by providing the `project_id`. It will retrieve all translation keys configured for that project. **How do I add a new language to my localization project?** You can use the `create_locale` tool. You'll need to provide the `project_id`, the locale `name` (e.g., 'French'), and the locale `code` (e.g., 'fr-FR'). **Is it possible to update an existing project's name?** Yes, the `update_project` tool allows you to modify properties like the project `name` and `main_format` using the `project_id`.