# GoHighLevel Gold — We Build Bridges

11 tools that turn Claude into your agency's GHL operator, via the **official LeadConnector API v2**.
$39 once. No subscription. Your own API key (BYOK), fail-closed.

> **BYOK + fail-closed before price:** Bring your own keys — `GHL_API_KEY` + `LOCATION_ID` stay on your machine, fail-closed without them. **Price $39 once** (no subscription) — 11 tools + setup =12 require `GOLD_LICENSE_KEY`.

## Why this exists

- Agencies pay GoHighLevel $97–497/month and still click through contacts one by one ([gohighlevel.com/pricing](https://www.gohighlevel.com/pricing), accessed 2026-08-22).
- The best free MCP (`mastanley13/GoHighLevel-MCP`, 193 stars / 202 forks) has been **abandoned since July 2025** with an unclear license. We rebuilt from scratch on the official v2 API — maintained, typed, bulk-first.

## Tools (11 tools + gold_setup_check =12 total — BYOK fail-closed)

| Tool | What it does |
|---|---|
| `gold_ghl_contacts_search_upsert_bulk` | Search contacts by query OR bulk-upsert up to 50 by email with tags |
| `gold_ghl_opportunity_move_stage` | Move a deal to any pipeline stage / won / lost (+ value) |
| `gold_ghl_conversations_list_reply_draft` | List threads unread-first; pull one thread to draft the reply |
| `gold_ghl_appointments_calendar` | Calendars + upcoming appointments window |
| `gold_ghl_tags_bulk_apply` | Add/remove tags across up to 25 contacts per call |
| `gold_ghl_custom_fields_map` | Exact custom field keys/types so AI fills them right |
| `gold_ghl_conversation_ai_summary` | AI summary of conversation (BYOK OpenAI or transcript) |
| `gold_ghl_location_switcher` | Agency mode: list/inspect every sub-account your key reaches |
| `gold_ghl_workflows_list` | What automation fires (name/status/stats) before you touch anything |
| `gold_ghl_pipeline_snapshot_report` | Monday report: open + won value per stage, one call |

## Setup (BYOK, 2 minutes)

1. In your sub-account: **Settings → Private Integrations → Create New Integration** → copy the PIT token.
2. Env or `~/.gold-mcp/.env`:
   - `GOLD_LICENSE_KEY` — your $29/$39 license key (PRO gate, fail-closed)
   - `GHL_API_KEY` — the PIT token
   - `GHL_LOCATION_ID` — default sub-account id (optional; agencies pass `location_id` per call or use `gold_ghl_location_switcher`)
3. Register in your MCP client:

```json
{ "mcpServers": { "ghl-gold": { "command": "npx", "args": ["-y", "ghl-gold"], "env": { "GOLD_LICENSE_KEY": "...", "GHL_API_KEY": "...", "GHL_LOCATION_ID": "..." } } } }
```

## Safety model

- Read tools list freely; write tools are explicit and scoped (max 50 upserts / 25 tag-touches per call).
- Sending conversations is intentionally NOT in v1 — drafts only, you press send in GHL.
- Fail-closed: missing key/license ⇒ structured config error, never fake data.

## License & privacy

One-time purchase, your keys stay on your machine, nothing phones home except GoHighLevel itself. See LICENSE + THIRD_PARTY_NOTICES.md.

*We Build Bridges — bridges between AI and the software you already pay for.*