Cloudinary ACTION
Resource Transformation
Transforms image or video resources on-the-fly. It allows transformation options for resource optimization (i.e. web viewing), resize and crop the resources, etc. Image transformation documentation. Video transformation documentation
- Action
- Writes data
- API key
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's Cloudinary account once, then configure and run Resource Transformation from your backend or agent.
import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const result = await pd.actions.run({
id: "cloudinary-resource-transformation",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
cloudinary: { authProvisionId: "apn_xxxxxxx" },
resourceType: "Resource Type",
options: "Options",
},
})
console.log(result)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "cloudinary-resource-transformation",
"configured_props": {
"cloudinary": { "authProvisionId": "apn_xxxxxxx" },
"resourceType": "Resource Type",
"options": "Options"
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "cloudinary",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "cloudinary-resource-transformation",
arguments: {
resourceType: "Resource Type",
options: "Options",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| Property | Type | Description |
|---|---|---|
resourceType Resource Type | string | Type of the resource to upload. Valid values: image, video. Optional |
options Options | string | For an image resourceType, use this parameter to set the image transformation options to apply and/or the URL parameters supported by Cloudinary API. For all transformation options, please check Image transformation API reference, for URL parameters, please check Transforming media assets using dynamic URLs.
For a video resourceType, use this parameter to set video transformation options to apply and/or the URL parameters supported by Cloudinary API. For all transformation options, please check Video transformation API reference, for URL parameters, please check Transforming media assets using dynamic URLs. Required |
imageSource Image Source | string | If resourceType is an image, use this parameter to point to the source of the image to apply transformations on. It can be a local file, the actual image data, a remote FTP, HTTP or HTTPS URL address of an existing image. For details and examples, see: file source options. Optional |
videoPublicId Video Public Id | string | If resourceType is a video, use this parameter to set the public id of the video to apply transformations on. The public id is the unique identifier of the video, and is either specified when uploading the video to your Cloudinary account, or automatically assigned by Cloudinary. For more details on the options for specifying the public id, see Public ID - the image identifier. Optional |
REFERENCE
Tool details
Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.
- Registry key
- cloudinary-resource-transformation
- Version
- 0.2.2
- App
- Cloudinary
- Authentication
- API key
- Behavior
- May modify external data
- Source
- View on GitHub ↗