Skip to main content
Glama
MuhammadRaza-dev713

Smart Conversion Debugging MCP Server

Smart Conversion Debugging MCP Server

An MCP server that helps debug conversion tracking issues across GoHighLevel, Meta CAPI, webhooks, and GTM.

Quick Start

# Install dependencies
npm install

# Test tools locally
node test.js

# Run interactive CLI agent
node agent.js

# Start MCP server (for AI client connections)
node index.js

Related MCP server: Web Analytics & Tracking MCP Server

Available Tools

Tool

Description

getWebhookEvents

Returns stored webhook events

getGHLContacts

Fetch contacts from GoHighLevel

getMetaEvents

Returns Meta CAPI tracked events

getGTMEvents

Returns frontend GTM events

getSystemLogs

Returns error logs

debugConversion

Full analysis with issues + fixes


Connecting to MCP Clients

1. Claude Desktop

Edit your Claude Desktop config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "conversion-debugger": {
      "command": "node",
      "args": ["D:/first mcp server/index.js"],
      "env": {
        "USE_MOCK_DATA": "true"
      }
    }
  }
}

Restart Claude Desktop after saving. You'll see the tools available in the chat.


2. VS Code with GitHub Copilot

Add to your VS Code settings.json or workspace settings:

{
  "github.copilot.chat.mcpServers": {
    "conversion-debugger": {
      "command": "node",
      "args": ["D:/first mcp server/index.js"],
      "env": {
        "USE_MOCK_DATA": "true"
      }
    }
  }
}

Or create .vscode/mcp.json in your workspace:

{
  "servers": {
    "conversion-debugger": {
      "command": "node",
      "args": ["${workspaceFolder}/index.js"],
      "env": {
        "USE_MOCK_DATA": "true"
      }
    }
  }
}

3. Cursor IDE

Add to Cursor settings (~/.cursor/mcp.json or project .cursor/mcp.json):

{
  "mcpServers": {
    "conversion-debugger": {
      "command": "node",
      "args": ["D:/first mcp server/index.js"],
      "env": {
        "USE_MOCK_DATA": "true"
      }
    }
  }
}

4. Continue.dev

Add to your Continue config (~/.continue/config.json):

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "node",
          "args": ["D:/first mcp server/index.js"]
        }
      }
    ]
  }
}

5. Custom MCP Client (Node.js)

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
import { spawn } from "child_process";

const transport = new StdioClientTransport({
  command: "node",
  args: ["D:/first mcp server/index.js"],
});

const client = new Client({ name: "my-client", version: "1.0.0" });
await client.connect(transport);

// List available tools
const tools = await client.listTools();
console.log(tools);

// Call a tool
const result = await client.callTool({
  name: "debugConversion",
  arguments: {},
});
console.log(result);

await client.close();

Environment Variables

Copy .env.example to .env and configure:

# Use mock data (set to false for live API calls)
USE_MOCK_DATA=true

# GoHighLevel
GHL_API_KEY=your_api_key
GHL_LOCATION_ID=your_location_id

# Meta CAPI
META_ACCESS_TOKEN=your_access_token
META_PIXEL_ID=your_pixel_id

Example AI Prompts

Once connected to an MCP client, try these prompts:

  1. "Debug my conversion tracking"

    • The AI will call debugConversion and explain the issues

  2. "Show me all GHL contacts from today"

    • Calls getGHLContacts with date filters

  3. "Compare webhook events with Meta events"

    • Calls multiple tools and cross-references data

  4. "Why are some conversions not reaching Meta?"

    • Full debugging workflow with root cause analysis


Project Structure

first mcp server/
├── index.js              # MCP server entry point
├── agent.js              # Interactive CLI agent
├── test.js               # Tool testing script
├── package.json
├── .env.example
├── config/
│   └── env.js            # Environment configuration
├── clients/
│   ├── httpClient.js     # HTTP utilities
│   ├── ghlClient.js      # GoHighLevel API client
│   └── metaClient.js     # Meta CAPI client
├── data/
│   ├── mockData.js       # Mock data for testing
│   └── dataProvider.js   # Live/mock data switching
└── tools/
    ├── utils.js
    ├── getWebhookEvents.js
    ├── getGHLContacts.js
    ├── getMetaEvents.js
    ├── getGTMEvents.js
    ├── getSystemLogs.js
    └── debugConversion.js

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Integrates Google Tag Manager with Claude to automate the creation and management of tags, triggers, and variables using natural language prompts. It provides specialized tools for GA4 and Facebook Pixel setup, along with automated tracking workflows for ecommerce and lead generation sites.
    9
    -
  • A
    license
    C
    quality
    B
    maintenance
    Server-side conversion tracking for online shops: inspect events, check delivery to Google Ads, Meta, GA4 and Microsoft Ads, and manage ad campaigns. Every tool is derived from the Trackdolphin OpenAPI description, so the server never carries a second, drifting list.
    89
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables an AI assistant to set up and manage server-side conversion tracking by connecting ad platforms like Google Ads, Meta, and GA4, building and publishing conversion flows that fire when forms are submitted, installing tracking snippets, and reviewing conversion events. It also supports diagnosing missing conversions and excluding internal traffic, all through a hosted connector authorized against the user's own account.
    MIT