meta_ads_preview_ads

Preview Meta Ads

Meta MCP App

Description

Interactive UI for displaying Meta ad previews with creative content and metrics

Read-onlyIdempotent

Usage

This is an MCP App tool — it renders an interactive UI directly in Claude Desktop. It does not return text or JSON; instead it returns a resource_link pointing to a bundled application that renders the content client-side.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "meta_ads_preview_ads",
    "arguments": {
      "account_id": "act_123456789",
      "ads": [
        {
          "ad_id": "12345"
        }
      ],
      "reason": "Preview ad creative"
    }
  }
}

Parameters

NameTypeRequiredDescription
account_id string Required The ad account IDminLength: 1
ads array Required Ads to preview (1-20)
reason string Required Why this tool call is neededminLength: 1, maxLength: 500
Optional parameters (1)
NameTypeRequiredDescription
metric_labels object Optional Display labels for metric keys

Examples

Single ad

{
  "account_id": "act_123456789",
  "ads": [
    {
      "ad_id": "12345"
    }
  ],
  "reason": "Preview ad creative"
}

With metrics

{
  "account_id": "act_123456789",
  "ads": [
    {
      "ad_id": "12345",
      "metrics": {
        "spend": "150.00",
        "ctr": "2.5%"
      }
    }
  ],
  "metric_labels": {
    "spend": "Spend",
    "ctr": "Click Rate"
  },
  "reason": "Preview ad with performance metrics"
}