Smartling

Create a new job batch to upload multiple files and attach them to a translation job in one coordinated flow. A batch declares a list of file URIs up front, then lets you upload each file (smartling_upload_file_to_job_batch), register/cancel individual files as needed (smartling_process_job_batch_action), and track progress (smartling_get_job_batch_status) - instead of you polling each upload/parse/attach step yourself. The batch automatically executes once every declared file is either uploaded or canceled. - translation_job_uid must reference an existing job (see smartling_get_or_create_translation_job or smartling_create_job) - file_uris must be unique within the batch - rush_job is only valid when authorize is true; setting it with authorize=false is rejected - locale_workflows[].translation_job_workflow_step_due_dates can only be set when authorize is true

smartling_create_job_batch

Create strings in a Smartling project and poll until completion. # What are strings in Smartling? Strings are individual pieces of text content that need to be translated. Each string has a unique identifier (hashcode) and can contain metadata like instructions, format specifications, and variant information. # Use cases - Create new translatable content in a Smartling project - Upload strings with specific formatting requirements - Add strings with translation instructions and context - Bulk create strings for translation workflows # Examples - Create simple strings: strings=[{"string_text": "Hello World"}] - Create strings with variants: strings=[{"string_text": "Submit", "variant": "button.submit"}] - Create strings with instructions: strings=[{"string_text": "Click here", "instruction": "This is a call-to-action button"}] - Create strings with formatting: strings=[{"string_text": "<b>Bold text</b>", "format": "html"}] # Parameters - project_id: The unique identifier of the Smartling project - namespace: (Optional) Namespace to organize strings - placeholder_format: (Optional) Format for placeholders (e.g., "java", "python", "c", "resx", "yaml") - placeholder_format_custom: (Optional) Custom regex pattern for placeholders - strings: Array of string objects to create (max 100 strings per request) # String Object Properties - string_text: The actual text content (required) - variant: (Optional) Unique identifier/key for the string - callback_url: (Optional) URL for callback notifications - callback_method: (Optional) HTTP method for callback (GET, POST) - instruction: (Optional) Translation instruction/context - format: (Optional) Content format (plain, html, xml, etc.) - max_length: (Optional) Maximum character length for translations # Polling Behavior This tool automatically polls the creation process status until completion (up to 5 minutes). It returns when the process is either successfully completed or failed.

smartling_create_strings

Create a new Smartling style guide for an account. style_guide_type picks which other fields apply: - PLAINTEXT: a style guide defined by free-form text. Requires text. Does not accept any of the SMARTLING-only fields below. - SMARTLING: a structured style guide built from discrete stylistic fields (tone, grammar voice, translation exceptions, etc.), all optional. Does not accept text. name must be unique within the account. base_locale_id is a locale code (e.g. "en-US" or "en"). # Examples - Create a plaintext style guide: style_guide_type="PLAINTEXT", name="Marketing", base_locale_id="en-US", text="Always use a friendly, upbeat tone." - Create a structured style guide: style_guide_type="SMARTLING", name="Support Docs", base_locale_id="en-US", grammar_voice="ACTIVE_VOICE", capitalization=true

smartling_create_styleguide

Unassign the user currently assigned to an issue.

smartling_delete_issue_assignee

Delete a comment from an issue. This action cannot be easily undone.

smartling_delete_issue_comment

Delete a manual LQA finding that was recorded by mistake. This action cannot be easily undone.

smartling_delete_lqa_error

Permanently delete a Smartling style guide. This fails if the style guide is still referenced by a linguistic package - remove that reference first.

smartling_delete_styleguide

Download a file attachment from a Smartling style guide. Returns a presigned download URL for the file, not the file content itself. The URL is valid for 15 minutes, so fetch it promptly - re-run this tool to get a fresh URL if it expires.

smartling_download_styleguide_attachment

Download translated content for a file from Smartling - as a single file for one locale, a zip of all locales for one file, or a zip of multiple files across specified locales. # Modes - SINGLE_LOCALE: one file, one locale - returns the translated file itself - ALL_LOCALES_ZIP: one file, every locale that has translations - returns a zip archive - MULTIPLE_FILES_ZIP: multiple files, each with its own locale list - returns a zip archive (up to 500 file/locale combinations total) # Important Notes - For MADCAP, DITA_ZIP, CSV, XLSX_TEMPLATE, and XCSTRINGS files only, locale_id in SINGLE_LOCALE mode also accepts a comma-separated locale list or "all" to get one combined (non-zip) file with all of those locales. - MULTIPLE_FILES_ZIP returns a "no files found" text response instead of a file when file_filter=PUBLISHED_FILES_ONLY excludes every requested file. - Returns a presigned download URL, not the file content itself. The URL is valid for 15 minutes, so fetch it promptly - re-run this tool to get a fresh URL if it expires.

smartling_download_translated_file

Edit the body text of an existing issue.

smartling_edit_issue_text

Run an automated Linguistic Quality Assurance (LQA) evaluation on a single translated string and get back any detected quality errors. Checks the translation against the source using Smartling's linguistic quality rules (e.g. blocklist compliance, omissions, mistranslations) and returns errors found, each with a category and severity. Does not modify the string or record errors anywhere - it only reports what an LQA scan would flag; use smartling_record_lqa_error to persist a finding.

smartling_execute_lqa_evaluation

Export LQA findings across the whole Smartling account as a CSV file, using the same filters as smartling_find_account_lqa_errors. Returns a presigned download URL, not the CSV content itself. The URL is valid for 15 minutes, so fetch it promptly - re-run this tool to get a fresh URL if it expires.

smartling_export_account_lqa_errors

Export glossary entries in various formats (CSV, XLSX, TBX), with filtering by locale, state, labels, dates, and more. Returns a presigned download URL for the exported file, not the file content itself. The URL is valid for 15 minutes, so fetch it promptly - re-run this tool to get a fresh URL if it expires.

smartling_export_glossary

Search issues across all projects in a Smartling account, with pagination, sorting, filters, and optional project narrowing.

smartling_find_account_issues

Search LQA findings across the whole Smartling account, with rich filters. The account is taken from the MCP token credentials.

smartling_find_account_lqa_errors

Search issues within a single Smartling project, with pagination, sorting, and filters by date, state, severity, type, assignee, job containment, and string hashcode/locale.

smartling_find_project_issues

Check whether email addresses already belong to a user, account user, or pending invite in a Smartling account - useful before inviting new users.

smartling_get_account_user_status

Get the Smartling accounts the current authenticated user has access to. Call this first to obtain the account_id required by most other tools; if more than one account is returned, ask the user which one to use. Returns up to 100 accounts by default; pass limit (1-100) to raise or lower that cap. There is no offset for this endpoint, so accounts beyond the limit cannot be retrieved.

smartling_get_available_accounts_for_current_user

Get the current authenticated user's role information (top native role, currently active role, and the roles they are allowed to switch to) along with their name and email - also useful as a "who am I" lookup.

smartling_get_current_user_roles_info

Retrieve the translation jobs that include a specific file in a Smartling project. Each job object contains job metadata (UID, status, dates). **Special case - Unassigned strings**: If the file contains strings not assigned to any job, the response includes an indicator object with all null values `{"jobUid":null,"dueDate":null,"createdDate":null,"status":null}` - this signals that some file content remains unassigned. Useful for diagnosing why a connector isn't delivering completed jobs (file content may span multiple incomplete jobs).

smartling_list_file_jobs

Get a file's translation status for every locale, and its last-modified date per locale. Returns two independent results - `status` (per-locale progress and word counts) and `lastModified` (per-locale last-modified dates) - from two separate Smartling API calls. They are not merged together.

smartling_get_file_status

Retrieve a specific glossary from the current Smartling account by its UID. If you only have a project (not a glossary UID), load the glossary-uid-resolution skill (smartling_load_skill) to resolve it.

smartling_get_glossary

Retrieve a single glossary entry by its UID.

smartling_get_glossary_entry

Get the per-asset, per-locale results of one instant (machine) translation request made via smartling_integration_request_instant_translation. Use state="FAILED" to diagnose failures via each locale's errorMessage.

smartling_integration_get_instant_translation_request

Discover everything needed to search a connector's content: connection status, valid filter values, and locale mappings - these vary per connector and per account. See the integration-translation-request skill (smartling_load_skill) for when to call this in the overall workflow. connected=false means the integration isn't ready for this project - every other field is omitted, and smartling_integration_search_assets should not be called yet.

smartling_integration_get_search_context

Get the shareable invitation link URL for a pending invite.

smartling_get_invite_link

Retrieve detailed information about a specific string issue - a question, clarification request, or quality flag raised against a string (source or translation) in a project.

smartling_get_issue

Retrieve a single issue comment by UID.

smartling_get_issue_comment

Get full details for a specific Smartling job by its UID, including priority, source files, callback configuration, and custom fields - more than smartling_list_jobs returns.

smartling_get_job

Get the detailed status of a Smartling job batch, including per-file and per-locale progress. See smartling_create_job_batch for what a batch is. To debug a stuck or failed batch, inspect files[].status and files[].errors for the failing file.

smartling_get_job_batch_status

Get the chronological audit trail of a Smartling job: creation, status changes, content additions/removals, due date/priority changes, and rush request create/remove events. Each entry records the action, when it started/ended, who (if anyone) performed it, and event-specific details. Returns up to 100 most recent entries by default; use offset/limit to page through more, guided by totalCount in the response.

smartling_get_job_history

Get per-locale, per-workflow-step translation progress for a job, or for a single file within it (target_locale_id and file_uri are mutually exclusive). Also useful for finding the workflow UIDs currently active on a job, e.g. before checking LQA/MQM statistics availability.

smartling_get_job_progress

Get the full category/severity/error-type breakdown for one LQA schema - resolves human-readable names to the UIDs smartling_record_lqa_error and smartling_update_lqa_error need. Check severityTypeCode first: - NAMED: match severityNames[].name to your desired severity, then pass its severityNameUid to smartling_record_lqa_error/smartling_update_lqa_error - POINT_RANGE: pass a numeric severity_score within severityRange.min-max instead - severityNames will be empty

smartling_get_lqa_schema_topology

Retrieve a specific linguistic package (a bundle of glossaries, style guides, and TM settings made available to translators) from the current Smartling account by its UID. To resolve a package from a project: smartling_list_projects -> smartling_get_project -> smartling_get_linguistic_package (skip the first step if you already have the project uid).

smartling_get_linguistic_package

Get MQM (Multidimensional Quality Metrics) quality scores for one or more translation jobs, gated by whether statistics are actually available yet. MQM statistics are computed from LQA findings recorded against a job's translations (see smartling_record_lqa_error), rolled up into per-job, per-schema, and per-locale quality scores. They're only meaningful once enough LQA review has happened, so always check each result's mqmStatisticsAvailable before reading a score - a false value means statistics is null for that job, not that quality is zero. - "Show quality for Job NAME" -> read the job-level fields (qualityScore, criticalErrorCount, etc.) inside statistics - "Show quality for [language] for Job NAME" -> read statistics.schemas[].targetLocales[] for that locale To enumerate the actual strings behind a quality issue (e.g. "show strings with critical errors"), see the mqm-quality-drilldown skill (smartling_load_skill).

smartling_get_mqm_statistics

Get detailed information about a specific Smartling project by its UID, including its target locales.

smartling_get_project

Get a Smartling style guide by its unique identifier. A style guide is a set of content formatting, tone, and writing-style rules used to keep translations consistent with brand voice.

smartling_get_styleguide

Get the calling user's style guide permissions.

smartling_get_styleguide_permissions

Get the actions the current caller is allowed to perform on specific users in an account (e.g. check whether removal is allowed before calling smartling_remove_users).

smartling_get_user_allowed_actions

Get word count and weighted word count report from Smartling as CSV, covering projects, jobs, translation resources, agencies, locales, workflow steps, and fuzzy matching profiles. **CRITICAL**: the date range (end_date - start_date) must be less than 1 year (365 days), or the API returns a validation error. Apply as many filters as possible (project_ids, target_locale_ids, job_uids, user_uids, workflow_step_types, a narrow start_date/end_date) and request only the fields you need via 'fields' - unfiltered calls can return very large responses. If unsure which fields to request, see the 'fields' parameter description for a recommended default set.

smartling_get_word_count_report