hylo-mcp

MCP server for the Hylo GHL Knowledge API. Gives Claude Code, Cursor, and Windsurf native tool access to GoHighLevel reference data — workflow actions, triggers, API schemas, UI protocols, and navigation hints.

Quick Start

npx hylo-mcp

Requires a Hylo API key. Sign up for a 7-day free trial.

Setup

Claude Code

Add to ~/.claude.json (or project .claude/settings.json):

{
  "mcpServers": {
    "hylo": {
      "command": "npx",
      "args": ["-y", "hylo-mcp"],
      "env": {
        "HYLO_API_KEY": "hylo_sk_your_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "hylo": {
      "command": "npx",
      "args": ["-y", "hylo-mcp"],
      "env": {
        "HYLO_API_KEY": "hylo_sk_your_key_here"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "hylo": {
      "command": "npx",
      "args": ["-y", "hylo-mcp"],
      "env": {
        "HYLO_API_KEY": "hylo_sk_your_key_here"
      }
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | hylo_search_actions | Search GHL workflow actions by keyword or category | | hylo_search_triggers | Search GHL workflow triggers by keyword or category | | hylo_search_schemas | Search GHL API endpoint schemas by keyword, category, or HTTP method | | hylo_get_schema | Get the full schema for a specific API endpoint | | hylo_navigate | Get navigation hints for a GHL feature (URLs, sidebar paths, tips) | | hylo_get_protocol | Get the full UI protocol for a GHL feature (selectors, modals, forms) | | hylo_plan_workflow | Generate a workflow template from a natural language description | | hylo_validate_workflow | Validate a workflow configuration against known GHL constraints | | hylo_get_workflow_auth | Get the GHL token-extraction recipe + downstream call recipe for reading/writing workflow bodies. Call this before any workflow body read/write — PIT/OAuth Bearer 401 on those routes. |

All tools are read-only and annotated as safe for auto-approval.

CLI Subcommands

In addition to the MCP server, the package exposes utility commands:

| Command | What it does | |---------|--------------| | npx hylo-mcp | Run the MCP server (default — used by your IDE config). | | npx hylo-mcp grab-token | Extract a fresh GHL Firebase ID token from a running Chrome on --remote-debugging-port=9222 and write it to ~/.hylo/ghl-token.json. Use when you need to read/write workflow bodies and don't want to paste an auth-dump snippet. | | npx hylo-mcp --help | Show usage. |

grab-token — quick start

# 1. Quit Chrome, relaunch with the debug port flag.
open -na "Google Chrome" --args --remote-debugging-port=9222   # macOS

# 2. Sign into GHL, open any workflows page.

# 3. Grab the token.
npx hylo-mcp grab-token
# → ~/.hylo/ghl-token.json

Tokens are Firebase ID tokens with ~1hr TTL — rerun the command when you get 401s. Override the port with HYLO_CDP_PORT=<port>.

Configuration

| Variable | Required | Description | |----------|----------|-------------| | HYLO_API_KEY | Yes | Your Hylo API key (starts with hylo_sk_) | | HYLO_API_URL | No | API base URL (default: https://api.hylo.pro). For development only. | | HYLO_CDP_PORT | No | Chrome DevTools Protocol port for grab-token (default 9222). |

Getting an API Key

1. Visit hylo.pro
2. Sign up for a 7-day free trial
3. Copy your API key from the dashboard
4. Add it to your IDE's MCP configuration (see Setup above)

Troubleshooting

| Error | Cause | Fix | |-------|-------|-----| | "HYLO_API_KEY environment variable is not set" | No API key configured | Add HYLO_API_KEY to your MCP config's env block | | "Invalid API key" | Key is wrong or revoked | Check your key at hylo.pro/dashboard | | "Subscription inactive" | Trial expired or subscription cancelled | Reactivate at hylo.pro/dashboard | | "Rate limit exceeded" | Too many requests for your plan | Upgrade at hylo.pro/pricing |

License

MIT