Skip to content

Commit f3bf302

Browse files
SmannenbachSmannenbach
committed
feat(ghl-browser): add 10 high-priority modules — 308 tools across 60 modules
Add 50 tools across 10 new modules covering high-priority GHL gaps: - Ad Publishing: campaigns, metrics, create, toggle (Facebook/Google) - Bulk Actions: bulk tag add/remove, field update, operation status - Chat Widget: config, update, toggle, embed code, departments - Content AI: settings, templates, generate, history, usage - Gift Cards: CRUD, transactions, activate/deactivate - Preference Management: categories, contact prefs, TCPA/GDPR compliance - Reseller: overview, clients, pricing, invoices - SaaS Mode: overview, plans, clients, billing summary - Platform Billing: invoices, payment method, usage, plan comparison - Store Catalog: products, categories, orders summary All 308 tools register cleanly. TypeScript compiles with zero errors.
1 parent 61e801e commit f3bf302

14 files changed

Lines changed: 2923 additions & 4 deletions

‎src/ghl-browser/README.md‎

Lines changed: 102 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# ghl-browser-mcp
22

3-
Browser-automation MCP server providing **258 tools** covering the full
3+
Browser-automation MCP server providing **308 tools** covering the full
44
GoHighLevel (GHL) platform. Every major GHL feature area is accessible:
55
workflow builder, funnel pages, pipeline management, campaigns, social media,
66
blogs, forms, email templates, website/page builder, proposals, calendars,
@@ -54,7 +54,7 @@ Speaks MCP over stdio. Add to your MCP client config:
5454
}
5555
```
5656

57-
## Tools (258 total)
57+
## Tools (308 total)
5858

5959
All tools are best-effort UI automation. If GHL reorganizes the DOM, tools
6060
may fail gracefully with a screenshot path in the error message for debugging.
@@ -572,6 +572,106 @@ VERBOSE=1 node integration-test.mjs
572572
| `ghl_browser_toggle_location_feature` | Enable or disable a feature toggle |
573573
| `ghl_browser_get_location_domains` | Get configured domains: custom domains, CNAME, SSL status |
574574

575+
### Ad Publishing (5)
576+
577+
| Tool | Description |
578+
|---|---|
579+
| `ghl_browser_list_ad_campaigns` | List ad campaigns (Facebook/Google) with name, platform, status, budget, spend |
580+
| `ghl_browser_get_ad_campaign_details` | Get detailed metrics and settings for a specific ad campaign |
581+
| `ghl_browser_create_ad_campaign` | Create a new ad campaign on Facebook or Google |
582+
| `ghl_browser_get_ad_metrics` | Get aggregate ad performance: impressions, clicks, CTR, spend, conversions |
583+
| `ghl_browser_toggle_ad_campaign` | Enable or pause an ad campaign |
584+
585+
### Bulk Actions (5)
586+
587+
| Tool | Description |
588+
|---|---|
589+
| `ghl_browser_list_bulk_operations` | List recent bulk operations with type, status, count, and date |
590+
| `ghl_browser_get_bulk_operation_status` | Get the status and progress of a specific bulk operation |
591+
| `ghl_browser_bulk_add_tag` | Add a tag to multiple contacts at once |
592+
| `ghl_browser_bulk_remove_tag` | Remove a tag from multiple contacts at once |
593+
| `ghl_browser_bulk_update_field` | Update a custom field value for multiple contacts at once |
594+
595+
### Chat Widget (5)
596+
597+
| Tool | Description |
598+
|---|---|
599+
| `ghl_browser_get_chat_widget_config` | Get current live chat widget config: enabled, colors, position, greeting |
600+
| `ghl_browser_update_chat_widget` | Update chat widget settings: greeting, position, colors |
601+
| `ghl_browser_toggle_chat_widget` | Enable or disable the live chat widget |
602+
| `ghl_browser_get_chat_widget_code` | Get the embed code snippet for the chat widget |
603+
| `ghl_browser_list_chat_widget_departments` | List departments/routing rules with agents and hours |
604+
605+
### Content AI (5)
606+
607+
| Tool | Description |
608+
|---|---|
609+
| `ghl_browser_get_content_ai_settings` | Get Content AI config: tone, brand voice, language, usage limits |
610+
| `ghl_browser_list_content_ai_templates` | List writing templates by category (email, ad, social, blog) |
611+
| `ghl_browser_generate_content_ai_text` | Generate AI content using a template and prompt |
612+
| `ghl_browser_list_content_ai_history` | List recently generated outputs with template and date |
613+
| `ghl_browser_get_content_ai_usage` | Get usage stats: credits used, remaining, content generated |
614+
615+
### Gift Cards (5)
616+
617+
| Tool | Description |
618+
|---|---|
619+
| `ghl_browser_list_gift_cards` | List gift card products with denomination, status, inventory |
620+
| `ghl_browser_get_gift_card_details` | Get details of a specific gift card product |
621+
| `ghl_browser_create_gift_card` | Create a new gift card product with name and denomination |
622+
| `ghl_browser_list_gift_card_transactions` | List purchase/redemption transactions |
623+
| `ghl_browser_toggle_gift_card` | Activate or deactivate a gift card product |
624+
625+
### Preference Management (5)
626+
627+
| Tool | Description |
628+
|---|---|
629+
| `ghl_browser_get_preference_settings` | Get communication preference settings: opt-in defaults, channels |
630+
| `ghl_browser_list_preference_categories` | List preference categories with channel settings |
631+
| `ghl_browser_create_preference_category` | Create a new preference category |
632+
| `ghl_browser_get_contact_preferences` | Get a contact's communication preferences across all categories |
633+
| `ghl_browser_get_compliance_summary` | Get compliance summary: TCPA, GDPR, CAN-SPAM status |
634+
635+
### Reseller (5)
636+
637+
| Tool | Description |
638+
|---|---|
639+
| `ghl_browser_get_reseller_overview` | Get reseller program overview: plan, commission, clients, revenue |
640+
| `ghl_browser_list_reseller_clients` | List reseller clients with plan, status, monthly revenue |
641+
| `ghl_browser_get_reseller_client_details` | Get detailed info for a specific reseller client |
642+
| `ghl_browser_get_reseller_pricing` | Get reseller pricing tiers and commission structure |
643+
| `ghl_browser_list_reseller_invoices` | List reseller invoices with date, amount, status |
644+
645+
### SaaS Mode (5)
646+
647+
| Tool | Description |
648+
|---|---|
649+
| `ghl_browser_get_saas_overview` | Get SaaS overview: plan, pricing, active clients, MRR |
650+
| `ghl_browser_list_saas_plans` | List subscription plans with price, features, subscriber count |
651+
| `ghl_browser_create_saas_plan` | Create a new subscription plan with pricing and features |
652+
| `ghl_browser_list_saas_clients` | List SaaS clients with plan, status, billing |
653+
| `ghl_browser_get_saas_billing_summary` | Get billing summary: MRR, ARR, churn rate |
654+
655+
### Platform Billing (5)
656+
657+
| Tool | Description |
658+
|---|---|
659+
| `ghl_browser_get_platform_billing_overview` | Get billing overview: plan, cycle, next payment, balance |
660+
| `ghl_browser_list_platform_invoices` | List platform-level invoices with date, amount, status |
661+
| `ghl_browser_get_platform_payment_method` | Get payment method on file: card type, last 4, expiry |
662+
| `ghl_browser_list_platform_usage` | Get usage breakdown: contacts, emails, SMS, storage |
663+
| `ghl_browser_get_platform_plan_comparison` | Compare available plans with pricing and limits |
664+
665+
### Store Catalog (5)
666+
667+
| Tool | Description |
668+
|---|---|
669+
| `ghl_browser_list_store_products` | List products with name, price, inventory, category, status |
670+
| `ghl_browser_get_store_product_details` | Get detailed information for a specific product |
671+
| `ghl_browser_create_store_product` | Create a new product with name, price, description, category |
672+
| `ghl_browser_list_store_categories` | List product categories with name and product count |
673+
| `ghl_browser_get_store_orders_summary` | Get orders summary: total orders, revenue, pending, fulfilled |
674+
575675
### Utils (4)
576676

577677
| Tool | Description |

‎src/ghl-browser/integration-test.mjs‎

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -230,6 +230,56 @@ const READ_ONLY_TOOLS = [
230230
{ name: "ghl_browser_get_location_features", args: {}, group: "Loc Settings" },
231231
{ name: "ghl_browser_get_location_domains", args: {}, group: "Loc Settings" },
232232

233+
// Ad Publishing
234+
{ name: "ghl_browser_list_ad_campaigns", args: {}, group: "Ads" },
235+
{ name: "ghl_browser_get_ad_metrics", args: {}, group: "Ads" },
236+
237+
// Bulk Actions
238+
{ name: "ghl_browser_list_bulk_operations", args: {}, group: "Bulk" },
239+
240+
// Chat Widget
241+
{ name: "ghl_browser_get_chat_widget_config", args: {}, group: "Chat" },
242+
{ name: "ghl_browser_list_chat_widget_departments", args: {}, group: "Chat" },
243+
244+
// Content AI
245+
{ name: "ghl_browser_get_content_ai_settings", args: {}, group: "Content AI" },
246+
{ name: "ghl_browser_list_content_ai_templates", args: {}, group: "Content AI" },
247+
{ name: "ghl_browser_list_content_ai_history", args: {}, group: "Content AI" },
248+
{ name: "ghl_browser_get_content_ai_usage", args: {}, group: "Content AI" },
249+
250+
// Gift Cards
251+
{ name: "ghl_browser_list_gift_cards", args: {}, group: "Gift Cards" },
252+
{ name: "ghl_browser_list_gift_card_transactions", args: {}, group: "Gift Cards" },
253+
254+
// Preference Management
255+
{ name: "ghl_browser_get_preference_settings", args: {}, group: "Prefs" },
256+
{ name: "ghl_browser_list_preference_categories", args: {}, group: "Prefs" },
257+
{ name: "ghl_browser_get_compliance_summary", args: {}, group: "Prefs" },
258+
259+
// Reseller
260+
{ name: "ghl_browser_get_reseller_overview", args: {}, group: "Reseller" },
261+
{ name: "ghl_browser_list_reseller_clients", args: {}, group: "Reseller" },
262+
{ name: "ghl_browser_get_reseller_pricing", args: {}, group: "Reseller" },
263+
{ name: "ghl_browser_list_reseller_invoices", args: {}, group: "Reseller" },
264+
265+
// SaaS Mode
266+
{ name: "ghl_browser_get_saas_overview", args: {}, group: "SaaS" },
267+
{ name: "ghl_browser_list_saas_plans", args: {}, group: "SaaS" },
268+
{ name: "ghl_browser_list_saas_clients", args: {}, group: "SaaS" },
269+
{ name: "ghl_browser_get_saas_billing_summary", args: {}, group: "SaaS" },
270+
271+
// Platform Billing
272+
{ name: "ghl_browser_get_platform_billing_overview", args: {}, group: "Billing" },
273+
{ name: "ghl_browser_list_platform_invoices", args: {}, group: "Billing" },
274+
{ name: "ghl_browser_get_platform_payment_method", args: {}, group: "Billing" },
275+
{ name: "ghl_browser_list_platform_usage", args: {}, group: "Billing" },
276+
{ name: "ghl_browser_get_platform_plan_comparison", args: {}, group: "Billing" },
277+
278+
// Store Catalog
279+
{ name: "ghl_browser_list_store_products", args: {}, group: "Store" },
280+
{ name: "ghl_browser_list_store_categories", args: {}, group: "Store" },
281+
{ name: "ghl_browser_get_store_orders_summary", args: {}, group: "Store" },
282+
233283
// Screenshot (read-only — captures a page)
234284
{ name: "ghl_browser_screenshot", args: { path: "/dashboard", label: "integration-test" }, group: "Utils" },
235285

‎src/ghl-browser/package.json‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
{
22
"name": "@qoder/ghl-browser-mcp",
3-
"version": "1.4.0",
3+
"version": "1.5.0",
44
"private": true,
55
"type": "module",
6-
"description": "Browser-automation MCP server providing 258 tools covering the full GHL (GoHighLevel) UI: workflows, funnels, pipelines, campaigns, social, blogs, forms, email, pages, proposals, calendars, bookings, reporting, memberships, invoices, reputation, affiliates, settings, triggers, snapshots, conversation AI, media library, tags, custom fields, automation templates, conversations, contacts, documents, payments, ecommerce, events, communities, copilot, custom objects, notifications, voice AI, power dialer, performance AI, agency management, dashboard widgets, SEO, snippets, contact scoring, superagents, AI employees, agent builder, agent studio, industry agents, and location settings",
6+
"description": "Browser-automation MCP server providing 308 tools covering the full GHL (GoHighLevel) UI: workflows, funnels, pipelines, campaigns, social, blogs, forms, email, pages, proposals, calendars, bookings, reporting, memberships, invoices, reputation, affiliates, settings, triggers, snapshots, conversation AI, media library, tags, custom fields, automation templates, conversations, contacts, documents, payments, ecommerce, events, communities, copilot, custom objects, notifications, voice AI, power dialer, performance AI, agency management, dashboard widgets, SEO, snippets, contact scoring, superagents, AI employees, agent builder, agent studio, industry agents, location settings, ad publishing, bulk actions, chat widget, content AI, gift cards, preference management, reseller, SaaS mode, platform billing, and store catalog",
77
"bin": {
88
"ghl-browser-mcp": "dist/index.js"
99
},

0 commit comments

Comments
 (0)