DeepL

Get one custom instruction of a style rule set: its label, prompt, and source language. get-style-rule-set returns all instructions of a set at once. DeepL Pro only.

get-custom-instruction

Get the name, language pairs (dictionaries), and creation time of one glossary. Returns no terms; use get-glossary-dictionary-entries for those. DeepL Pro only.

get-glossary-info

Get the terms of a glossary for one language pair, as TSV: one entry per line, source term and target term separated by a tab. Use this to show or check what a glossary contains. list-glossaries and get-glossary-info show which language pairs it has. DeepL Pro only.

get-glossary-dictionary-entries

Get one style rule set with full detail: its enabled predefined style rules, its custom instructions, and the version that update-style-rule-set needs. A translation that passes its id as styleId applies both; pass only additional instructions in customInstructions. DeepL Pro only.

get-style-rule-set

List the assets (files and folders) in a DeepL Link provider. The provider must have status Connected in list-providers; if it is not connected, ask the user to connect it at https://www.deepl.com/your-account/my-apps. Entries with isFolder=true are folders — pass their id as folderId to list their contents. To find a file in a known folder, list the folders: start without folderId and filter, then follow the folder ids. A search with filter alone uses the provider's search index and can miss a file added in the last minutes. With folderId, filter matches only that folder's entries and has no such delay. unsupportedReason, when set, explains why an asset cannot be translated. Pass the id of a file as source to upload-document-from-link.

list-assets

List the external storage providers (e.g. OneDrive, Google Drive, SharePoint) that DeepL Link exposes to the caller, with each provider's connection status and capabilities. Use list-assets with a returned providerId to browse a connected provider's files. When the provider the user needs has status NotConnected or Unconfigured, give the user connectUrl to connect it or to finish its setup, and continue without that provider in the same turn (for a document, call upload-document).

list-providers

List the user's DeepL glossaries with their ids, names, language pairs (dictionaries), and creation times. Use this to find the id of a glossary that the user names, or to show which glossaries exist. Returns no terms; use get-glossary-dictionary-entries for those. The glossary tools accept only the ids this tool returns. DeepL Pro only.

list-glossaries

List the predefined style rules that DeepL offers for one language, with their parameters and options, plus all supported languages. A style rule set enables a selection of them with update-style-rule-set. These are not the user's saved style rule sets; use list-style-rule-sets for those. Omit language only to get the rules of every language. A supported language without rules supports custom instructions only. DeepL Pro only.

list-predefined-style-rules

List the languages DeepL can translate from, as language codes such as 'EN' or 'DE'. Use this to answer which languages DeepL supports, and to find a valid sourceLang code.

get-source-languages

List the user's style rule sets with their ids, names, and languages. A style rule set holds style rules and custom instructions that a translation applies when you pass its id as styleId to translate-text or upload-document. Use this to show the user's style rules or to find a styleId. Use get-style-rule-set for the rules and instructions of one set. These ids are not glossary ids. DeepL Pro only.

list-style-rule-sets

List the languages DeepL can translate into, as language codes such as 'EN-US' or 'DE'. Use this to answer which languages DeepL supports, and to find a valid targetLangs code for translate-text or upload-document.

get-target-languages

Permanently delete terms from a glossary for one language pair, identified by their source terms. All other terms stay. Read the exact source terms with get-glossary-dictionary-entries first. A source term that the glossary does not have is listed in notFound, and the call still succeeds. DeepL Pro only.

remove-glossary-entries

Rename a glossary. Its terms stay unchanged. Use list-glossaries to find the glossary id. DeepL Pro only.

rename-glossary

Rewrite or improve text with DeepL Write: make it clearer, more formal or casual, friendlier, more confident, or simpler. Use this when the user wants to polish, reword, or change the style or tone of a text. To only fix spelling and grammar, use correct-text; to translate, use translate-text. Set writingStyle or tone to match the request, e.g. writingStyle 'business' for a more formal text or tone 'friendly' for a friendlier one, together with targetLang. Results match the inputs by position.

rephrase-text

Replace all terms of a glossary for one language pair with the entries you send; terms you leave out are deleted. Use this only to rewrite the full term list, and read the current terms with get-glossary-dictionary-entries first. To add or change terms and keep the rest, use update-glossary-entries. To delete the language pair, use delete-glossary-dictionary. DeepL Pro only.

replace-glossary-dictionary

Second step of a document translation: shows the user a widget for a document session that an earlier call returned. Call it with that 'sessionId'. After upload-document, call it right after that call whenever you cannot access or transfer the file bytes to 'uploadUrl': the user then selects the file in the widget. If the server already has the file, the widget shows the progress instead. The widget tracks the translation and offers the download.

upload-document-show-fallback-widget

Translate a whole file or document, preserving its original layout and formatting. Use this — not translate-text — whenever the user wants to translate a file or document (rather than text typed into the conversation), even if its contents are already visible to you; translate-text would strip the formatting. For plain text pasted into the conversation, use translate-text instead. Supported file extensions in this deployment: .docx, .doc, .pptx, .ppt, .xlsx, .xls, .pdf, .htm, .html, .txt, .xlf, .xliff, .srt, .xlsm, .md, .markdown, .yaml, .yml, .json, .xml, .vtt, .properties, .strings, .resx, .rtf, .odt, .dita, .idml, .mif, .zip, .png, .jpg, .jpeg. PNG and JPEG files are limited to 3 MB; limits for other formats depend on the user's plan. Use this tool to start a translation of a file you can upload or that the user selects, and pass 'filename' with the file's extension. It reserves a short-lived upload session and returns 'sessionId' and 'uploadUrl'; it does not upload the file itself, and nothing is translated or billed until the file arrives. If the call had no 'filename', first call upload-document again with it. Then do exactly one of the following: 1. Upload the source file bytes: HTTP PUT the raw bytes to 'uploadUrl' with 'Content-Type: application/octet-stream'. 2. If you cannot access or transfer the file bytes, immediately call upload-document-show-fallback-widget with the returned 'sessionId'; it shows the user an upload widget where they select the file. Being unable to upload the bytes directly is an expected, recoverable condition: the next step is then to call upload-document-show-fallback-widget. Pass all target languages in one call rather than one call per language: the file is then uploaded only once. Each language is translated and billed separately once the file arrives. A language DeepL refuses is listed in 'failures' while the others still translate. An administrator may assign a language system (style profile) to the account, whose glossaries and style rule set can replace the glossaryId and styleId passed here; 'appliedCustomizations' on a target says so when it happened, per target language.

upload-document

Translate text into one or more languages with DeepL. Use this for any text in the conversation: words, phrases, messages, UI strings, or pasted passages, also when the user asks how to say something in another language. For a file or document (e.g. Word, PowerPoint, Excel, PDF, HTML, .txt, .srt, .xlf/.xliff), use upload-document instead, even if you can read its contents: upload-document keeps the layout and formatting, and this tool returns plain text. Set the optional parameters that the request implies, such as formality. When the text comes from a longer document or conversation, pass the text around it as context. On the DeepL Free plan, formality, context, and customInstructions are not applied; 'ignoredParameters' in the result lists the ones that were dropped. Pass all target languages in one call: the result holds one entry per language, and a language DeepL refuses is listed in 'failures' while the others still translate. Pass separate texts as separate entries: within each language, the results match the inputs by position. A blank text rejects the whole request. To apply a glossary that the user names, look up its id with list-glossaries and also pass sourceLang. An unknown glossaryId is ignored, and the translation runs without it. An administrator may assign a language system (style profile) to the account, whose glossaries and style rule set can replace the glossaryId and styleId passed here; 'appliedCustomizations' in the result says so when it happened, per target language.

translate-text

Replace the label, prompt, and source language of a custom instruction. Send label and prompt even when only one of them changes. Use get-style-rule-set to find the instruction id and its current values. DeepL Pro only.

update-custom-instruction

Add terms to a glossary, or change existing terms, for one language pair. Use this to fill a new glossary, to extend one, or to add a language pair to it. A source term that the glossary already has gets the target term you send; all other terms stay unchanged. To delete terms, use remove-glossary-entries. DeepL Pro only.

update-glossary-entries

Rename a style rule set, or change which predefined style rules it enables. Call get-style-rule-set first: version and language must come from its latest response. rules replaces the enabled rules: omit it to keep them, pass {} to disable all, or pass the complete set of rules that must be enabled. Use create-custom-instruction and update-custom-instruction for the instructions of the set. DeepL Pro only.

update-style-rule-set