Cloudinary Analysis — Claude Code MCP server for image analysis
The Cloudinary Analysis MCP server for Claude Code sends external images to Cloudinary for analysis. It can check moderation, produce captions and tags, and run other supported analysis modes.
MIT updated 2026-11-12
claude mcp add --transport http analysis-mcp https://analysis.mcp.cloudinary.com/mcpWhat Cloudinary Analysis does
Cloudinary Analysis sends an external asset to the Analyze API and returns results for the requested analysis. Available modes include moderation, general AI Vision queries, captioning, tagging, image quality checks, and watermark detection. Models also cover specific categories such as fashion and human anatomy.
The Analyze API is in public beta. Each analysis mode requires an active subscription to its corresponding Cloudinary add-on. Authentication uses a Cloudinary API Key and API Secret, or OAuth2.
What it helps with
- check an image for policy violations
- generate a caption or tags for an image
- assess image quality
- detect a watermark in an image
Example prompts for the agent
- Check this external image for moderation issues with Cloudinary.
- Generate a caption and tags for this image using Cloudinary.
- Assess this image’s quality through Cloudinary.
How to install Cloudinary Analysis
1Platform CLI: remote server
claude mcp add --transport http analysis-mcp https://analysis.mcp.cloudinary.com/mcp2Platform CLI
claude mcp add --env CLOUDINARY_CLOUD_NAME=<CLOUDINARY_CLOUD_NAME> --env CLOUDINARY_API_KEY=<CLOUDINARY_API_KEY> --env CLOUDINARY_API_SECRET=<CLOUDINARY_API_SECRET> --transport stdio cloudinary-analysis -- npx -y @cloudinary/analysis-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add cloudinary-analysis --url https://analysis.mcp.cloudinary.com/mcp2Platform CLI
codex mcp add cloudinary-analysis --env CLOUDINARY_CLOUD_NAME=<CLOUDINARY_CLOUD_NAME> --env CLOUDINARY_API_KEY=<CLOUDINARY_API_KEY> --env CLOUDINARY_API_SECRET=<CLOUDINARY_API_SECRET> -- npx -y @cloudinary/analysis-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"cloudinary-analysis": {
"url": "https://analysis.mcp.cloudinary.com/mcp"
}
}
}{
"mcpServers": {
"cloudinary-analysis": {
"command": "npx",
"args": [
"-y",
"@cloudinary/analysis-mcp"
],
"env": {
"CLOUDINARY_CLOUD_NAME": "<CLOUDINARY_CLOUD_NAME>",
"CLOUDINARY_API_KEY": "<CLOUDINARY_API_KEY>",
"CLOUDINARY_API_SECRET": "<CLOUDINARY_API_SECRET>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"cloudinary-analysis": {
"type": "http",
"url": "https://analysis.mcp.cloudinary.com/mcp"
}
}
}{
"servers": {
"cloudinary-analysis": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cloudinary/analysis-mcp"
],
"env": {
"CLOUDINARY_CLOUD_NAME": "<CLOUDINARY_CLOUD_NAME>",
"CLOUDINARY_API_KEY": "<CLOUDINARY_API_KEY>",
"CLOUDINARY_API_SECRET": "<CLOUDINARY_API_SECRET>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http cloudinary-analysis https://analysis.mcp.cloudinary.com/mcp2Platform CLI
gemini mcp add -e CLOUDINARY_CLOUD_NAME=<CLOUDINARY_CLOUD_NAME> -e CLOUDINARY_API_KEY=<CLOUDINARY_API_KEY> -e CLOUDINARY_API_SECRET=<CLOUDINARY_API_SECRET> cloudinary-analysis npx -y @cloudinary/analysis-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Cloudinary Analysis
How do I install Cloudinary Analysis in Claude Code?
Add the remote MCP server with claude mcp add --transport http analysis-mcp https://analysis.mcp.cloudinary.com/mcp.
What does Cloudinary Analysis do?
It analyzes external images through Cloudinary, with modes such as moderation, captioning, tagging, image quality analysis, and watermark detection.
What does Cloudinary Analysis require?
It needs a Cloudinary Cloud Name and authentication through an API Key and API Secret or OAuth2. The selected analysis mode also requires an active subscription to its Cloudinary add-on.