Can I use Crowdin as a CLI?

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

Can I expose Crowdin through MCP?

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

Where are Crowdin credentials stored?

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

Can I deny write access for Crowdin MCP tools?

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

productivity

Crowdin Lua API for KosmoKrator Agents

Agent-facing Lua documentation and function reference for the Crowdin KosmoKrator integration.

Lua Namespace

Agents call this integration through app.integrations.crowdin.*. Use lua_read_doc("integrations.crowdin") inside KosmoKrator to discover the same reference at runtime.

Call Lua from the Headless CLI

Use kosmo integrations:lua when a shell script, CI job, cron job, or another coding CLI should run a deterministic Crowdin workflow without starting an interactive agent session.

Inline Lua call

kosmo integrations:lua --eval 'dump(app.integrations.crowdin.list_projects({group_id = 1, limit = 1, offset = 1}))' --json

Read Lua docs headlessly

kosmo integrations:lua --eval 'print(docs.read("crowdin"))' --json
kosmo integrations:lua --eval 'print(docs.read("crowdin.list_projects"))' --json

Workflow file

Put repeatable logic in a Lua file, then execute it with JSON output for the calling process.

workflow.lua

local crowdin = app.integrations.crowdin
local result = crowdin.list_projects({group_id = 1, limit = 1, offset = 1})

dump(result)

Run the workflow

kosmo integrations:lua workflow.lua --json
kosmo integrations:lua workflow.lua --force --json

Namespace note. integrations:lua exposes app.integrations.crowdin, app.mcp.*, docs.*, json.*, and regex.*. Use app.integrations.crowdin.default.* or app.integrations.crowdin.work.* when you configured named credential accounts.

MCP-only Lua

If the script only needs configured MCP servers and does not need Crowdin, use the narrower mcp:lua command.

MCP Lua command

# Use mcp:lua for MCP-only scripts; use integrations:lua for this integration namespace.
kosmo mcp:lua --eval 'dump(mcp.servers())' --json

Agent-Facing Lua Docs

This is the rendered version of the full Lua documentation exposed to agents when they inspect the integration namespace.

Crowdin Integration

Tools

crowdin_list_projects

List Crowdin projects.

Parameters:

group_id (integer, optional) — Filter projects by group ID.
limit (integer, optional) — Maximum number of projects to return (max 500, default 25).
offset (integer, optional) — Pagination offset (default 0).

crowdin_get_project

Get details of a specific project.

Parameters:

project_id (integer, required) — The project ID.

crowdin_list_strings

List source strings in a project.

Parameters:

project_id (integer, required) — The project ID.
file_id (integer, optional) — Filter by file ID.
branch_id (integer, optional) — Filter by branch ID.
limit (integer, optional) — Maximum number of strings to return (default 25).
offset (integer, optional) — Pagination offset (default 0).

crowdin_get_string

Get details of a specific source string.

Parameters:

project_id (integer, required) — The project ID.
string_id (integer, required) — The string ID.

crowdin_list_translations

List translations in a project.

Parameters:

project_id (integer, required) — The project ID.
string_id (integer, optional) — Filter by source string ID.
language_id (integer, optional) — Filter by language ID.
limit (integer, optional) — Maximum number of translations to return (default 25).
offset (integer, optional) — Pagination offset (default 0).

crowdin_list_languages

List supported languages.

Parameters:

limit (integer, optional) — Maximum number of languages to return (default 25).
offset (integer, optional) — Pagination offset (default 0).

crowdin_get_current_user

Get the currently authenticated user.

Parameters: None.

Raw agent markdown

# Crowdin Integration

## Tools

### crowdin_list_projects
List Crowdin projects.

**Parameters:**
- `group_id` (integer, optional) — Filter projects by group ID.
- `limit` (integer, optional) — Maximum number of projects to return (max 500, default 25).
- `offset` (integer, optional) — Pagination offset (default 0).

### crowdin_get_project
Get details of a specific project.

**Parameters:**
- `project_id` (integer, required) — The project ID.

### crowdin_list_strings
List source strings in a project.

**Parameters:**
- `project_id` (integer, required) — The project ID.
- `file_id` (integer, optional) — Filter by file ID.
- `branch_id` (integer, optional) — Filter by branch ID.
- `limit` (integer, optional) — Maximum number of strings to return (default 25).
- `offset` (integer, optional) — Pagination offset (default 0).

### crowdin_get_string
Get details of a specific source string.

**Parameters:**
- `project_id` (integer, required) — The project ID.
- `string_id` (integer, required) — The string ID.

### crowdin_list_translations
List translations in a project.

**Parameters:**
- `project_id` (integer, required) — The project ID.
- `string_id` (integer, optional) — Filter by source string ID.
- `language_id` (integer, optional) — Filter by language ID.
- `limit` (integer, optional) — Maximum number of translations to return (default 25).
- `offset` (integer, optional) — Pagination offset (default 0).

### crowdin_list_languages
List supported languages.

**Parameters:**
- `limit` (integer, optional) — Maximum number of languages to return (default 25).
- `offset` (integer, optional) — Pagination offset (default 0).

### crowdin_get_current_user
Get the currently authenticated user.

**Parameters:** None.

Metadata-derived Lua example

local result = app.integrations.crowdin.list_projects({group_id = 1, limit = 1, offset = 1})
print(result)

Functions

list_projects Read

List Crowdin projects. Returns project IDs, names, target languages, and other metadata. Supports pagination and filtering by group.

Lua path: app.integrations.crowdin.list_projects
Full name: crowdin.crowdin_list_projects

Parameter	Type	Required	Description
`group_id`	integer	no	Filter projects by group ID.
`limit`	integer	no	Maximum number of projects to return (max 500, default 25).
`offset`	integer	no	Pagination offset (default 0).

get_project Read

Get details of a specific Crowdin project by ID. Returns project name, description, source/target languages, and other settings.

Lua path: app.integrations.crowdin.get_project
Full name: crowdin.crowdin_get_project

Parameter	Type	Required	Description
`project_id`	integer	yes	The project ID.

list_strings Read

List source strings in a Crowdin project. Returns string IDs, text, context, and file associations. Supports filtering by file or branch.

Lua path: app.integrations.crowdin.list_strings
Full name: crowdin.crowdin_list_strings

Parameter	Type	Required	Description
`project_id`	integer	yes	The project ID.
`file_id`	integer	no	Filter strings by file ID.
`branch_id`	integer	no	Filter strings by branch ID.
`limit`	integer	no	Maximum number of strings to return (default 25).
`offset`	integer	no	Pagination offset (default 0).

get_string Read

Get details of a specific source string in a Crowdin project. Returns string text, context, file path, and other metadata.

Lua path: app.integrations.crowdin.get_string
Full name: crowdin.crowdin_get_string

Parameter	Type	Required	Description
`project_id`	integer	yes	The project ID.
`string_id`	integer	yes	The string ID.

list_translations Read

List translations in a Crowdin project. Returns translated text, language info, and approval status. Supports filtering by string or language.

Lua path: app.integrations.crowdin.list_translations
Full name: crowdin.crowdin_list_translations

Parameter	Type	Required	Description
`project_id`	integer	yes	The project ID.
`string_id`	integer	no	Filter translations by source string ID.
`language_id`	integer	no	Filter translations by language ID.
`limit`	integer	no	Maximum number of translations to return (default 25).
`offset`	integer	no	Pagination offset (default 0).

list_languages Read

List languages supported by Crowdin. Returns language IDs, locale codes (e.g., "en", "de", "fr"), names, and text direction.

Lua path: app.integrations.crowdin.list_languages
Full name: crowdin.crowdin_list_languages

Parameter	Type	Required	Description
`limit`	integer	no	Maximum number of languages to return (default 25).
`offset`	integer	no	Pagination offset (default 0).

get_current_user Read

Get the currently authenticated Crowdin user profile. Returns username, email, display name, and avatar URL.

Lua path: app.integrations.crowdin.get_current_user
Full name: crowdin.crowdin_get_current_user

Parameter	Type	Required	Description
No parameters.