Smartling MCP Server Tools

The Smartling MCP server lets ChatGPT, Claude, and other AI tools interact with your Smartling account through chat. Based on your prompt, your AI tool selects the appropriate tools to complete your request. The available tools are organized by category below. To connect your AI tool, see Smartling MCP Server: Connect Your AI Chat Tools to Smartling.

Machine translation tools

smartling_machine_translate_text: Translates text items between languages, with automatic language detection.
smartling_machine_translate_file: Translates entire files in various formats. Supply the file with an upload_id from smartling_request_upload_url, or send the file content directly if your client can't run commands. Returns a download link (valid for 15 minutes) instead of the file.
smartling_request_upload_url: Returns a short-lived upload link for a file. This is the default way to supply a file for clients that can run commands on your computer, whatever the file size.

String tagging tools

smartling_add_tags_to_strings: Adds tags to strings for categorization and filtering (up to 100 tags and 1,000 strings per request).
smartling_remove_tags_from_strings: Removes specific tags from strings (up to 100 tags and 1,000 strings per request).
smartling_remove_all_tags_from_strings: Removes all tags from strings for complete cleanup (up to 1,000 strings per request).

Style guide tools

smartling_list_styleguides: Lists style guides, with optional name filtering.
smartling_get_styleguide: Retrieves detailed style guide configuration by UID.
smartling_create_styleguide: Creates a new style guide, either PLAINTEXT or SMARTLING-type (recommended).
smartling_update_styleguide: Updates an existing style guide's content and settings.
smartling_delete_styleguide: Permanently deletes a style guide.
smartling_set_styleguide_locales: Replaces the full set of target locales bound to a style guide.
smartling_list_styleguide_locales: Lists the target locales currently bound to a style guide.
smartling_add_styleguide_attachment: Adds a link or file attachment to a style guide.
smartling_list_styleguide_attachments: Lists the attachments on a style guide.
smartling_remove_styleguide_attachment: Removes an attachment from a style guide.
smartling_download_styleguide_attachment: Downloads a file attachment from a style guide. Returns a download link (valid for 15 minutes) instead of the file.
smartling_get_styleguide_permissions: Gets your style guide permissions.

Project management tools

smartling_list_projects: Lists Smartling projects, with filtering options (name, type codes, archived status).
smartling_get_project: Retrieves detailed project information by UID.

Glossary management tools

smartling_list_glossaries: Lists glossaries, with advanced filtering (query, state, locale, UIDs).
smartling_get_glossary: Retrieves complete glossary configuration by UID.
smartling_match_glossary_terms: Matches source and translation text against glossary terms.
smartling_export_glossary: Exports a glossary's terms as CSV, XLSX, or TBX. Returns a download link (valid for 15 minutes) instead of the file.
smartling_manage_glossary: Creates a new glossary or updates an existing one.
smartling_manage_glossaries_archive_state: Archives or restores one or more glossaries in bulk.
smartling_get_glossary_entry: Retrieves a single glossary entry by its UID.
smartling_search_glossary_entries: Searches entries within a glossary by a set of filters.
smartling_manage_glossary_entry: Creates a new glossary entry or updates an existing one.
smartling_manage_glossary_entries_bulk: Archives, restores, removes, or adds or removes labels on glossary entries matching a filter, in bulk.
smartling_list_glossary_labels: Lists all glossary labels in an account.
smartling_manage_label: Creates, updates, or deletes a glossary label.
smartling_manage_glossary_import: Imports glossary entries from a file (CSV, XML, or XLSX) through a start, status, and confirm workflow.
smartling_authorize_entries_for_translation: Authorizes glossary entries matching a filter for translation into one or more locales through existing project workflows.

Linguistic package tools

smartling_list_linguistic_packages: Lists all linguistic packages from the current account.
smartling_get_linguistic_package: Retrieves linguistic package configuration by UID.

Translation memory tools

smartling_search_translation_memory: Searches translation memory for similar translations in a specific project and locale.

String search tools

smartling_search_strings: Searches for strings in a Smartling project using various filters (status, locales, source keywords).
smartling_create_strings: Creates strings in a Smartling project and waits until creation finishes.

Workflow tools

smartling_list_workflows: Lists workflows from a specific Smartling project, with optional filtering.

Job management tools

smartling_list_jobs: Lists translation jobs from a specific project, with optional filtering by name and status.
smartling_create_job: Creates a new Smartling job with full control over custom fields, reference numbers, and due dates. See smartling_get_or_create_translation_job for a simpler alternative.
smartling_get_job: Retrieves detailed information about a specific job by UID, including priority, source files, and metadata.
smartling_update_job: Updates a job's metadata (name, description, due date, reference number, callback configuration, custom fields). Any optional field you leave out is cleared.
smartling_add_strings_to_job: Adds strings to an existing job by their hashcodes, with optional target locale and move settings.
smartling_remove_strings_from_job: Removes strings from an existing job by their hashcodes, for specific or all target locales.
smartling_authorize_job: Authorizes a job to begin translation work, moving it from preparation to active status.
smartling_get_job_history: Retrieves the audit history of a job (creation, status changes, content, due date, and priority changes), with pagination through offset and limit.
smartling_get_job_progress: Gets per-locale, per-workflow-step progress for a translation job, optionally scoped to a single locale or file.
smartling_list_job_files: Lists the source files attached to a Smartling job, with pagination.
smartling_list_file_jobs: Lists the translation jobs a specific file is involved in, flagging any unassigned content.
smartling_manage_job_file: Adds or removes a file from a Smartling job.
smartling_manage_job_status: Changes a job's lifecycle status (cancel, close, or delete).

Job batch tools

smartling_create_job_batch: Creates a batch to upload multiple files and attach them to a translation job in one coordinated flow.
smartling_get_or_create_translation_job: Gets an existing translation job by name template, or creates one. A simpler alternative to smartling_create_job for batch and file-upload workflows.
smartling_process_job_batch_action: Registers or cancels a single file within a job batch.
smartling_upload_file_to_job_batch: Uploads a file's content into a job batch. Supply the file with an upload_id from smartling_request_upload_url, or send the file content directly if your client can't run commands.
smartling_get_job_batch_status: Retrieves detailed batch status, including per-file, per-locale progress.
smartling_list_job_batches: Lists job batches for a project, with optional filtering by translation job or status.

Report tools

smartling_get_word_count_report: Gets a word count report (projects, jobs, agencies, locales, workflow steps, fuzzy matching) from Smartling in CSV format.
smartling_get_workflow_step_types: Gets the available workflow step types, for use in filtering other report tools.

File management tools

smartling_download_translated_file: Downloads translated content for a file: a single file and locale, a zip of all locales, or a zip of multiple files across locales. Returns a download link (valid for 15 minutes) instead of the file.
smartling_get_file_status: Retrieves a file's translation status for every locale, and its last-modified date per locale.
smartling_search_recent_files: Searches recently uploaded source files or recently published translated files.
smartling_manage_file: Manages a file's lifecycle in a project (supports deleting or renaming a file).

People management tools

smartling_get_available_accounts_for_current_user: Gets available accounts for the current user. Use this before other Smartling tools that need an accountUid parameter.
smartling_list_users: Lists users from the current Smartling account, with advanced filtering options (keyword, roles, projects, status, pagination).
smartling_get_current_user_roles_info: Gets your top native role, your currently active role, and the roles you can switch to.
smartling_list_current_user_projects: Lists the projects you can access within an account.
smartling_get_user_allowed_actions: Gets the actions you are allowed to perform on specific users in an account.
smartling_remove_users: Removes users from a Smartling account, revoking their access entirely.
smartling_list_invites: Lists pending invites for a Smartling account, with filtering, sorting, and pagination.
smartling_get_invite_link: Gets the shareable invitation link URL for a pending invite.
smartling_manage_invites: Resends or cancels pending invites, identified by invite UIDs or user UIDs.
smartling_get_account_user_status: Checks whether email addresses already belong to a user, account user, or pending invite.
smartling_invite_users: Invites one or more new users to a Smartling account with account-level, project-level, and workflow-level roles.

Vendor tools

smartling_list_content_assignments: Lists content assignments for the current account (project, locale, workflow step, translation job, assignee, due dates, word count).

Issue tools

String issues capture questions, clarification requests, and quality flags raised against source or translated strings.

Issue lifecycle

smartling_create_issue: Creates a new issue on a string with type, sub-type, severity, and assignee.
smartling_get_issue: Retrieves full details of one issue by UID.
smartling_edit_issue_text: Edits the body text of an existing issue (maximum 4,000 characters).
smartling_open_or_close_issue: Changes an issue's state to OPENED or RESOLVED.
smartling_update_issue_answered: Toggles the answered flag.
smartling_update_issue_assignee: Assigns an issue to a specific user.
smartling_delete_issue_assignee: Removes the current assignee.
smartling_update_issue_severity_level: Changes severity (LOW, MEDIUM, HIGH).
smartling_update_issue_type: Changes type and sub-type, and optionally narrows to a locale.

Comments

smartling_list_issue_comments: Lists all comments on an issue.
smartling_get_issue_comment: Retrieves one comment by UID.
smartling_add_issue_comment: Posts a new comment (maximum 4,000 characters).
smartling_update_issue_comment: Edits an existing comment.
smartling_delete_issue_comment: Deletes a comment.

Search and count

smartling_find_project_issues: Searches issues in one project, with pagination and sorting.
smartling_count_project_issues: Counts issues in one project matching the filter.
smartling_find_account_issues: Searches issues across all projects in your account.
smartling_count_account_issues: Counts issues across all projects in your account.

LQA tools

smartling_execute_lqa_evaluation: Runs an automated Linguistic Quality Assurance (LQA) evaluation on a single translated string and returns the detected quality errors (category, severity).
smartling_list_lqa_schemas: Lists LQA schemas configured for an account.
smartling_get_lqa_schema_topology: Gets the category, severity, and error-type breakdown for one LQA schema (resolves human-readable names to UIDs).
smartling_record_lqa_error: Records a manual LQA finding on a translated string.
smartling_update_lqa_error: Updates an existing recorded finding's error type, severity, or comment.
smartling_delete_lqa_error: Deletes a recorded finding.
smartling_mark_lqa_no_errors: Marks a translated string as reviewed with no errors found.
smartling_list_lqa_errors_per_string: Reads back findings recorded on one specific string.
smartling_find_account_lqa_errors: Account-wide filtered search across recorded findings.
smartling_export_account_lqa_errors: Exports account-wide findings as a CSV, using the same filters as smartling_find_account_lqa_errors. Returns a download link (valid for 15 minutes) instead of the file.
smartling_get_mqm_statistics: Gets MQM (Multidimensional Quality Metrics) quality scores for one or more jobs, where available.

Skill tools

Skills are bundles of instructional text the server can hand an AI model on demand, for capabilities that don't need a dedicated tool.

smartling_list_skills: Lists available skills, grouped by category, with an optional category filter.
smartling_load_skill: Loads the full instructions for one skill by id, for the AI model to follow directly.

Integration and connector tools

Connectors pull content from a third-party system into Smartling for search and translation. Call smartling_integration_list_available first to see which connectors exist on an account, then smartling_integration_get_search_context before smartling_integration_search_assets to learn valid filter values.

smartling_integration_list_available: Lists connectors available on an account and their normalized integration ID.
smartling_integration_get_search_context: Fetches connection status, valid filter values (asset types, submission statuses, connector-specific filters), and locale mappings for a connector and project.
smartling_integration_search_assets: Searches a connector's content for assets to translate.
smartling_integration_request_tms_translation: Submits selected assets to an existing Smartling job for human translation.
smartling_integration_request_instant_translation: Requests on-the-fly machine translation for selected assets.
smartling_integration_search_instant_translation_requests: Lists and filters past instant translation requests.
smartling_integration_get_instant_translation_request: Gets per-asset, per-locale results of one instant translation request.

Downloading generated files

Five tools return a download link instead of the file itself: smartling_download_translated_file, smartling_export_glossary, smartling_machine_translate_file, smartling_export_account_lqa_errors, and smartling_download_styleguide_attachment. The link is valid for 15 minutes. After that, run the tool again to get a new one. This keeps large files, such as zipped translations and exports, out of the conversation with your AI tool, so open the link directly to get the content.

Get answers instantly