@cloudinary/structured-metadata-mcp MCP Server

Endpoints

Endpoint	Method	Description
/mcp	POST	Streamable HTTP transportRecommended
/sse	GET	SSE transportDeprecated

Server URL

http://structured-metadata.mcp.cloudinary.com/mcp

Configuration

Add this to your MCP client configuration. OAuth is used by default when no headers are provided.

Minimal (OAuth)

{
  "mcpServers": {
    "@cloudinary/structured-metadata-mcp": {
      "url": "http://structured-metadata.mcp.cloudinary.com/mcp"
    }
  }
}

With API Key

{
  "mcpServers": {
    "@cloudinary/structured-metadata-mcp": {
      "url": "http://structured-metadata.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-url": "cloudinary://api_key:api_secret@cloud_name"
      }
    }
  }
}

Authentication

Method	Description
OAuth 2.0	Default. The OAuth flow is initiated automatically when the client connects with no auth headers.
API Key	Pass `cloudinary-url` header, or individual `cloudinary-cloud-name`, `cloudinary-api-key`, `cloudinary-api-secret` headers.

Configuration Headers

Optional headers to customize server behavior. Applied at session creation time.

Header	Description
`cloudinary-region`	API region: `api`, `api-eu`, or `api-ap`
`cloudinary-tools`	Comma-separated list of tools to enable (e.g. `search-assets,list-images`)

Response Headers

API response headers are collected into _meta.headers on each tool result. The debug preset is active by default.

Header	Description
`cloudinary-collect-headers`	Control which response headers are returned. Accepts: `debug` — rate-limit + request ID (default) `ratelimit` — rate-limit headers only `all` — every response header Or a comma-separated list of exact names, `prefix:<value>`, `regex:<pattern>`, and preset names
`cloudinary-embed-headers`	Set to `true` to also include collected headers in the response body as `_headers`, for clients that don't surface `_meta`

Tool result structure

{
  "_meta": {
    "headers": {
      "x-featureratelimit-limit": "5000",
      "x-featureratelimit-remaining": "4998",
      "x-featureratelimit-reset": "Thu, 13 Feb 2026 00:00:00 GMT",
      "x-request-id": "bfeaccc60050594832508590a358a1a4"
    }
  },
  "content": [{ "type": "text", "text": "{...}" }]
}

Available Tools (11)

create-metadata-field list-metadata-fields get-metadata-field update-metadata-field delete-metadata-field update-metadata-datasource-values delete-metadata-datasource-values create-metadata-rule list-metadata-rules update-metadata-rule delete-metadata-rule