Quick start
Agency MCP is a Model Context Protocol server that connects your AI client — Claude Desktop, Cursor, Continue, or others — to your GoHighLevel agency account, so your AI can read and write GHL data through named, validated tool calls.
What you have right now
After installing Agency MCP from the GHL marketplace, two things exist:
- Your personal API bearer token. It was shown once on the install-success page. If you saved it, you can use it immediately. If you missed it, go to your dashboard and create a new one (see Bearer tokens).
- Your dashboard. You can return to it any time at
https://agency-mcp.launchmaniac.com/app— or from GHL via Settings > Apps > Agency MCP.
3-step setup
Step 1. Choose your AI client.
- Claude Desktop (Mac): Download
agency-mcp-installer.zipfrom the install-success page. Unzip it, double-clickinstall.command, and follow the prompt. The installer creates a per-device bearer and writes the config for you. You do not need to touch any JSON files. - Cursor, Continue, Zed, Windsurf: Copy the JSON config snippet shown in the "Advanced / manual install" section of your dashboard. Paste it into
~/.cursor/mcp.json(or your client's equivalent config file) and replace the placeholder with your bearer token. - Claude.ai web (browser-only): A no-install browser mode is on the roadmap but is not available yet. Use the desktop install path for now.
Step 2. Confirm the connection.
Open your AI client. Ask it something simple:
List my active Agency MCP tools
The client should respond with a list of tool names. If it does, the connection is working.
Step 3. Try a real prompt.
Ask your AI assistant something like:
Show me all contacts in my GHL account who have the tag "lead" and were created in the last 7 days
Your AI will pick the appropriate tool — likely search_contacts — call Agency MCP, and return the results. No manual API calls, no copy-pasting contact IDs.
What's next
- Learn how to connect additional AI clients: Connecting AI clients
- Manage your bearer tokens: Bearer tokens
- Give a bearer a focused permission set: Scope permissions
- Understand pricing and white-label rights: Pricing and white-label resale
- Troubleshoot common errors: Troubleshooting