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

ghl-mcp-server-v2

by zackscriven

ghl_estimate_template_create

Creates a new estimate template in GoHighLevel so agencies or sub-accounts can standardize estimate details, line items, currency, and discounts.

Instructions

Create Estimate Template Create a new estimate template Endpoint: POST /invoices/estimate/template (Version header: v3; source: v3/invoices-v3.json) Requires an Agency or Sub-Account token. OAuth scopes: invoices/estimate.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": {
      "body": "<body>"
    },
    "name": "ghl_estimate_template_create"
  }
}

Input Schema

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

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed7 schema fields changedv2.1.0
    • addedInput schema / properties / body / properties / attachments / items / title
      Added value: +"AttachmentsDto"
    • changedInput schema / properties / body / properties / businessDetails / properties / address / allOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "addressLine1": {
      -        "description": "Address Line 1",
      -        "example": "9931 Beechwood",
      -        "type": "string"
      -      },
      -      "addressLine2": {
      -        "description": "Address Line 2",
      -        "example": "Beechwood",
      -        "type": "string"
      -      },
      -      "city": {
      -        "description": "City",
      -        "example": "St. Houston",
      -        "type": "string"
      -      },
      -      "countryCode": {
      -        "description": "Country Code",
      -        "example": "US",
      -        "type": "string"
      -      },
      -      "postalCode": {
      -        "description": "Postal Code",
      -        "example": "559-6993",
      -        "type": "string"
      -      },
      -      "state": {
      -        "description": "State",
      -        "example": "TX",
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "addressLine1": {
      +        "description": "Address Line 1",
      +        "example": "9931 Beechwood",
      +        "type": "string"
      +      },
      +      "addressLine2": {
      +        "description": "Address Line 2",
      +        "example": "Beechwood",
      +        "type": "string"
      +      },
      +      "city": {
      +        "description": "City",
      +        "example": "St. Houston",
      +        "type": "string"
      +      },
      +      "countryCode": {
      +        "description": "Country Code",
      +        "example": "US",
      +        "type": "string"
      +      },
      +      "postalCode": {
      +        "description": "Postal Code",
      +        "example": "559-6993",
      +        "type": "string"
      +      },
      +      "state": {
      +        "description": "State",
      +        "example": "TX",
      +        "type": "string"
      +      }
      +    },
      +    "title": "AddressDto",
      +    "type": "object"
      +  }
      +]
    • addedInput schema / properties / body / properties / businessDetails / title
      Added value: +"BusinessDetailsDto"
    • addedInput schema / properties / body / properties / discount / title
      Added value: +"DiscountDto"
    • changedInput schema / properties / body / properties / miscellaneousCharges / allOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "charges": {
      -        "description": "charges for the processing fee",
      -        "items": {
      -          "type": "array"
      -        },
      -        "type": "array"
      -      },
      -      "collectedMiscellaneousCharges": {
      -        "description": "collected miscellaneous charges",
      -        "example": 10,
      -        "type": "number"
      -      },
      -      "paidCharges": {
      -        "description": "paid miscellaneous charges",
      -        "items": {
      -          "properties": {
      -            "_id": {
      -              "description": "id of the processing fee",
      -              "example": "673d01d7d547648a8dab6211",
      -              "type": "string"
      -            },
      -            "amount": {
      -              "description": "amount of the processing fee",
      -              "example": 10,
      -              "type": "number"
      -            },
      -            "charge": {
      -              "description": "charge for the processing fee",
      -              "example": 10,
      -              "type": "number"
      -            },
      -            "name": {
      -              "description": "name of the processing fee",
      -              "example": "Processing Fee",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "name",
      -            "charge",
      -            "amount",
      -            "_id"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "charges"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "charges": {
      +        "description": "charges for the processing fee",
      +        "items": {
      +          "type": "array"
      +        },
      +        "type": "array"
      +      },
      +      "collectedMiscellaneousCharges": {
      +        "description": "collected miscellaneous charges",
      +        "example": 10,
      +        "type": "number"
      +      },
      +      "paidCharges": {
      +        "description": "paid miscellaneous charges",
      +        "items": {
      +          "properties": {
      +            "_id": {
      +              "description": "id of the processing fee",
      +              "example": "673d01d7d547648a8dab6211",
      +              "type": "string"
      +            },
      +            "amount": {
      +              "description": "amount of the processing fee",
      +              "example": 10,
      +              "type": "number"
      +            },
      +            "charge": {
      +              "description": "charge for the processing fee",
      +              "example": 10,
      +              "type": "number"
      +            },
      +            "name": {
      +              "description": "name of the processing fee",
      +              "example": "Processing Fee",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "name",
      +            "charge",
      +            "amount",
      +            "_id"
      +          ],
      +          "title": "ProcessingFeePaidChargeDto",
      +          "type": "object"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "charges"
      +    ],
      +    "title": "ProcessingFeeDto",
      +    "type": "object"
      +  }
      +]
    • changedInput schema / properties / body / properties / sendEstimateDetails / allOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "action": {
      -        "enum": [
      -          "sms_and_email",
      -          "send_manually",
      -          "email",
      -          "sms"
      -        ],
      -        "type": "string"
      -      },
      -      "altId": {
      -        "description": "Location Id or Agency Id",
      -        "example": "6578278e879ad2646715ba9c",
      -        "type": "string"
      -      },
      -      "altType": {
      -        "enum": [
      -          "location"
      -        ],
      -        "type": "string"
      -      },
      -      "estimateName": {
      -        "description": "estimate name",
      -        "example": "Estimate",
      -        "type": "string"
      -      },
      -      "liveMode": {
      -        "description": "livemode for estimate",
      -        "example": true,
      -        "type": "boolean"
      -      },
      -      "sentFrom": {
      -        "allOf": [
      -          {
      -            "properties": {
      -              "fromEmail": {
      -                "description": "Email id to be used while sending email notification",
      -                "example": "alex@example.com",
      -                "type": "string"
      -              },
      -              "fromName": {
      -                "description": "Sender name to be used while sending email notification",
      -                "example": "Alex",
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          }
      -        ],
      -        "description": "sender details for invoice, valid only if invoice is not sent manually"
      -      },
      -      "userId": {
      -        "description": "Please ensure that the UserId corresponds to an authorized personnel, either by an employee ID or agency ID, to access this location. This account will serve as the primary channel for all future communications and updates.",
      -        "example": "6578278e879ad2646715ba9c",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "altId",
      -      "altType",
      -      "action",
      -      "liveMode",
      -      "userId"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "action": {
      +        "enum": [
      +          "sms_and_email",
      +          "send_manually",
      +          "email",
      +          "sms"
      +        ],
      +        "type": "string"
      +      },
      +      "altId": {
      +        "description": "Location Id or Agency Id",
      +        "example": "6578278e879ad2646715ba9c",
      +        "type": "string"
      +      },
      +      "altType": {
      +        "enum": [
      +          "location"
      +        ],
      +        "type": "string"
      +      },
      +      "estimateName": {
      +        "description": "estimate name",
      +        "example": "Estimate",
      +        "type": "string"
      +      },
      +      "liveMode": {
      +        "description": "livemode for estimate",
      +        "example": true,
      +        "type": "boolean"
      +      },
      +      "sentFrom": {
      +        "allOf": [
      +          {
      +            "properties": {
      +              "fromEmail": {
      +                "description": "Email id to be used while sending email notification",
      +                "example": "alex@example.com",
      +                "type": "string"
      +              },
      +              "fromName": {
      +                "description": "Sender name to be used while sending email notification",
      +                "example": "Alex",
      +                "type": "string"
      +              }
      +            },
      +            "title": "InvoiceSettingsSenderConfigurationDto",
      +            "type": "object"
      +          }
      +        ],
      +        "description": "sender details for invoice, valid only if invoice is not sent manually"
      +      },
      +      "userId": {
      +        "description": "Please ensure that the UserId corresponds to an authorized personnel, either by an employee ID or agency ID, to access this location. This account will serve as the primary channel for all future communications and updates.",
      +        "example": "6578278e879ad2646715ba9c",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "altId",
      +      "altType",
      +      "action",
      +      "liveMode",
      +      "userId"
      +    ],
      +    "title": "SendEstimateDto",
      +    "type": "object"
      +  }
      +]
    • addedInput schema / properties / body / title
      Added value: +"EstimateTemplatesDto"
  2. First observedv2.0.0

TDQS

A3.5/5.0
Behavior4/5

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

Annotations already cover the safety profile (readOnly=false, destructive=false, idempotent=false, openWorld=true), and the description adds genuine extra context: the underlying POST endpoint, the v3 version header, and the required OAuth scope invoices/estimate.write plus Agency/Sub-Account token. It does not describe duplicate-name behavior or the response, which keeps it from a 5.

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

Conciseness4/5

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

Front-loaded and short, with the core action stated in the first two lines. The repeated title line and the spec-provenance parenthetical ("source: v3/invoices-v3.json") are minor filler but don't obscure the point.

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 create tool with a deeply nested but fully documented body schema and no output schema, the description supplies the missing operational facts (endpoint, version header, auth, scope). Only side effects such as duplicate handling or template-to-location scoping are unaddressed.

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?

There is a single `body` parameter and the nested schema has 100% description coverage, so the schema already documents fields like altId, items, discount, and businessDetails. The description adds nothing about the body, so the baseline 3 applies.

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?

States a specific verb and resource ("Create a new estimate template") that clearly separates it from the sibling template_update/delete/list/preview tools. It does not explicitly name or contrast with those siblings, so it stops short of a 5.

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

Usage Guidelines2/5

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

There is no guidance on when to create a template versus calling ghl_estimate_create directly, or on prerequisites such as needing an existing location/agency record. The only contextual hint is the auth requirement, which is an operational constraint rather than usage guidance.

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