# Weblate MCP for AI Agents AI Agent Connect > Weblate MCP lets you manage your translation projects and localization workflows directly from your AI agent. It handles everything from listing projects to managing user permissions and syncing repository updates. It's built for teams who need to keep their apps localized without constantly switching back and forth to a web dashboard. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_BB7tOVZtUlqFRMrzhqiO7WlY5ErcxYHccOcfaZyf/ai-agent-connect - **Tags:** translation-management, localization-workflow, i18n, l10n, continuous-localization ## Description Connect your Weblate instance to any AI agent to manage your continuous localization and translation workflows through natural conversation. Instead of jumping between your code editor, your terminal, and the Weblate dashboard, you can now get the status you need directly in your workspace. You can ask your agent to show you the progress on a specific language or check which strings are still missing without leaving your current tab. It handles the heavy lifting of project management, like creating new components or assigning roles to your translation team. You can even trigger repository syncs to keep your version control in line with your latest translations. It's one of the many tools available in the Vinkius catalog that turns your AI into a functional localization manager. Instead of manually digging through settings, you just talk to your agent to get the data you need. ## Tools ### create_project_component Create a new component in a project. This lets you organize specific parts of your app for translation. ### create_project Create a new project. Use this to start a new localization effort from scratch. ### create_role Create a new role with specific permissions. This helps you define what different team members can actually do. ### create_user Create a new Weblate user. Add new translators to your project without manual entry. ### delete_user Delete a user (marks inactive). Remove old accounts to keep your user list clean. ### get_group Get group details (roles, projects, components). See what permissions and access a specific group has. ### get_language Get language details (plural formulas, aliases). Check the specific settings for a language like English or Spanish. ### get_project Get project details. Pull all the high-level info for a specific localization project. ### list_languages List all languages. See every language you have defined in your Weblate instance. ### list_user_notifications List user notification subscriptions. Check who is getting alerts for translation changes. ### list_project_components List components within a project. See all the organized parts of a project ready for translation. ### get_project_file_url Get the URL to download all translations as a ZIP archive. Grab all your translated files in one go. ### list_project_labels Manage project labels. See or update the tags used to organize your projects. ### list_project_languages Paginated statistics for all languages in a project. Get a breakdown of progress for every language in one project. ### perform_repository_operation Perform VCS operations (push, pull, commit, reset, cleanup). Sync your code with the translation platform directly. ### get_project_repository Get overall VCS status for the project. Check if your repository is in sync with the translation files. ### list_projects List all projects. See every localization project you have active. ### list_roles List roles associated with the user. See what permissions your current account has. ### get_root Get Weblate API root entry point. Access the base endpoint for the Weblate API. ### list_users List Weblate users. See all the people who have accounts in your localization system. ### get_role Get role details and permission codenames. See exactly what permissions a role carries. ### get_user Get detailed user information. Look up a specific user's profile and status. ### list_groups List Weblate groups. See all the groups currently set up in your instance. ### get_language_statistics Get global statistics for a language. See how much of a language is finished across all projects. ### manage_user_notifications Manage user notification subscriptions. Update who gets notified when new strings are added. ### update_user Update user details. Change the profile info for an existing user. ### get_user_contributions List translations with user contributions. See which strings a specific translator has worked on. ### get_user_statistics Get user translation statistics. See how many strings a specific user has completed. ### add_group_admins Add team administrators to a group. Give specific people admin rights over a group. ### add_group_roles Associate roles with a group. Assign permissions to a group at once. ### create_group Create a new group. Organize your translators into teams like Reviewers or QA. ### create_language Create a new language definition. Add a new language to your localization workflow. ## Prompt Examples **Prompt:** ``` How's the French translation looking for the mobile app? ``` **Response:** ``` I've pulled the latest stats for your mobile app project. Here is the current status for the French (`fr`) translation: | Language | Completion | Total Strings | Missing/Fuzzy | | :--- | :--- | :--- | :--- | | **French** | **72%** | 1,450 | 335 | Most of the core UI is finished, but the 'Settings' component still has several untranslated strings. ``` **Prompt:** ``` I need to add a new translator named Alice to the Reviewer group. ``` **Response:** ``` I've successfully set up the new user for you. * **User Created:** Alice (alice@example.com) * **Group Assigned:** Reviewers * **Permissions:** Full review and approval rights She's all set to start reviewing translations now. ``` **Prompt:** ``` Show me the last few things the translation team worked on. ``` **Response:** ``` Here are the most recent contributions from the translation team: * **User:** marcus_t * **Project:** Web Dashboard * **Strings:** 12 new translations in the 'Login' component. * **User:** sarah_dev * **Project:** Mobile App * **Strings:** 5 strings updated in the 'Profile' section. ``` ## Capabilities ### List all translation projects See every localization project you have active in one list. ### Create new components Add specific parts of your app to a project for translation. ### Check language progress Get completion statistics for any language across all projects. ### Manage user permissions Create users and assign roles to manage your translation team. ### Sync repository updates Perform VCS operations to keep your code and translations in sync. ### Track user contributions See which specific strings a translator has worked on. ## Use Cases ### The Release Check A localization manager asks the agent to show the completion percentage for the German translation. The agent uses `list_project_languages` and `get_language_statistics` to report that 85% is done. ### The New Translator A lead dev needs to add a new reviewer. They tell the agent to create a new user and add them to the Reviewers group using `create_user` and `add_group_roles`. ### The Sync Issue A developer notices the translation files are out of date. They ask the agent to pull the latest changes from the repository using `perform_repository_operation`. ### The Audit A manager wants to see who is actually contributing to the mobile app. The agent runs `get_user_contributions` to list all strings worked on by the Mobile Team. ## Benefits - Check language coverage instantly using `list_project_languages` to see what's missing. - Sync your code with `perform_repository_operation` without leaving your editor. - Manage your team with `create_user` and `add_group_roles` to handle permissions quickly. - Get a snapshot of work with `get_user_statistics` to see which translators are most active. - Organize your app's structure using `create_project_component` to keep translations grouped. - Download all your work with `get_project_file_url` for easy local backups. ## How It Works The bottom line is you get a hands-on localization manager that lives inside your AI chat. 1. Subscribe to the Connector and provide your Weblate Instance URL and Personal API Token. 2. Connect it to your AI client like Claude or Cursor. 3. Start asking your agent to manage projects, users, or sync repositories. ## Frequently Asked Questions **Can Weblate MCP help me see translation progress?** Yes. You can ask your agent to provide a status update on any language. It will pull real-time completion percentages and counts of missing strings directly from your projects. **How do I use Weblate MCP to manage my translation team?** You can use your AI client to create new users, define roles, and assign permissions. It makes it easy to organize your team into groups like 'Reviewers' or 'QA' without manual entry. **Can I sync my code with Weblate using this Connector?** Yes, the Connector supports VCS operations. You can tell your agent to pull or push updates to keep your code repository in sync with the latest translation files. **How does Weblate MCP handle multiple projects?** It can see all projects in your instance. You can ask for a summary of all active projects or drill down into the specific components and languages of a single one. **Can Weblate MCP help with user permissions?** Absolutely. You can manage who has access to what by creating roles and assigning them to groups, all through a simple conversation with your AI agent. **Is Weblate MCP good for checking missing strings?** It's perfect for that. You can ask for a report on specific languages to identify exactly how many strings are still untranslated or marked as fuzzy. **Can I check the translation progress for a specific language code?** Yes! Use the `get_language_statistics` tool with the language code (e.g., 'fr'). The agent will return detailed metrics including translated, fuzzy, and failing strings. **Is it possible to trigger a Git pull or push from the AI?** Absolutely. Use the `perform_repository_operation` tool. You can specify the project and component along with the operation (like 'pull' or 'push') to sync with your remote repository. **Can I manage user access and view their contributions?** Yes. You can use `list_users` to see accounts, `get_user_contributions` to audit translation activity, and `add_group_roles` to manage permissions programmatically.