Skip to main content
Glama

Run canonical LeanrIQ Competitor Intelligence V2 for one advertiser-scoped competitor. Defaults match Studio: 90-day DISPLAY evidence and no mixed social/video banner inference. Without forceRefresh, an existing canonical result is reused when available. (deprecated alias)

leanriq_get_competitor_creative_intelligence
Idempotent

Run canonical LeanrIQ Competitor Intelligence V2 for one advertiser-scoped competitor. Defaults match Studio: 90-day DISPLAY evidence and no mixed social/video banner inference. Without forceRefresh, an existing canonical result is reused when available.. Deprecated alias for run_competitor_intelligence. Classification: creates billable AI usage. Execution: durable. Task support: optional. Mutation modes: validate_only, preview_only, execute. Partial failure policy: completed_items_not_rolled_back. The returned JSON is internal application state for LeanrIQ and ChatGPT orchestration. Use assistantSummary first when responding to the user. Never display raw JSON, data, or meta unless the user explicitly asks for raw JSON. Mention IDs only when useful for follow-up or debugging. Prefer concise, human language, highlight the most useful insight, and suggest the next best LeanrIQ action. If idempotencyKey is omitted on a mutation, the MCP layer derives a deterministic retry key from the tool and business arguments so an accidental identical replay cannot create duplicate work.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "leanriq_get_competitor_creative_intelligence"
  }
}

Input Schema

NameRequiredDescriptionDefault
nameNo
limitNo
domainNo
marketNo
regionNo
seatIdNo
marketsNo
websiteNo
seatNameNo
brandNameNo
advertiserIdNo
competitorIdNo
evidenceModeNoDISPLAY
forceRefreshNo
lookbackDaysNo
sourceLocaleNo
strategyModeNoBOTH
targetMarketNo
contentLocaleNo
evidenceLimitNo
marketContextNo
strategyModesNo
targetMarketsNo
competitorNameNo
contentLocalesNo
competitorDomainNo
competitorWebsiteNo
crossChannelLimitNo
recommendationModeNoFULL
defaultContentLocaleNo
competitorKeyMessagesNo
competitorPositioningNo
marketLanguageProfileNo
resolvedContentLocaleNo
languageVariantGroupIdNo
requestedOutputLocalesNo
supportedContentLocalesNo
advertiserGuidanceSnapshotNo

Output Schema

NameRequiredDescriptionDefault
dataYes
metaYes
errorNo
statusYes
assistantSummaryYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / crossChannelLimit
      Added value: +{
      +  "maximum": 120,
      +  "minimum": 1,
      +  "type": "integer"
      +}
  2. Changed15 schema fields changed
    • addedInput schema / properties / contentLocale
      Added value: +{
      +  "type": "string"
      +}
    • addedInput schema / properties / contentLocales
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "maxItems": 20,
      +  "type": "array"
      +}
    • addedInput schema / properties / defaultContentLocale
      Added value: +{
      +  "type": "string"
      +}
    • addedInput schema / properties / languageVariantGroupId
      Added value: +{
      +  "maxLength": 160,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / marketContext
      Added value: +{
      +  "properties": {
      +    "currency": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "targetMarket": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "targetMarkets": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "timeZone": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / marketLanguageProfile
      Added value: +{
      +  "additionalProperties": {},
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / requestedOutputLocales
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "maxItems": 20,
      +  "type": "array"
      +}
    • addedInput schema / properties / resolvedContentLocale
      Added value: +{
      +  "type": "string"
      +}
    • addedInput schema / properties / sourceLocale
      Added value: +{
      +  "type": "string"
      +}
    • addedInput schema / properties / supportedContentLocales
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "maxItems": 20,
      +  "type": "array"
      +}
    • addedInput schema / properties / targetMarket
      Added value: +{
      +  "maxLength": 160,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • removedInput schema / properties / targetMarkets / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  }
      -]
    • addedInput schema / properties / targetMarkets / items
      Added value: +{
      +  "maxLength": 160,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / targetMarkets / maxItems
      Added value: +50
    • addedInput schema / properties / targetMarkets / type
      Added value: +"array"
  3. Changed1 schema field changed
    • addedInput schema / properties / recommendationMode
      Added value: +{
      +  "default": "FULL",
      +  "enum": [
      +    "FULL",
      +    "EVIDENCE_ONLY"
      +  ],
      +  "type": "string"
      +}
  4. Changed2 schema fields changed
    • addedInput schema / properties / competitorKeyMessages
      Added value: +{
      +  "items": {
      +    "maxLength": 300,
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "maxItems": 8,
      +  "type": "array"
      +}
    • addedInput schema / properties / competitorPositioning
      Added value: +{
      +  "maxLength": 1200,
      +  "minLength": 1,
      +  "type": "string"
      +}
  5. Changed2 schema fields changed
    • changedInput schema / properties / evidenceLimit / maximum
      Previous value: -24New value: +48
    • changedInput schema / properties / limit / maximum
      Previous value: -24New value: +48
  6. Changed24 schema fields changed
    • removedInput schema / properties / adFormat
      Removed value: -{
      -  "default": "DISPLAY_IMAGE",
      -  "enum": [
      -    "DISPLAY_IMAGE",
      -    "IMAGE",
      -    "DISPLAY"
      -  ],
      -  "type": "string"
      -}
    • addedInput schema / properties / advertiserGuidanceSnapshot
      Added value: +{
      +  "additionalProperties": {},
      +  "propertyNames": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / advertiserId
      Added value: +{
      +  "maxLength": 240,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • changedInput schema / properties / brandName / maxLength
      Previous value: -120New value: +180
    • addedInput schema / properties / competitorDomain
      Added value: +{
      +  "maxLength": 300,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / competitorId
      Added value: +{
      +  "maxLength": 200,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / competitorName
      Added value: +{
      +  "maxLength": 180,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / competitorWebsite
      Added value: +{
      +  "maxLength": 300,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / domain
      Added value: +{
      +  "maxLength": 300,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / evidenceLimit
      Added value: +{
      +  "maximum": 24,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / evidenceMode
      Added value: +{
      +  "default": "DISPLAY",
      +  "enum": [
      +    "DISPLAY",
      +    "CROSS_CHANNEL",
      +    "BOTH"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / forceRefresh
      Added value: +{
      +  "default": false,
      +  "type": "boolean"
      +}
    • removedInput schema / properties / limit / default
      Removed value: -120
    • changedInput schema / properties / limit / maximum
      Previous value: -120New value: +24
    • addedInput schema / properties / lookbackDays
      Added value: +{
      +  "default": 90,
      +  "maximum": 730,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / market
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  ]
      +}
    • addedInput schema / properties / markets
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  ]
      +}
    • addedInput schema / properties / name
      Added value: +{
      +  "maxLength": 180,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / strategyMode
      Added value: +{
      +  "default": "BOTH",
      +  "enum": [
      +    "REPLICATE",
      +    "DIFFERENTIATE",
      +    "BOTH"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / strategyModes
      Added value: +{
      +  "items": {
      +    "enum": [
      +      "REPLICATE",
      +      "DIFFERENTIATE"
      +    ],
      +    "type": "string"
      +  },
      +  "maxItems": 2,
      +  "type": "array"
      +}
    • addedInput schema / properties / targetMarkets
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    }
      +  ]
      +}
    • removedInput schema / properties / vertical
      Removed value: -{
      -  "maxLength": 160,
      -  "minLength": 1,
      -  "type": "string"
      -}
    • changedInput schema / properties / website / maxLength
      Previous value: -255New value: +300
    • removedInput schema / required
      Removed value: -[
      -  "brandName",
      -  "website"
      -]
  7. First observed

TDQS

A4/5.0
Behavior5/5

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

Well beyond the annotations (readOnlyHint=false, idempotentHint=true, destructiveHint=false), the description discloses that this creates billable AI usage, executes durably, supports validate_only/preview_only/execute modes, uses a completed_items_not_rolled_back partial failure policy, and derives a deterministic retry key when idempotencyKey is omitted. These are exactly the operational facts an agent cannot infer from structured 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?

Purpose and defaults are front-loaded and useful, but a long tail of response-formatting boilerplate ('Use assistantSummary first', 'Never display raw JSON') consumes substantial space, and there is a stray double period after 'when available'. The sentences earn their place individually but the block is not tight.

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?

Mutation safety, billing, durability, partial-failure handling, and idempotency are all covered, and an output schema exists so return values need not be described. However, for a tool with 38 undocumented parameters, the description leaves too much of the input surface unexplained to be considered complete.

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

Parameters2/5

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

Schema description coverage is 0% across 38 parameters, so the description carries the full burden, yet it only explains the semantics of a handful (forceRefresh caching behavior, 90-day lookbackDays, DISPLAY evidenceMode). Core scoping inputs such as advertiserId, competitorId, markets/targetMarkets, strategyMode, and the locale fields receive no explanation anywhere.

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?

The description states a specific verb and resource ('Run canonical LeanrIQ Competitor Intelligence V2') scoped to 'one advertiser-scoped competitor', and explicitly identifies itself as a deprecated alias of run_competitor_intelligence. An agent can distinguish it from the many sibling intelligence tools without opening the schema.

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 concrete operating context: defaults match Studio (90-day DISPLAY evidence, no mixed social/video banner inference) and existing canonical results are reused unless forceRefresh is set. The deprecation line routes the agent toward run_competitor_intelligence, though it never explicitly says 'prefer the replacement' or when to call this alias at all.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources