Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Cloudinary MCP server

Vendor MCP
Open markdown

The Cloudinary MCP connector routes your AI agent's tool calls to Cloudinary's own MCP server through Scalekit. Each user signs in to Cloudinary once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 30 tools.

Tools
30
What they doRead · write · destructive
12 · 11 · 712 read11 write7 destructive
Users sign in with
OAuth app
Scalekit's or your own

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Cloudinary MCP connection

    In AgentKit > Connections, create a Cloudinary MCP connection. The name you give it is the connection_name your code passes. See Configure connections.

    Scalekit credentials are available for Cloudinary MCP server, so you don't need to register an OAuth app.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'cloudinarymcp'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Cloudinary MCP:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'cloudinarymcp_get_tx_reference',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • cloudinarymcp_get_asset_detailsGet resource by asset ID Returns the details of a single resource specified by its asset ID.Read-only

    Get Asset Details

    Get resource by asset ID Returns the details of a single resource specified by its asset ID.

    Inputs

    asset_idstringrequired
    The asset ID of the resource. Must be a 32-character hexadecimal string.
    accessibility_analysisboolean
    Whether to return accessibility analysis scores for the image. Default: false.default false
    colorsboolean
    Whether to include color information (predominant colors and histogram of 32 leading colors). Default: false.default false
    coordinatesboolean
    Whether to include previously specified custom cropping coordinates and faces coordinates. Default: false.default false
    derived_next_cursorstring
    The cursor for the next page of derived assets when there are more derived images than max_results.
    facesboolean
    Whether to include a list of coordinates of detected faces. Default: false.default false
    max_resultsinteger
    Maximum number of derived assets to return. Default: 10.default 10
    media_metadataboolean
    Whether to include IPTC, XMP, and detailed Exif metadata in the response. Default: false.default false
    pagesboolean
    Whether to report the number of pages in multi-page documents (e.g., PDF). Default: false.default false
    phashboolean
    Whether to include the perceptual hash (pHash) of the uploaded photo for image similarity detection. Default: false.default false
    quality_analysisboolean
    Whether to return quality analysis scores for the image. Default: false.default false
    versionsboolean
    Whether to include details of all the backed up versions of the asset. Default: false.default false
  • cloudinarymcp_get_generation_taskGet a generation task Get the status of a generation task.Read-only

    Get a Generation Task

    Get a generation task Get the status of a generation task.

    Inputs

    task_idstringrequired
    The ID of the generation task.
  • cloudinarymcp_get_tx_referenceGet Cloudinary transformation rules documentation from official docs MANDATORY before creating, modifying, or discussing Cloudinary transformations.Read-only

    Get Tx Reference

    Get Cloudinary transformation rules documentation from official docs MANDATORY before creating, modifying, or discussing Cloudinary transformations. Required when user asks for image/video effects, resizing, cropping, filters, etc. Not needed for simple asset management (upload, list, delete, etc.). Call only once per session - documentation doesn't change, reuse the knowledge. This tool returns the complete, authoritative Cloudinary transformation reference that contains all valid parameters, syntax rules, and best practices.

    Inputs

    This tool takes no inputs.

  • cloudinarymcp_get_usage_detailsRetrieves comprehensive usage metrics and account statistics A report on the status of product environment usage, including storage, credits, bandwidth, requests, number of resources, and add-on usage.Read-only

    Get Usage Details

    Retrieves comprehensive usage metrics and account statistics A report on the status of product environment usage, including storage, credits, bandwidth, requests, number of resources, and add-on usage. No date parameter needed to get current usage statistics.

    Inputs

    datestring
    The date for which to retrieve usage details (YYYY-MM-DD). If not specified, returns the current usage.
  • cloudinarymcp_list_filesGet raw assets Retrieves a list of raw assets.Read-only

    List Files

    Get raw assets Retrieves a list of raw assets. Results can be filtered by various criteria like tags, prefix, or specific public IDs.

    Inputs

    directionstring
    The sort direction for the results. Default is "desc".one of ascdesc
    fieldsstring
    Additional fields to include in the response. The fields public_id and asset_id are always included.
    max_resultsinteger
    Maximum number of results to return (1-500).
    next_cursorstring
    Cursor for pagination.
    prefixstring
    A public_id prefix. When specified, all assets with that prefix are returned.
    public_idsarray
    An array of public IDs to return.
    start_atstring
    An ISO-8601 formatted timestamp. When specified, returns resources created since that timestamp. Supported only if neither `prefix` nor `public_ids` were passed.
    tagsboolean
    Whether to include the list of tag names assigned to each asset. Default is false.default false
    typestring
    The delivery type to filter by. When omitted, returns assets of all delivery types.
  • cloudinarymcp_list_imagesGet image assets Retrieves a list of image assets.Read-only

    List Images

    Get image assets Retrieves a list of image assets. Results can be filtered by various criteria like tags, prefix, or specific public IDs.

    Inputs

    directionstring
    The sort direction for the results. Default is "desc".one of ascdesc
    fieldsstring
    Additional fields to include in the response. The fields public_id and asset_id are always included.
    max_resultsinteger
    Maximum number of results to return (1-500).
    next_cursorstring
    Cursor for pagination.
    prefixstring
    A public_id prefix. When specified, all assets with that prefix are returned.
    public_idsarray
    An array of public IDs to return.
    start_atstring
    An ISO-8601 formatted timestamp. When specified, returns resources created since that timestamp. Supported only if neither `prefix` nor `public_ids` were passed.
    tagsboolean
    Whether to include the list of tag names assigned to each asset. Default is false.default false
    typestring
    The delivery type to filter by. When omitted, returns assets of all delivery types.
  • cloudinarymcp_list_tagsRetrieves a list of tags currently applied to assets in your Cloudinary account Retrieves a comprehensive list of all tags that exist in your product environment for assets of the specified type.Read-only

    List Tags

    Retrieves a list of tags currently applied to assets in your Cloudinary account Retrieves a comprehensive list of all tags that exist in your product environment for assets of the specified type. [Cloudinary Admin API documentation](https://cloudinary.com/documentation/admin_api)

    Inputs

    resource_typestringrequired
    The type of resource (image, video, or raw).one of imagevideoraw
    max_resultsinteger
    Maximum number of results to return (1-500).
    next_cursorstring
    Cursor for pagination.
    prefixstring
    Limit the returned tags to those that start with the specified prefix.
  • cloudinarymcp_list_videosGet video assets Retrieves a list of video assets.Read-only

    List Videos

    Get video assets Retrieves a list of video assets. Results can be filtered by various criteria like tags, prefix, or specific public IDs.

    Inputs

    directionstring
    The sort direction for the results. Default is "desc".one of ascdesc
    fieldsstring
    Additional fields to include in the response. The fields public_id and asset_id are always included.
    max_resultsinteger
    Maximum number of results to return (1-500).
    next_cursorstring
    Cursor for pagination.
    prefixstring
    A public_id prefix. When specified, all assets with that prefix are returned.
    public_idsarray
    An array of public IDs to return.
    start_atstring
    An ISO-8601 formatted timestamp. When specified, returns resources created since that timestamp. Supported only if neither `prefix` nor `public_ids` were passed.
    tagsboolean
    Whether to include the list of tag names assigned to each asset. Default is false.default false
    typestring
    The delivery type to filter by. When omitted, returns assets of all delivery types.