diagnose_meta_catalog_funnel

POST

api

tools

execute

The catalog funnel (impressions -> clicks -> view content -> add to cart -> purchase): each step's rate against the previous window of the same length, the step whose rate fell most, and products that are viewed but not added or added but not bought. Read-only.

curl --request POST \
  --url https://mcp.adsmcp.si/api/v1/tools/diagnose_meta_catalog_funnel/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "platform": "meta",
  "arguments": {
    "account_id": "<string>",
    "ad_account_id": "<string>",
    "start_date": "<string>",
    "end_date": "<string>",
    "campaign_id": "<string>"
  }
}
'

import requests

url = "https://mcp.adsmcp.si/api/v1/tools/diagnose_meta_catalog_funnel/execute"

payload = {
    "platform": "meta",
    "arguments": {
        "account_id": "<string>",
        "ad_account_id": "<string>",
        "start_date": "<string>",
        "end_date": "<string>",
        "campaign_id": "<string>"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    platform: 'meta',
    arguments: {
      account_id: '<string>',
      ad_account_id: '<string>',
      start_date: '<string>',
      end_date: '<string>',
      campaign_id: '<string>'
    }
  })
};

fetch('https://mcp.adsmcp.si/api/v1/tools/diagnose_meta_catalog_funnel/execute', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://mcp.adsmcp.si/api/v1/tools/diagnose_meta_catalog_funnel/execute",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'platform' => 'meta',
    'arguments' => [
        'account_id' => '<string>',
        'ad_account_id' => '<string>',
        'start_date' => '<string>',
        'end_date' => '<string>',
        'campaign_id' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://mcp.adsmcp.si/api/v1/tools/diagnose_meta_catalog_funnel/execute"

	payload := strings.NewReader("{\n  \"platform\": \"meta\",\n  \"arguments\": {\n    \"account_id\": \"<string>\",\n    \"ad_account_id\": \"<string>\",\n    \"start_date\": \"<string>\",\n    \"end_date\": \"<string>\",\n    \"campaign_id\": \"<string>\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://mcp.adsmcp.si/api/v1/tools/diagnose_meta_catalog_funnel/execute")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"platform\": \"meta\",\n  \"arguments\": {\n    \"account_id\": \"<string>\",\n    \"ad_account_id\": \"<string>\",\n    \"start_date\": \"<string>\",\n    \"end_date\": \"<string>\",\n    \"campaign_id\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://mcp.adsmcp.si/api/v1/tools/diagnose_meta_catalog_funnel/execute")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"platform\": \"meta\",\n  \"arguments\": {\n    \"account_id\": \"<string>\",\n    \"ad_account_id\": \"<string>\",\n    \"start_date\": \"<string>\",\n    \"end_date\": \"<string>\",\n    \"campaign_id\": \"<string>\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "ok": true,
  "platform": "<string>",
  "tool": "<string>",
  "error": {
    "message": "<string>",
    "code": "<unknown>",
    "details": "<unknown>"
  },
  "mcp_response": "<unknown>",
  "data": "<unknown>"
}

Read-only. Runs right away and changes nothing in your ad accounts. It still needs a connected platform (check get_connections_status) and counts as one tool call.

The catalog funnel (impressions -> clicks -> view content -> add to cart -> purchase): each step’s rate against the previous window of the same length, the step whose rate fell most, and products that are viewed but not added or added but not bought. Read-only. Platform: Meta Ads · Type: Read

How to call it

MCP: on https://mcp.adsmcp.si/mcp, run it through the meta_ads_read tool with {"action": "execute", "tool_name": "diagnose_meta_catalog_funnel", "arguments": { ... }}, or call diagnose_meta_catalog_funnel by name. search_tools finds it and get_tool_schema returns its arguments; https://mcp.adsmcp.si/mcp/flat lists every tool by name.
REST: POST https://mcp.adsmcp.si/api/v1/tools/diagnose_meta_catalog_funnel/execute with Authorization: Bearer sk_live_... and a JSON body {"platform": "meta", "arguments": { ... }}. The arguments are listed below; they are exactly the tool’s input schema.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Authorization

string

required

Bearer token

Idempotency-Key

string

Body

application/json

platform

string

default:meta

arguments

object

Show child attributes

Response

Tool execution result.

boolean

required

platform

string

required

tool

string

required

error

null | object

required

Show child attributes

mcp_response

any

required

data

any

curl --request POST \
  --url https://mcp.adsmcp.si/api/v1/tools/diagnose_meta_catalog_funnel/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "platform": "meta",
  "arguments": {
    "account_id": "<string>",
    "ad_account_id": "<string>",
    "start_date": "<string>",
    "end_date": "<string>",
    "campaign_id": "<string>"
  }
}
'

import requests

url = "https://mcp.adsmcp.si/api/v1/tools/diagnose_meta_catalog_funnel/execute"

payload = {
    "platform": "meta",
    "arguments": {
        "account_id": "<string>",
        "ad_account_id": "<string>",
        "start_date": "<string>",
        "end_date": "<string>",
        "campaign_id": "<string>"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    platform: 'meta',
    arguments: {
      account_id: '<string>',
      ad_account_id: '<string>',
      start_date: '<string>',
      end_date: '<string>',
      campaign_id: '<string>'
    }
  })
};

fetch('https://mcp.adsmcp.si/api/v1/tools/diagnose_meta_catalog_funnel/execute', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://mcp.adsmcp.si/api/v1/tools/diagnose_meta_catalog_funnel/execute",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'platform' => 'meta',
    'arguments' => [
        'account_id' => '<string>',
        'ad_account_id' => '<string>',
        'start_date' => '<string>',
        'end_date' => '<string>',
        'campaign_id' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://mcp.adsmcp.si/api/v1/tools/diagnose_meta_catalog_funnel/execute"

	payload := strings.NewReader("{\n  \"platform\": \"meta\",\n  \"arguments\": {\n    \"account_id\": \"<string>\",\n    \"ad_account_id\": \"<string>\",\n    \"start_date\": \"<string>\",\n    \"end_date\": \"<string>\",\n    \"campaign_id\": \"<string>\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://mcp.adsmcp.si/api/v1/tools/diagnose_meta_catalog_funnel/execute")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"platform\": \"meta\",\n  \"arguments\": {\n    \"account_id\": \"<string>\",\n    \"ad_account_id\": \"<string>\",\n    \"start_date\": \"<string>\",\n    \"end_date\": \"<string>\",\n    \"campaign_id\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://mcp.adsmcp.si/api/v1/tools/diagnose_meta_catalog_funnel/execute")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"platform\": \"meta\",\n  \"arguments\": {\n    \"account_id\": \"<string>\",\n    \"ad_account_id\": \"<string>\",\n    \"start_date\": \"<string>\",\n    \"end_date\": \"<string>\",\n    \"campaign_id\": \"<string>\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "ok": true,
  "platform": "<string>",
  "tool": "<string>",
  "error": {
    "message": "<string>",
    "code": "<unknown>",
    "details": "<unknown>"
  },
  "mcp_response": "<unknown>",
  "data": "<unknown>"
}

Overview

General

Reports & analysis

Monitors, approvals & diagnostics

Google Ads

Meta Ads

Amazon Ads

TikTok Ads

LinkedIn Ads

ChatGPT Ads

Google Analytics 4

Klaviyo

Not supported yet

diagnose_meta_catalog_funnel

How to call it

Authorizations

Headers

Body

Response