Can I use Cloudinary as a CLI?

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

Can I expose Cloudinary through MCP?

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

Where are Cloudinary credentials stored?

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

Can I deny write access for Cloudinary MCP tools?

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

data

Cloudinary CLI for AI Agents

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

Cloudinary CLI Setup

Cloudinary can be configured headlessly with `kosmokrator integrations:configure cloudinary`.

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 cloudinary --enable --read allow --write ask --json
kosmokrator integrations:doctor cloudinary --json
kosmokrator integrations:status --json

Credentials

Authentication type: api key secret api_key_secret. 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 cloudinary.cloudinary_api_get '{"path":"example_path","params":"example_params"}' --json

Provider shortcut

kosmo integrations:cloudinary cloudinary_api_get '{"path":"example_path","params":"example_params"}' --json

Discovery

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

Discovery commands

kosmo integrations:docs cloudinary --json
kosmo integrations:docs cloudinary.cloudinary_api_get --json
kosmo integrations:schema cloudinary.cloudinary_api_get --json
kosmo integrations:search "Cloudinary" --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.

`cloudinary.cloudinary_api_get`

Call a read-only Cloudinary Admin API GET endpoint not covered by a first-class tool.

Read read

Parameters: path, params

Generic call

kosmo integrations:call cloudinary.cloudinary_api_get '{"path":"example_path","params":"example_params"}' --json

Shortcut

kosmo integrations:cloudinary cloudinary_api_get '{"path":"example_path","params":"example_params"}' --json

`cloudinary.cloudinary_create_folder`

Create a Cloudinary asset folder.

Write write

Parameters: folder

Generic call

kosmo integrations:call cloudinary.cloudinary_create_folder '{"folder":"example_folder"}' --json

Shortcut

kosmo integrations:cloudinary cloudinary_create_folder '{"folder":"example_folder"}' --json

`cloudinary.cloudinary_delete_folder`

Delete an empty Cloudinary asset folder.

Write write

Parameters: folder, params

Generic call

kosmo integrations:call cloudinary.cloudinary_delete_folder '{"folder":"example_folder","params":"example_params"}' --json

Shortcut

kosmo integrations:cloudinary cloudinary_delete_folder '{"folder":"example_folder","params":"example_params"}' --json

`cloudinary.cloudinary_delete_resource`

Delete a media resource from Cloudinary by its type and public ID. This permanently removes the asset and all its derived resources.

Write write

Parameters: type, public_id, delivery_type, invalidate

Generic call

kosmo integrations:call cloudinary.cloudinary_delete_resource '{"type":"example_type","public_id":"example_public_id","delivery_type":"example_delivery_type","invalidate":true}' --json

Shortcut

kosmo integrations:cloudinary cloudinary_delete_resource '{"type":"example_type","public_id":"example_public_id","delivery_type":"example_delivery_type","invalidate":true}' --json

`cloudinary.cloudinary_get_resource`

Get details of a specific Cloudinary resource by its type and public ID. Returns full asset metadata including dimensions, format, URL, tags, and derived resources.

Read read

Parameters: type, public_id, delivery_type

Generic call

kosmo integrations:call cloudinary.cloudinary_get_resource '{"type":"example_type","public_id":"example_public_id","delivery_type":"example_delivery_type"}' --json

Shortcut

kosmo integrations:cloudinary cloudinary_get_resource '{"type":"example_type","public_id":"example_public_id","delivery_type":"example_delivery_type"}' --json

`cloudinary.cloudinary_get_usage`

Get Cloudinary product environment usage details.

Read read

Parameters: params

Generic call

kosmo integrations:call cloudinary.cloudinary_get_usage '{"params":"example_params"}' --json

Shortcut

kosmo integrations:cloudinary cloudinary_get_usage '{"params":"example_params"}' --json

`cloudinary.cloudinary_list_folders`

List all folders in your Cloudinary cloud. Returns folder names and paths with pagination support.

Read read

Parameters: max_results, next_cursor

Generic call

kosmo integrations:call cloudinary.cloudinary_list_folders '{"max_results":1,"next_cursor":"example_next_cursor"}' --json

Shortcut

kosmo integrations:cloudinary cloudinary_list_folders '{"max_results":1,"next_cursor":"example_next_cursor"}' --json

`cloudinary.cloudinary_list_resources`

List media resources in your Cloudinary cloud. Filter by resource type (image, video, raw) and prefix. Supports pagination with max_results and next_cursor.

Read read

Parameters: type, max_results, next_cursor, prefix, delivery_type

Generic call

kosmo integrations:call cloudinary.cloudinary_list_resources '{"type":"example_type","max_results":1,"next_cursor":"example_next_cursor","prefix":"example_prefix","delivery_type":"example_delivery_type"}' --json

Shortcut

kosmo integrations:cloudinary cloudinary_list_resources '{"type":"example_type","max_results":1,"next_cursor":"example_next_cursor","prefix":"example_prefix","delivery_type":"example_delivery_type"}' --json

`cloudinary.cloudinary_list_resources_by_tag`

List Cloudinary assets that have a specific tag.

Read read

Parameters: tag, resource_type, params

Generic call

kosmo integrations:call cloudinary.cloudinary_list_resources_by_tag '{"tag":"example_tag","resource_type":"example_resource_type","params":"example_params"}' --json

Shortcut

kosmo integrations:cloudinary cloudinary_list_resources_by_tag '{"tag":"example_tag","resource_type":"example_resource_type","params":"example_params"}' --json

`cloudinary.cloudinary_list_subfolders`

List subfolders under a Cloudinary folder path.

Read read

Parameters: folder, params

Generic call

kosmo integrations:call cloudinary.cloudinary_list_subfolders '{"folder":"example_folder","params":"example_params"}' --json

Shortcut

kosmo integrations:cloudinary cloudinary_list_subfolders '{"folder":"example_folder","params":"example_params"}' --json

`cloudinary.cloudinary_list_tags`

List tag names used by Cloudinary assets for a resource type.

Read read

Parameters: resource_type, params

Generic call

kosmo integrations:call cloudinary.cloudinary_list_tags '{"resource_type":"example_resource_type","params":"example_params"}' --json

Shortcut

kosmo integrations:cloudinary cloudinary_list_tags '{"resource_type":"example_resource_type","params":"example_params"}' --json

`cloudinary.cloudinary_list_transformations`

List Cloudinary named transformations with pagination.

Read read

Parameters: params

Generic call

kosmo integrations:call cloudinary.cloudinary_list_transformations '{"params":"example_params"}' --json

Shortcut

kosmo integrations:cloudinary cloudinary_list_transformations '{"params":"example_params"}' --json

`cloudinary.cloudinary_list_upload_presets`

List Cloudinary upload presets with pagination.

Read read

Parameters: params

Generic call

kosmo integrations:call cloudinary.cloudinary_list_upload_presets '{"params":"example_params"}' --json

Shortcut

kosmo integrations:cloudinary cloudinary_list_upload_presets '{"params":"example_params"}' --json

`cloudinary.cloudinary_ping`

Ping Cloudinary servers to test API reachability.

Read read

Parameters: none

Generic call

kosmo integrations:call cloudinary.cloudinary_ping '{}' --json

Shortcut

kosmo integrations:cloudinary cloudinary_ping '{}' --json

`cloudinary.cloudinary_search_folders`

Search Cloudinary asset folders with optional expression and pagination parameters.

Read read

Parameters: params

Generic call

kosmo integrations:call cloudinary.cloudinary_search_folders '{"params":"example_params"}' --json

Shortcut

kosmo integrations:cloudinary cloudinary_search_folders '{"params":"example_params"}' --json

`cloudinary.cloudinary_search_resources`

Search Cloudinary assets using the Admin API search expression language.

Read read

Parameters: params

Generic call

kosmo integrations:call cloudinary.cloudinary_search_resources '{"params":"example_params"}' --json

Shortcut

kosmo integrations:cloudinary cloudinary_search_resources '{"params":"example_params"}' --json

`cloudinary.cloudinary_upload`

Upload an image to Cloudinary. Provide a file URL or base64 data URI, an optional public ID, and an optional folder path. Returns the uploaded asset details.

Read read

Parameters: file, public_id, folder, resource_type, options

Generic call

kosmo integrations:call cloudinary.cloudinary_upload '{"file":"example_file","public_id":"example_public_id","folder":"example_folder","resource_type":"example_resource_type","options":"example_options"}' --json

Shortcut

kosmo integrations:cloudinary cloudinary_upload '{"file":"example_file","public_id":"example_public_id","folder":"example_folder","resource_type":"example_resource_type","options":"example_options"}' --json

Function Schemas

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

cloudinary.cloudinary_api_get 2 parameters

Schema command

kosmo integrations:schema cloudinary.cloudinary_api_get --json

Parameter	Type	Required	Description
`path`	string	yes	Admin API path such as /resources/search or /usage.
`params`	object	no	Query parameters.

cloudinary.cloudinary_create_folder 1 parameters

Schema command

kosmo integrations:schema cloudinary.cloudinary_create_folder --json

Parameter	Type	Required	Description
`folder`	string	yes	Folder path to create.

cloudinary.cloudinary_delete_folder 2 parameters

Schema command

kosmo integrations:schema cloudinary.cloudinary_delete_folder --json

Parameter	Type	Required	Description
`folder`	string	yes	Folder path to delete.
`params`	object	no	Optional delete parameters such as skip_backup.

cloudinary.cloudinary_delete_resource 4 parameters

Schema command

kosmo integrations:schema cloudinary.cloudinary_delete_resource --json

Parameter	Type	Required	Description
`type`	string	yes	Resource type: "image", "video", or "raw".
`public_id`	string	yes	The public ID of the resource to delete (e.g. "blog/old-photo").
`delivery_type`	string	no	Delivery type such as upload, private, or authenticated. Default: upload.
`invalidate`	boolean	no	Whether to request CDN invalidation where enabled for the account.

cloudinary.cloudinary_get_resource 3 parameters

Schema command

kosmo integrations:schema cloudinary.cloudinary_get_resource --json

Parameter	Type	Required	Description
`type`	string	yes	Resource type: "image", "video", or "raw".
`public_id`	string	yes	The public ID of the resource (e.g. "blog/hero-image").
`delivery_type`	string	no	Delivery type such as upload, private, or authenticated. Default: upload.

cloudinary.cloudinary_get_usage 1 parameters

Schema command

kosmo integrations:schema cloudinary.cloudinary_get_usage --json

Parameter	Type	Required	Description
`params`	object	no	Optional date parameter in yyyy-mm-dd format.

cloudinary.cloudinary_list_folders 2 parameters

Schema command

kosmo integrations:schema cloudinary.cloudinary_list_folders --json

Parameter	Type	Required	Description
`max_results`	integer	no	Maximum number of folders to return (default 10).
`next_cursor`	string	no	Pagination cursor from a previous response to get the next page.

cloudinary.cloudinary_list_resources 5 parameters

Schema command

kosmo integrations:schema cloudinary.cloudinary_list_resources --json

Parameter	Type	Required	Description
`type`	string	no	Resource type to list: "image", "video", or "raw". Defaults to "image".
`max_results`	integer	no	Maximum number of resources to return (max 500, default 10).
`next_cursor`	string	no	Pagination cursor from a previous response to get the next page.
`prefix`	string	no	Only include resources whose public ID starts with this prefix (e.g. "blog/").
`delivery_type`	string	no	Delivery type such as upload, private, or authenticated. Default: upload.

cloudinary.cloudinary_list_resources_by_tag 3 parameters

Schema command

kosmo integrations:schema cloudinary.cloudinary_list_resources_by_tag --json

Parameter	Type	Required	Description
`tag`	string	yes	Tag name.
`resource_type`	string	no	Resource type: image, video, or raw. Default: image.
`params`	object	no	Optional max_results, next_cursor, and direction.

cloudinary.cloudinary_list_subfolders 2 parameters

Schema command

kosmo integrations:schema cloudinary.cloudinary_list_subfolders --json

Parameter	Type	Required	Description
`folder`	string	yes	Parent folder path.
`params`	object	no	Optional max_results and next_cursor.

cloudinary.cloudinary_list_tags 2 parameters

Schema command

kosmo integrations:schema cloudinary.cloudinary_list_tags --json

Parameter	Type	Required	Description
`resource_type`	string	no	Resource type: image, video, or raw. Default: image.
`params`	object	no	Optional prefix, max_results, and next_cursor.

cloudinary.cloudinary_list_transformations 1 parameters

Schema command

kosmo integrations:schema cloudinary.cloudinary_list_transformations --json

Parameter	Type	Required	Description
`params`	object	no	Optional max_results and next_cursor.

cloudinary.cloudinary_list_upload_presets 1 parameters

Schema command

kosmo integrations:schema cloudinary.cloudinary_list_upload_presets --json

Parameter	Type	Required	Description
`params`	object	no	Optional max_results and next_cursor.

cloudinary.cloudinary_ping 0 parameters

Schema command

kosmo integrations:schema cloudinary.cloudinary_ping --json

Parameter	Type	Required	Description
No parameters.

cloudinary.cloudinary_search_folders 1 parameters

Schema command

kosmo integrations:schema cloudinary.cloudinary_search_folders --json

Parameter	Type	Required	Description
`params`	object	no	Optional expression, sort_by, max_results, and next_cursor.

cloudinary.cloudinary_search_resources 1 parameters

Schema command

kosmo integrations:schema cloudinary.cloudinary_search_resources --json

Parameter	Type	Required	Description
`params`	object	no	Query parameters such as expression, sort_by, max_results, next_cursor, aggregate, with_field.

cloudinary.cloudinary_upload 5 parameters

Schema command

kosmo integrations:schema cloudinary.cloudinary_upload --json

Parameter	Type	Required	Description
`file`	string	yes	The file to upload — a remote URL (e.g. "https://example.test/photo.jpg") or a base64 data URI (e.g. "data:image/png;base64,...").
`public_id`	string	no	The public ID to assign to the uploaded asset. If omitted, Cloudinary generates a random ID.
`folder`	string	no	The folder to store the asset in (e.g. "blog/images").
`resource_type`	string	no	Resource type: image, video, or raw. Default: image.
`options`	object	no	Additional signed upload parameters such as tags, context, eager, overwrite, or upload_preset.

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.