@nightsquawktech/gohighlevel-mcp-server 0.1.0

package/dist/tools/locations.js

@@ -0,0 +1,43 @@
+import { formatApiError } from "../services/errors.js";
+import { GetLocationSchema, ListUsersSchema } from "../schemas/locations.js";
+import { formatResponse, makeToolResponse, summarizeRecord } from "./format.js";
+import { registerCollectionReadTool } from "./read-tools.js";
+export function registerLocationTools(server, client) {
+    server.registerTool("ghl_get_location", {
+        title: "Get GoHighLevel Location",
+        description: "Get one GoHighLevel location/sub-account with GET /locations/{locationId}.",
+        inputSchema: GetLocationSchema.shape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async ({ location_id, response_format }) => {
+        try {
+            const location = await client.get(`/locations/${encodeURIComponent(resolveLocationId(client, location_id))}`);
+            const data = { location };
+            const markdown = ["# GoHighLevel Location", "", summarizeRecord(location, ["id", "name", "businessName", "email", "phone", "timezone"])].join("\n");
+            return makeToolResponse(data, formatResponse(response_format, data, markdown));
+        }
+        catch (error) {
+            const data = { error: formatApiError(error) };
+            return makeToolResponse(data, data.error, true);
+        }
+    });
+    registerCollectionReadTool(server, client, {
+        name: "ghl_list_users",
+        title: "List GoHighLevel Users",
+        description: "List users for a location with GET /users/?locationId={locationId}.",
+        inputSchema: ListUsersSchema.shape,
+        path: () => "/users/",
+        query: (params) => ({ locationId: resolveLocationId(client, params.location_id) }),
+        preferredFields: ["id", "name", "firstName", "lastName", "email", "phone", "role"],
+        heading: "GoHighLevel Users",
+        collectionLabel: "users"
+    });
+}
+function resolveLocationId(client, locationId) {
+    return typeof locationId === "string" && locationId.length > 0 ? locationId : client.defaultLocationId;
+}
+//# sourceMappingURL=locations.js.map

package/dist/tools/locations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locations.js","sourceRoot":"","sources":["../../src/tools/locations.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAyB,MAAM,yBAAyB,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,MAAyB;IAChF,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE,4EAA4E;QACzF,WAAW,EAAE,iBAAiB,CAAC,KAAK;QACpC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,eAAe,EAAoB,EAAE,EAAE;QAC3D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAU,cAAc,kBAAkB,CAAC,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;YACvH,MAAM,IAAI,GAAG,EAAE,QAAQ,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,CAAC,wBAAwB,EAAE,EAAE,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpJ,OAAO,gBAAgB,CAAC,IAAI,EAAE,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9C,OAAO,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CACF,CAAC;IAEF,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE;QACzC,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,qEAAqE;QAClF,WAAW,EAAE,eAAe,CAAC,KAAK;QAClC,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;QACrB,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QAClF,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC;QAClF,OAAO,EAAE,mBAAmB;QAC5B,eAAe,EAAE,OAAO;KACzB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAyB,EAAE,UAAmB;IACvE,OAAO,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;AACzG,CAAC"}

package/dist/tools/opportunities.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { GoHighLevelClient } from "../services/gohighlevel-client.js";
+export declare function registerOpportunityTools(server: McpServer, client: GoHighLevelClient): void;
+//# sourceMappingURL=opportunities.d.ts.map

package/dist/tools/opportunities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opportunities.d.ts","sourceRoot":"","sources":["../../src/tools/opportunities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAmB3E,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAuL3F"}

package/dist/tools/opportunities.js

@@ -0,0 +1,182 @@
+import { formatApiError } from "../services/errors.js";
+import { CreateOpportunitySchema, DeleteOpportunitySchema, GetPipelinesSchema, OpportunityIdSchema, SearchOpportunitiesSchema, UpdateOpportunitySchema, UpdateOpportunityStatusSchema } from "../schemas/opportunities.js";
+import { formatResponse, makeToolResponse, mergeExtra, omitUndefined, requireConfirm, summarizeRecord } from "./format.js";
+import { registerCollectionReadTool } from "./read-tools.js";
+export function registerOpportunityTools(server, client) {
+    registerCollectionReadTool(server, client, {
+        name: "ghl_search_opportunities",
+        title: "Search GoHighLevel Opportunities",
+        description: "Search opportunities with GET /opportunities/search using GoHighLevel server-side filters.",
+        inputSchema: SearchOpportunitiesSchema.shape,
+        path: () => "/opportunities/search",
+        query: (params) => omitUndefined({
+            location_id: resolveLocationId(client, params.location_id),
+            q: params.q,
+            pipeline_id: params.pipeline_id,
+            pipeline_stage_id: params.pipeline_stage_id,
+            status: params.status,
+            assigned_to: params.assigned_to,
+            campaignId: params.campaignId,
+            id: params.id,
+            order: params.order,
+            endDate: params.endDate,
+            startAfter: params.startAfter,
+            startAfterId: params.startAfterId,
+            date: params.date,
+            country: params.country,
+            limit: params.server_limit,
+            page: params.page
+        }),
+        preferredFields: ["id", "name", "contactId", "pipelineId", "pipelineStageId", "status", "monetaryValue"],
+        heading: "GoHighLevel Opportunities",
+        collectionLabel: "opportunities"
+    });
+    registerCollectionReadTool(server, client, {
+        name: "ghl_get_pipelines",
+        title: "Get GoHighLevel Pipelines",
+        description: "List opportunity pipelines with GET /opportunities/pipelines?locationId={locationId}.",
+        inputSchema: GetPipelinesSchema.shape,
+        path: () => "/opportunities/pipelines",
+        query: (params) => ({ locationId: resolveLocationId(client, params.location_id) }),
+        preferredFields: ["id", "name", "stages"],
+        heading: "GoHighLevel Pipelines",
+        collectionLabel: "pipelines"
+    });
+    server.registerTool("ghl_get_opportunity", {
+        title: "Get GoHighLevel Opportunity",
+        description: "Get one opportunity with GET /opportunities/{id}.",
+        inputSchema: OpportunityIdSchema.shape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async ({ opportunity_id, response_format }) => {
+        try {
+            const opportunity = await client.get(`/opportunities/${encodeURIComponent(opportunity_id)}`);
+            const data = { opportunity };
+            const markdown = ["# GoHighLevel Opportunity", "", summarizeRecord(opportunity, ["id", "name", "contactId", "pipelineId", "pipelineStageId", "status", "monetaryValue"])].join("\n");
+            return makeToolResponse(data, formatResponse(response_format, data, markdown));
+        }
+        catch (error) {
+            const data = { error: formatApiError(error) };
+            return makeToolResponse(data, data.error, true);
+        }
+    });
+    server.registerTool("ghl_create_opportunity", {
+        title: "Create GoHighLevel Opportunity",
+        description: "Create an opportunity with POST /opportunities/. Write operation: do not run against live data without explicit approval.",
+        inputSchema: CreateOpportunitySchema.shape,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true
+        }
+    }, async (params) => {
+        try {
+            const opportunity = await client.post("/opportunities/", opportunityBody(client, params, true));
+            const data = { opportunity };
+            const markdown = ["# Created GoHighLevel Opportunity", "", summarizeRecord(opportunity, ["id", "name", "contactId", "pipelineId", "pipelineStageId", "status", "monetaryValue"])].join("\n");
+            return makeToolResponse(data, formatResponse(params.response_format, data, markdown));
+        }
+        catch (error) {
+            const data = { error: formatApiError(error) };
+            return makeToolResponse(data, data.error, true);
+        }
+    });
+    server.registerTool("ghl_update_opportunity", {
+        title: "Update GoHighLevel Opportunity",
+        description: "Update an opportunity with PUT /opportunities/{id}. Write operation: do not run against live data without explicit approval.",
+        inputSchema: UpdateOpportunitySchema.shape,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async (params) => {
+        try {
+            const body = opportunityBody(client, params, false);
+            if (Object.keys(body).length === 0) {
+                const data = { error: "At least one opportunity property must be provided for update." };
+                return makeToolResponse(data, data.error, true);
+            }
+            const opportunity = await client.put(`/opportunities/${encodeURIComponent(params.opportunity_id)}`, body);
+            const data = { opportunity };
+            const markdown = ["# Updated GoHighLevel Opportunity", "", summarizeRecord(opportunity, ["id", "name", "contactId", "pipelineId", "pipelineStageId", "status", "monetaryValue"])].join("\n");
+            return makeToolResponse(data, formatResponse(params.response_format, data, markdown));
+        }
+        catch (error) {
+            const data = { error: formatApiError(error) };
+            return makeToolResponse(data, data.error, true);
+        }
+    });
+    server.registerTool("ghl_update_opportunity_status", {
+        title: "Update GoHighLevel Opportunity Status",
+        description: "Update opportunity status with PUT /opportunities/{id}/status. Write operation: do not run against live data without explicit approval.",
+        inputSchema: UpdateOpportunityStatusSchema.shape,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async ({ opportunity_id, status, response_format }) => {
+        try {
+            const opportunity = await client.put(`/opportunities/${encodeURIComponent(opportunity_id)}/status`, { status });
+            const data = { opportunity };
+            const markdown = ["# Updated GoHighLevel Opportunity Status", "", summarizeRecord(opportunity, ["id", "name", "status"])].join("\n");
+            return makeToolResponse(data, formatResponse(response_format, data, markdown));
+        }
+        catch (error) {
+            const data = { error: formatApiError(error) };
+            return makeToolResponse(data, data.error, true);
+        }
+    });
+    server.registerTool("ghl_delete_opportunity", {
+        title: "Delete GoHighLevel Opportunity",
+        description: "Delete an opportunity with DELETE /opportunities/{id}. Requires confirm: true and owner approval before live execution.",
+        inputSchema: DeleteOpportunitySchema.shape,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: true
+        }
+    }, async ({ opportunity_id, confirm, response_format }) => {
+        const guard = requireConfirm(confirm);
+        if (guard) {
+            const data = { error: guard };
+            return makeToolResponse(data, data.error, true);
+        }
+        try {
+            const result = await client.del(`/opportunities/${encodeURIComponent(opportunity_id)}`);
+            const data = { opportunity_id, result };
+            const markdown = ["# Deleted GoHighLevel Opportunity", "", `Deleted opportunity ${opportunity_id}.`].join("\n");
+            return makeToolResponse(data, formatResponse(response_format, data, markdown));
+        }
+        catch (error) {
+            const data = { error: formatApiError(error) };
+            return makeToolResponse(data, data.error, true);
+        }
+    });
+}
+function resolveLocationId(client, locationId) {
+    return typeof locationId === "string" && locationId.length > 0 ? locationId : client.defaultLocationId;
+}
+function opportunityBody(client, params, includeLocationId) {
+    return mergeExtra({
+        ...(includeLocationId ? { locationId: resolveLocationId(client, "location_id" in params ? params.location_id : undefined) } : {}),
+        name: params.name,
+        contactId: params.contactId,
+        pipelineId: params.pipelineId,
+        pipelineStageId: params.pipelineStageId,
+        status: params.status,
+        monetaryValue: params.monetaryValue,
+        assignedTo: params.assignedTo,
+        source: params.source
+    }, params.extra);
+}
+//# sourceMappingURL=opportunities.js.map

package/dist/tools/opportunities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opportunities.js","sourceRoot":"","sources":["../../src/tools/opportunities.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACvB,6BAA6B,EAM9B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC3H,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,MAAyB;IACnF,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE;QACzC,IAAI,EAAE,0BAA0B;QAChC,KAAK,EAAE,kCAAkC;QACzC,WAAW,EAAE,4FAA4F;QACzG,WAAW,EAAE,yBAAyB,CAAC,KAAK;QAC5C,IAAI,EAAE,GAAG,EAAE,CAAC,uBAAuB;QACnC,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC;YAC/B,WAAW,EAAE,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC;YAC1D,CAAC,EAAE,MAAM,CAAC,CAAC;YACX,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;YAC3C,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,MAAM,CAAC,YAAY;YAC1B,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC;QACF,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,eAAe,CAAC;QACxG,OAAO,EAAE,2BAA2B;QACpC,eAAe,EAAE,eAAe;KACjC,CAAC,CAAC;IAEH,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE;QACzC,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,2BAA2B;QAClC,WAAW,EAAE,uFAAuF;QACpG,WAAW,EAAE,kBAAkB,CAAC,KAAK;QACrC,IAAI,EAAE,GAAG,EAAE,CAAC,0BAA0B;QACtC,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QAClF,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC;QACzC,OAAO,EAAE,uBAAuB;QAChC,eAAe,EAAE,WAAW;KAC7B,CAAC,CAAC;IAEH,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,6BAA6B;QACpC,WAAW,EAAE,mDAAmD;QAChE,WAAW,EAAE,mBAAmB,CAAC,KAAK;QACtC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,cAAc,EAAE,eAAe,EAAsB,EAAE,EAAE;QAChE,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,GAAG,CAAU,kBAAkB,kBAAkB,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;YACtG,MAAM,IAAI,GAAG,EAAE,WAAW,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,CAAC,2BAA2B,EAAE,EAAE,EAAE,eAAe,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrL,OAAO,gBAAgB,CAAC,IAAI,EAAE,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9C,OAAO,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,gCAAgC;QACvC,WAAW,EAAE,2HAA2H;QACxI,WAAW,EAAE,uBAAuB,CAAC,KAAK;QAC1C,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,MAA8B,EAAE,EAAE;QACvC,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,IAAI,CAAU,iBAAiB,EAAE,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;YACzG,MAAM,IAAI,GAAG,EAAE,WAAW,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,CAAC,mCAAmC,EAAE,EAAE,EAAE,eAAe,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7L,OAAO,gBAAgB,CAAC,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QACxF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9C,OAAO,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,gCAAgC;QACvC,WAAW,EAAE,8HAA8H;QAC3I,WAAW,EAAE,uBAAuB,CAAC,KAAK;QAC1C,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,MAA8B,EAAE,EAAE;QACvC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YACpD,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,gEAAgE,EAAE,CAAC;gBACzF,OAAO,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAClD,CAAC;YAED,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,GAAG,CAAU,kBAAkB,kBAAkB,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACnH,MAAM,IAAI,GAAG,EAAE,WAAW,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,CAAC,mCAAmC,EAAE,EAAE,EAAE,eAAe,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7L,OAAO,gBAAgB,CAAC,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QACxF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9C,OAAO,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,+BAA+B,EAC/B;QACE,KAAK,EAAE,uCAAuC;QAC9C,WAAW,EAAE,yIAAyI;QACtJ,WAAW,EAAE,6BAA6B,CAAC,KAAK;QAChD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe,EAAgC,EAAE,EAAE;QAClF,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,GAAG,CAAU,kBAAkB,kBAAkB,CAAC,cAAc,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YACzH,MAAM,IAAI,GAAG,EAAE,WAAW,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,CAAC,0CAA0C,EAAE,EAAE,EAAE,eAAe,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrI,OAAO,gBAAgB,CAAC,IAAI,EAAE,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9C,OAAO,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,gCAAgC;QACvC,WAAW,EAAE,yHAAyH;QACtI,WAAW,EAAE,uBAAuB,CAAC,KAAK;QAC1C,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAA0B,EAAE,EAAE;QAC7E,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YAC9B,OAAO,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAU,kBAAkB,kBAAkB,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;YACjG,MAAM,IAAI,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,CAAC,mCAAmC,EAAE,EAAE,EAAE,uBAAuB,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChH,OAAO,gBAAgB,CAAC,IAAI,EAAE,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9C,OAAO,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAyB,EAAE,UAAmB;IACvE,OAAO,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;AACzG,CAAC;AAED,SAAS,eAAe,CACtB,MAAyB,EACzB,MAAuD,EACvD,iBAA0B;IAE1B,OAAO,UAAU,CAAC;QAChB,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,iBAAiB,CAAC,MAAM,EAAE,aAAa,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjI,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC"}

package/dist/tools/read-tools.d.ts

@@ -0,0 +1,22 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { z } from "zod";
+import type { GoHighLevelClient } from "../services/gohighlevel-client.js";
+type ToolParams = Record<string, unknown>;
+type CollectionReadOptions = {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: Record<string, z.ZodTypeAny>;
+    path: (params: ToolParams) => string;
+    query?: (params: ToolParams) => Record<string, unknown> | undefined;
+    body?: (params: ToolParams) => Record<string, unknown> | undefined;
+    method?: "get" | "post";
+    preferredFields: string[];
+    heading: string;
+    collectionLabel: string;
+};
+export declare function registerCollectionReadTool(server: McpServer, client: GoHighLevelClient, options: CollectionReadOptions): void;
+export declare function extractItems(raw: unknown): unknown[];
+export declare function extractTraceId(raw: unknown): unknown;
+export {};
+//# sourceMappingURL=read-tools.d.ts.map

package/dist/tools/read-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-tools.d.ts","sourceRoot":"","sources":["../../src/tools/read-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAK3E,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,KAAK,qBAAqB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,MAAM,CAAC;IACrC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACpE,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACnE,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAQF,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,qBAAqB,GAC7B,IAAI,CA4CN;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,EAAE,CAepD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEpD"}

package/dist/tools/read-tools.js

@@ -0,0 +1,68 @@
+import { formatApiError } from "../services/errors.js";
+import { formatResponse, makeToolResponse, paginate, summarizeRecord } from "./format.js";
+export function registerCollectionReadTool(server, client, options) {
+    server.registerTool(options.name, {
+        title: options.title,
+        description: options.description,
+        inputSchema: options.inputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async (params) => {
+        try {
+            const paging = params;
+            const raw = options.method === "post"
+                ? await client.post(options.path(params), options.body?.(params))
+                : await client.get(options.path(params), options.query?.(params));
+            const items = extractItems(raw);
+            const data = {
+                server_total: extractServerTotal(raw),
+                traceId: extractTraceId(raw),
+                ...paginate(items, paging.limit, paging.offset)
+            };
+            const totalText = data.server_total === undefined
+                ? `${data.total} ${options.collectionLabel}`
+                : `${data.server_total} ${options.collectionLabel} reported by GoHighLevel, ${data.total} received`;
+            const markdown = [
+                `# ${options.heading}`,
+                "",
+                `Showing ${data.count} of ${totalText}.`,
+                "",
+                ...data.items.map((item) => `- ${summarizeRecord(item, options.preferredFields)}`)
+            ].join("\n");
+            return makeToolResponse(data, formatResponse(paging.response_format, data, markdown));
+        }
+        catch (error) {
+            const data = { error: formatApiError(error) };
+            return makeToolResponse(data, data.error, true);
+        }
+    });
+}
+export function extractItems(raw) {
+    if (Array.isArray(raw)) {
+        return raw;
+    }
+    if (raw && typeof raw === "object") {
+        const source = raw;
+        for (const key of ["customFields", "customValues", "contacts", "tags", "pipelines", "opportunities", "conversations", "messages", "calendars", "users", "fields", "folders", "events", "appointments", "slots", "freeSlots", "notes", "tasks", "results", "items", "data", "rows"]) {
+            if (Array.isArray(source[key])) {
+                return source[key];
+            }
+        }
+    }
+    return raw === undefined || raw === null ? [] : [raw];
+}
+export function extractTraceId(raw) {
+    return raw && typeof raw === "object" ? raw.traceId : undefined;
+}
+function extractServerTotal(raw) {
+    if (!raw || typeof raw !== "object") {
+        return undefined;
+    }
+    const value = raw.total;
+    return typeof value === "number" ? value : undefined;
+}
+//# sourceMappingURL=read-tools.js.map

package/dist/tools/read-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-tools.js","sourceRoot":"","sources":["../../src/tools/read-tools.ts"],"names":[],"mappings":"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"}

package/dist/tools/tags.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { GoHighLevelClient } from "../services/gohighlevel-client.js";
+export declare function registerTagTools(server: McpServer, client: GoHighLevelClient): void;
+//# sourceMappingURL=tags.d.ts.map

package/dist/tools/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/tools/tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAgB3E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAyHnF"}

package/dist/tools/tags.js

@@ -0,0 +1,113 @@
+import { formatApiError } from "../services/errors.js";
+import { CreateTagSchema, DeleteTagSchema, GetTagSchema, ListTagsSchema, UpdateTagSchema } from "../schemas/tags.js";
+import { formatResponse, makeToolResponse, requireConfirm, summarizeRecord } from "./format.js";
+import { registerCollectionReadTool } from "./read-tools.js";
+export function registerTagTools(server, client) {
+    registerCollectionReadTool(server, client, {
+        name: "ghl_list_tags",
+        title: "List GoHighLevel Tags",
+        description: "List tags for a GoHighLevel location from /locations/{locationId}/tags.",
+        inputSchema: ListTagsSchema.shape,
+        path: (params) => `/locations/${encodeURIComponent(resolveLocationId(client, params.location_id))}/tags`,
+        preferredFields: ["id", "name"],
+        heading: "GoHighLevel Tags",
+        collectionLabel: "tags"
+    });
+    server.registerTool("ghl_get_tag", {
+        title: "Get GoHighLevel Tag",
+        description: "Get one tag from /locations/{locationId}/tags/{id}.",
+        inputSchema: GetTagSchema.shape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async ({ location_id, tag_id, response_format }) => {
+        try {
+            const tag = await client.get(`/locations/${encodeURIComponent(resolveLocationId(client, location_id))}/tags/${encodeURIComponent(tag_id)}`);
+            const data = { tag };
+            const markdown = ["# GoHighLevel Tag", "", summarizeRecord(tag, ["id", "name"])].join("\n");
+            return makeToolResponse(data, formatResponse(response_format, data, markdown));
+        }
+        catch (error) {
+            const data = { error: formatApiError(error) };
+            return makeToolResponse(data, data.error, true);
+        }
+    });
+    server.registerTool("ghl_create_tag", {
+        title: "Create GoHighLevel Tag",
+        description: "Create a location tag. Write operation: do not run against live data without explicit approval.",
+        inputSchema: CreateTagSchema.shape,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true
+        }
+    }, async ({ location_id, name, response_format }) => {
+        try {
+            const tag = await client.post(`/locations/${encodeURIComponent(resolveLocationId(client, location_id))}/tags`, { name });
+            const data = { tag };
+            const markdown = ["# Created GoHighLevel Tag", "", summarizeRecord(tag, ["id", "name"])].join("\n");
+            return makeToolResponse(data, formatResponse(response_format, data, markdown));
+        }
+        catch (error) {
+            const data = { error: formatApiError(error) };
+            return makeToolResponse(data, data.error, true);
+        }
+    });
+    server.registerTool("ghl_update_tag", {
+        title: "Update GoHighLevel Tag",
+        description: "Update a location tag. Write operation: do not run against live data without explicit approval.",
+        inputSchema: UpdateTagSchema.shape,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async ({ location_id, tag_id, name, response_format }) => {
+        try {
+            const tag = await client.put(`/locations/${encodeURIComponent(resolveLocationId(client, location_id))}/tags/${encodeURIComponent(tag_id)}`, { name });
+            const data = { tag };
+            const markdown = ["# Updated GoHighLevel Tag", "", summarizeRecord(tag, ["id", "name"])].join("\n");
+            return makeToolResponse(data, formatResponse(response_format, data, markdown));
+        }
+        catch (error) {
+            const data = { error: formatApiError(error) };
+            return makeToolResponse(data, data.error, true);
+        }
+    });
+    server.registerTool("ghl_delete_tag", {
+        title: "Delete GoHighLevel Tag",
+        description: "Delete a location tag. Requires confirm: true and owner approval before live execution.",
+        inputSchema: DeleteTagSchema.shape,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: true
+        }
+    }, async ({ location_id, tag_id, confirm, response_format }) => {
+        const guard = requireConfirm(confirm);
+        if (guard) {
+            const data = { error: guard };
+            return makeToolResponse(data, data.error, true);
+        }
+        try {
+            const result = await client.del(`/locations/${encodeURIComponent(resolveLocationId(client, location_id))}/tags/${encodeURIComponent(tag_id)}`);
+            const data = { tag_id, result };
+            const markdown = ["# Deleted GoHighLevel Tag", "", `Deleted tag ${tag_id}.`].join("\n");
+            return makeToolResponse(data, formatResponse(response_format, data, markdown));
+        }
+        catch (error) {
+            const data = { error: formatApiError(error) };
+            return makeToolResponse(data, data.error, true);
+        }
+    });
+}
+function resolveLocationId(client, locationId) {
+    return typeof locationId === "string" && locationId.length > 0 ? locationId : client.defaultLocationId;
+}
+//# sourceMappingURL=tags.js.map

package/dist/tools/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.js","sourceRoot":"","sources":["../../src/tools/tags.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+export type GhlMethod = "GET" | "POST" | "PUT" | "DELETE";
+export type ResponseFormat = "markdown" | "json";
+export interface GhlConfig {
+    baseUrl: string;
+    apiToken: string;
+    apiVersion: string;
+    locationId: string;
+    timeoutMs: number;
+}
+export interface PaginatedItems<T> {
+    [key: string]: unknown;
+    total: number;
+    count: number;
+    offset: number;
+    items: T[];
+    has_more: boolean;
+    next_offset?: number;
+}
+export interface ToolResponse<T extends Record<string, unknown>> {
+    [key: string]: unknown;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    structuredContent: T;
+    isError?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE1D,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,iBAAiB,EAAE,CAAC,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@nightsquawktech/gohighlevel-mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for curated GoHighLevel API v2 coverage.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "COMMERCIAL.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "clean": "rimraf dist"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "axios": "^1.13.2",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "rimraf": "^6.0.1",
+    "tsx": "^4.20.0",
+    "typescript": "^5.9.0"
+  },
+  "license": "AGPL-3.0-only",
+  "author": "Kevin Reyes (NightSquawk Tech) <hello@nightsquawk.tech>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NightSquawk/gohighlevel-mcp-server.git"
+  },
+  "homepage": "https://github.com/NightSquawk/gohighlevel-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/NightSquawk/gohighlevel-mcp-server/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}