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

ghl-mcp-server-v2

by zackscriven

ghl_location_update

Idempotent

Updates a GoHighLevel sub-account (location) using supplied details and an agency-level token via the v3 locations endpoint.

Instructions

REQUIRES AN AGENCY-LEVEL (Company) TOKEN — spec security is Agency-Access-Only. Put Sub-Account (Formerly Location) Update a Sub-Account (Formerly Location) based on the data provided Endpoint: PUT /locations/{locationId} (Version header: v3; source: v3/locations-v3.json) Requires an Agency (company-level) token. OAuth scopes: locations.write

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": {
      "locationId": "<locationId>",
      "body": "<body>"
    },
    "name": "ghl_location_update"
  }
}

Input Schema

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

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed7 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 / snapshot / allOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "id": {
      -        "description": "Snaptshot ID",
      -        "example": "XXXXXXXXXXX",
      -        "type": "string"
      -      },
      -      "override": {
      -        "default": false,
      -        "description": "If you want override all conflicted assets then pass true. Default value is false.",
      -        "example": false,
      -        "type": "boolean"
      -      }
      -    },
      -    "required": [
      -      "id"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "id": {
      +        "description": "Snaptshot ID",
      +        "example": "XXXXXXXXXXX",
      +        "type": "string"
      +      },
      +      "override": {
      +        "default": false,
      +        "description": "If you want override all conflicted assets then pass true. Default value is false.",
      +        "example": false,
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "id"
      +    ],
      +    "title": "SnapshotPutSchema",
      +    "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: +"UpdateLocationDto"
  2. First observedv2.0.0

TDQS

A3.8/5.0
Behavior4/5

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

The annotations already cover idempotency, mutability, and open-world behavior, so the description adds valuable auth and scope details beyond annotations. It does not describe update semantics such as partial vs full replacement or what happens to omitted fields.

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

Conciseness3/5

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

The agency-token requirement is front-loaded well, but it is repeated later in the description. The title-like phrase 'Put Sub-Account' and the generic 'based on the data provided' also add some redundancy.

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?

The description covers the critical auth requirement, OAuth scope, HTTP method, endpoint, and version, which is sufficient given full schema coverage. It could better explain whether this is a partial or full update and whether omitted location fields are preserved.

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 coverage is 100%, so the schema documents both parameters and all nested body fields. The description adds no parameter-level meaning beyond the endpoint path, making the baseline score appropriate.

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

Purpose4/5

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

The description clearly states the specific action and resource: update a sub-account/location via PUT /locations/{locationId}. It is distinguishable from create/get/delete siblings by the verb, though it does not explicitly name alternatives.

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?

It gives important usage context by stating that an agency-level (Company) token is required and specifying the OAuth scope locations.write. It does not discuss when to choose this over other location tools, but the prerequisites are clear.

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