# Get MCP Ads creative performance Show creative performance cards when the user explicitly requests KPIs, metrics, results, a creative report, creative analytics, top or worst ads. Works on your own connected ad and analytics accounts. Needs platform, account id, since and more. Show creative performance cards when the user explicitly requests KPIs, metrics, results, a creative report, creative analytics, top or worst ads, or a performance ranking/comparison. For images, videos or a simple visual gallery, use get_creative_gallery instead, even when dates are mentioned. Supports TikTok, Meta, Pinterest, Snapchat, Reddit, Amazon sponsored ads and Google Performance Max. Amazon returns a pending reportJobToken first; repeat with that token after the suggested delay. Cards use Business Manager ad names and retain all contributing ads when media are shared. In the report, users change the period, up to six KPIs, the comparison (account average or previous period), sort and Cards/Table views themselves; pass the KPIs they named in metrics. They can compare up to three creatives and send an analysis request back to the conversation. Do not infer fatigue without creative age and daily trends. Agentik price: $0.05 per hundred creatives loaded. A page is charged only when it starts a new hundred (offset 0, then the first page past each multiple of 100; limit defaults to 24), so 100 creatives cost $0.05 whatever the page size. - Tool ID: `getmcpads/get-creative-performance` - Name in the catalog: Get MCP Ads: Get creative performance - Provider: [Get MCP Ads](/providers/getmcpads.md) - Capability: [Creative performance reviews](/tools/advertising/creative-reviews.md) - Price: usage based, the maximum is shown before a run - Workspace access is automatic. Connect a platform using the link and notice returned to your AI assistant; an owner or admin completes platform consent and returns to the conversation; see the [guide](/docs/getmcpads.md). - Authentication: an authorised Agentik workspace is required for execution, including zero-price tools. ## Pricing contract The provider’s price, with no markup. Billed for measured usage. ```json { "model": "per_call", "amountUsd": 0.05, "multipliers": [ { "when": { "field": "offset", "continuesBlock": { "limitField": "limit", "defaultLimit": 24, "size": 100 } }, "setUsd": 0 } ] } ``` ## Complete input schema ```json { "type": "object", "properties": { "platform": { "type": "string", "enum": [ "tiktok_ads", "google_ads", "meta_ads", "pinterest_ads", "snapchat_ads", "reddit_ads", "amazon_ads" ], "description": "TikTok, Meta, Pinterest or Snapchat ads; Google Performance Max image/video assets." }, "account_id": { "type": "string", "description": "The advertising account, from list_accounts." }, "adProduct": { "type": "string", "enum": [ "SP", "SB", "SD" ], "description": "Amazon only: Sponsored Products (default), Brands or Display. Brands/Display use 14-day click purchases/sales. SB Ads excludes legacy single-group campaigns." }, "reportJobToken": { "type": "string", "description": "Amazon only: resume the pending report for these exact dates and attribution." }, "attributionDays": { "type": "string", "enum": [ "1", "7", "14", "30" ], "description": "Amazon Sponsored Products click attribution window; defaults to 14 days." }, "since": { "type": "string", "description": "Start date, YYYY-MM-DD." }, "until": { "type": "string", "description": "End date, YYYY-MM-DD." }, "metrics": { "type": "array", "items": { "type": "string" }, "description": "Metrics per creative. Defaults to spend, impressions and cpa. Rates such as cpa, cpc, cpm, ctr, cvr and roas are recomputed. Standard keys: spend, impressions, clicks, conversions, revenue, cpa, cpc, cpm, ctr, cvr, roas. Each source also accepts its supported catalog keys (TikTok CTA/VTA/EVTA included); the widget provides a searchable source-specific catalog. Unavailable or non-additive values across multiple ads are null. Maximum eight KPIs.", "minItems": 1, "maxItems": 8 }, "limit": { "type": "integer", "minimum": 1, "maximum": 60, "description": "Top creatives by spend within the report coverage. Defaults to 24; maximum 60." }, "offset": { "type": "integer", "minimum": 0, "maximum": 1000, "description": "Start of the page in the spend ranking, from the previous result's page.nextOffset. Default 0; account totals are the same on every page." }, "campaign_ids": { "type": "array", "items": { "type": "string" }, "maxItems": 20, "description": "Only these campaigns; totals cover them." }, "adset_ids": { "type": "array", "items": { "type": "string" }, "maxItems": 20, "description": "Only these ad sets or asset groups." }, "ad_ids": { "type": "array", "items": { "type": "string" }, "maxItems": 100, "description": "Only these ads." }, "workspace_id": { "type": "string", "description": "Authorized workspace ID from list_accounts/list_workspaces. Use the user's chosen workspace; never guess between clients. Optional when a unique account identifies it." } }, "required": [ "platform", "account_id", "since", "until" ] } ``` ## Published example No example input is published for this tool. Ask for the inputs required by its schema. ## Execute and retrieve Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative. A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md). [REST inspection](https://api.agentik.cc/v1/tools/getmcpads/get-creative-performance) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md) --- [HTML page](/providers/getmcpads/get-creative-performance) · [Agent index](/llms.txt)