# Smartling MCP for AI Agents AI Agent Connect > Smartling (Translation Workflow API) MCP. Connect your Smartling account to your AI client to manage localization jobs, upload source files, and download translations without switching tabs. Automate content authorization and visual context uploads to keep your localization pipeline moving. ## Overview - **Category:** collaboration - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_5QcDqXV1nvbDFmYjGLXZ24BExH2qTP4svbYsNGAe/ai-agent-connect - **Tags:** localization, translation-api, i18n, l10n, workflow-automation ## Description This Smartling MCP lets you handle the entire localization lifecycle from a single chat interface. You're tired of jumping between your project management tool and the translation platform just to check a status or push a new file. This connection lets you manage your global content from a single chat window. You can ask your agent to pull up specific projects, spin up new translation jobs, and get your files into the hands of linguists immediately. Instead of manually clicking through menus to upload JSON, XML, or HTML files, your agent handles the heavy lifting. It even takes care of the visual context, letting you attach screenshots so translators actually see what they're working on. You'll get your completed translations back in the same thread, ready to be dropped into your code or content. It's a way to make your translation pipeline feel like a conversation rather than a series of tedious data entries. You can find this in the Vinkius catalog to get your global content moving faster. This means you spend less time on the admin side of translation and more time actually shipping your product to new markets. It takes the friction out of the i18n process for your whole team by removing the need for constant tab switching. You can finally treat localization like a background task rather than a manual hurdle. ## Tools ### add_content_to_job Add specific content to an existing translation job. This keeps your linguists focused on the right tasks. ### create_job Create a new translation job within a project. Use this to start new localization cycles instantly. ### download_translated_file Download a finished translation file for your project. This gets the final text back into your hands. ### get_project Get specific details for a Smartling project. Use it to check project status or IDs quickly. ### list_projects List all your active Smartling projects. This gives you a bird's-eye view of your localization work. ### upload_context Upload visual context for your translators. Help them understand the UI by providing screenshots. ### upload_file Upload a source file for translation. Send your JSON, XML, or HTML files directly to the platform. ## Prompt Examples **Prompt:** ``` Show me all my current Smartling projects. ``` **Response:** ``` I've pulled your current projects from Smartling. Here they are: | Project Name | Project ID | Status | | :--- | :--- | :--- | | Mobile App v2 | `a1b2c3d4` | In Progress | | Marketing Site | `e5f6g7h8` | Completed | Would you like me to get more details on one of these? ``` **Prompt:** ``` Create a new job called 'Winter Update' in the Mobile App v2 project. ``` **Response:** ``` I've successfully created the **Winter Update** job in project `a1b2c3d4`. * **Job ID:** `job_98765` * **Status:** Ready for content You can now tell me which files to upload to this job. ``` **Prompt:** ``` Upload the French translation for 'strings.json' from project a1b2c3d4. ``` **Response:** ``` I've grabbed the French version of `strings.json` for you. * **Locale:** fr-FR * **File Status:** Downloaded I've also prepared the content for your review. Would you like me to display the translated strings here? ``` ## Capabilities ### Create new translation jobs Use the Smartling MCP to start a new translation task instantly. ### Upload source files Send JSON, XML, or HTML files directly to your project. ### Download translated content Fetch finished translations for any locale in one step. ### Manage translation projects View and inspect your entire localization landscape from the chat. ### Provide visual context Attach screenshots to help translators see the UI layout. ### Group content for linguists Organize strings into specific jobs to improve workflow flow. ### Authorize content automatically Set permissions during the upload process to keep things moving. ## Use Cases ### Checking multiple project statuses A localization manager needs to check statuses for 10 different apps. They ask the agent to list all projects and check the status of a specific one. ### Pushing new UI strings A developer is ready to push a new set of UI strings. They tell the agent to upload the JSON file and create a new translation job. ### Providing visual context for a translator A content team notices a translator is struggling with a button's placement. They use the agent to upload a screenshot of the UI to the specific job. ### Pulling finished French strings A project just finished and the dev needs the French strings. The dev asks the agent to download the French translation for the main strings file. ## Benefits - Stop manual data entry by using create_job to start translation tasks without leaving your chat. - Get your files into production faster by using upload_file to send source content directly to Smartling. - Improve translation accuracy by using upload_context to provide linguists with visual references. - Stay on top of your workload by using list_projects to see every active localization effort at once. - Save time on file management by using download_translated_file to grab finished text for your project. ## How It Works The bottom line is you stop manual data entry and start managing localization through natural language. 1. Subscribe to the Smartling MCP and enter your User Identifier and User Secret. 2. Connect your AI client to the Vinkius marketplace. 3. Start asking your agent to list projects or upload files. ## Frequently Asked Questions **Can the Smartling MCP actually translate my text?** No, this Connector manages the workflow. It lets your agent handle the admin tasks like creating jobs, uploading files, and checking statuses within the Smartling platform. The actual translation still happens through Smartling's services or your linguists. **How does the Smartling MCP help with localization accuracy?** It helps by making it easier to provide context. You can use your agent to upload screenshots or HTML context directly to a job, so your translators see exactly where the text will appear in your app. **Can I use the Smartling MCP to upload my JSON files?** Yes. You can tell your agent to upload source files like JSON, XML, or HTML directly to a specific job. It handles the upload for you without you having to leave your chat window. **Is the Smartling MCP good for developers?** It's great for devs because it lets you pull translations and push new resource files directly from your workspace. You can manage the entire i18n pipeline without switching back and forth to a web dashboard. **What projects can I see with the Smartling MCP?** You can see every project connected to your Smartling account. Your agent can list them all, check specific project details, and help you organize your localization landscape in one place. **Can I upload a file and have it immediately ready for translation?** Yes! When using the `upload_file` tool, set the `authorize` parameter to true. This will automatically authorize the content for translation in your project. **How do I group multiple files into a single translation task?** First, use `create_job` to create a new translation job. Then, use `add_content_to_job` for each file URI you want to associate with that specific job UID. **Can I provide visual context to help translators?** Absolutely. Use the `upload_context` tool to send visual references (like screenshots or HTML) to your project, ensuring higher translation quality.