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

ghl-mcp-server-v2

by zackscriven

ghl_ad_li_campaign_group_upsert

Idempotent

Create or update a LinkedIn ad campaign group, including its campaigns and ads, by sending a PUT request with budget, targeting, and publishing details.

Instructions

Upsert ad campaign group Create or update a LinkedIn ad campaign group with campaigns and ads Endpoint: PUT /ad-publishing/linkedin/ads (Version header: v3; source: v3/ad-publishing-v3.json) OAuth scopes: adPublishing.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_ad_li_campaign_group_upsert"
  }
}

Input Schema

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

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed60 schema fields changedv2.1.0
    • changedInput schema / properties / body / properties / adBudgetOptimization / example
      Previous value: -"MAX_REACH"New value: +"MAXIMUM_DELIVERY"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / adCampaignGroupId / description
      Previous value: -"Parent campaign group identifier"New value: +"Parent campaign group id"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / adCampaignGroupId / example
      Previous value: -"cg_abc123"New value: +"6a840c5a1c2e6acf77b1d258"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / adCampaignId / description
      Previous value: -"Parent ad campaign identifier"New value: +"Parent ad campaign id"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / adCampaignId / example
      Previous value: -"camp_abc123"New value: +"6a840c7b1c2e6acf77b1d2a5"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / adId / description
      Previous value: -"LinkedIn ad resource ID"New value: +"LinkedIn ad id, set once published"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / adId / example
      Previous value: -"12345678"New value: +"1554451156"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / callToActionLabel / description
      Previous value: -"Call to action label"New value: +"Call-to-action button label"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / callToActionLabel / example
      Previous value: -"LEARN_MORE"New value: +"APPLY"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / contentReferenceString / description
      Previous value: -"Content reference URN for boosted posts"New value: +"URN of the underlying LinkedIn share, set once published"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / contentReferenceString / example
      Previous value: -"urn:li:share:123"New value: +"urn:li:share:7495384246371512320"
    • addedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / createdAt
      Added value: +{
      +  "description": "Created at",
      +  "example": "2026-08-18T07:40:43.385Z",
      +  "type": "string"
      +}
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / description / example
      Previous value: -"Join thousands who already made the switch"New value: +""
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / destinationFormId / description
      Previous value: -"Destination lead-gen form ID"New value: +"Lead form id when the ad routes to a form instead of a URL"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / destinationFormId / example
      Previous value: -"form_abc123"New value: +""
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / destinationUrl / description
      Previous value: -"Click-through destination URL"New value: +"Click destination"
    • removedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / headline
      Removed value: -{
      -  "description": "Ad headline",
      -  "example": "Your next career move starts here",
      -  "type": "string"
      -}
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / id / example
      Previous value: -"ad_abc123"New value: +"6a840c7b1c2e6acf77b1d2a8"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / introductoryText / description
      Previous value: -"Introductory ad copy shown above the creative"New value: +"Body copy above the creative"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / introductoryText / example
      Previous value: -"Check out our summer sale!"New value: +"Grow your pipeline this quarter"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / linkedInError / description
      Previous value: -"LinkedIn API error message"New value: +"Rejection or publish error from LinkedIn. Empty string when there is none."
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / linkedInError / example
      Previous value: -"Ad rejected by policy"New value: +""
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / description
      Previous value: -"Ad creative media"New value: +"Creative media"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / example
      Previous value: -[
      -  {
      -    "src": "https://example.com/image.jpg",
      -    "type": "image"
      -  }
      -]New value: +[
      +  {
      +    "_id": "6a840c881c2e6acf77b1d3c9",
      +    "destinationUrl": "example.com",
      +    "fileSizeBytes": 1066210,
      +    "headline": "Try it free",
      +    "name": "creative.png",
      +    "src": "https://staging.files.leadconnectorhq.com/file/abc/def.png",
      +    "type": "image",
      +    "urn": "urn:li:image:D5610AQEjSUtmzK0rjw"
      +  }
      +]
    • addedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / _id
      Added value: +{
      +  "description": "Mongo subdocument id. Note `_id`, not `id` — the transform applies to the top-level document only.",
      +  "example": "6a840c881c2e6acf77b1d3c9",
      +  "type": "string"
      +}
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / destinationUrl / description
      Previous value: -"Click-through destination URL"New value: +"Click destination for this media"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / destinationUrl / example
      Previous value: -"https://example.com"New value: +"example.com"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / fileSizeBytes / example
      Previous value: -102400New value: +1066210
    • removedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / frames
      Removed value: -{
      -  "description": "Video frame URLs",
      -  "example": [
      -    "https://example.com/frame1.jpg"
      -  ],
      -  "items": {
      -    "type": "string"
      -  },
      -  "type": "array"
      -}
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / headline / description
      Previous value: -"Media headline"New value: +"Headline shown with this media"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / headline / example
      Previous value: -"Get started today"New value: +"Try it free"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / name / description
      Previous value: -"Media name"New value: +"Original file name"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / name / example
      Previous value: -"ad_image.jpg"New value: +"creative.png"
    • removedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / selectedPoster
      Removed value: -{
      -  "description": "Selected poster frame index",
      -  "example": 0,
      -  "type": "number"
      -}
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / src / description
      Previous value: -"Media source URL"New value: +"Source URL of the uploaded file"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / src / example
      Previous value: -"https://example.com/image.jpg"New value: +"https://staging.files.leadconnectorhq.com/file/abc/def.png"
    • removedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / thumbnailUrl
      Removed value: -{
      -  "description": "Thumbnail URL",
      -  "example": "https://example.com/thumb.jpg",
      -  "type": "string"
      -}
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / type / description
      Previous value: -"Media type"New value: +"Media kind"
    • removedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / type / enum
      Removed value: -[
      -  "video",
      -  "image"
      -]
    • addedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / urn
      Added value: +{
      +  "description": "LinkedIn media URN, set once the asset has been uploaded. Observed present on reads but absent from the upsert response, which also returns a new `_id` for the same media — the subdocument appears to be replaced on save.",
      +  "example": "urn:li:image:D5610AQEjSUtmzK0rjw",
      +  "type": "string"
      +}
    • addedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / required
      Added value: +[
      +  "type",
      +  "src",
      +  "name"
      +]
    • addedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / title
      Added value: +"LinkedInAdMediaDTO"
    • removedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / meta
      Removed value: -{
      -  "description": "Additional ad metadata",
      -  "example": {
      -    "tone": "professional"
      -  },
      -  "type": "object"
      -}
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / name / example
      Previous value: -"Summer Sale Ad"New value: +"Ad 1"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / publishingStatus / description
      Previous value: -"Ad publishing status"New value: +"Publishing status"
    • removedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / publishingStatus / enum
      Removed value: -[
      -  "DRAFT",
      -  "SCHEDULED",
      -  "PUBLISHED",
      -  "PUBLISHING",
      -  "FAILED",
      -  "IN_REVIEW",
      -  "PAUSED",
      -  "ARCHIVED",
      -  "WITH_ISSUES",
      -  "REJECTED"
      -]
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / publishingStatus / example
      Previous value: -"PUBLISHED"New value: +"FAILED"
    • addedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / updatedAt
      Added value: +{
      +  "description": "Updated at",
      +  "example": "2026-08-18T07:45:04.624Z",
      +  "type": "string"
      +}
    • addedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / required
      Added value: +[
      +  "id",
      +  "name",
      +  "adCampaignId",
      +  "adCampaignGroupId",
      +  "publishingStatus",
      +  "linkedInError",
      +  "introductoryText",
      +  "description",
      +  "destinationUrl",
      +  "destinationFormId",
      +  "callToActionLabel",
      +  "media",
      +  "createdAt",
      +  "updatedAt"
      +]
    • addedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / title
      Added value: +"LinkedInAdDTO"
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / audience / allOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "geoLocations": {
      -        "description": "Geographic location targets",
      -        "example": [
      -          {
      -            "facetUrn": "urn:li:adTargetingFacet:locations",
      -            "name": "India",
      -            "selectionType": "include",
      -            "urn": "urn:li:geo:102713980"
      -          }
      -        ],
      -        "items": {
      -          "properties": {
      -            "facetUrn": {
      -              "description": "Facet URN",
      -              "example": "urn:li:adTargetingFacet:locations",
      -              "type": "string"
      -            },
      -            "name": {
      -              "description": "Location display name",
      -              "example": "India",
      -              "type": "string"
      -            },
      -            "selectionType": {
      -              "description": "Selection type",
      -              "enum": [
      -                "include",
      -                "exclude"
      -              ],
      -              "example": "include",
      -              "type": "string"
      -            },
      -            "urn": {
      -              "description": "Location URN",
      -              "example": "urn:li:geo:12321321",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "name",
      -            "urn",
      -            "facetUrn",
      -            "selectionType"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "targetAudience": {
      -        "allOf": [
      -          {
      -            "properties": {
      -              "exclude": {
      -                "description": "Excluded targeting attributes",
      -                "example": [],
      -                "items": {
      -                  "items": {
      -                    "properties": {
      -                      "categoryName": {
      -                        "description": "Category name",
      -                        "example": "Location",
      -                        "type": "string"
      -                      },
      -                      "facet": {
      -                        "description": "Facet identifier",
      -                        "example": "urn:li:adTargetingFacet:locations",
      -                        "type": "string"
      -                      },
      -                      "name": {
      -                        "description": "Display name",
      -                        "example": "United States",
      -                        "type": "string"
      -                      },
      -                      "urn": {
      -                        "description": "Targeting attribute URN",
      -                        "example": "urn:li:geo:103644278",
      -                        "type": "string"
      -                      }
      -                    },
      -                    "required": [
      -                      "urn",
      -                      "name",
      -                      "categoryName",
      -                      "facet"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "type": "array"
      -              },
      -              "include": {
      -                "description": "Included targeting attributes (groups of ANDed attributes, ORed together)",
      -                "example": [
      -                  [
      -                    {
      -                      "categoryName": "Location",
      -                      "facet": "urn:li:adTargetingFacet:locations",
      -                      "name": "United States",
      -                      "urn": "urn:li:geo:103644278"
      -                    }
      -                  ]
      -                ],
      -                "items": {
      -                  "items": {
      -                    "properties": {
      -                      "categoryName": {
      -                        "description": "Category name",
      -                        "example": "Location",
      -                        "type": "string"
      -                      },
      -                      "facet": {
      -                        "description": "Facet identifier",
      -                        "example": "urn:li:adTargetingFacet:locations",
      -                        "type": "string"
      -                      },
      -                      "name": {
      -                        "description": "Display name",
      -                        "example": "United States",
      -                        "type": "string"
      -                      },
      -                      "urn": {
      -                        "description": "Targeting attribute URN",
      -                        "example": "urn:li:geo:103644278",
      -                        "type": "string"
      -                      }
      -                    },
      -                    "required": [
      -                      "urn",
      -                      "name",
      -                      "categoryName",
      -                      "facet"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "type": "array"
      -              }
      -            },
      -            "type": "object"
      -          }
      -        ],
      -        "description": "Target audience attribute selections",
      -        "example": {
      -          "exclude": [],
      -          "include": []
      -        }
      -      }
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "geoLocations": {
      +        "description": "Geographic location targets",
      +        "example": [
      +          {
      +            "facetUrn": "urn:li:adTargetingFacet:locations",
      +            "name": "India",
      +            "selectionType": "include",
      +            "urn": "urn:li:geo:102713980"
      +          }
      +        ],
      +        "items": {
      +          "properties": {
      +            "facetUrn": {
      +              "description": "Facet URN",
      +              "example": "urn:li:adTargetingFacet:locations",
      +              "type": "string"
      +            },
      +            "name": {
      +              "description": "Location display name",
      +              "example": "India",
      +              "type": "string"
      +            },
      +            "selectionType": {
      +              "description": "Selection type",
      +              "enum": [
      +                "include",
      +                "exclude"
      +              ],
      +              "example": "include",
      +              "type": "string"
      +            },
      +            "urn": {
      +              "description": "Location URN",
      +              "example": "urn:li:geo:12321321",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "name",
      +            "urn",
      +            "facetUrn",
      +            "selectionType"
      +          ],
      +          "title": "GeoLocationDTO",
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "targetAudience": {
      +        "allOf": [
      +          {
      +            "properties": {
      +              "exclude": {
      +                "description": "Excluded targeting attributes. Same nested-array shape as `include` — outer entries are AND-ed, inner entries are OR-ed. Omit or send an empty array when nothing is excluded.",
      +                "example": [
      +                  [
      +                    {
      +                      "categoryName": "Skill",
      +                      "facet": "urn:li:adTargetingFacet:skills",
      +                      "name": "JavaScript",
      +                      "urn": "urn:li:skill:1"
      +                    }
      +                  ]
      +                ],
      +                "items": {
      +                  "items": {
      +                    "properties": {
      +                      "categoryName": {
      +                        "description": "Category name",
      +                        "example": "Location",
      +                        "type": "string"
      +                      },
      +                      "facet": {
      +                        "description": "Facet identifier",
      +                        "example": "urn:li:adTargetingFacet:locations",
      +                        "type": "string"
      +                      },
      +                      "name": {
      +                        "description": "Display name",
      +                        "example": "United States",
      +                        "type": "string"
      +                      },
      +                      "urn": {
      +                        "description": "Targeting attribute URN",
      +                        "example": "urn:li:geo:103644278",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "urn",
      +                      "name",
      +                      "categoryName",
      +                      "facet"
      +                    ],
      +                    "title": "SelectedAttributeDTO",
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "type": "array"
      +              },
      +              "include": {
      +                "description": "Included targeting attributes (groups of ANDed attributes, ORed together)",
      +                "example": [
      +                  [
      +                    {
      +                      "categoryName": "Location",
      +                      "facet": "urn:li:adTargetingFacet:locations",
      +                      "name": "United States",
      +                      "urn": "urn:li:geo:103644278"
      +                    }
      +                  ]
      +                ],
      +                "items": {
      +                  "items": {
      +                    "properties": {
      +                      "categoryName": {
      +                        "description": "Category name",
      +                        "example": "Location",
      +                        "type": "string"
      +                      },
      +                      "facet": {
      +                        "description": "Facet identifier",
      +                        "example": "urn:li:adTargetingFacet:locations",
      +                        "type": "string"
      +                      },
      +                      "name": {
      +                        "description": "Display name",
      +                        "example": "United States",
      +                        "type": "string"
      +                      },
      +                      "urn": {
      +                        "description": "Targeting attribute URN",
      +                        "example": "urn:li:geo:103644278",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "urn",
      +                      "name",
      +                      "categoryName",
      +                      "facet"
      +                    ],
      +                    "title": "SelectedAttributeDTO",
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "type": "array"
      +              }
      +            },
      +            "title": "TargetAudienceDTO",
      +            "type": "object"
      +          }
      +        ],
      +        "description": "Target audience attribute selections",
      +        "example": {
      +          "exclude": [
      +            [
      +              {
      +                "categoryName": "Skill",
      +                "facet": "urn:li:adTargetingFacet:skills",
      +                "name": "JavaScript",
      +                "urn": "urn:li:skill:1"
      +              }
      +            ]
      +          ],
      +          "include": [
      +            [
      +              {
      +                "categoryName": "Location",
      +                "facet": "urn:li:adTargetingFacet:locations",
      +                "name": "United States",
      +                "urn": "urn:li:geo:103644278"
      +              }
      +            ]
      +          ]
      +        }
      +      }
      +    },
      +    "title": "AudienceDTO",
      +    "type": "object"
      +  }
      +]
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / audience / example / geoLocations
      Previous value: -[]New value: +[
      +  {
      +    "facetUrn": "urn:li:adTargetingFacet:locations",
      +    "name": "United States",
      +    "selectionType": "include",
      +    "urn": "urn:li:geo:103644278"
      +  }
      +]
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / audience / example / targetAudience / exclude
      Previous value: -[]New value: +[
      +  {
      +    "facet": "urn:li:adTargetingFacet:staffCountRanges",
      +    "values": [
      +      "urn:li:staffCountRange:SIZE_1"
      +    ]
      +  }
      +]
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / audience / example / targetAudience / include
      Previous value: -[]New value: +[
      +  [
      +    {
      +      "categoryName": "Skill",
      +      "facet": "urn:li:adTargetingFacet:skills",
      +      "name": "JavaScript",
      +      "urn": "urn:li:skill:1"
      +    }
      +  ]
      +]
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / locale / allOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "country": {
      -        "description": "Country code",
      -        "example": "US",
      -        "type": "string"
      -      },
      -      "language": {
      -        "description": "Language code",
      -        "example": "en",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "country",
      -      "language"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "country": {
      +        "description": "Country code",
      +        "example": "US",
      +        "type": "string"
      +      },
      +      "language": {
      +        "description": "Language code",
      +        "example": "en",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "country",
      +      "language"
      +    ],
      +    "title": "LocaleDTO",
      +    "type": "object"
      +  }
      +]
    • changedInput schema / properties / body / properties / adCampaigns / items / properties / unitCost / allOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "amount": {
      -        "description": "Bid amount in currency minor units",
      -        "example": 500,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "amount"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "amount": {
      +        "description": "Bid amount (major currency units)",
      +        "example": 5,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "amount"
      +    ],
      +    "title": "UnitCostDTO",
      +    "type": "object"
      +  }
      +]
    • addedInput schema / properties / body / properties / adCampaigns / items / title
      Added value: +"AdCampaignDTO"
    • changedInput schema / properties / body / properties / budget / allOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "amount": {
      -        "description": "Budget amount (currency minor units)",
      -        "example": 10000,
      -        "type": "number"
      -      },
      -      "budgetType": {
      -        "description": "LinkedIn campaign budget type",
      -        "enum": [
      -          "DAILY",
      -          "LIFETIME"
      -        ],
      -        "example": "DAILY",
      -        "type": "string"
      -      },
      -      "scheduleEndDate": {
      -        "description": "Schedule end date (ISO 8601)",
      -        "example": "2025-12-31",
      -        "type": "string"
      -      },
      -      "scheduleStartDate": {
      -        "description": "Schedule start date (ISO 8601)",
      -        "example": "2025-01-01",
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "amount": {
      +        "description": "Budget amount in the account currency",
      +        "example": 30,
      +        "type": "number"
      +      },
      +      "budgetType": {
      +        "description": "Budget cadence",
      +        "enum": [
      +          "DAILY",
      +          "LIFETIME"
      +        ],
      +        "example": "DAILY",
      +        "type": "string"
      +      },
      +      "scheduleEndDate": {
      +        "description": "Schedule end",
      +        "example": "2026-09-17T07:40:10.110Z",
      +        "type": "string"
      +      },
      +      "scheduleStartDate": {
      +        "description": "Schedule start",
      +        "example": "2026-08-18T07:40:10.110Z",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "budgetType",
      +      "amount"
      +    ],
      +    "title": "LinkedInBudgetDTO",
      +    "type": "object"
      +  }
      +]
    • addedInput schema / properties / body / properties / customValueMappings
      Added value: +{
      +  "description": "User-provided overrides for custom_values merge tags used in ad copy",
      +  "example": {
      +    "{{ custom_values.pet_name }}": "Fluffy"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / body / title
      Added value: +"AdCampaignGroupDataDTO"
  2. First observedv2.0.0

TDQS

A3.5/5.0
Behavior3/5

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

Annotations already declare the mutating, idempotent, open-world profile, so the bar is lower. The description adds real value with the exact endpoint (PUT /ad-publishing/linkedin/ads), API version header v3, spec source, and the required OAuth scope — useful for failure diagnosis. It does not disclose side effects the schema hints at, such as media subdocuments being replaced (new `_id` on save) or what a partial body does to existing campaigns/ads.

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?

Four tight lines: purpose first, then scope of payload, then endpoint, then auth. Every line carries operational value and nothing is padded. Minor deduction because the endpoint/metadata lines are dense run-ons compared with the sparse prose.

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

Completeness3/5

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

For a deeply nested, 100%-documented body schema with no output schema, the description is adequate but leaves two agent-relevant gaps: it never describes what an upsert returns (the new id, publishing status, linkedInError fields an agent may need to chain on), and it omits partial-update semantics for the nested campaign/ad arrays. Auth and endpoint are the only extras beyond the schema.

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

Parameters4/5

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

Schema description coverage is 100% and the single `body` parameter is exhaustively documented in the schema, including nested DTOs, examples, and enum values, so baseline 4 applies (one param, fully covered). The description contributes nothing about the body itself — notably not explaining which nested fields are required on create vs update — so it does not earn a 5.

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 names a specific verb pair and resource: create or update a LinkedIn ad campaign group, including its child campaigns and ads. That distinguishes it reasonably well from siblings like ghl_ad_li_campaign_group_get, _publish, and _reporting_get, which are read/publish/report operations. It stops short of 5 because it never states the create-vs-update discriminator (e.g., whether supplying `id` triggers update).

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

Usage Guidelines3/5

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

"Create or update" implies the two situations the tool covers, and the OAuth scope line hints at a prerequisite (adPublishing.write). However, there is no explicit when-to-use guidance against alternatives — nothing says to call campaign_group_publish after an upsert, nor how this differs from ghl_ad_li_campaign_group_get. Usage is only implied.

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