MMetadata /docs
⌘K
Docs/Tools/fetch_creative_details

fetch_creative_details

Get detailed information for specific creative assets by their IDs.

Read creative

Returns data. Calling it changes nothing, so it is safe in an unattended loop.

What it does

Get detailed information for specific creative assets by their IDs.
                   Looks up each creative ID individually.

                   WHEN TO USE:
                   - Get metadata for specific creative assets
                   - Lookup creative names and content types
                   - Verify creative asset properties before using in ads
                   - Audit creative asset details and status
                   - Validate library IDs before ad creation

                   RETURNED INFORMATION:
                   - Creative asset name and ID
                   - Content type (IMAGE, VIDEO, GIF, DOCUMENT)
                   - File properties (size, dimensions, format)
                   - Upload and modification timestamps
                   - Visibility status and permissions
                   - Preview URLs and download links
                   - Associated metadata and tags

                   FEATURES:
                   - Batch lookup of multiple creative IDs
                   - Individual error handling for invalid/missing IDs
                   - Returns None for failed lookups while continuing others
                   - Detailed logging of API requests and responses
                   - Comprehensive metadata for each valid asset

Arguments

ArgumentTypeNotes
creative_id integer creative id to be query

Request

curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
  -H "Authorization: $METADATA_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fetch_creative_details","arguments":{}}}'

Response

Real, from the production server, in 320 ms. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.

recorded response
{
 "error": "[error redacted]",
 "tool": "fetch_creative_details",
 "service": "[service redacted]"
}

Other creative tools:

All 160 tools · machine-readable index