> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adsmcp.si/llms.txt
> Use this file to discover all available pages before exploring further.

# diagnose_meta_catalog_funnel

> 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

> [!NOTE]
>
> **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.


## OpenAPI

````yaml api-reference/openapi.json POST /api/v1/tools/diagnose_meta_catalog_funnel/execute
openapi: 3.1.0
info:
  title: ADSMCP REST API
  version: 0.1.0
  description: >-
    ADSMCP REST API: every public ADSMCP tool as POST
    /api/v1/tools/{name}/execute. Generated from the ADSMCP code (the service
    serves the same document at GET /api/v1/openapi.json). Changes to ad
    accounts are staged for approval by a person on the ADSMCP dashboard;
    nothing in this API can approve them.
servers:
  - url: https://mcp.adsmcp.si
    description: ADSMCP MCP and REST service
security: []
paths:
  /api/v1/tools/diagnose_meta_catalog_funnel/execute:
    post:
      tags:
        - meta
      summary: >-
        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.
      description: >-
        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. Use this when you need
        that result and get_connections_status already shows the platform as
        connected. Read tools run without the approval queue.
      operationId: execute_diagnose_meta_catalog_funnel
      parameters:
        - name: Authorization
          in: header
          required: true
          schema:
            type: string
          description: Bearer token
        - name: Idempotency-Key
          in: header
          required: false
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                platform:
                  type: string
                  default: meta
                arguments:
                  type: object
                  properties:
                    account_id:
                      type: string
                      description: >-
                        Meta ad account id (act_123 or 123). Optional when
                        exactly one account is connected.
                    ad_account_id:
                      type: string
                      description: Alias of account_id (the name the docs use).
                    lookback_days:
                      type: integer
                      enum:
                        - 7
                        - 14
                        - 30
                        - 60
                        - 90
                        - 120
                      description: >-
                        Days ending yesterday (UTC), default 30. Ignored when
                        start_date and end_date are given.
                    start_date:
                      type: string
                      description: >-
                        YYYY-MM-DD; with end_date, overrides lookback_days (at
                        most 120 days).
                    end_date:
                      type: string
                      description: YYYY-MM-DD, not in the future.
                    campaign_id:
                      type: string
                      description: Limit the analysis to this campaign (numeric id).
                  additionalProperties: false
              additionalProperties: false
      responses:
        '200':
          description: Tool execution result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExecuteToolResponse'
        '400':
          description: Invalid JSON input.
        '401':
          description: Authentication error.
      security:
        - bearerAuth: []
components:
  schemas:
    ExecuteToolResponse:
      type: object
      properties:
        ok:
          type: boolean
        platform:
          type: string
        tool:
          type: string
        data: {}
        error:
          anyOf:
            - type: 'null'
            - $ref: '#/components/schemas/ErrorResponse'
        mcp_response: {}
      required:
        - ok
        - platform
        - tool
        - error
        - mcp_response
      additionalProperties: false
    ErrorResponse:
      type: object
      properties:
        code: {}
        message:
          type: string
        details: {}
      required:
        - message
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API token

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.