Skip to main content
Glama
ghl-mcp-server-v2

ghl-mcp-server-v2

by zackscriven

ghl_location_create

Creates a new sub-account (location) under a company using required name and company ID; an agency-level token is needed.

Instructions

REQUIRES AN AGENCY-LEVEL (Company) TOKEN — spec security is Agency-Access-Only. Creates a new sub-account (location) under the given companyId. Create Sub-Account (Formerly Location)

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "body": "<body>"
    },
    "name": "ghl_location_create"
  }
}

Input Schema

NameRequiredDescriptionDefault
bodyYesRequest body (schema carried verbatim from the official OpenAPI spec).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed6 schema fields changedv2.1.0
    • changedInput schema / properties / body / properties / mailgun / allOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "apiKey": {
      -        "description": "API key provided by Mailgun",
      -        "example": "key-XXXXXXXXXXX",
      -        "type": "string"
      -      },
      -      "domain": {
      -        "description": "Domain connected with Mailgun",
      -        "example": "replies.yourdomain.com",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "apiKey",
      -      "domain"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "apiKey": {
      +        "description": "API key provided by Mailgun",
      +        "example": "key-XXXXXXXXXXX",
      +        "type": "string"
      +      },
      +      "domain": {
      +        "description": "Domain connected with Mailgun",
      +        "example": "replies.yourdomain.com",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "apiKey",
      +      "domain"
      +    ],
      +    "title": "MailgunSchema",
      +    "type": "object"
      +  }
      +]
    • changedInput schema / properties / body / properties / prospectInfo / allOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "email": {
      -        "description": "Email of the prospect",
      -        "example": "john.doe@mail.com",
      -        "type": "string"
      -      },
      -      "firstName": {
      -        "description": "First name of the prospect",
      -        "example": "John",
      -        "type": "string"
      -      },
      -      "lastName": {
      -        "description": "Last name of the prospect",
      -        "example": "Doe",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "firstName",
      -      "lastName",
      -      "email"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "email": {
      +        "description": "Email of the prospect",
      +        "example": "john.doe@mail.com",
      +        "type": "string"
      +      },
      +      "firstName": {
      +        "description": "First name of the prospect",
      +        "example": "John",
      +        "type": "string"
      +      },
      +      "lastName": {
      +        "description": "Last name of the prospect",
      +        "example": "Doe",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "firstName",
      +      "lastName",
      +      "email"
      +    ],
      +    "title": "ProspectInfoDto",
      +    "type": "object"
      +  }
      +]
    • changedInput schema / properties / body / properties / settings / allOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "allowDuplicateContact": {
      -        "example": false,
      -        "type": "boolean"
      -      },
      -      "allowDuplicateOpportunity": {
      -        "example": false,
      -        "type": "boolean"
      -      },
      -      "allowFacebookNameMerge": {
      -        "example": false,
      -        "type": "boolean"
      -      },
      -      "disableContactTimezone": {
      -        "example": false,
      -        "type": "boolean"
      -      }
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "allowDuplicateContact": {
      +        "example": false,
      +        "type": "boolean"
      +      },
      +      "allowDuplicateOpportunity": {
      +        "example": false,
      +        "type": "boolean"
      +      },
      +      "allowFacebookNameMerge": {
      +        "example": false,
      +        "type": "boolean"
      +      },
      +      "disableContactTimezone": {
      +        "example": false,
      +        "type": "boolean"
      +      }
      +    },
      +    "title": "SettingsSchema",
      +    "type": "object"
      +  }
      +]
    • changedInput schema / properties / body / properties / social / allOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "blogRss": {
      -        "description": "Instagram URL",
      -        "example": "https://www.blogRss.com/",
      -        "type": "string"
      -      },
      -      "facebookUrl": {
      -        "description": "Facebook URL",
      -        "example": "https://www.facebook.com/",
      -        "type": "string"
      -      },
      -      "foursquare": {
      -        "description": "Foursquare URL",
      -        "example": "https://www.foursquare.com/",
      -        "type": "string"
      -      },
      -      "googlePlacesId": {
      -        "description": "Google Business Places ID",
      -        "example": "ChIJJGPdVbQTrjsRGUkefteUeFk",
      -        "type": "string"
      -      },
      -      "googlePlus": {
      -        "description": "Googleplus URL",
      -        "example": "https://www.googleplus.com/",
      -        "type": "string"
      -      },
      -      "instagram": {
      -        "description": "Instagram URL",
      -        "example": "https://www.instagram.com/",
      -        "type": "string"
      -      },
      -      "linkedIn": {
      -        "description": "LinkedIn URL",
      -        "example": "https://www.linkedIn.com/",
      -        "type": "string"
      -      },
      -      "pinterest": {
      -        "description": "Instagram URL",
      -        "example": "https://www.pinterest.com/",
      -        "type": "string"
      -      },
      -      "twitter": {
      -        "description": "Twitter URL",
      -        "example": "https://www.foutwitterrsquare.com/",
      -        "type": "string"
      -      },
      -      "yelp": {
      -        "description": "Yelp URL",
      -        "example": "https://www.yelp.com/",
      -        "type": "string"
      -      },
      -      "youtube": {
      -        "description": "Instagram URL",
      -        "example": "https://www.youtube.com/",
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "blogRss": {
      +        "description": "Instagram URL",
      +        "example": "https://www.blogRss.com/",
      +        "type": "string"
      +      },
      +      "facebookUrl": {
      +        "description": "Facebook URL",
      +        "example": "https://www.facebook.com/",
      +        "type": "string"
      +      },
      +      "foursquare": {
      +        "description": "Foursquare URL",
      +        "example": "https://www.foursquare.com/",
      +        "type": "string"
      +      },
      +      "googlePlacesId": {
      +        "description": "Google Business Places ID",
      +        "example": "ChIJJGPdVbQTrjsRGUkefteUeFk",
      +        "type": "string"
      +      },
      +      "googlePlus": {
      +        "description": "Googleplus URL",
      +        "example": "https://www.googleplus.com/",
      +        "type": "string"
      +      },
      +      "instagram": {
      +        "description": "Instagram URL",
      +        "example": "https://www.instagram.com/",
      +        "type": "string"
      +      },
      +      "linkedIn": {
      +        "description": "LinkedIn URL",
      +        "example": "https://www.linkedIn.com/",
      +        "type": "string"
      +      },
      +      "pinterest": {
      +        "description": "Instagram URL",
      +        "example": "https://www.pinterest.com/",
      +        "type": "string"
      +      },
      +      "twitter": {
      +        "description": "Twitter URL",
      +        "example": "https://www.foutwitterrsquare.com/",
      +        "type": "string"
      +      },
      +      "yelp": {
      +        "description": "Yelp URL",
      +        "example": "https://www.yelp.com/",
      +        "type": "string"
      +      },
      +      "youtube": {
      +        "description": "Instagram URL",
      +        "example": "https://www.youtube.com/",
      +        "type": "string"
      +      }
      +    },
      +    "title": "SocialSchema",
      +    "type": "object"
      +  }
      +]
    • changedInput schema / properties / body / properties / twilio / allOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "authToken": {
      -        "description": "Auth token provided by Twilio",
      -        "example": "77_XXXXXXXXXXX",
      -        "type": "string"
      -      },
      -      "sid": {
      -        "description": "SID provided by Twilio",
      -        "example": "AC_XXXXXXXXXXX",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "sid",
      -      "authToken"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "authToken": {
      +        "description": "Auth token provided by Twilio",
      +        "example": "77_XXXXXXXXXXX",
      +        "type": "string"
      +      },
      +      "sid": {
      +        "description": "SID provided by Twilio",
      +        "example": "AC_XXXXXXXXXXX",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "sid",
      +      "authToken"
      +    ],
      +    "title": "TwilioSchema",
      +    "type": "object"
      +  }
      +]
    • addedInput schema / properties / body / title
      Added value: +"CreateLocationDto"
  2. First observedv2.0.0

TDQS

A3.9/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=false, openWorldHint=true, idempotentHint=false, destructiveHint=false. The description adds genuinely new behavioral context beyond that: the exact endpoint (POST /locations/, v3 header), the required OAuth scope locations.write, and the plan-level entitlement. It does not disclose what the response contains or whether re-invocation creates duplicates.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The critical auth requirement is front-loaded, but it is then restated verbatim later ('Requires an Agency (company-level) token'), and the body carries raw HTML artifacts (nested divs, ':::info ... :::') that add no meaning. Roughly a third of the text is redundant or generated markup.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a non-idempotent, open-world create operation with no output schema, the description covers auth, entitlement, endpoint, and scope, which is most of what an agent needs to avoid a failed call. It omits only the return payload (e.g. whether the new locationId is returned for follow-up calls).

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% and there is a single `body` parameter whose nested fields are all documented in the schema, so the schema does the heavy lifting. The description does not clarify the body beyond naming companyId as the parent, so baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource with scope: 'Creates a new sub-account (location) under the given companyId.' An agent can distinguish this from ghl_location_update, ghl_location_get, and ghl_location_delete without opening the schema, and the agency-level parentage is made explicit.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides strong preconditions: an Agency (company-level) token is REQUIRED, and the feature is only available on the Agency Pro ($497) plan. This effectively gates when the tool can be used. It doesn't contrast with sibling alternatives (e.g. ghl_location_update for modifying an existing sub-account), so it stops short of a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools