Can I use DeepL as a CLI?

Yes. KosmoKrator exposes a DeepL CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose DeepL through MCP?

Yes. The KosmoKrator MCP gateway can expose selected DeepL tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are DeepL credentials stored?

DeepL credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for DeepL MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

DeepL CLI for AI Agents

Use the DeepL CLI from KosmoKrator to call DeepL tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

DeepL CLI Setup

DeepL can be configured headlessly with `kosmokrator integrations:configure deepl`.

Install, configure, and verify

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure deepl --enable --read allow --write ask --json
kosmokrator integrations:doctor deepl --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

No credentials are required.

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call

kosmo integrations:call deepl.deepl_translate_text '{}' --json

Provider shortcut

kosmo integrations:deepl deepl_translate_text '{}' --json

Discovery

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

Discovery commands

kosmo integrations:docs deepl --json
kosmo integrations:docs deepl.deepl_translate_text --json
kosmo integrations:schema deepl.deepl_translate_text --json
kosmo integrations:search "DeepL" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CI Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status. Cron Jobs Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config. Shell Scripts Call integration functions from shell scripts with stable JSON input and output. Headless Automation Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers. Coding Agents Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

`deepl.deepl_translate_text`

The translate function. The total request body size must not exceed 128 KiB (128 * 1024 bytes). Please split up your text into multiple calls if it exceeds this limit.

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_translate_text '{}' --json

Shortcut

kosmo integrations:deepl deepl_translate_text '{}' --json

`deepl.deepl_translate_document`

This call uploads a document and queues it for translation. The call returns once the upload is complete, returning a document ID and key which can be used to query the translation statushttps://www.deepl.com/docs-api/documents/get-document-status and to download the translated documenthttps://www.deepl.com/docs-api/documents/download-document once translation is complete. Because the request includes a file upload, it must be an HTTP POST request with content type multipart/form-data. Please be aware that the uploaded document is automatically removed from the server once the translated document has been downloaded. You have to upload the document again in order to restart the translation. The maximum upload limit for documents is available herehttps://support.deepl.com/hc/articles/360020582359-Document-formats and may vary based on API plan and document type. You may specify the glossary to use for the document translation using the glossaryid parameter. Important: This requires the sourcelang parameter to be set and the language pair of the glossary has to match the language pair of the request.

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_translate_document '{}' --json

Shortcut

kosmo integrations:deepl deepl_translate_document '{}' --json

`deepl.deepl_get_document_status`

Retrieve the current status of a document translation process. If the translation is still in progress, the estimated time remaining is also included in the response.

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_get_document_status '{}' --json

Shortcut

kosmo integrations:deepl deepl_get_document_status '{}' --json

`deepl.deepl_download_document`

Once the status of the document translation process is done, the result can be downloaded. For privacy reasons the translated document is automatically removed from the server once it was downloaded and cannot be downloaded again.

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_download_document '{}' --json

Shortcut

kosmo integrations:deepl deepl_download_document '{}' --json

`deepl.deepl_list_glossary_languages`

Retrieve the list of language pairs supported by the glossary feature.

Read read

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_list_glossary_languages '{}' --json

Shortcut

kosmo integrations:deepl deepl_list_glossary_languages '{}' --json

`deepl.deepl_create_multilingual_glossary`

Create a Glossary

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_create_multilingual_glossary '{}' --json

Shortcut

kosmo integrations:deepl deepl_create_multilingual_glossary '{}' --json

`deepl.deepl_list_multilingual_glossaries`

List all glossaries and their meta-information, but not the glossary entries.

Read read

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_list_multilingual_glossaries '{}' --json

Shortcut

kosmo integrations:deepl deepl_list_multilingual_glossaries '{}' --json

`deepl.deepl_get_multilingual_glossary`

Retrieve meta information for a single glossary, omitting the glossary entries.

Read read

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_get_multilingual_glossary '{}' --json

Shortcut

kosmo integrations:deepl deepl_get_multilingual_glossary '{}' --json

`deepl.deepl_patch_multilingual_glossary`

Edit glossary details, such as name or a dictionary for a source and target language.

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_patch_multilingual_glossary '{}' --json

Shortcut

kosmo integrations:deepl deepl_patch_multilingual_glossary '{}' --json

`deepl.deepl_delete_multilingual_glossary`

Deletes the specified glossary.

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_delete_multilingual_glossary '{}' --json

Shortcut

kosmo integrations:deepl deepl_delete_multilingual_glossary '{}' --json

`deepl.deepl_get_multilingual_glossary_entries`

List the entries of a single glossary in tsv format.

Read read

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_get_multilingual_glossary_entries '{}' --json

Shortcut

kosmo integrations:deepl deepl_get_multilingual_glossary_entries '{}' --json

`deepl.deepl_delete_dictionary`

Deletes the dictionary associated with the given language pair with the given glossary ID.

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_delete_dictionary '{}' --json

Shortcut

kosmo integrations:deepl deepl_delete_dictionary '{}' --json

`deepl.deepl_replace_dictionary`

Replaces or creates a dictionary in the glossary with the specified entries.

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_replace_dictionary '{}' --json

Shortcut

kosmo integrations:deepl deepl_replace_dictionary '{}' --json

`deepl.deepl_create_glossary`

Create a Glossary

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_create_glossary '{}' --json

Shortcut

kosmo integrations:deepl deepl_create_glossary '{}' --json

`deepl.deepl_list_glossaries`

List all glossaries and their meta-information, but not the glossary entries.

Read read

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_list_glossaries '{}' --json

Shortcut

kosmo integrations:deepl deepl_list_glossaries '{}' --json

`deepl.deepl_get_glossary`

Retrieve meta information for a single glossary, omitting the glossary entries.

Read read

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_get_glossary '{}' --json

Shortcut

kosmo integrations:deepl deepl_get_glossary '{}' --json

`deepl.deepl_delete_glossary`

Deletes the specified glossary.

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_delete_glossary '{}' --json

Shortcut

kosmo integrations:deepl deepl_delete_glossary '{}' --json

`deepl.deepl_get_glossary_entries`

List the entries of a single glossary in the format specified by the Accept header.

Read read

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_get_glossary_entries '{}' --json

Shortcut

kosmo integrations:deepl deepl_get_glossary_entries '{}' --json

`deepl.deepl_rephrase_text`

Request text improvement

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_rephrase_text '{}' --json

Shortcut

kosmo integrations:deepl deepl_rephrase_text '{}' --json

`deepl.deepl_get_usage`

Retrieve usage information within the current billing period together with the corresponding account limits. Usage is returned for translated characters, translated documents, and translated documents team totals for team accounts only. Character usage includes both text and document translations, and is measured by the source text length in Unicode code points. Document usage only includes document translations, and is measured in individual documents. Depending on the user account type, some usage types will be omitted. Character usage is only included for developer accounts. Document usage is only included for non-developer accounts, and team-combined document usage is only included for non-developer team accounts.

Read read

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_get_usage '{}' --json

Shortcut

kosmo integrations:deepl deepl_get_usage '{}' --json

`deepl.deepl_list_languages`

Retrieve the list of languages that are currently supported for translation, either as source or target language, respectively.

Read read

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_list_languages '{}' --json

Shortcut

kosmo integrations:deepl deepl_list_languages '{}' --json

`deepl.deepl_admin_create_developer_key`

Create a developer key as an admin

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_admin_create_developer_key '{}' --json

Shortcut

kosmo integrations:deepl deepl_admin_create_developer_key '{}' --json

`deepl.deepl_admin_get_developer_keys`

Get all developer keys as an admin

Read read

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_admin_get_developer_keys '{}' --json

Shortcut

kosmo integrations:deepl deepl_admin_get_developer_keys '{}' --json

`deepl.deepl_admin_deactivate_developer_key`

Deactivate a developer key as an admin

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_admin_deactivate_developer_key '{}' --json

Shortcut

kosmo integrations:deepl deepl_admin_deactivate_developer_key '{}' --json

`deepl.deepl_admin_rename_developer_key`

Rename a developer key as an admin

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_admin_rename_developer_key '{}' --json

Shortcut

kosmo integrations:deepl deepl_admin_rename_developer_key '{}' --json

`deepl.deepl_admin_set_developer_key_usage_limits`

Set developer key usage limits as an admin

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_admin_set_developer_key_usage_limits '{}' --json

Shortcut

kosmo integrations:deepl deepl_admin_set_developer_key_usage_limits '{}' --json

`deepl.deepl_admin_get_analytics`

Retrieve usage statistics for the organization within a specified date range. Optionally group the results by API key or by API key and day.

Read read

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_admin_get_analytics '{}' --json

Shortcut

kosmo integrations:deepl deepl_admin_get_analytics '{}' --json

`deepl.deepl_get_style_rule_lists`

Retrieve style rule lists

Read read

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_get_style_rule_lists '{}' --json

Shortcut

kosmo integrations:deepl deepl_get_style_rule_lists '{}' --json

`deepl.deepl_create_style_rule_list`

Create a style rule list

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_create_style_rule_list '{}' --json

Shortcut

kosmo integrations:deepl deepl_create_style_rule_list '{}' --json

`deepl.deepl_get_style_rule_list`

Retrieve a style rule list

Read read

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_get_style_rule_list '{}' --json

Shortcut

kosmo integrations:deepl deepl_get_style_rule_list '{}' --json

`deepl.deepl_update_style_rule_list`

Update a style rule list

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_update_style_rule_list '{}' --json

Shortcut

kosmo integrations:deepl deepl_update_style_rule_list '{}' --json

`deepl.deepl_delete_style_rule_list`

Delete a style rule list

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_delete_style_rule_list '{}' --json

Shortcut

kosmo integrations:deepl deepl_delete_style_rule_list '{}' --json

`deepl.deepl_update_style_rule_configured_rules`

Update configured rules for a style rule list

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_update_style_rule_configured_rules '{}' --json

Shortcut

kosmo integrations:deepl deepl_update_style_rule_configured_rules '{}' --json

`deepl.deepl_create_custom_instruction`

Create a custom instruction

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_create_custom_instruction '{}' --json

Shortcut

kosmo integrations:deepl deepl_create_custom_instruction '{}' --json

`deepl.deepl_get_custom_instruction`

Retrieve a custom instruction

Read read

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_get_custom_instruction '{}' --json

Shortcut

kosmo integrations:deepl deepl_get_custom_instruction '{}' --json

`deepl.deepl_update_custom_instruction`

Update a custom instruction

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_update_custom_instruction '{}' --json

Shortcut

kosmo integrations:deepl deepl_update_custom_instruction '{}' --json

`deepl.deepl_delete_custom_instruction`

Delete a custom instruction

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_delete_custom_instruction '{}' --json

Shortcut

kosmo integrations:deepl deepl_delete_custom_instruction '{}' --json

`deepl.deepl_list_translation_memories`

Retrieve a list of translation memories associated with the authenticated account.

Read read

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_list_translation_memories '{}' --json

Shortcut

kosmo integrations:deepl deepl_list_translation_memories '{}' --json

`deepl.deepl_get_voice_streaming_url`

Get Streaming URL

Write write

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_get_voice_streaming_url '{}' --json

Shortcut

kosmo integrations:deepl deepl_get_voice_streaming_url '{}' --json

`deepl.deepl_request_reconnection`

Request Reconnection

Read read

Parameters: none

Generic call

kosmo integrations:call deepl.deepl_request_reconnection '{}' --json

Shortcut

kosmo integrations:deepl deepl_request_reconnection '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

deepl.deepl_translate_text 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_translate_text --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_translate_document 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_translate_document --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_get_document_status 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_get_document_status --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_download_document 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_download_document --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_list_glossary_languages 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_list_glossary_languages --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_create_multilingual_glossary 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_create_multilingual_glossary --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_list_multilingual_glossaries 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_list_multilingual_glossaries --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_get_multilingual_glossary 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_get_multilingual_glossary --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_patch_multilingual_glossary 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_patch_multilingual_glossary --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_delete_multilingual_glossary 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_delete_multilingual_glossary --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_get_multilingual_glossary_entries 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_get_multilingual_glossary_entries --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_delete_dictionary 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_delete_dictionary --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_replace_dictionary 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_replace_dictionary --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_create_glossary 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_create_glossary --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_list_glossaries 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_list_glossaries --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_get_glossary 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_get_glossary --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_delete_glossary 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_delete_glossary --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_get_glossary_entries 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_get_glossary_entries --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_rephrase_text 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_rephrase_text --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_get_usage 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_get_usage --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_list_languages 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_list_languages --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_admin_create_developer_key 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_admin_create_developer_key --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_admin_get_developer_keys 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_admin_get_developer_keys --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_admin_deactivate_developer_key 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_admin_deactivate_developer_key --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_admin_rename_developer_key 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_admin_rename_developer_key --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_admin_set_developer_key_usage_limits 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_admin_set_developer_key_usage_limits --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_admin_get_analytics 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_admin_get_analytics --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_get_style_rule_lists 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_get_style_rule_lists --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_create_style_rule_list 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_create_style_rule_list --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_get_style_rule_list 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_get_style_rule_list --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_update_style_rule_list 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_update_style_rule_list --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_delete_style_rule_list 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_delete_style_rule_list --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_update_style_rule_configured_rules 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_update_style_rule_configured_rules --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_create_custom_instruction 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_create_custom_instruction --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_get_custom_instruction 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_get_custom_instruction --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_update_custom_instruction 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_update_custom_instruction --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_delete_custom_instruction 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_delete_custom_instruction --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_list_translation_memories 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_list_translation_memories --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_get_voice_streaming_url 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_get_voice_streaming_url --json

Parameter	Type	Required	Description
No parameters.

deepl.deepl_request_reconnection 0 parameters

Schema command

kosmo integrations:schema deepl.deepl_request_reconnection --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.