Find creatives that look the same
find_similar_creativesFind creatives that look the same as one creative, using the production similarity index. This is visual similarity, not exact creative membership. threshold_status distinguishes an explicitly requested threshold from the production default; result_status=bounded_native_cap means the upstream similarity endpoint exposes at most 20 candidates and has_more is conservative at that cap. Returns metadata without media URLs; use get_media for selected ids. QUOTA: 1 MCP credit per delivered row. PRICING: on paid plans ×1 after 500 MCP credits/month; one-time consent via accept_pricing_terms; before calling, get the maximum debit from estimate_cost (free) and tell the user.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"creative_id": "<creative_id>"
},
"name": "find_similar_creatives"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | maximum metadata rows to return (default 20, maximum 20) | |
| threshold | No | optional maximum visual difference between two creatives (0 uses the production default; maximum 128 — lower is stricter) | |
| creative_id | Yes | source creative UUID from search_creatives |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| error | No | Present only when isError is true: machine-readable failure. The human explanation stays in content. | |
| params | No | Request parameter echo: applied = parameters that shaped this result; normalized = parameters rewritten before applying (alias, type coercion, resolved id); ignored = parameters that were accepted but NOT applied, with the reason. | |
| has_more | No | ||
| threshold | No | ||
| addon_hints | No | Add-on modules that have additional data for objects of this result (no prices, no paid values). subscription_status=active: the account has the module — use its normal path. Do not push a purchase the user did not ask about. | |
| result_status | No | ||
| similarity_basis | No | ||
| threshold_status | No | ||
| source_creative_id | No |