# Cloudinary Structured Metadata

This MCP server for Claude Code manages Cloudinary structured metadata. It comes into play when an agent needs to work with metadata fields, their value sources, or rules.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: cloudinary
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cloudinary/structured-metadata-mcp
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/cloudinary-structured-metadata

## What it does

The server gives an agent tools for Cloudinary’s Structured Metadata API. It can list, create, edit, and delete metadata fields and rules, as well as search field value sources and restore removed entries.

Access requires a Cloudinary cloud name, API key, and API secret; `CLOUDINARY_URL` can replace the separate credentials. Local execution requires Node.js 20.19.0 or later. Claude Code can connect over HTTP or launch the package through `npx` using stdio.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://structured-metadata.mcp.cloudinary.com/mcp`
- Environment variables: `CLOUDINARY_CLOUD_NAME`, `CLOUDINARY_API_KEY`, `CLOUDINARY_API_SECRET` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http structured-metadata-mcp https://structured-metadata.mcp.cloudinary.com/mcp
```

2. **Platform CLI**
```bash
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-structured-metadata -- npx -y @cloudinary/structured-metadata-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add cloudinary-structured-metadata --url https://structured-metadata.mcp.cloudinary.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add cloudinary-structured-metadata --env CLOUDINARY_CLOUD_NAME=<CLOUDINARY_CLOUD_NAME> --env CLOUDINARY_API_KEY=<CLOUDINARY_API_KEY> --env CLOUDINARY_API_SECRET=<CLOUDINARY_API_SECRET> -- npx -y @cloudinary/structured-metadata-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cloudinary-structured-metadata": {
            "url": "https://structured-metadata.mcp.cloudinary.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cloudinary-structured-metadata": {
            "command": "npx",
            "args": [
                "-y",
                "@cloudinary/structured-metadata-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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cloudinary-structured-metadata": {
            "type": "http",
            "url": "https://structured-metadata.mcp.cloudinary.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cloudinary-structured-metadata": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@cloudinary/structured-metadata-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

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http cloudinary-structured-metadata https://structured-metadata.mcp.cloudinary.com/mcp
```

2. **Platform CLI**
```bash
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-structured-metadata npx -y @cloudinary/structured-metadata-mcp
```
Replace <…> with your own values

## When to use it
- list metadata fields in a Cloudinary account
- create a field with a set of allowed values
- change values in a field’s datasource
- set a rule to tag assets in a folder

## Example prompts
- Show the metadata fields in my Cloudinary account.
- Add `enterprise` to the datasource for `category`.
- Create a rule that assigns category `product` to assets in the `products` folder.

## Similar
- [cloudinary-docs](https://affpapa.org/en/nevibecode/skills/cloudinary-docs.md) — skill · 1100 installs
- [cloudinary-transformations](https://affpapa.org/en/nevibecode/skills/cloudinary-transformations.md) — skill · 906 installs
- [Web Search — Structured Results for AI Agents](https://affpapa.org/en/nevibecode/mcp/web-search-structured-results-for-ai-agents.md) — MCP server · 4334 installs
- [Structured Output MCP Agent](https://affpapa.org/en/nevibecode/mcp/structured-output-mcp-agent.md) — MCP server · 3042 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
