{
  "type": "object",
  "properties": {
    "page_url": {
      "type": "string",
      "description": "Full HTTP/HTTPS URL of the page to analyze for GEO readiness."
    },
    "focus_query": {
      "type": "string",
      "description": "Optional business/query angle to prioritize in the analysis, for example: 'private banking for entrepreneurs in switzerland'."
    }
  },
  "required": [
    "page_url"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "text": {
          "type": "string",
          "description": "Full GEO analysis report as Markdown (Executive Summary plus seven fixed sections)."
        },
        "model": {
          "type": "string"
        },
        "scorecard": {
          "type": "object",
          "properties": {
            "dimensions": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "enum": [
                      "Entity Clarity",
                      "Answer-First Extractability",
                      "Citation & Authority Signals",
                      "Intent Coverage",
                      "Visible Structure"
                    ]
                  },
                  "score": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "rationale": {
                    "type": "string"
                  }
                },
                "additionalProperties": false,
                "required": [
                  "name",
                  "score",
                  "rationale"
                ]
              },
              "description": "Exactly the five fixed GEO dimensions, in order."
            },
            "overall": {
              "type": "integer",
              "minimum": 0,
              "maximum": 100
            }
          },
          "additionalProperties": false,
          "required": [
            "dimensions",
            "overall"
          ]
        },
        "url_retrieval_status": {
          "type": "string",
          "description": "Gemini URL context retrieval status for page_url; always URL_RETRIEVAL_STATUS_SUCCESS on the success branch."
        },
        "grounding": {
          "type": "object",
          "properties": {
            "web_search_queries": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "sources": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "uri": {
                    "type": "string"
                  }
                },
                "additionalProperties": false,
                "required": [
                  "uri"
                ]
              }
            }
          },
          "additionalProperties": false,
          "required": [
            "web_search_queries",
            "sources"
          ],
          "description": "Google Search grounding provenance: queries and web sources other than page_url (whose retrieval is reported by url_retrieval_status). Empty when no search query was issued."
        },
        "usage": {
          "type": "object",
          "properties": {
            "input_tokens": {
              "type": "number"
            },
            "output_tokens": {
              "type": "number"
            },
            "thinking_tokens": {
              "type": "number"
            },
            "total_tokens": {
              "type": "number"
            },
            "cost_usd": {
              "type": "number"
            },
            "grounding_search_queries": {
              "type": "number"
            },
            "grounding_cost_usd": {
              "type": "number"
            }
          },
          "additionalProperties": false,
          "description": "Token counts and list-price USD estimates for this call."
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "text",
        "model",
        "scorecard",
        "url_retrieval_status",
        "grounding",
        "usage"
      ],
      "description": "Page-grounded GEO analysis with structured scorecard and provenance."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The analysis query. Should be specific about what to analyze. Examples: 'Analyze content and SEO for https://example.com/page', 'What content gaps exist for topic X?', 'Compare content quality with competitors for topic Y', or 'Technical SEO recommendations for page Z'"
    }
  },
  "required": [
    "query"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "text": {
          "type": "string"
        },
        "model": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "text",
        "model"
      ],
      "description": "Vertex AI grounded analysis text response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "preview",
        "apply"
      ]
    },
    "confirmation_token": {
      "type": "string"
    },
    "confirmation_phrase": {
      "type": "string",
      "enum": [
        "CONFIRM_MANAGEMENT_CHANGE"
      ]
    },
    "company_id": {
      "type": "string",
      "description": "Target company UUID; defaults to the current MCP company context when omitted."
    },
    "auto_purchase_plan_license": {
      "type": "boolean",
      "description": "Explicitly purchase missing plan licenses so imported brands can be active."
    },
    "brands": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 255
          },
          "plan": {
            "type": "string",
            "maxLength": 40,
            "description": "A shared catalog code (starter, growth, enterprise) or a company dedicated plan code. A static enum cannot list dedicated codes, which are created per company, so the value is validated server-side against the plans that company may assign."
          },
          "website": {
            "type": "string",
            "maxLength": 255
          },
          "aliases": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 255
            },
            "description": "Brand aliases; stored and returned as name_variants."
          },
          "country_iso2": {
            "type": "string",
            "pattern": "^[A-Za-z]{2}$",
            "description": "Two-letter ISO 3166-1 market code."
          },
          "language": {
            "type": "string",
            "maxLength": 5,
            "description": "ISO 639-1 language, optionally with region (for example en or en-US)."
          },
          "tracked_name": {
            "type": "string",
            "maxLength": 255
          },
          "tracking_context": {
            "type": "string"
          },
          "excluded_name_variants": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 255
            }
          },
          "favorite_products": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 255
            },
            "maxItems": 5
          },
          "favorite_attributes": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 255
            },
            "maxItems": 5
          },
          "default_topics": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 255
            },
            "maxItems": 12
          },
          "owned_domains": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 500
            },
            "description": "Web domains the brand itself publishes on, beyond 'website'. Hostnames only, optionally with a scheme, path or '*.' prefix: 'voyages.leclerc', 'https://www.example.com/blog', '*.example.com'. Used to classify citations as Owned Media and to scope the OnSite agent's search for existing pages, so a non-domain value is rejected. For OnSite, a path scopes pages to that section ('https://www.example.com/gb/en' keeps /gb/en pages only); a bare host covers every path. Never put keywords, search terms, product names or competitor brands here; topics belong in 'default_topics' and competitors are set separately."
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 255
            },
            "description": "Existing Brand tags, by id, 'Namespace:Value', or bare value when unambiguous. An import never creates a tag: an unknown one rejects its record."
          },
          "llms": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 255
            },
            "description": "Models this brand tracks, overriding its plan catalogue. Requires prompts_per_model, and every listed model must be available in the brand's country."
          },
          "prompts_per_model": {
            "type": "integer",
            "minimum": 1,
            "description": "Prompts each model in llms tracks. Requires llms."
          }
        },
        "required": [
          "name"
        ],
        "additionalProperties": true
      },
      "maxItems": 100
    },
    "user_access_assignments": {
      "type": "array",
      "description": "Optional home-company user grants applied atomically with brand create/import. Company Admins are always granted OWNER even when omitted. Each entry: {user_id, role} where role is OWNER | EDITOR | VIEWER | MONITOR_ONLY. On bulk import, the same assignments apply to every created brand.",
      "items": {
        "type": "object",
        "properties": {
          "user_id": {
            "type": "string",
            "description": "Target user UUID in the brand home company."
          },
          "role": {
            "type": "string",
            "enum": [
              "OWNER",
              "EDITOR",
              "VIEWER",
              "MONITOR_ONLY"
            ]
          }
        },
        "required": [
          "user_id",
          "role"
        ],
        "additionalProperties": false
      }
    },
    "on_invalid_records": {
      "type": "string",
      "enum": [
        "reject",
        "skip"
      ],
      "description": "What to do when some records are invalid: 'reject' (the default) imports nothing, 'skip' imports only the records that hold up. Never pick 'skip' on your own."
    }
  },
  "required": [
    "brands"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Bulk brand creation preview or apply result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "preview",
        "apply"
      ]
    },
    "confirmation_token": {
      "type": "string"
    },
    "confirmation_phrase": {
      "type": "string",
      "enum": [
        "CONFIRM_MANAGEMENT_CHANGE"
      ]
    },
    "brand_id": {
      "type": "string"
    },
    "competitors": {
      "type": "array",
      "maxItems": 100
    },
    "on_invalid_records": {
      "type": "string",
      "enum": [
        "reject",
        "skip"
      ],
      "description": "What to do when some records are invalid: 'reject' (the default) imports nothing, 'skip' imports only the records that hold up. Never pick 'skip' on your own."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Bulk competitor creation preview or apply result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "preview",
        "apply"
      ]
    },
    "confirmation_token": {
      "type": "string"
    },
    "confirmation_phrase": {
      "type": "string",
      "enum": [
        "CONFIRM_MANAGEMENT_CHANGE"
      ]
    },
    "users": {
      "type": "array",
      "maxItems": 100
    },
    "on_invalid_records": {
      "type": "string",
      "enum": [
        "reject",
        "skip"
      ],
      "description": "What to do when some records are invalid: 'reject' (the default) imports nothing, 'skip' imports only the records that hold up. Never pick 'skip' on your own."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Bulk user invitation preview or apply result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "preview",
        "apply"
      ]
    },
    "confirmation_token": {
      "type": "string"
    },
    "confirmation_phrase": {
      "type": "string",
      "enum": [
        "CONFIRM_MANAGEMENT_CHANGE"
      ]
    },
    "company_id": {
      "type": "string",
      "description": "Target company UUID; defaults to the current MCP company context when omitted."
    },
    "brand": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 255
        },
        "plan": {
          "type": "string",
          "maxLength": 40,
          "description": "A shared catalog code (starter, growth, enterprise) or a company dedicated plan code. A static enum cannot list dedicated codes, which are created per company, so the value is validated server-side against the plans that company may assign."
        },
        "website": {
          "type": "string",
          "maxLength": 255
        },
        "aliases": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "description": "Brand aliases; stored and returned as name_variants."
        },
        "country_iso2": {
          "type": "string",
          "pattern": "^[A-Za-z]{2}$",
          "description": "Two-letter ISO 3166-1 market code."
        },
        "language": {
          "type": "string",
          "maxLength": 5,
          "description": "ISO 639-1 language, optionally with region (for example en or en-US)."
        },
        "tracked_name": {
          "type": "string",
          "maxLength": 255
        },
        "tracking_context": {
          "type": "string"
        },
        "excluded_name_variants": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          }
        },
        "favorite_products": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "maxItems": 5
        },
        "favorite_attributes": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "maxItems": 5
        },
        "default_topics": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "maxItems": 12
        },
        "owned_domains": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 500
          },
          "description": "Web domains the brand itself publishes on, beyond 'website'. Hostnames only, optionally with a scheme, path or '*.' prefix: 'voyages.leclerc', 'https://www.example.com/blog', '*.example.com'. Used to classify citations as Owned Media and to scope the OnSite agent's search for existing pages, so a non-domain value is rejected. For OnSite, a path scopes pages to that section ('https://www.example.com/gb/en' keeps /gb/en pages only); a bare host covers every path. Never put keywords, search terms, product names or competitor brands here; topics belong in 'default_topics' and competitors are set separately."
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "description": "Existing Brand tags, by id, 'Namespace:Value', or bare value when unambiguous. An import never creates a tag: an unknown one rejects its record."
        },
        "llms": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "description": "Models this brand tracks, overriding its plan catalogue. Requires prompts_per_model, and every listed model must be available in the brand's country."
        },
        "prompts_per_model": {
          "type": "integer",
          "minimum": 1,
          "description": "Prompts each model in llms tracks. Requires llms."
        },
        "name_variants": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "description": "Canonical alias field retained for backward compatibility; prefer aliases."
        },
        "company_id": {
          "type": "string",
          "description": "Backward-compatible nested company ID; prefer top-level company_id."
        },
        "auto_purchase_plan_license": {
          "type": "boolean",
          "description": "Purchase a missing plan license when permitted."
        }
      },
      "required": [
        "name"
      ],
      "additionalProperties": true
    },
    "user_access_assignments": {
      "type": "array",
      "description": "Optional home-company user grants applied atomically with brand create/import. Company Admins are always granted OWNER even when omitted. Each entry: {user_id, role} where role is OWNER | EDITOR | VIEWER | MONITOR_ONLY. On bulk import, the same assignments apply to every created brand.",
      "items": {
        "type": "object",
        "properties": {
          "user_id": {
            "type": "string",
            "description": "Target user UUID in the brand home company."
          },
          "role": {
            "type": "string",
            "enum": [
              "OWNER",
              "EDITOR",
              "VIEWER",
              "MONITOR_ONLY"
            ]
          }
        },
        "required": [
          "user_id",
          "role"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "brand"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Brand creation preview or apply result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "preview",
        "apply"
      ]
    },
    "confirmation_token": {
      "type": "string"
    },
    "confirmation_phrase": {
      "type": "string",
      "enum": [
        "CONFIRM_MANAGEMENT_CHANGE"
      ]
    },
    "competitor": {
      "type": "object"
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Competitor creation preview or apply result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "format": {
      "type": "string",
      "enum": [
        "pdf",
        "pptx"
      ],
      "description": "Output format: pdf or pptx (PowerPoint)."
    },
    "brand_id": {
      "type": "string",
      "description": "Brand UUID (optional if context brand is available)."
    },
    "start_date": {
      "type": "string",
      "description": "Start date YYYY-MM-DD (optional; defaults from MCP context)."
    },
    "end_date": {
      "type": "string",
      "description": "End date YYYY-MM-DD (optional; defaults from MCP context)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Optional inclusive lookback window in days ending on `reference_end_date` when available, otherwise on the server's last complete day (yesterday). When set, overrides start_date/end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Optional topic UUID or comma-separated UUIDs."
    },
    "platform": {
      "type": "string",
      "description": "Optional AI platform filter (e.g. chatgpt, gemini)."
    },
    "model": {
      "type": "string",
      "description": "Optional model filter."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Optional funnel filter."
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter)."
    }
  },
  "required": [
    "format"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "pdfUrl": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "pdfUrl"
      ],
      "description": "Ads dashboard PDF export temporary URL."
    },
    {
      "type": "object",
      "properties": {
        "pptxUrl": {
          "type": "string"
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": false,
      "required": [
        "pptxUrl",
        "warnings"
      ],
      "description": "Ads dashboard PPT export temporary URL."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "format": {
      "type": "string",
      "enum": [
        "pdf",
        "pptx"
      ],
      "description": "Output format: pdf or pptx (PowerPoint)."
    },
    "brand_id": {
      "type": "string",
      "description": "Brand UUID (optional if context brand is available)."
    },
    "start_month": {
      "type": "string",
      "description": "Start month YYYY-MM (required)."
    },
    "end_month": {
      "type": "string",
      "description": "End month YYYY-MM (defaults to start_month)."
    },
    "gender": {
      "type": "string",
      "description": "Optional audience filter."
    },
    "age_band": {
      "type": "string",
      "description": "Optional audience filter."
    },
    "language": {
      "type": "string",
      "description": "Optional audience filter."
    },
    "platform": {
      "type": "string",
      "description": "Optional AI platform filter (e.g. chatgpt, gemini)."
    },
    "country_code": {
      "type": "string",
      "description": "Optional audience filter."
    },
    "household_income": {
      "type": "string",
      "description": "Optional audience filter."
    }
  },
  "required": [
    "format",
    "start_month"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "pdfUrl": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "pdfUrl"
      ],
      "description": "Audience dashboard PDF export temporary URL."
    },
    {
      "type": "object",
      "properties": {
        "pptxUrl": {
          "type": "string"
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": false,
      "required": [
        "pptxUrl",
        "warnings"
      ],
      "description": "Audience dashboard PPT export temporary URL."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID (optional if context brand is available)."
    },
    "start_date": {
      "type": "string",
      "description": "Start date YYYY-MM-DD (optional; defaults from MCP context)."
    },
    "end_date": {
      "type": "string",
      "description": "End date YYYY-MM-DD (optional; defaults from MCP context)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Optional inclusive lookback window in days ending on `reference_end_date` when available, otherwise on the server's last complete day (yesterday). When set, overrides start_date/end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Optional topic UUID or comma-separated UUIDs."
    },
    "platform": {
      "type": "string",
      "description": "Optional AI platform filter (e.g. chatgpt, gemini)."
    },
    "model": {
      "type": "string",
      "description": "Optional model filter."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Optional funnel filter."
    }
  }
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "pdfUrl": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "pdfUrl"
      ],
      "description": "Brand Monitor PDF export temporary download URL."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID (optional if context brand is available)."
    },
    "start_date": {
      "type": "string",
      "description": "Start date YYYY-MM-DD (optional; defaults from MCP context)."
    },
    "end_date": {
      "type": "string",
      "description": "End date YYYY-MM-DD (optional; defaults from MCP context)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Optional inclusive lookback window in days ending on `reference_end_date` when available, otherwise on the server's last complete day (yesterday). When set, overrides start_date/end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Optional topic UUID or comma-separated UUIDs."
    },
    "platform": {
      "type": "string",
      "description": "Optional AI platform filter (e.g. chatgpt, gemini)."
    },
    "model": {
      "type": "string",
      "description": "Optional model filter."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Optional funnel filter."
    }
  }
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "pptxUrl": {
          "type": "string"
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": false,
      "required": [
        "pptxUrl",
        "warnings"
      ],
      "description": "Brand Monitor PPT export temporary URL and non-fatal warnings."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "format": {
      "type": "string",
      "enum": [
        "pdf",
        "pptx"
      ],
      "description": "Output format: pdf or pptx (PowerPoint)."
    },
    "brand_id": {
      "type": "string",
      "description": "Brand UUID (optional if context brand is available)."
    },
    "start_date": {
      "type": "string",
      "description": "Start date YYYY-MM-DD (optional; defaults from MCP context)."
    },
    "end_date": {
      "type": "string",
      "description": "End date YYYY-MM-DD (optional; defaults from MCP context)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Optional inclusive lookback window in days ending on `reference_end_date` when available, otherwise on the server's last complete day (yesterday). When set, overrides start_date/end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Optional topic UUID or comma-separated UUIDs."
    },
    "platform": {
      "type": "string",
      "description": "Optional AI platform filter (e.g. chatgpt, gemini)."
    },
    "model": {
      "type": "string",
      "description": "Optional model filter."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Optional funnel filter."
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter)."
    },
    "topic_category": {
      "type": "string",
      "enum": [
        "Attribute",
        "Product"
      ],
      "description": "Perception topic category (default Attribute)."
    }
  },
  "required": [
    "format"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "pdfUrl": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "pdfUrl"
      ],
      "description": "Brand Perception dashboard PDF export temporary URL."
    },
    {
      "type": "object",
      "properties": {
        "pptxUrl": {
          "type": "string"
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": false,
      "required": [
        "pptxUrl",
        "warnings"
      ],
      "description": "Brand Perception dashboard PPT export temporary URL."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "format": {
      "type": "string",
      "enum": [
        "pdf",
        "pptx"
      ],
      "description": "Output format: pdf or pptx (PowerPoint)."
    },
    "brand_id": {
      "type": "string",
      "description": "Brand UUID (optional if context brand is available)."
    },
    "start_date": {
      "type": "string",
      "description": "Start date YYYY-MM-DD (optional; defaults from MCP context)."
    },
    "end_date": {
      "type": "string",
      "description": "End date YYYY-MM-DD (optional; defaults from MCP context)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Optional inclusive lookback window in days ending on `reference_end_date` when available, otherwise on the server's last complete day (yesterday). When set, overrides start_date/end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Optional topic UUID or comma-separated UUIDs."
    },
    "platform": {
      "type": "string",
      "description": "Optional AI platform filter (e.g. chatgpt, gemini)."
    },
    "model": {
      "type": "string",
      "description": "Optional model filter."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Optional funnel filter."
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter)."
    }
  },
  "required": [
    "format"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "pdfUrl": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "pdfUrl"
      ],
      "description": "Competitors dashboard PDF export temporary URL."
    },
    {
      "type": "object",
      "properties": {
        "pptxUrl": {
          "type": "string"
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": false,
      "required": [
        "pptxUrl",
        "warnings"
      ],
      "description": "Competitors dashboard PPT export temporary URL."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "format": {
      "type": "string",
      "enum": [
        "pdf",
        "pptx"
      ],
      "description": "Output format: pdf or pptx (PowerPoint)."
    },
    "company_id": {
      "type": "string",
      "description": "Company UUID (required)."
    },
    "start_date": {
      "type": "string",
      "description": "Start date YYYY-MM-DD (required)."
    },
    "end_date": {
      "type": "string",
      "description": "End date YYYY-MM-DD (required)."
    },
    "brand_id": {
      "type": "string",
      "description": "Optional comma-separated brand UUIDs."
    },
    "countries": {
      "type": "string",
      "description": "Optional comma-separated country codes."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Optional funnel filter."
    },
    "platform": {
      "type": "string",
      "description": "Optional AI platform filter (e.g. chatgpt, gemini)."
    }
  },
  "required": [
    "format",
    "company_id",
    "start_date",
    "end_date"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "pdfUrl": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "pdfUrl"
      ],
      "description": "Portfolio dashboard PDF export temporary URL."
    },
    {
      "type": "object",
      "properties": {
        "pptxUrl": {
          "type": "string"
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": false,
      "required": [
        "pptxUrl",
        "warnings"
      ],
      "description": "Portfolio dashboard PPT export temporary URL."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "format": {
      "type": "string",
      "enum": [
        "pdf",
        "pptx"
      ],
      "description": "Output format: pdf or pptx (PowerPoint)."
    },
    "brand_id": {
      "type": "string",
      "description": "Brand UUID (optional if context brand is available)."
    },
    "start_date": {
      "type": "string",
      "description": "Start date YYYY-MM-DD (optional; defaults from MCP context)."
    },
    "end_date": {
      "type": "string",
      "description": "End date YYYY-MM-DD (optional; defaults from MCP context)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Optional inclusive lookback window in days ending on `reference_end_date` when available, otherwise on the server's last complete day (yesterday). When set, overrides start_date/end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Optional topic UUID or comma-separated UUIDs."
    },
    "platform": {
      "type": "string",
      "description": "Optional AI platform filter (e.g. chatgpt, gemini)."
    },
    "model": {
      "type": "string",
      "description": "Optional model filter."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Optional funnel filter."
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter)."
    }
  },
  "required": [
    "format"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "pdfUrl": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "required": [
        "pdfUrl"
      ],
      "description": "Shopping dashboard PDF export temporary URL."
    },
    {
      "type": "object",
      "properties": {
        "pptxUrl": {
          "type": "string"
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": false,
      "required": [
        "pptxUrl",
        "warnings"
      ],
      "description": "Shopping dashboard PPT export temporary URL."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "Prompt Studio session UUID."
    },
    "prompt_generation_additional_instructions": {
      "type": "string",
      "description": "Optional extra instructions for prompt generation."
    }
  },
  "required": [
    "session_id"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Prompt Studio prompt generation dispatched (session_id to poll)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided. Ads data is available from 2026-04-09; earlier dates are clamped automatically."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Use getTopics to discover topic IDs."
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (optional). Defaults to 'chatgpt'; use 'googleaioverview' for Google AI Overview ads."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Ads by prompt (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided. Ads data is available from 2026-04-09; earlier dates are clamped automatically."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Use getTopics to discover topic IDs."
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (optional). Defaults to 'chatgpt'; use 'googleaioverview' for Google AI Overview ads."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Ads by topic (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided. Ads data is available from 2026-04-09; earlier dates are clamped automatically."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Use getTopics to discover topic IDs."
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (optional). Defaults to 'chatgpt'; use 'googleaioverview' for Google AI Overview ads."
    },
    "funnel": {
      "type": "string",
      "description": "Optional funnel filter: awareness, consideration, conversion (comma-separated allowed)."
    },
    "persona_id": {
      "type": "string",
      "description": "Optional Prompt Studio persona UUID (from getPromptPersonas). Omit for the all-personas planner scope."
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Optional planning-cycle (Prompt Studio iteration) start date YYYY-MM-DD (from getIterationStartDates). Defaults to the latest standard iteration."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Row offset of the page to return (default 0). Pass the previous next_offset."
    },
    "include_evidence": {
      "type": "boolean",
      "description": "Include supporting evidence per row (top_advertisers, product_candidates, prompt_examples, grounding diagnostics). Default false; pages hold fewer rows when true."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "rows": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Ads Planner recommendation row (the corresponding Meikai service)."
          }
        },
        "total_rows": {
          "type": "integer",
          "minimum": 0
        },
        "offset": {
          "type": "integer",
          "minimum": 0
        },
        "returned_rows": {
          "type": "integer",
          "minimum": 0
        },
        "next_offset": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0
        },
        "include_evidence": {
          "type": "boolean"
        }
      },
      "additionalProperties": false,
      "required": [
        "rows",
        "total_rows",
        "offset",
        "returned_rows",
        "next_offset",
        "include_evidence"
      ],
      "description": "Size-bounded page of Ads Planner recommendation rows."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided. Ads data is available from 2026-04-09; earlier dates are clamped automatically."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Use getTopics to discover topic IDs."
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (optional). Defaults to 'chatgpt'; use 'googleaioverview' for Google AI Overview ads."
    },
    "platform": {
      "type": "string",
      "description": "Optional AI platform filter (alias of ai_platform). Comma-separated platforms supported."
    },
    "funnel": {
      "type": "string",
      "description": "Optional funnel filter: awareness, consideration, conversion (comma-separated allowed)."
    },
    "model": {
      "type": "string",
      "description": "Optional model filter."
    },
    "persona_id": {
      "type": "string",
      "description": "Optional Prompt Studio persona UUID or comma-separated UUIDs."
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Optional topic iteration start date YYYY-MM-DD."
    },
    "advertiser": {
      "type": "string",
      "description": "Optional advertiser name filter."
    },
    "search": {
      "type": "string",
      "description": "Optional search across creative title/body/advertiser."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page number (default 1)."
    },
    "page_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Results per page (default 20, max 100)."
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "ad_penetration",
        "appearances",
        "prompt_coverage",
        "trend",
        "share_of_advertiser",
        "share_of_advertiser_rank",
        "last_seen_at",
        "title",
        "advertiser"
      ],
      "description": "Sort field (default ad_penetration)."
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort order (default desc)."
    },
    "company_id": {
      "type": "string",
      "description": "Optional company UUID scope when not using brand_id alone."
    },
    "prompt_id": {
      "type": "string",
      "description": "Optional prompt UUID or comma-separated UUIDs."
    },
    "tag_id": {
      "type": "string",
      "description": "Optional prompt-tag UUID or comma-separated UUIDs."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Aggregated ad creative row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided. Ads data is available from 2026-04-09; earlier dates are clamped automatically."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Use getTopics to discover topic IDs."
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (optional). Defaults to 'chatgpt'; use 'googleaioverview' for Google AI Overview ads."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Ads share over time (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided. Ads data is available from 2026-04-09; earlier dates are clamped automatically."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Use getTopics to discover topic IDs."
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (optional). Defaults to 'chatgpt'; use 'googleaioverview' for Google AI Overview ads."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Ads summary KPI row."
      },
      "description": "the corresponding Meikai service"
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided. Ads data is available from 2026-04-09; earlier dates are clamped automatically."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Use getTopics to discover topic IDs."
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (optional). Defaults to 'chatgpt'; use 'googleaioverview' for Google AI Overview ads."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Top advertisers (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided. Ads data is available from 2026-04-09; earlier dates are clamped automatically."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Use getTopics to discover topic IDs."
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (optional). Defaults to 'chatgpt'; use 'googleaioverview' for Google AI Overview ads."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Ads trend series (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided. Ads data is available from 2026-04-09; earlier dates are clamped automatically."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Use getTopics to discover topic IDs."
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (optional). Defaults to 'chatgpt'; use 'googleaioverview' for Google AI Overview ads."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Ads vs visibility aggregate (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "conversation_id": {
      "type": "string",
      "description": "If provided, returns details of a specific conversation. If not provided, returns list of conversations."
    },
    "brand_id": {
      "type": "string",
      "description": "Filter conversations by brand (optional)"
    },
    "workspace_id": {
      "type": "string",
      "description": "Filter conversations by workspace (optional, defaults to active workspace context)"
    },
    "archived": {
      "type": "boolean",
      "description": "Filter by archived status (optional, true/false)"
    },
    "search": {
      "type": "string",
      "description": "Search conversations by title (case-insensitive partial match, optional)"
    },
    "page": {
      "type": "number",
      "description": "Page number for pagination (for list, optional, default: 1)"
    },
    "page_size": {
      "type": "number",
      "description": "Number of conversations per page (optional, default: 10, max: 20)"
    },
    "limit_messages": {
      "type": "number",
      "description": "Maximum number of messages to return in conversation details (optional, default: 50, max: 100)"
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {},
      "additionalProperties": true,
      "description": "Conversation list, detail, or messages payload."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "export_job_id": {
      "type": "string",
      "description": "Export job UUID returned by startAsyncExportJob."
    }
  },
  "required": [
    "export_job_id"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Export download metadata or file info."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "export_job_id": {
      "type": "string",
      "description": "Export job UUID returned by startAsyncExportJob."
    }
  },
  "required": [
    "export_job_id"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Export job status."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string",
      "description": "The UUID of the company (optional, defaults to context company_id; required for publisher context)"
    },
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand to scope to (optional; if provided with company_id, filters to that brand)"
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID)"
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., chatgpt, gemini, perplexity, googleaioverview)"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Authority correlation series (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID for brand website scope (XOR with company_id). Requires CDN log customer IDs on the brand."
    },
    "company_id": {
      "type": "string",
      "description": "Company UUID for publisher corporate website scope (XOR with brand_id). Requires publisher company type and CDN log customer IDs on the company."
    },
    "start_date": {
      "type": "string",
      "description": "Start date in YYYY-MM-DD format (required)"
    },
    "end_date": {
      "type": "string",
      "description": "End date in YYYY-MM-DD format (required)"
    },
    "host": {
      "type": "string",
      "description": "Optional host filter (e.g., 'www.meikai.ai'). If not provided, returns data for all hosts."
    },
    "platform": {
      "type": "string",
      "enum": [
        "OpenAI",
        "Perplexity",
        "Google",
        "Microsoft"
      ],
      "description": "Optional verified platform filter. Only verified bot platforms are supported."
    },
    "bot_agent": {
      "type": "string",
      "description": "Optional verified bot-agent label filter (for example: 'GPTBot (OpenAI training crawler)' or 'Googlebot (Google search crawler)')."
    },
    "path_contains": {
      "type": "string",
      "description": "Optional case-insensitive substring filter for path coverage checks (for example: 'pricing', '/blog/', 'product'). Useful to check whether specific page groups are crawled by verified bots."
    }
  },
  "required": [
    "start_date",
    "end_date"
  ]
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Bot traffic data (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., 'chatgpt', 'gemini', 'perplexity', 'grok', 'copilot', 'openai', 'google-ai-mode', 'googleaioverview'). Common values: chatgpt, gemini, perplexity, grok, copilot, googleaioverview"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g., 'gpt-5', 'gpt-5-t-mini', 'gemini-3.5-flash', 'grok-3', 'grok-4-auto', 'perplexity'). Model names vary by platform"
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Optional Prompt Studio cycle/iteration start date (YYYY-MM-DD) to restrict results to that iteration's evergreen topics. Get valid values from getIterationStartDates with classification='evergreen'."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Perception by category."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., 'chatgpt', 'gemini', 'perplexity', 'grok', 'copilot', 'openai', 'google-ai-mode', 'googleaioverview'). Common values: chatgpt, gemini, perplexity, grok, copilot, googleaioverview"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g., 'gpt-5', 'gpt-5-t-mini', 'gemini-3.5-flash', 'grok-3', 'grok-4-auto', 'perplexity'). Model names vary by platform"
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Optional Prompt Studio cycle/iteration start date (YYYY-MM-DD) to restrict results to that iteration's evergreen topics. Get valid values from getIterationStartDates with classification='evergreen'."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Perception categories metadata."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from getBrandPerceptionTopics results or user message."
    },
    "topic_category": {
      "type": "string",
      "enum": [
        "Attribute",
        "Product"
      ],
      "description": "Filter by topic category: 'Attribute' (brand attributes) or 'Product' (product-specific topics)"
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., 'chatgpt', 'gemini', 'perplexity', 'grok', 'copilot', 'openai', 'google-ai-mode', 'googleaioverview'). Common values: chatgpt, gemini, perplexity, grok, copilot, googleaioverview"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g., 'gpt-5', 'gpt-5-t-mini', 'gemini-3.5-flash', 'grok-3', 'grok-4-auto', 'perplexity'). Model names vary by platform"
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Optional Prompt Studio cycle/iteration start date (YYYY-MM-DD) to restrict results to that iteration's evergreen topics. Get valid values from getIterationStartDates with classification='evergreen'."
    },
    "granularity": {
      "type": "string",
      "enum": [
        "daily",
        "weekly"
      ],
      "description": "Time granularity: 'daily' for day-by-day data or 'weekly' for weekly aggregation (optional, default: 'weekly')"
    },
    "top_n_competitors": {
      "type": "number",
      "description": "Number of top competitors to include in comparison (optional, default: 10, max: 10)"
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Competitor comparison series."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from getBrandPerceptionTopics results or user message."
    },
    "topic_category": {
      "type": "string",
      "enum": [
        "Attribute",
        "Product"
      ],
      "description": "Filter by topic category: 'Attribute' (brand attributes) or 'Product' (product-specific topics)"
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., 'chatgpt', 'gemini', 'perplexity', 'grok', 'copilot', 'openai', 'google-ai-mode', 'googleaioverview'). Common values: chatgpt, gemini, perplexity, grok, copilot, googleaioverview"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g., 'gpt-5', 'gpt-5-t-mini', 'gemini-3.5-flash', 'grok-3', 'grok-4-auto', 'perplexity'). Model names vary by platform"
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Optional Prompt Studio cycle/iteration start date (YYYY-MM-DD) to restrict results to that iteration's evergreen topics. Get valid values from getIterationStartDates with classification='evergreen'."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Perception competitors metadata."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from getBrandPerceptionTopics results or user message."
    },
    "topic_category": {
      "type": "string",
      "enum": [
        "Attribute",
        "Product"
      ],
      "description": "Filter by topic category: 'Attribute' (brand attributes) or 'Product' (product-specific topics)"
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., 'chatgpt', 'gemini', 'perplexity', 'grok', 'copilot', 'openai', 'google-ai-mode', 'googleaioverview'). Common values: chatgpt, gemini, perplexity, grok, copilot, googleaioverview"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g., 'gpt-5', 'gpt-5-t-mini', 'gemini-3.5-flash', 'grok-3', 'grok-4-auto', 'perplexity'). Model names vary by platform"
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Optional Prompt Studio cycle/iteration start date (YYYY-MM-DD) to restrict results to that iteration's evergreen topics. Get valid values from getIterationStartDates with classification='evergreen'."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Perception distribution."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from getBrandPerceptionTopics results or user message."
    },
    "topic_category": {
      "type": "string",
      "enum": [
        "Attribute",
        "Product"
      ],
      "description": "Filter by topic category: 'Attribute' (brand attributes) or 'Product' (product-specific topics)"
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., 'chatgpt', 'gemini', 'perplexity', 'grok', 'copilot', 'openai', 'google-ai-mode', 'googleaioverview'). Common values: chatgpt, gemini, perplexity, grok, copilot, googleaioverview"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g., 'gpt-5', 'gpt-5-t-mini', 'gemini-3.5-flash', 'grok-3', 'grok-4-auto', 'perplexity'). Model names vary by platform"
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Optional Prompt Studio cycle/iteration start date (YYYY-MM-DD) to restrict results to that iteration's evergreen topics. Get valid values from getIterationStartDates with classification='evergreen'."
    },
    "granularity": {
      "type": "string",
      "enum": [
        "daily",
        "weekly"
      ],
      "description": "Time granularity: 'daily' for day-by-day data or 'weekly' for weekly aggregation (optional, default: 'weekly')"
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Perception over time."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_category": {
      "type": "string",
      "enum": [
        "Attribute",
        "Product"
      ],
      "description": "Filter by topic category: 'Attribute' (brand attributes) or 'Product' (product-specific topics)"
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., 'chatgpt', 'gemini', 'perplexity', 'grok', 'copilot', 'openai', 'google-ai-mode', 'googleaioverview'). Common values: chatgpt, gemini, perplexity, grok, copilot, googleaioverview"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g., 'gpt-5', 'gpt-5-t-mini', 'gemini-3.5-flash', 'grok-3', 'grok-4-auto', 'perplexity'). Model names vary by platform"
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Optional Prompt Studio cycle/iteration start date (YYYY-MM-DD) to restrict results to that iteration's evergreen topics. Get valid values from getIterationStartDates with classification='evergreen'."
    },
    "top_n_competitors": {
      "type": "number",
      "description": "Number of top competitors to include in the radar chart (optional, default: 10, max: 10)"
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Perception radar chart data."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "response_id": {
      "type": "string",
      "description": "The UUID of the response. Extract this from getBrandPerceptionResponses results or user message when they mention a specific response ID."
    },
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand, required for authorization)"
    }
  },
  "required": [
    "response_id"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Perception response detail."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from getBrandPerceptionTopics results or user message."
    },
    "topic_category": {
      "type": "string",
      "enum": [
        "Attribute",
        "Product"
      ],
      "description": "Filter by topic category: 'Attribute' (brand attributes) or 'Product' (product-specific topics)"
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., 'chatgpt', 'gemini', 'perplexity', 'grok', 'copilot', 'openai', 'google-ai-mode', 'googleaioverview'). Common values: chatgpt, gemini, perplexity, grok, copilot, googleaioverview"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g., 'gpt-5', 'gpt-5-t-mini', 'gemini-3.5-flash', 'grok-3', 'grok-4-auto', 'perplexity'). Model names vary by platform"
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Optional Prompt Studio cycle/iteration start date (YYYY-MM-DD) to restrict results to that iteration's evergreen topics. Get valid values from getIterationStartDates with classification='evergreen'."
    },
    "min_rating": {
      "type": "number",
      "description": "Minimum target brand rating filter (optional, 1-5)"
    },
    "max_rating": {
      "type": "number",
      "description": "Maximum target brand rating filter (optional, 1-5)"
    },
    "confidence": {
      "type": "string",
      "enum": [
        "high",
        "medium",
        "low"
      ],
      "description": "Filter by extraction confidence: 'high' (high confidence extractions), 'medium' (medium confidence), 'low' (low confidence)"
    },
    "limit": {
      "type": "number",
      "description": "Number of results per page (optional, default: 50, max: 100)"
    },
    "offset": {
      "type": "number",
      "description": "Number of results to skip for pagination (optional, default: 0)"
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "date",
        "rating",
        "confidence"
      ],
      "description": "Field to sort by. ALWAYS use appropriate sorting based on query intent: 'date' for newest/oldest (with sort_order='desc' for newest, sort_order='asc' for oldest), 'rating' for highest/lowest ratings (with sort_order='desc' for highest, sort_order='asc' for lowest), 'confidence' for highest/lowest confidence (with sort_order='desc' for highest, sort_order='asc' for lowest). NEVER rely on defaults - always specify sort_by and sort_order."
    },
    "sort_order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort order: 'asc' for ascending or 'desc' for descending. ALWAYS specify: Use 'desc' for newest/highest, 'asc' for oldest/lowest. Must ALWAYS be provided when sort_by is used."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_category": {
      "type": "string",
      "enum": [
        "Attribute",
        "Product"
      ],
      "description": "Filter by topic category: 'Attribute' (brand attributes) or 'Product' (product-specific topics)"
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., 'chatgpt', 'gemini', 'perplexity', 'grok', 'copilot', 'openai', 'google-ai-mode', 'googleaioverview'). Common values: chatgpt, gemini, perplexity, grok, copilot, googleaioverview"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g., 'gpt-5', 'gpt-5-t-mini', 'gemini-3.5-flash', 'grok-3', 'grok-4-auto', 'perplexity'). Model names vary by platform"
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Optional Prompt Studio cycle/iteration start date (YYYY-MM-DD) to restrict results to that iteration's evergreen topics. Get valid values from getIterationStartDates with classification='evergreen'."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Perception summary KPI."
      },
      "description": "the corresponding Meikai service"
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_category": {
      "type": "string",
      "enum": [
        "Attribute",
        "Product"
      ],
      "description": "Filter by topic category: 'Attribute' (brand attributes like quality, innovation) or 'Product' (product-specific topics)"
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., 'chatgpt', 'gemini', 'perplexity', 'grok', 'copilot', 'openai', 'google-ai-mode', 'googleaioverview'). Common values: chatgpt, gemini, perplexity, grok, copilot, googleaioverview"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g., 'gpt-5', 'gpt-5-t-mini', 'gemini-3.5-flash', 'grok-3', 'grok-4-auto', 'perplexity'). Model names vary by platform"
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Optional Prompt Studio cycle/iteration start date (YYYY-MM-DD) to restrict results to that iteration's evergreen topics. Get valid values from getIterationStartDates with classification='evergreen'."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Perception topics metadata."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID. Optional when MCP context provides the current brand."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic UUID (comma-separated UUIDs allowed)."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage."
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (maps to query param ai_platform), e.g. chatgpt, gemini, googleaioverview."
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (platform-specific)."
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter). Use getPromptPersonas to list valid ids for the brand."
    },
    "calculation_mode": {
      "type": "string",
      "enum": [
        "classic",
        "weighted"
      ],
      "description": "Calculation mode for visibility metrics. 'classic' uses unweighted calculations (default). 'weighted' applies Statcounter AI outbound-referral share weighting; this does not represent users or total AI usage."
    },
    "lens_competitor_name": {
      "type": "string",
      "description": "Competitor Lens: analyze this competitor instead of the monitored brand, keeping every other filter identical (same scope as the webapp's Competitor Lens selector). Accepts the competitor's name or any of its aliases, case-insensitive. Use getCompetitorMetrics to list the brand's competitors. Omit to analyze the brand itself."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "value": {
            "type": [
              "number",
              "null"
            ],
            "description": "Metric value for the current period."
          },
          "previous_value": {
            "type": [
              "number",
              "null"
            ],
            "description": "Metric value for the previous period of equal length."
          },
          "pct_change": {
            "type": [
              "number",
              "null"
            ],
            "description": "Relative change in average numeric rank vs the previous period. Positive means the rank increased/worsened; negative means it decreased/improved."
          },
          "observation_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Responses used for the current average position."
          },
          "previous_observation_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Responses used for the previous-period average position."
          },
          "brand_count_avg": {
            "type": [
              "number",
              "null"
            ],
            "description": "Average distinct eligible brands mentioned in current-period responses where the analyzed brand has a position."
          }
        },
        "additionalProperties": false,
        "description": "Average Brand Monitor position card. For each response mentioning the analyzed brand, brands are ranked by first mention; value is the average response-level rank. Lower is better and 1 means mentioned first."
      },
      "description": "Average brand-position card rows (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "page_size": {
      "type": "number",
      "description": "Number of topics to return per page. Use large values when user wants 'all' topics or comprehensive data."
    },
    "page": {
      "type": "number",
      "description": "Page number for pagination"
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of a specific brand to prioritize/filter (optional, defaults to current selected brand from context)"
    },
    "company_id": {
      "type": "string",
      "description": "The UUID of the company to list brands for (optional, defaults to context company_id; company administrators only when different from own company)"
    },
    "page_size": {
      "type": "number",
      "description": "Number of brands to return per page"
    },
    "page": {
      "type": "number",
      "description": "Page number for pagination"
    },
    "search": {
      "type": "string",
      "description": "Substring to match against brand name or company name (case-insensitive). Use when listing many brands or the user gives a partial name."
    },
    "ordering": {
      "type": "string",
      "description": "Sort field: name, -name, created_at, -created_at, updated_at, -updated_at, company_name, -company_name",
      "enum": [
        "name",
        "-name",
        "created_at",
        "-created_at",
        "updated_at",
        "-updated_at",
        "company_name",
        "-company_name"
      ]
    },
    "tag_id": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ],
      "description": "Filter by tag UUID(s). Accepts a single UUID, a comma-separated string, or an array of UUIDs. OR within one namespace and AND across namespaces (same semantics as REST tag_id)."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "vercel",
        "aws",
        "azure-front-door",
        "cloudflare",
        "netlify",
        "fastly",
        "akamai",
        "all",
        "overview"
      ],
      "description": "Which CDN provider guide to show. 'overview' for general architecture and setup, specific provider name for provider-specific instructions, 'all' for all providers (default)."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "additionalProperties": true
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "data"
      ],
      "description": "Static product documentation payload."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string",
      "description": "The UUID of the company (optional, defaults to context company_id; required for publisher context)"
    },
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand to scope to (optional; if provided with company_id, filters to that brand)"
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID)"
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., chatgpt, gemini, perplexity, googleaioverview)"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Citations by platform (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string",
      "description": "The UUID of the company (optional, defaults to context company_id; required for publisher context)"
    },
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand to scope to (optional; if provided with company_id, filters to that brand)"
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID)"
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., chatgpt, gemini, perplexity, googleaioverview)"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Citation media-type breakdown (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string",
      "description": "The UUID of the company (optional, defaults to context company_id; required for publisher context)"
    },
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand to scope to (optional; if provided with company_id, filters to that brand)"
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID)"
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., chatgpt, gemini, perplexity, googleaioverview)"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "page": {
      "type": "integer",
      "description": "Page number (default 1)"
    },
    "page_size": {
      "type": "integer",
      "description": "Items per page (default 20, max 200)"
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string",
      "description": "The UUID of the company (optional, defaults to context company_id; required for publisher context)"
    },
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand to scope to (optional; if provided with company_id, filters to that brand)"
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID)"
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., chatgpt, gemini, perplexity, googleaioverview)"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Citation rate KPI row."
      },
      "description": "Citation rate card (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). PREFERRED over search when filtering by topic - use this when you have topic_id from getTopics or user message."
    },
    "prompt_id": {
      "type": "string",
      "description": "Filter by prompt ID(s). Can be a single UUID or comma-separated list of UUIDs. Use this to get citations for specific prompts (e.g., prompts in a cluster)."
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID (restricts to that persona's assigned active regular prompts)."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage"
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., 'chatgpt', 'gemini', 'perplexity', 'grok', 'copilot', 'openai', 'google-ai-mode', 'googleaioverview'). Common values: chatgpt, gemini, perplexity, grok, copilot, googleaioverview"
    },
    "platforms": {
      "type": "string",
      "description": "Filter by multiple AI platforms in one query (comma-separated, e.g. 'chatgpt,gemini,google-ai-mode'). Prefer over repeated single-platform calls."
    },
    "per_platform_url_cap": {
      "type": "integer",
      "description": "With multi-platform platforms filter, keep only the top N citation URLs per platform before merging across platforms. Used by OffSite earned-media analysis to preserve legacy per-platform top-N semantics in one query."
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g., 'gpt-5', 'gpt-5-t-mini', 'gemini-3.5-flash', 'grok-3', 'grok-4-auto', 'perplexity'). Model names vary by platform"
    },
    "media_type": {
      "type": "string",
      "enum": [
        "Reference & Informational",
        "Public & Institutional",
        "Competitor",
        "Earned Media",
        "Commercial Media",
        "Owned Media",
        "Shared Media"
      ],
      "description": "Filter by media type. Valid values: 'Reference & Informational' (reference sites, informational content), 'Public & Institutional' (public institutions, government sites), 'Competitor' (competitor websites), 'Earned Media' (unpaid media coverage like press mentions, reviews, articles), 'Commercial Media' (commercial/advertising media), 'Owned Media' (content you own/control like your website, blog), 'Shared Media' (shared/social platforms)"
    },
    "is_mentioning_brand": {
      "type": "string",
      "enum": [
        "true",
        "false",
        "unknown"
      ],
      "description": "Filter citations by whether the URL mentions the brand. 'true' = only URLs that mention the brand; 'false' = only URLs that do not mention the brand; 'unknown' = only URLs where brand mention status is unknown. Omit to return all citations."
    },
    "favorite_competitor_mentioned_not_brand": {
      "type": "string",
      "enum": [
        "true",
        "false"
      ],
      "description": "Filter by competitor-only: 'true' = only URLs where a favorite competitor is mentioned in scraped content but the brand is not; 'false' = only URLs that do not match that. Response fields isMentioningAnyFavoriteCompetitor and isFavoriteCompetitorMentionedNotBrand may be null until backend data is available."
    },
    "exclude_domains": {
      "type": "string",
      "description": "Exclude citations from these domains. Comma-separated list of domain names (e.g. 'example.com, foo.org'). Case-insensitive."
    },
    "lens_competitor_name": {
      "type": "string",
      "description": "Competitor Lens: analyze this competitor instead of the monitored brand, keeping every other filter identical (same scope as the webapp's Competitor Lens selector). Accepts the competitor's name or any of its aliases, case-insensitive. Use getCompetitorMetrics to list the brand's competitors. Omit to analyze the brand itself."
    },
    "domain": {
      "type": "string",
      "description": "Filter URL rows to a specific domain (case-insensitive, supports apex/subdomain matching in backend)."
    },
    "view": {
      "type": "string",
      "enum": [
        "urls",
        "domains"
      ],
      "description": "Result mode: 'urls' (default) for URL-level rows, or 'domains' for grouped domain rows."
    },
    "search": {
      "type": "string",
      "description": "Search query for URL or title text. Use ONLY when you don't have topic_id or prompt_id filters available. Prefer ID-based filters (topic_id, prompt_id) over search when possible."
    },
    "include_total": {
      "type": "boolean",
      "description": "When true (default in backend), include totalCount in pagination metadata."
    },
    "count_only": {
      "type": "boolean",
      "description": "When true, only returns pagination totals (no data rows). Useful to fetch counts quickly."
    },
    "page": {
      "type": "number",
      "description": "Page number for pagination"
    },
    "page_size": {
      "type": "number",
      "description": "Number of citations per page. Maximum allowed is 200 to prevent token limit issues. Use values up to 200 when user wants comprehensive data, 'all' results, or analysis of top/most items. Default is 50."
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "url",
        "domain",
        "mediaType",
        "title",
        "citationsCount",
        "domainCitationCount",
        "domainUrlCount",
        "isMentioningBrand",
        "isFavoriteCompetitorMentionedNotBrand",
        "domainBrandMentions",
        "domainCompetitorOnlyMentions",
        "domainCompetitorOnlyPresence",
        "shareOfCitation",
        "shareOfCitationDomain",
        "promptsImpactedByUrl",
        "promptsImpactedByDomain",
        "lastSeenAt",
        "firstSeenAt"
      ],
      "description": "Field to sort by. ALWAYS use appropriate sorting based on query intent: 'citationsCount' for most/least cited (with order='desc' for most, order='asc' for least), 'domainBrandMentions' for most/least URLs mentioning brand per domain (with order='desc' for most, order='asc' for least), 'shareOfCitation' for highest/lowest share (with order='desc' for highest, order='asc' for lowest), 'lastSeenAt' for recent/oldest (with order='desc' for recent, order='asc' for oldest), 'firstSeenAt' for earliest/latest first appearance (with order='asc' for earliest, order='desc' for latest), 'isFavoriteCompetitorMentionedNotBrand' for competitor-only flag, 'url' or 'domain' for alphabetical (with order='asc'). NEVER rely on defaults - always specify sort_by and order. Valid values: url, domain, mediaType, title, citationsCount, domainCitationCount, isMentioningBrand, isFavoriteCompetitorMentionedNotBrand, domainBrandMentions, shareOfCitation, shareOfCitationDomain, promptsImpactedByUrl, promptsImpactedByDomain, lastSeenAt, firstSeenAt"
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort order: 'asc' for ascending or 'desc' for descending. ALWAYS specify: Use 'desc' for top/most/highest/recent, 'asc' for least/lowest/oldest/alphabetical. Must ALWAYS be provided when sort_by is used - never rely on defaults."
    },
    "include_prompt_ids": {
      "type": "boolean",
      "description": "When true and prompt_id is set, response includes promptIds (array of prompt UUIDs) per citation row for client-side batching (e.g. split citations by cluster)."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "page_size": {
      "type": "number",
      "description": "Number of companies to return per page"
    },
    "page": {
      "type": "number",
      "description": "Page number for pagination"
    },
    "search": {
      "type": "string",
      "description": "Substring to match against company name (case-insensitive). Use when listing many companies or the user gives a partial name."
    },
    "type": {
      "type": "string",
      "description": "Filter by company type",
      "enum": [
        "advertiser",
        "publisher",
        "agency"
      ]
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string"
    },
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "group_by": {
      "type": "string",
      "enum": [
        "topic",
        "funnel",
        "platform"
      ],
      "description": "Optional single dimension for by_dimension array"
    },
    "topic_id": {
      "type": "string"
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ]
    },
    "platform": {
      "type": "string"
    },
    "model": {
      "type": "string"
    },
    "competitor_name": {
      "type": "string"
    },
    "calculation_mode": {
      "type": "string",
      "enum": [
        "classic",
        "weighted"
      ],
      "description": "Calculation mode for visibility metrics. 'classic' uses unweighted calculations (default). 'weighted' applies Statcounter AI outbound-referral share weighting; this does not represent users or total AI usage."
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "visibility",
        "share_of_voice",
        "mentions",
        "rank",
        "name"
      ],
      "description": "Sort field for competitor list (default: rank)"
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort order for competitor list (default: asc)"
    },
    "dimension_sort_by": {
      "type": "string",
      "enum": [
        "target_visibility",
        "target_share_of_voice",
        "gap_visibility",
        "gap_share_of_voice",
        "key"
      ],
      "description": "Sort field for by_dimension rows (default: target_visibility)"
    },
    "dimension_order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort order for by_dimension rows (default: desc)"
    },
    "page": {
      "type": "number"
    },
    "page_size": {
      "type": "number"
    }
  }
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "properties": {
            "success": {
              "type": "boolean",
              "const": true
            },
            "calculationMode": {
              "type": "string",
              "enum": [
                "classic",
                "weighted"
              ]
            },
            "targetBrand": {
              "type": "object",
              "additionalProperties": true,
              "description": "Target-brand aggregate metrics."
            },
            "competitors": {
              "type": "array",
              "items": {
                "type": "object",
                "additionalProperties": true,
                "description": "Favorite-competitor aggregate metrics."
              }
            },
            "byDimension": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "dimension": {
                    "type": "string",
                    "enum": [
                      "platform",
                      "topic",
                      "funnel"
                    ]
                  },
                  "key": {
                    "type": "string"
                  },
                  "label": {
                    "type": "string"
                  },
                  "targetResponsesWithMentions": {
                    "type": [
                      "integer",
                      "number",
                      "null"
                    ],
                    "minimum": 0
                  },
                  "topCompetitorResponsesWithMentions": {
                    "type": [
                      "integer",
                      "number",
                      "null"
                    ],
                    "minimum": 0
                  },
                  "totalResponses": {
                    "type": [
                      "integer",
                      "number",
                      "null"
                    ],
                    "minimum": 0
                  },
                  "denominatorScope": {
                    "type": "string",
                    "enum": [
                      "all_analyzed_responses",
                      "weighted_all_analyzed_responses"
                    ]
                  },
                  "targetVisibility": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Target responses with mentions divided by all analyzed responses in this row's scope."
                  },
                  "targetShareOfVoice": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Target mentions divided by all tracked mentions in this row's scope."
                  },
                  "topCompetitor": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "topCompetitorVisibility": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Top favorite competitor visibility in the identical row scope."
                  },
                  "topCompetitorShareOfVoice": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Top favorite competitor share of voice in the identical row scope."
                  },
                  "gapVisibility": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Target minus top-competitor visibility."
                  },
                  "gapShareOfVoice": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "Target minus top-competitor share of voice."
                  }
                },
                "additionalProperties": true,
                "required": [
                  "dimension",
                  "key",
                  "label",
                  "targetResponsesWithMentions",
                  "topCompetitorResponsesWithMentions",
                  "totalResponses",
                  "denominatorScope",
                  "targetVisibility",
                  "targetShareOfVoice",
                  "topCompetitor",
                  "topCompetitorVisibility",
                  "topCompetitorShareOfVoice",
                  "gapVisibility",
                  "gapShareOfVoice"
                ]
              }
            },
            "pagination": {
              "type": "object",
              "additionalProperties": true,
              "description": "Pagination for byDimension rows."
            },
            "weightMetadata": {
              "type": "object",
              "additionalProperties": true,
              "description": "Calculation mode, ratio unit, and optional weighting evidence."
            }
          },
          "additionalProperties": true,
          "required": [
            "success",
            "calculationMode",
            "targetBrand",
            "competitors",
            "byDimension",
            "pagination",
            "weightMetadata"
          ],
          "description": "Competitive breakdown with auditable numerator and denominator evidence."
        }
      },
      "additionalProperties": true,
      "required": [
        "success",
        "data"
      ]
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID. Optional when MCP context provides the current brand."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic UUID (comma-separated UUIDs allowed)."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage."
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (maps to query param ai_platform), e.g. chatgpt, gemini, googleaioverview."
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (platform-specific)."
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter). Use getPromptPersonas to list valid ids for the brand."
    },
    "calculation_mode": {
      "type": "string",
      "enum": [
        "classic",
        "weighted"
      ],
      "description": "Calculation mode for visibility metrics. 'classic' uses unweighted calculations (default). 'weighted' applies Statcounter AI outbound-referral share weighting; this does not represent users or total AI usage."
    },
    "competitor_name": {
      "type": "string",
      "description": "Exact competitor name to inspect (required)."
    }
  },
  "required": [
    "competitor_name"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "additionalProperties": true,
          "description": "Aggregated competitor detail (competitor, currentBrand, snapshot, topicAdvantages, citationAdvantages, topProducts, topPrompts). the corresponding Meikai service."
        }
      },
      "additionalProperties": true,
      "required": [
        "success",
        "data"
      ]
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID. Optional when MCP context provides the current brand."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic UUID (comma-separated UUIDs allowed)."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage."
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (maps to query param ai_platform), e.g. chatgpt, gemini, googleaioverview."
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (platform-specific)."
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter). Use getPromptPersonas to list valid ids for the brand."
    },
    "calculation_mode": {
      "type": "string",
      "enum": [
        "classic",
        "weighted"
      ],
      "description": "Calculation mode for visibility metrics. 'classic' uses unweighted calculations (default). 'weighted' applies Statcounter AI outbound-referral share weighting; this does not represent users or total AI usage."
    },
    "competitor_name": {
      "type": "string",
      "description": "Optional exact competitor name to compare. If this competitor is not in the brand's favorite competitors, the response will include a suggestion to add it as a favorite first."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Competitor metric row with optional assistant_suggestion."
          }
        }
      },
      "additionalProperties": true,
      "required": [
        "success",
        "data"
      ]
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID. Optional when MCP context provides the current brand."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic UUID (comma-separated UUIDs allowed)."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage."
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (maps to query param ai_platform), e.g. chatgpt, gemini, googleaioverview."
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (platform-specific)."
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter). Use getPromptPersonas to list valid ids for the brand."
    },
    "calculation_mode": {
      "type": "string",
      "enum": [
        "classic",
        "weighted"
      ],
      "description": "Calculation mode for visibility metrics. 'classic' uses unweighted calculations (default). 'weighted' applies Statcounter AI outbound-referral share weighting; this does not represent users or total AI usage."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Competitive presence distribution (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID. Optional when MCP context provides the current brand."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic UUID (comma-separated UUIDs allowed)."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage."
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (maps to query param ai_platform), e.g. chatgpt, gemini, googleaioverview."
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (platform-specific)."
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter). Use getPromptPersonas to list valid ids for the brand."
    },
    "calculation_mode": {
      "type": "string",
      "enum": [
        "classic",
        "weighted"
      ],
      "description": "Calculation mode for visibility metrics. 'classic' uses unweighted calculations (default). 'weighted' applies Statcounter AI outbound-referral share weighting; this does not represent users or total AI usage."
    },
    "competitor_scope": {
      "type": "string",
      "enum": [
        "favorites",
        "all"
      ],
      "description": "Competitor set. Defaults to configured favorite competitors."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "One-based competitor-column page for competitor_scope=all."
    },
    "page_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Competitors per page for competitor_scope=all (maximum 50)."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Topics x competitors matrix for favorite competitors."
    },
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Topics x competitors matrix page."
        },
        "competitorScope": {
          "type": "string",
          "const": "all"
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Competitor-column pagination metadata."
        }
      },
      "additionalProperties": true,
      "required": [
        "data",
        "competitorScope",
        "pagination"
      ]
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "agent_type": {
      "type": "string",
      "enum": [
        "onsite",
        "offsite",
        "shared_media"
      ],
      "description": "Filter by agent type: 'onsite' (content recommendations for owned media), 'offsite' (earned media recommendations), 'shared_media' (shared media - YouTube, TikTok, Instagram, LinkedIn, Pinterest)"
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from getTopics results or user message."
    },
    "search": {
      "type": "string",
      "description": "Search folders by name (case-insensitive)"
    },
    "page": {
      "type": "number",
      "description": "Page number for pagination"
    },
    "page_size": {
      "type": "number",
      "description": "Number of folders per page. Default is 20."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "page_id": {
      "type": "string",
      "description": "The UUID of the content page. Extract this from getContentPages results or user message when they mention a specific page ID."
    },
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    }
  },
  "required": [
    "page_id"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Content page detail."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "folder_id": {
      "type": "string",
      "description": "Filter by folder ID (UUID). Extract from getContentFolders results or user message."
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "disabled",
        "deleted"
      ],
      "description": "Filter by page status: 'active' (active pages), 'disabled' (disabled pages), 'deleted' (deleted pages)"
    },
    "search": {
      "type": "string",
      "maxLength": 200,
      "description": "Search page titles, URLs, content, topics, summaries, and nested recommendation page names, URLs, and domains"
    },
    "page": {
      "type": "number",
      "description": "Page number for pagination"
    },
    "page_size": {
      "type": "number",
      "description": "Number of pages per page. Default is 20."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "sections": {
      "oneOf": [
        {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "overview",
              "mcp_map",
              "permissions",
              "citation_media_types",
              "hierarchy",
              "prompt_studio",
              "clustering",
              "optimization",
              "insights",
              "all"
            ]
          },
          "description": "Subset of core-concepts payload to return. Omit for full response. Use ['overview'] for mission/pillars/funnel only; ['mcp_map'] for tool map + doc catalog; ['all'] is explicit full payload."
        },
        {
          "type": "string",
          "enum": [
            "overview",
            "mcp_map",
            "permissions",
            "citation_media_types",
            "hierarchy",
            "prompt_studio",
            "clustering",
            "optimization",
            "insights",
            "all"
          ],
          "description": "Single section id (same ids as array form)."
        }
      ]
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "additionalProperties": true
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "data"
      ],
      "description": "Static product documentation payload."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date in YYYY-MM-DD format (optional, defaults to last 7 days)"
    },
    "end_date": {
      "type": "string",
      "description": "End date in YYYY-MM-DD format (optional, defaults to the server's last complete day (yesterday))"
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from the user's message or from previous tool results (e.g., from getTopics). Use this to filter data to a specific topic. To include topic as a dimension in the output, use dimensions=['topic'] instead or in addition."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage. Use this to filter data to a specific funnel stage. To include funnel as a dimension in the output, use dimensions=['funnel'] instead or in addition."
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g. 'chatgpt', 'gemini', 'googleaioverview')"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g. 'gpt-5', 'gemini-3.5-flash'). Model names vary by platform"
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter). Use getPromptPersonas to list valid ids for the brand."
    },
    "calculation_mode": {
      "type": "string",
      "enum": [
        "classic",
        "weighted"
      ],
      "description": "Calculation mode for visibility metrics. 'classic' uses unweighted calculations (default). 'weighted' applies Statcounter AI outbound-referral share weighting; this does not represent users or total AI usage."
    },
    "lens_competitor_name": {
      "type": "string",
      "description": "Competitor Lens: analyze this competitor instead of the monitored brand, keeping every other filter identical (same scope as the webapp's Competitor Lens selector). Accepts the competitor's name or any of its aliases, case-insensitive. Use getCompetitorMetrics to list the brand's competitors. Omit to analyze the brand itself."
    },
    "dimensions": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "topic",
          "funnel"
        ]
      },
      "description": "Dimensions to include in the result set. Provide an array of dimension names, e.g., ['topic', 'funnel']. When 'topic' is included, each result row will have a 'topicId' field. When 'funnel' is included, each result row will have a 'funnel' field. This enables dimensional analysis. You can combine this with topic_id and/or funnel filter parameters to filter while including dimensions."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Daily visibility time series (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date in YYYY-MM-DD format (optional, defaults to last 7 days)"
    },
    "end_date": {
      "type": "string",
      "description": "End date in YYYY-MM-DD format (optional, defaults to the server's last complete day (yesterday))"
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). PREFERRED over other filters when filtering by topic - use this when you have topic_id from getTopics or user message."
    },
    "prompt_id": {
      "type": "string",
      "description": "Filter by prompt ID(s). Can be a single UUID or comma-separated list of UUIDs. Use this to get domain analysis for specific prompts (e.g., prompts in a cluster)."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage"
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., 'chatgpt', 'gemini', 'perplexity', 'grok', 'copilot', 'openai', 'google-ai-mode', 'googleaioverview'). Common values: chatgpt, gemini, perplexity, grok, copilot, googleaioverview"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g., 'gpt-5', 'gpt-5-t-mini', 'gemini-3.5-flash', 'grok-3', 'grok-4-auto', 'perplexity'). Model names vary by platform"
    },
    "media_type": {
      "type": "string",
      "enum": [
        "Reference & Informational",
        "Public & Institutional",
        "Competitor",
        "Earned Media",
        "Commercial Media",
        "Owned Media",
        "Shared Media"
      ],
      "description": "Filter by media type. Valid values: 'Reference & Informational' (reference sites, informational content), 'Public & Institutional' (public institutions, government sites), 'Competitor' (competitor websites), 'Earned Media' (unpaid media coverage like press mentions, reviews, articles), 'Commercial Media' (commercial/advertising media), 'Owned Media' (content you own/control like your website, blog), 'Shared Media' (shared/social platforms)"
    },
    "exclude_domains": {
      "type": "string",
      "description": "Exclude domains from results. Comma-separated list of domain names (case-insensitive)"
    },
    "page": {
      "type": "number",
      "description": "Page number for pagination"
    },
    "page_size": {
      "type": "number",
      "description": "Number of domains per page. Maximum allowed is 200 to prevent token limit issues. Use values up to 200 when user wants comprehensive data, 'all' results, or analysis of top/most domains. Default is 50."
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "domain",
        "domainCitationCount",
        "domainUrlCount",
        "domainBrandMentions",
        "domainBrandPresence",
        "domainCompetitorOnlyMentions",
        "domainCompetitorOnlyPresence",
        "promptsImpactedByDomain",
        "shareOfCitationDomain",
        "lastSeenAt",
        "firstSeenAt"
      ],
      "description": "Field to sort by. ALWAYS use appropriate sorting based on query intent: 'domainCitationCount' for most/least cited domains (with order='desc' for most, order='asc' for least), 'domainBrandMentions' for most/least URLs mentioning brand per domain (with order='desc' for most, order='asc' for least), 'domainBrandPresence' for brand presence ratio, 'domainCompetitorOnlyMentions' for domains where only competitors are mentioned (not the target brand), 'domainCompetitorOnlyPresence' for competitor-only presence ratio, 'shareOfCitationDomain' for highest/lowest share (with order='desc' for highest, order='asc' for lowest), 'lastSeenAt' for recent/oldest (with order='desc' for recent, order='asc' for oldest), 'firstSeenAt' for earliest/latest first appearance (with order='asc' for earliest, order='desc' for latest), 'domain' for alphabetical (with order='asc'). NEVER rely on defaults - always specify sort_by and order."
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort order: 'asc' for ascending or 'desc' for descending. ALWAYS specify: Use 'desc' for top/most/highest/recent, 'asc' for least/lowest/oldest/alphabetical. Must ALWAYS be provided when sort_by is used - never rely on defaults."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Domain or URL to validate (e.g. example.com or https://example.com/page)."
    },
    "paths": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional list of paths to validate (e.g. ['/','/culture','/voyages']). Defaults to ['/']."
    },
    "user_agents": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional list of user agents to validate. Defaults to ['*','GPTBot','Googlebot','PerplexityBot','ClaudeBot']."
    }
  },
  "required": [
    "domain"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {},
      "additionalProperties": true,
      "description": "Parsed robots.txt policy for a domain."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {},
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "additionalProperties": true
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "data"
      ],
      "description": "Static product documentation payload."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string",
      "description": "The UUID of the company (optional, defaults to context company_id; required for publisher context)"
    },
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand to scope to (optional; if provided with company_id, filters to that brand)"
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID)"
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., chatgpt, gemini, perplexity, googleaioverview)"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Highly cited prompts (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "classification": {
      "type": "string",
      "enum": [
        "standard",
        "evergreen"
      ],
      "description": "Optional dashboard classification. 'standard' = cycles with \u22651 unbranded prompt under a regular topic (Visibility scope). 'evergreen' = cycles with \u22651 branded prompt under an evergreen topic (Perception scope). Omit to return all cycles."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Iteration start dates (YYYY-MM-DD)."
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "data"
      ]
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "visibility",
        "engagement",
        "brand_perception",
        "commerce",
        "shopping",
        "real_traffic",
        "ads",
        "all"
      ],
      "description": "Which category of KPIs to show. 'visibility' for brand visibility metrics, 'engagement' for user engagement metrics, 'brand_perception' for brand perception scores, 'commerce' for commerce conversion metrics, 'shopping' for Product Tracker metrics, 'real_traffic' for panel-based real user metrics, 'ads' for Ads Analytics and Plan campaigns action labels, 'all' for all categories (default)."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "additionalProperties": true
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "data"
      ],
      "description": "Static product documentation payload."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Keywords count KPI."
      },
      "description": "the corresponding Meikai service"
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "page": {
      "type": "number",
      "description": "Page number (optional, default: 1)."
    },
    "page_size": {
      "type": "number",
      "description": "Items per page (optional, default: 500, max: 1000)."
    },
    "sort_by": {
      "type": "string",
      "description": "Sort field(s), comma-separated (optional). Allowed: keyword, keyword_share, mentions_current, mentions_prev, change_in_mentions_abs, change_in_mentions_pct, unique_users_current, unique_messages_current, repetition. Default: mentions_current."
    },
    "order": {
      "type": "string",
      "description": "Sort order(s), comma-separated to match sort_by (optional). 'asc' or 'desc'. Default: desc."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "page": {
      "type": "number",
      "description": "Page number (optional, default: 1)."
    },
    "page_size": {
      "type": "number",
      "description": "Items per page (optional, default: 10)."
    },
    "sort_by": {
      "type": "string",
      "description": "Sort field(s), comma-separated (optional). Allowed: keyword, keyword_share, mentions_current. Default: keyword_share."
    },
    "order": {
      "type": "string",
      "description": "Sort order(s), comma-separated to match sort_by (optional). 'asc' or 'desc'. Default: desc."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "min_mentions_current": {
      "type": "number",
      "description": "Minimum mentions in current period to include keyword (optional, default: 5)."
    },
    "page": {
      "type": "number",
      "description": "Page number (optional, default: 1)."
    },
    "page_size": {
      "type": "number",
      "description": "Items per page (optional, default: 10)."
    },
    "sort_by": {
      "type": "string",
      "description": "Sort field(s), comma-separated (optional). Allowed: keyword, change_in_mentions_abs, change_in_mentions_pct, mentions_current, mentions_prev. Default: change_in_mentions_pct."
    },
    "order": {
      "type": "string",
      "description": "Sort order(s), comma-separated to match sort_by (optional). 'asc' or 'desc'. Default: desc."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string",
      "description": "The UUID of the company (optional, defaults to context company_id; required for publisher context)"
    },
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand to scope to (optional; if provided with company_id, filters to that brand)"
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID)"
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., chatgpt, gemini, perplexity, googleaioverview)"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Lowly cited prompts (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "client": {
      "type": "string",
      "enum": [
        "chatgpt",
        "claude",
        "perplexity",
        "grok",
        "cursor",
        "custom",
        "all"
      ],
      "description": "Which client to focus on: chatgpt, claude, perplexity, grok, cursor, custom (generic MCP client), or all. Omit or 'all' for every client together."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "additionalProperties": true
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "data"
      ],
      "description": "Static product documentation payload."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID. Optional when MCP context provides the current brand."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic UUID (comma-separated UUIDs allowed)."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage."
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (maps to query param ai_platform), e.g. chatgpt, gemini, googleaioverview."
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (platform-specific)."
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter). Use getPromptPersonas to list valid ids for the brand."
    },
    "calculation_mode": {
      "type": "string",
      "enum": [
        "classic",
        "weighted"
      ],
      "description": "Calculation mode for visibility metrics. 'classic' uses unweighted calculations (default). 'weighted' applies Statcounter AI outbound-referral share weighting; this does not represent users or total AI usage."
    },
    "lens_competitor_name": {
      "type": "string",
      "description": "Competitor Lens: analyze this competitor instead of the monitored brand, keeping every other filter identical (same scope as the webapp's Competitor Lens selector). Accepts the competitor's name or any of its aliases, case-insensitive. Use getCompetitorMetrics to list the brand's competitors. Omit to analyze the brand itself."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "value": {
            "type": [
              "number",
              "null"
            ],
            "description": "Metric value for the current period."
          },
          "previous_value": {
            "type": [
              "number",
              "null"
            ],
            "description": "Metric value for the previous period of equal length."
          },
          "pct_change": {
            "type": [
              "number",
              "null"
            ],
            "description": "Relative change vs previous_value (decimal, e.g. 0.1 = +10%)."
          },
          "brand_mentions": {
            "type": [
              "number",
              "null"
            ],
            "description": "Weighted sum of target-brand mention counts in the period."
          },
          "responses_with_mentions": {
            "type": [
              "number",
              "null"
            ],
            "description": "Weighted count of responses that mention the target brand."
          }
        },
        "additionalProperties": false,
        "description": "Mentions card row: value = brand_mentions / responses_with_mentions (average mentions per response with a brand mention)."
      },
      "description": "Mentions card rows (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string",
      "description": "The UUID of the company (optional, defaults to context company_id; required for publisher context)"
    },
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand to scope to (optional; if provided with company_id, filters to that brand)"
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID)"
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., chatgpt, gemini, perplexity, googleaioverview)"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Top cited URLs (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "method": {
      "type": "string",
      "enum": [
        "script_tag",
        "gtm_client",
        "gtm_server",
        "all"
      ],
      "description": "Which installation method to show. 'script_tag' for simple script tag method, 'gtm_client' for Google Tag Manager client-side, 'gtm_server' for Google Tag Manager server-side, 'all' for all methods (default)."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "additionalProperties": true
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "data"
      ],
      "description": "Static product documentation payload."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "scope": {
      "type": "string",
      "enum": [
        "prompt_studio",
        "platform_ui",
        "all"
      ],
      "description": "Which language list to return. 'prompt_studio' = brand/content languages (Prompt Studio, Brand edit). 'platform_ui' = dashboard UI locales (user profile). 'all' = both lists with disambiguation (default)."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "additionalProperties": true
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "data"
      ],
      "description": "Static product documentation payload."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand to report eligibility for. Optional: omit for the catalogue alone. Defaults to the brand in context when there is one."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "additionalProperties": true
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "data"
      ],
      "description": "Static product documentation payload."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "prompt_id": {
      "type": "string",
      "description": "The UUID of the prompt. Extract this from the user's message when they mention a prompt ID."
    }
  },
  "required": [
    "prompt_id"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Prompt detail (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "prompt_id": {
      "type": "string",
      "description": "The UUID of the prompt. Extract this from the user's message when they mention a prompt ID."
    }
  },
  "required": [
    "prompt_id"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Prompt detail (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID)"
    },
    "lens_competitor_name": {
      "type": "string",
      "description": "Competitor Lens: analyze this competitor instead of the monitored brand, keeping every other filter identical (same scope as the webapp's Competitor Lens selector). Accepts the competitor's name or any of its aliases, case-insensitive. Use getCompetitorMetrics to list the brand's competitors. Omit to analyze the brand itself."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage"
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., 'chatgpt', 'gemini', 'perplexity', 'grok', 'copilot', 'googleaioverview')"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g., 'gpt-5', 'gemini-3.5-flash', 'grok-3')"
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID (assigned active regular prompts)."
    },
    "search": {
      "type": "string",
      "description": "Search query for prompt text (optional)"
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "last_run_date",
        "mentions",
        "visibility_rate",
        "share_of_voice",
        "share_of_voice_position",
        "runs_count",
        "latest_response_text_trunc",
        "last_five_responses",
        "prompt_text",
        "topic_text",
        "funnel",
        "competitors",
        "citations",
        "presence",
        "platforms"
      ],
      "description": "Field to sort by (optional). Valid values: last_run_date, mentions, visibility_rate, share_of_voice, share_of_voice_position, runs_count, latest_response_text_trunc, last_five_responses, prompt_text, topic_text, funnel, competitors, citations, presence, platforms. Default: mentions (desc). For perception questions, use Brand Perception tools instead of sorting by sentiment."
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort order: 'asc' or 'desc' (optional). Default: desc"
    },
    "page": {
      "type": "number",
      "description": "Page number for pagination"
    },
    "page_size": {
      "type": "number",
      "description": "Number of prompts per page (optional, default: 20, max: 50)"
    },
    "tag_id": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ],
      "description": "Filter by tag UUID(s). Accepts a single UUID, a comma-separated string, or an array of UUIDs. OR within one namespace and AND across namespaces (same semantics as REST tag_id)."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "format": "uuid",
      "description": "Brand UUID. Optional when context provides the current brand."
    },
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string"
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ]
    },
    "platform": {
      "type": "string"
    },
    "model": {
      "type": "string"
    },
    "persona_id": {
      "type": "string",
      "description": "Prompt Studio persona UUID (assigned active regular prompts)."
    },
    "search": {
      "type": "string"
    },
    "include_fanouts": {
      "type": "boolean",
      "description": "Include fanout aggregates (default false)"
    },
    "include_competitors": {
      "type": "boolean"
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "last_run_date",
        "share_of_voice",
        "mentions",
        "citations"
      ],
      "description": "Sort field (default: last_run_date). 'visibility' and 'avg_queries_per_response' are not supported in V1."
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "page": {
      "type": "number"
    },
    "page_size": {
      "type": "number"
    }
  }
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "additionalProperties": true,
          "description": "Prompt performance breakdown (rows, pagination, optional fanouts). the corresponding Meikai service."
        }
      },
      "additionalProperties": true,
      "required": [
        "success",
        "data"
      ]
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Optional Prompt Studio iteration start date (YYYY-MM-DD). Restricts to personas with prompt assignments in that iteration. Get valid values from getIterationStartDates."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            },
            "additionalProperties": false,
            "required": [
              "id",
              "name"
            ]
          },
          "description": "Prompt Studio personas available for filtering."
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "data"
      ]
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "prompt_id": {
      "type": "string",
      "description": "The UUID of the prompt (optional)"
    },
    "lens_competitor_name": {
      "type": "string",
      "description": "Competitor Lens: analyze this competitor instead of the monitored brand, keeping every other filter identical (same scope as the webapp's Competitor Lens selector). Accepts the competitor's name or any of its aliases, case-insensitive. Use getCompetitorMetrics to list the brand's competitors. Omit to analyze the brand itself."
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., 'chatgpt', 'gemini', 'perplexity', 'grok', 'copilot', 'openai', 'google-ai-mode', 'googleaioverview'). Common values: chatgpt, gemini, perplexity, grok, copilot, googleaioverview"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g., 'gpt-5', 'gpt-5-t-mini', 'gemini-3.5-flash', 'grok-3', 'grok-4-auto', 'perplexity'). Model names vary by platform"
    },
    "page": {
      "type": "number",
      "description": "Page number for pagination"
    },
    "page_size": {
      "type": "number",
      "description": "Number of responses per page. Maximum allowed is 100 to prevent token limit issues. Use values up to 100 when user wants comprehensive data or 'all' results. Default is 20."
    }
  },
  "required": [
    "brand_id"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID (defaults to the context brand)."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Prompt Studio monthly generation quota state (allowed, limit, remaining, resets_at)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "Prompt Studio session UUID."
    },
    "field_name": {
      "type": "string",
      "enum": [
        "personas_data",
        "topics_data",
        "prompts_data"
      ],
      "description": "Which field's history to return."
    }
  },
  "required": [
    "session_id",
    "field_name"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {},
      "additionalProperties": true,
      "description": "Prompt Studio field version history (session_id, field_name, history)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "Prompt Studio session UUID."
    }
  },
  "required": [
    "session_id"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {},
      "additionalProperties": true,
      "description": "Prompt Studio brand-analysis prompt audit payload (company administrators only)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "Prompt Studio session/version UUID. Omit to load the brand's current version (requires brand_id or context brand)."
    },
    "brand_id": {
      "type": "string",
      "description": "Brand UUID. Used when session_id is omitted to return the current version; defaults to the context brand."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Prompt Studio session/version state (current_step, brand analysis, personas, topics, prompts, citations, progress). the corresponding Meikai service or /current/."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). PREFERRED over search when filtering by topic - use this when you have topic_id from getTopics or user message."
    },
    "lens_competitor_name": {
      "type": "string",
      "description": "Competitor Lens: analyze this competitor instead of the monitored brand, keeping every other filter identical (same scope as the webapp's Competitor Lens selector). Accepts the competitor's name or any of its aliases, case-insensitive. Use getCompetitorMetrics to list the brand's competitors. Omit to analyze the brand itself."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage"
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., 'chatgpt', 'gemini', 'perplexity', 'grok', 'copilot', 'openai', 'google-ai-mode', 'googleaioverview'). Common values: chatgpt, gemini, perplexity, grok, copilot, googleaioverview"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g., 'gpt-5', 'gpt-5-t-mini', 'gemini-3.5-flash', 'grok-3', 'grok-4-auto', 'perplexity'). Model names vary by platform"
    },
    "search": {
      "type": "string",
      "description": "Search query for prompt text. Use ONLY when you don't have topic_id filter available. Prefer topic_id filter over search when possible."
    },
    "page": {
      "type": "number",
      "description": "Page number for pagination"
    },
    "page_size": {
      "type": "number",
      "description": "Number of prompts per page. Maximum allowed is 50 to prevent token limit issues. When using topic_id filter, results are typically under 50 prompts per topic, so page_size of 50 is usually sufficient. Use values up to 50 when user wants comprehensive data, 'all' results, or analysis of top/best/worst items. Default is 20."
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "last_run_date",
        "mentions",
        "visibility_rate",
        "share_of_voice",
        "share_of_voice_position",
        "runs_count",
        "latest_response_text_trunc",
        "last_five_responses",
        "prompt_text",
        "topic_text",
        "funnel",
        "competitors",
        "citations",
        "presence",
        "platforms",
        "brand_position"
      ],
      "description": "Field to sort by. ALWAYS use appropriate sorting based on query intent: 'share_of_voice' for top/best/worst prompts (with order='desc' for top, order='asc' for worst), 'mentions' for most/least mentioned (with order='desc' for most, order='asc' for least), 'last_run_date' for recent/oldest (with order='desc' for recent, order='asc' for oldest), 'prompt_text' for alphabetical (with order='asc'). NEVER rely on defaults - always specify sort_by and order. Valid values: last_run_date, mentions, visibility_rate, share_of_voice, share_of_voice_position, runs_count, latest_response_text_trunc, last_five_responses, prompt_text, topic_text, funnel, competitors, citations, presence, platforms, brand_position. For perception questions, use Brand Perception tools instead of sorting by sentiment."
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort order: 'asc' for ascending or 'desc' for descending. ALWAYS specify: Use 'desc' for top/best/highest/most/recent, 'asc' for worst/lowest/least/oldest/alphabetical. Must ALWAYS be provided when sort_by is used - never rely on defaults."
    },
    "tag_id": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ],
      "description": "Filter by tag UUID(s). Accepts a single UUID, a comma-separated string, or an array of UUIDs. OR within one namespace and AND across namespaces (same semantics as REST tag_id)."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "url": {
      "type": "string",
      "description": "Citation URL to match (UTM/tracking params are stripped before lookup)."
    },
    "domain": {
      "type": "string",
      "description": "Citation domain to match (alternative to url)."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Optional topic UUID filter."
    },
    "prompt_id": {
      "type": "string",
      "description": "Optional prompt UUID filter (comma-separated list supported)."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Optional funnel stage filter."
    },
    "platform": {
      "type": "string",
      "description": "Optional AI platform filter (e.g. chatgpt, gemini)."
    },
    "model": {
      "type": "string",
      "description": "Optional AI model filter."
    },
    "page": {
      "type": "number",
      "description": "Page number for pagination (default 1)."
    },
    "page_size": {
      "type": "number",
      "description": "Prompts per page (default 50, max 200)."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID)"
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID (same as Brand Monitor persona filter)."
    },
    "prompt_ids": {
      "type": "string",
      "description": "Optional comma-separated prompt UUIDs to restrict fanouts to a cluster or prompt subset"
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage"
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g., 'chatgpt', 'gemini', 'perplexity', 'grok', 'copilot', 'googleaioverview')"
    },
    "search": {
      "type": "string",
      "description": "Search in prompt text or fanout query text (case-insensitive)"
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "total_queries",
        "responses_with_web_search",
        "avg_queries_per_response",
        "fanouts_count",
        "prompt_text",
        "prompt_id"
      ],
      "description": "Field to sort prompts by (default: total_queries)"
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort order (default: desc)"
    },
    "page": {
      "type": "number",
      "description": "Page number for pagination (default: 1)"
    },
    "page_size": {
      "type": "number",
      "description": "Items per page. Maximum allowed is 200 to match the backend API ceiling."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Query fanouts by prompt (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {},
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "additionalProperties": true
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "data"
      ],
      "description": "Static product documentation payload."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "dimension": {
      "type": "string",
      "enum": [
        "models",
        "apps",
        "devices",
        "languages",
        "subscriptions"
      ],
      "description": "Dimension to breakdown by: 'models' (model usage), 'apps' (app usage), 'devices' (device breakdown), 'languages' (language breakdown), 'subscriptions' (subscription breakdown)"
    },
    "start_month": {
      "type": "string",
      "description": "Start month in YYYY-MM format (optional). If not provided, uses latest available month only. If only start_month is provided, uses it as both start and end (single month)."
    },
    "end_month": {
      "type": "string",
      "description": "End month in YYYY-MM format (optional). If not provided, uses latest available month only. If only end_month is provided, uses it as both start and end (single month)."
    },
    "limit": {
      "type": "number",
      "description": "Number of results to return (optional, default: 10, max: 20)"
    },
    "brand_id": {
      "type": "string",
      "description": "Brand UUID (optional). If provided, automatically filters by the brand's country."
    }
  },
  "required": [
    "dimension"
  ]
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Real traffic breakdown by dimension."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "start_month": {
      "type": "string",
      "description": "Start month in YYYY-MM format (optional). If not provided, uses latest available month only. If only start_month is provided, uses it as both start and end (single month)."
    },
    "end_month": {
      "type": "string",
      "description": "End month in YYYY-MM format (optional). If not provided, uses latest available month only. If only end_month is provided, uses it as both start and end (single month)."
    },
    "demographic_dimension": {
      "type": "string",
      "enum": [
        "age",
        "gender",
        "income",
        "education",
        "employment",
        "marital_status"
      ],
      "description": "Demographic dimension to breakdown by (optional, defaults to all). Options: 'age' (age_band), 'gender', 'income' (household_income), 'education', 'employment', 'marital_status'"
    },
    "brand_id": {
      "type": "string",
      "description": "Brand UUID (optional). If provided, automatically filters by the brand's country."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Demographics (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "start_month": {
      "type": "string",
      "description": "Start month in YYYY-MM format (optional). If not provided, uses latest available month only. If only start_month is provided, uses it as both start and end (single month)."
    },
    "end_month": {
      "type": "string",
      "description": "End month in YYYY-MM format (optional). If not provided, uses latest available month only. If only end_month is provided, uses it as both start and end (single month)."
    },
    "brand_id": {
      "type": "string",
      "description": "Brand UUID (optional). If provided, automatically filters by the brand's country."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {},
      "additionalProperties": true,
      "description": "Panelists and events overview (the corresponding Meikai service and events/)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "start_month": {
      "type": "string",
      "description": "Start month in YYYY-MM format (optional). If not provided, uses latest available month only. If only start_month is provided, uses it as both start and end (single month)."
    },
    "end_month": {
      "type": "string",
      "description": "End month in YYYY-MM format (optional). If not provided, uses latest available month only. If only end_month is provided, uses it as both start and end (single month)."
    },
    "limit": {
      "type": "number",
      "description": "Number of sample messages to return (optional, default: 5, max: 10)"
    },
    "platform": {
      "type": "string",
      "description": "Filter by platform (optional, e.g., 'chatgpt', 'perplexity', 'googleaioverview')"
    },
    "model": {
      "type": "string",
      "description": "Filter by model (optional, e.g., 'gpt-4', 'gemini-3.5-flash')"
    },
    "brand_id": {
      "type": "string",
      "description": "Brand UUID (optional). If provided, automatically filters by the brand's country."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Sample messages metadata (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from getTopics results or user message."
    },
    "iteration_index": {
      "type": "integer",
      "minimum": 1,
      "description": "Filter by Standard Prompt Studio cycle using oldest-first indexing: 1 is the oldest cycle, 2 is the second oldest, etc., matching getIterationStartDates with classification='standard'. Use this for requests such as 'recommendations for cycle 2'."
    },
    "iteration_start_date": {
      "type": "string",
      "format": "date",
      "description": "Filter by regular Prompt Studio cycle start date (YYYY-MM-DD). If iteration_index is also provided, both values must identify the same cycle."
    },
    "recommendation_type": {
      "type": "string",
      "enum": [
        "earned_media",
        "content_update",
        "new_content",
        "pdp",
        "shared_media"
      ],
      "description": "Filter by recommendation type: 'earned_media' (OffSite agent - PR/media opportunities), 'content_update' (OnSite agent - update existing content), 'new_content' (OnSite agent - create new content), 'pdp' (PDP agent - product detail page recommendations), 'shared_media' (Shared Media agent - YouTube, TikTok, Instagram, LinkedIn, Pinterest)"
    },
    "agent_type": {
      "type": "string",
      "enum": [
        "onsite",
        "offsite",
        "shared_media",
        "pdp"
      ],
      "description": "Filter by agent type: 'onsite' (content recommendations for owned media), 'offsite' (earned media recommendations), 'shared_media' (shared media recommendations - YouTube, TikTok, Instagram, LinkedIn, Pinterest), 'pdp' (product detail page recommendations)"
    },
    "status": {
      "type": "string",
      "enum": [
        "not_started",
        "in_progress",
        "done",
        "all"
      ],
      "description": "Filter by recommendation status: 'not_started' (not yet started), 'in_progress' (work in progress), 'done' (completed), 'all' (all statuses)"
    },
    "tier": {
      "type": "string",
      "description": "Filter by priority tier. Can be a single tier or comma-separated list: 'very_high' (top 5% - highest priority, urgent), 'high' (top 10% - high priority), 'medium' (top 25% - opportunity), 'strategic_debt' (above median - long-term strategic value), 'deprioritized' (below median - hygiene). Example: 'very_high,high' to get both very high and high priority recommendations."
    },
    "search": {
      "type": "string",
      "maxLength": 200,
      "description": "Search in plan titles, topic names, summaries, and nested recommendation page names, URLs, and domains"
    },
    "domain": {
      "type": "string",
      "description": "Filter to plans with at least one recommendation on this publisher domain (normalized hostname, e.g. runnersworld.com). Response recommendations are pruned to matching items. Combine with recommendation_type=earned_media and activation filters to inspect activation_profile for one domain."
    },
    "activation_partner_id": {
      "type": "string",
      "description": "Filter earned media recommendations by activation partner UUID."
    },
    "activation_route": {
      "type": "string",
      "description": "Filter earned media recommendations by activation route. Single value or comma-separated list. Allowed: sponsored_editorial, direct_media_buy, editorial_outreach, product_review, affiliate_commerce, unknown."
    },
    "activation_market": {
      "type": "string",
      "description": "Filter earned media recommendations by activation market ISO2 code."
    },
    "activation_needs_review": {
      "type": "boolean",
      "description": "Filter earned media recommendations by activation-profile review status."
    },
    "page": {
      "type": "number",
      "description": "Page number for pagination"
    },
    "page_size": {
      "type": "number",
      "description": "Number of recommendations per page. Maximum allowed is 100 to prevent token limit issues. Use values up to 100 when user wants comprehensive data or 'all' results. Default is 50."
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "created_at",
        "plan_title",
        "priority_tier",
        "progress_percentage"
      ],
      "description": "Field to sort by. ALWAYS use appropriate sorting based on query intent: 'priority_tier' for highest/lowest priority (with order='desc' for highest priority - very_high first, order='asc' for lowest priority), 'created_at' for newest/oldest (with order='desc' for newest, order='asc' for oldest), 'progress_percentage' for most/least progress (with order='desc' for most, order='asc' for least), 'plan_title' for alphabetical sorting. NEVER rely on defaults - always specify sort_by and order."
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort order: 'asc' for ascending or 'desc' for descending. ALWAYS specify: Use 'desc' for highest/newest/most, 'asc' for lowest/oldest/least. Must ALWAYS be provided when sort_by is used."
    },
    "include_summary": {
      "type": "boolean",
      "description": "When true, adds data.summary with counts by priority_tier, agent_type, and recommendation_type for the filtered set."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "properties": {
            "plans": {
              "type": "array",
              "items": {
                "type": "object",
                "additionalProperties": true,
                "description": "Analytics result row."
              },
              "description": "Recommendation plans for the selected page."
            },
            "summary": {
              "type": "object",
              "additionalProperties": true,
              "description": "Optional recommendation counts for the filtered result."
            },
            "cycle": {
              "type": "object",
              "additionalProperties": true,
              "description": "Optional Prompt Studio cycle metadata."
            }
          },
          "additionalProperties": true,
          "required": [
            "plans"
          ],
          "description": "Recommendation plans and optional aggregate metadata."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, total_pages)."
        }
      },
      "additionalProperties": true,
      "required": [
        "success",
        "data",
        "pagination"
      ],
      "description": "Paginated recommendation plans response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID (XOR with company_id)."
    },
    "company_id": {
      "type": "string",
      "description": "Publisher company UUID for corporate website pixel (XOR with brand_id)."
    },
    "start_date": {
      "type": "string",
      "description": "Start date in YYYY-MM-DD format (required)"
    },
    "end_date": {
      "type": "string",
      "description": "End date in YYYY-MM-DD format (required)"
    },
    "platform": {
      "type": "string",
      "enum": [
        "OpenAI",
        "Perplexity",
        "Anthropic",
        "Gemini",
        "Copilot",
        "You.com",
        "DeepSeek",
        "Grok",
        "Mistral",
        "Qwen",
        "Google Search",
        "Bing"
      ],
      "description": "Optional platform filter. If not provided, returns data for all platforms."
    }
  },
  "required": [
    "start_date",
    "end_date"
  ]
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Referral data (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "response_id": {
      "type": "string",
      "description": "The UUID of the response. Extract this from the user's message when they mention a response ID."
    },
    "lens_competitor_name": {
      "type": "string",
      "description": "Competitor Lens: analyze this competitor instead of the monitored brand, keeping every other filter identical (same scope as the webapp's Competitor Lens selector). Accepts the competitor's name or any of its aliases, case-insensitive. Use getCompetitorMetrics to list the brand's competitors. Omit to analyze the brand itself."
    }
  },
  "required": [
    "response_id"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Response detail (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date in YYYY-MM-DD format (optional, defaults to last 7 days)"
    },
    "end_date": {
      "type": "string",
      "description": "End date in YYYY-MM-DD format (optional, defaults to the server's last complete day (yesterday))"
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from the user's message or from previous tool results (e.g., from getTopics)."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage"
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g. 'chatgpt', 'gemini', 'googleaioverview')"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g. 'gpt-5', 'gemini-3.5-flash'). Model names vary by platform"
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter). Use getPromptPersonas to list valid ids for the brand."
    },
    "calculation_mode": {
      "type": "string",
      "enum": [
        "classic",
        "weighted"
      ],
      "description": "Calculation mode for visibility metrics. 'classic' uses unweighted calculations (default). 'weighted' applies Statcounter AI outbound-referral share weighting; this does not represent users or total AI usage."
    },
    "lens_competitor_name": {
      "type": "string",
      "description": "Competitor Lens: analyze this competitor instead of the monitored brand, keeping every other filter identical (same scope as the webapp's Competitor Lens selector). Accepts the competitor's name or any of its aliases, case-insensitive. Use getCompetitorMetrics to list the brand's competitors. Omit to analyze the brand itself."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "value": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total responses in the current period."
          },
          "promptCount": {
            "type": [
              "number",
              "null"
            ],
            "description": "Distinct prompts in the period."
          },
          "modelCount": {
            "type": [
              "number",
              "null"
            ],
            "description": "Distinct models in the period."
          },
          "total_prompts": {
            "type": "integer",
            "minimum": 0,
            "description": "Active unbranded prompts in the selected scope."
          }
        },
        "additionalProperties": true,
        "description": "Responses count card (single object, not period comparison)."
      },
      "description": "Responses count card (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date in YYYY-MM-DD format (optional, defaults to last 7 days)"
    },
    "end_date": {
      "type": "string",
      "description": "End date in YYYY-MM-DD format (optional, defaults to the server's last complete day (yesterday))"
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from the user's message or from previous tool results (e.g., from getTopics)."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage"
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g. 'chatgpt', 'gemini', 'googleaioverview')"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g. 'gpt-5', 'gemini-3.5-flash'). Model names vary by platform"
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter). Use getPromptPersonas to list valid ids for the brand."
    },
    "calculation_mode": {
      "type": "string",
      "enum": [
        "classic",
        "weighted"
      ],
      "description": "Calculation mode for visibility metrics. 'classic' uses unweighted calculations (default). 'weighted' applies Statcounter AI outbound-referral share weighting; this does not represent users or total AI usage."
    },
    "lens_competitor_name": {
      "type": "string",
      "description": "Competitor Lens: analyze this competitor instead of the monitored brand, keeping every other filter identical (same scope as the webapp's Competitor Lens selector). Accepts the competitor's name or any of its aliases, case-insensitive. Use getCompetitorMetrics to list the brand's competitors. Omit to analyze the brand itself."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Share of model breakdown (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date in YYYY-MM-DD format (optional, defaults to last 7 days)"
    },
    "end_date": {
      "type": "string",
      "description": "End date in YYYY-MM-DD format (optional, defaults to the server's last complete day (yesterday))"
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from the user's message or from previous tool results (e.g., from getTopics)."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage"
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g. 'chatgpt', 'gemini', 'googleaioverview')"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g. 'gpt-5', 'gemini-3.5-flash'). Model names vary by platform"
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter). Use getPromptPersonas to list valid ids for the brand."
    },
    "calculation_mode": {
      "type": "string",
      "enum": [
        "classic",
        "weighted"
      ],
      "description": "Calculation mode for visibility metrics. 'classic' uses unweighted calculations (default). 'weighted' applies Statcounter AI outbound-referral share weighting; this does not represent users or total AI usage."
    },
    "lens_competitor_name": {
      "type": "string",
      "description": "Competitor Lens: analyze this competitor instead of the monitored brand, keeping every other filter identical (same scope as the webapp's Competitor Lens selector). Accepts the competitor's name or any of its aliases, case-insensitive. Use getCompetitorMetrics to list the brand's competitors. Omit to analyze the brand itself."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Share of platform breakdown (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date in YYYY-MM-DD format (optional, defaults to last 7 days)"
    },
    "end_date": {
      "type": "string",
      "description": "End date in YYYY-MM-DD format (optional, defaults to the server's last complete day (yesterday))"
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from the user's message or from previous tool results (e.g., from getTopics)."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage"
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g. 'chatgpt', 'gemini', 'googleaioverview')"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g. 'gpt-5', 'gemini-3.5-flash'). Model names vary by platform"
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter). Use getPromptPersonas to list valid ids for the brand."
    },
    "calculation_mode": {
      "type": "string",
      "enum": [
        "classic",
        "weighted"
      ],
      "description": "Calculation mode for visibility metrics. 'classic' uses unweighted calculations (default). 'weighted' applies Statcounter AI outbound-referral share weighting; this does not represent users or total AI usage."
    },
    "lens_competitor_name": {
      "type": "string",
      "description": "Competitor Lens: analyze this competitor instead of the monitored brand, keeping every other filter identical (same scope as the webapp's Competitor Lens selector). Accepts the competitor's name or any of its aliases, case-insensitive. Use getCompetitorMetrics to list the brand's competitors. Omit to analyze the brand itself."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Share of voice breakdown (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date in YYYY-MM-DD format (optional, defaults to last 7 days)"
    },
    "end_date": {
      "type": "string",
      "description": "End date in YYYY-MM-DD format (optional, defaults to the server's last complete day (yesterday))"
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from the user's message or from previous tool results (e.g., from getTopics)."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage"
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g. 'chatgpt', 'gemini', 'googleaioverview')"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g. 'gpt-5', 'gemini-3.5-flash'). Model names vary by platform"
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter). Use getPromptPersonas to list valid ids for the brand."
    },
    "calculation_mode": {
      "type": "string",
      "enum": [
        "classic",
        "weighted"
      ],
      "description": "Calculation mode for visibility metrics. 'classic' uses unweighted calculations (default). 'weighted' applies Statcounter AI outbound-referral share weighting; this does not represent users or total AI usage."
    },
    "lens_competitor_name": {
      "type": "string",
      "description": "Competitor Lens: analyze this competitor instead of the monitored brand, keeping every other filter identical (same scope as the webapp's Competitor Lens selector). Accepts the competitor's name or any of its aliases, case-insensitive. Use getCompetitorMetrics to list the brand's competitors. Omit to analyze the brand itself."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "value": {
            "type": [
              "number",
              "null"
            ],
            "description": "Metric value for the current period."
          },
          "previous_value": {
            "type": [
              "number",
              "null"
            ],
            "description": "Metric value for the previous period of equal length."
          },
          "pct_change": {
            "type": [
              "number",
              "null"
            ],
            "description": "Relative change vs previous_value (decimal, e.g. 0.1 = +10%)."
          },
          "brand_mentions": {
            "type": [
              "number",
              "null"
            ],
            "description": "Target brand mention count (weighted)."
          },
          "total_mentions": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total mentions across target brand and competitors (weighted)."
          }
        },
        "additionalProperties": false,
        "description": "Share-of-voice card row: value = brand_mentions / total_mentions."
      },
      "description": "Share-of-voice card rows (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from getTopics or user message."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Brand comparison (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from getTopics or user message."
    },
    "granularity": {
      "type": "string",
      "enum": [
        "day",
        "week"
      ],
      "description": "Time granularity: 'day' or 'week' (optional, default: 'day')."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Positioning (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from getTopics or user message."
    },
    "granularity": {
      "type": "string",
      "enum": [
        "day",
        "week"
      ],
      "description": "Time granularity: 'day' or 'week' (optional, default: 'day')."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Pricing (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID. Optional when MCP context provides the current brand."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic UUID; comma-separated UUIDs are accepted."
    },
    "funnel": {
      "type": "string",
      "description": "Filter by funnel stage; comma-separated awareness, consideration, and conversion values are accepted."
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform; comma-separated platform identifiers are accepted. Retailer Shopping defaults to chatgpt."
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID; comma-separated UUIDs are accepted. Use getPromptPersonas to list valid values."
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Filter by Prompt Studio cycle start date (YYYY-MM-DD)."
    },
    "brand_category": {
      "type": "string",
      "enum": [
        "target_brand",
        "competitor",
        "all"
      ],
      "description": "Filter by brand category (optional, default: 'all')."
    },
    "page": {
      "type": "number",
      "description": "Page number (optional, default: 1)."
    },
    "page_size": {
      "type": "number",
      "description": "Items per page (optional, default: 20, max: 100)."
    },
    "search": {
      "type": "string",
      "description": "Search in product_title, product_link, matched_brand, manufacturer_brand, or retailer (optional)."
    },
    "retailer": {
      "type": "string",
      "description": "Filter by retailer name contains (optional)."
    },
    "retailer_key": {
      "type": "string",
      "description": "Exact retailer identity key returned by getShoppingRetailerCompetition. Cannot be combined with retailer."
    },
    "monitoring_category_key": {
      "type": "string",
      "description": "Retailer-only category key returned by getShoppingRetailerCategories, including the literal unclassified."
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "appearance_count",
        "avg_position",
        "avg_rating",
        "total_reviews",
        "product_title",
        "brand_category",
        "matched_brand",
        "manufacturer_brand",
        "retailer"
      ],
      "description": "Sort field (optional, default: 'appearance_count')."
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort order (optional, default: 'desc')."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Product list (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from getTopics or user message."
    },
    "brand_category": {
      "type": "string",
      "enum": [
        "target_brand",
        "competitor",
        "all"
      ],
      "description": "Filter by brand category (optional, default: 'all')."
    },
    "page": {
      "type": "number",
      "description": "Page number (optional, default: 1)."
    },
    "page_size": {
      "type": "number",
      "description": "Items per page (optional, default: 20, max: 100)."
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "date",
        "position",
        "rating",
        "reviews",
        "product_title"
      ],
      "description": "Sort field (optional, default: 'date')."
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort order (optional, default: 'desc')."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from getTopics or user message."
    },
    "granularity": {
      "type": "string",
      "enum": [
        "day",
        "week"
      ],
      "description": "Time granularity: 'day' or 'week' (optional, default: 'day')."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Reputation (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID. Optional when MCP context provides the current brand."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic UUID; comma-separated UUIDs are accepted."
    },
    "funnel": {
      "type": "string",
      "description": "Filter by funnel stage; comma-separated awareness, consideration, and conversion values are accepted."
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform; comma-separated platform identifiers are accepted. Retailer Shopping defaults to chatgpt."
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID; comma-separated UUIDs are accepted. Use getPromptPersonas to list valid values."
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Filter by Prompt Studio cycle start date (YYYY-MM-DD)."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "monitoring_category_key": {
                "type": "string"
              },
              "monitoring_category_ids": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "name": {
                "type": "string"
              },
              "definition": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "rank": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "recommended_product_count": {
                "type": "integer",
                "minimum": 0
              },
              "shopping_response_count": {
                "type": "integer",
                "minimum": 0
              },
              "shopping_presence_pct": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Category Shopping responses with a target-retailer offer, in percent."
              },
              "product_coverage_pct": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Category product-card occurrences with a target-retailer offer, in percent."
              },
              "offer_share_pct": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Target-retailer offers divided by named offers in the category, in percent."
              },
              "price_win_rate_pct": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Target price wins divided by exact-card same-currency comparisons, in percent."
              },
              "price_comparison_count": {
                "type": "integer",
                "minimum": 0
              },
              "median_target_price_gap_pct": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Median target price gap versus the best competitor across comparable product cards, in percent."
              },
              "responses_with_target_retailer": {
                "type": "integer",
                "minimum": 0
              },
              "product_occurrence_count": {
                "type": "integer",
                "minimum": 0
              },
              "covered_product_occurrence_count": {
                "type": "integer",
                "minimum": 0
              },
              "named_offer_count": {
                "type": "integer",
                "minimum": 0
              },
              "target_retailer_offer_count": {
                "type": "integer",
                "minimum": 0
              },
              "target_price_win_count": {
                "type": "integer",
                "minimum": 0
              }
            },
            "additionalProperties": true,
            "required": [
              "monitoring_category_key",
              "monitoring_category_ids",
              "name",
              "definition",
              "rank",
              "recommended_product_count",
              "shopping_response_count",
              "shopping_presence_pct",
              "product_coverage_pct",
              "offer_share_pct",
              "price_win_rate_pct",
              "price_comparison_count",
              "median_target_price_gap_pct",
              "responses_with_target_retailer",
              "product_occurrence_count",
              "covered_product_occurrence_count",
              "named_offer_count",
              "target_retailer_offer_count",
              "target_price_win_count"
            ]
          },
          "description": "Retailer Shopping category-performance rows."
        },
        "classification": {
          "type": "object",
          "properties": {
            "classifiedProductCount": {
              "type": "integer",
              "minimum": 0
            },
            "unclassifiedProductCount": {
              "type": "integer",
              "minimum": 0
            },
            "pendingProductCount": {
              "type": "integer",
              "minimum": 0
            },
            "complete": {
              "type": "boolean"
            }
          },
          "additionalProperties": false,
          "required": [
            "classifiedProductCount",
            "unclassifiedProductCount",
            "pendingProductCount",
            "complete"
          ]
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "data",
        "classification"
      ]
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID. Optional when MCP context provides the current brand."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic UUID; comma-separated UUIDs are accepted."
    },
    "funnel": {
      "type": "string",
      "description": "Filter by funnel stage; comma-separated awareness, consideration, and conversion values are accepted."
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform; comma-separated platform identifiers are accepted. Retailer Shopping defaults to chatgpt."
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID; comma-separated UUIDs are accepted. Use getPromptPersonas to list valid values."
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Filter by Prompt Studio cycle start date (YYYY-MM-DD)."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "retailer_key": {
            "type": "string"
          },
          "retailer": {
            "type": "string"
          },
          "is_target_retailer": {
            "type": "boolean"
          },
          "offer_count": {
            "type": "integer",
            "minimum": 0
          },
          "offer_share_pct": {
            "type": [
              "number",
              "null"
            ],
            "description": "Retailer offers divided by all named-retailer offers, in percent."
          },
          "product_occurrence_count": {
            "type": "integer",
            "minimum": 0
          },
          "shared_product_occurrence_count": {
            "type": "integer",
            "minimum": 0
          },
          "competitor_only_product_occurrence_count": {
            "type": "integer",
            "minimum": 0
          },
          "price_comparison_count": {
            "type": "integer",
            "minimum": 0
          },
          "target_price_win_count": {
            "type": "integer",
            "minimum": 0
          },
          "target_price_win_rate_pct": {
            "type": [
              "number",
              "null"
            ],
            "description": "Target-retailer wins divided by exact-card same-currency comparisons, in percent; ties count as wins."
          }
        },
        "additionalProperties": true,
        "required": [
          "retailer_key",
          "retailer",
          "is_target_retailer",
          "offer_count",
          "offer_share_pct",
          "product_occurrence_count",
          "shared_product_occurrence_count",
          "competitor_only_product_occurrence_count",
          "price_comparison_count",
          "target_price_win_count",
          "target_price_win_rate_pct"
        ]
      },
      "description": "Named-retailer offer, overlap, and target-relative price rows."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID. Optional when MCP context provides the current brand."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic UUID; comma-separated UUIDs are accepted."
    },
    "funnel": {
      "type": "string",
      "description": "Filter by funnel stage; comma-separated awareness, consideration, and conversion values are accepted."
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform; comma-separated platform identifiers are accepted. Retailer Shopping defaults to chatgpt."
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID; comma-separated UUIDs are accepted. Use getPromptPersonas to list valid values."
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Filter by Prompt Studio cycle start date (YYYY-MM-DD)."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string"
          },
          "eligible_response_count": {
            "type": "integer",
            "minimum": 0
          },
          "shopping_response_count": {
            "type": "integer",
            "minimum": 0
          },
          "retailer_visible_response_count": {
            "type": "integer",
            "minimum": 0
          },
          "total_product_occurrence_count": {
            "type": "integer",
            "minimum": 0
          },
          "covered_product_occurrence_count": {
            "type": "integer",
            "minimum": 0
          },
          "competitor_only_product_occurrence_count": {
            "type": "integer",
            "minimum": 0
          },
          "named_offer_count": {
            "type": "integer",
            "minimum": 0
          },
          "target_offer_count": {
            "type": "integer",
            "minimum": 0
          },
          "offer_share_pct": {
            "type": [
              "number",
              "null"
            ],
            "description": "Target-retailer offers divided by named-retailer offers, in percent."
          },
          "product_coverage_pct": {
            "type": [
              "number",
              "null"
            ],
            "description": "Product-card occurrences with the target retailer divided by all product-card occurrences, in percent."
          }
        },
        "additionalProperties": true,
        "required": [
          "date",
          "eligible_response_count",
          "shopping_response_count",
          "retailer_visible_response_count",
          "total_product_occurrence_count",
          "covered_product_occurrence_count",
          "competitor_only_product_occurrence_count",
          "named_offer_count",
          "target_offer_count",
          "offer_share_pct",
          "product_coverage_pct"
        ]
      },
      "description": "Daily retailer Shopping trend and availability rows."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from getTopics or user message."
    },
    "granularity": {
      "type": "string",
      "enum": [
        "day",
        "week"
      ],
      "description": "Time granularity: 'day' or 'week' (optional, default: 'day')."
    },
    "top_brands": {
      "type": "number",
      "description": "Max number of brands before aggregating into 'Others' (optional, default: 10, max: 50)."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Share of shelf (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID. Optional when MCP context provides the current brand."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic UUID; comma-separated UUIDs are accepted."
    },
    "funnel": {
      "type": "string",
      "description": "Filter by funnel stage; comma-separated awareness, consideration, and conversion values are accepted."
    },
    "ai_platform": {
      "type": "string",
      "description": "Filter by AI platform; comma-separated platform identifiers are accepted. Retailer Shopping defaults to chatgpt."
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID; comma-separated UUIDs are accepted. Use getPromptPersonas to list valid values."
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Filter by Prompt Studio cycle start date (YYYY-MM-DD)."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Shopping summary KPI row. Retailer rows include trigger rate, retailer visibility, offer share, product coverage, price-win rate, and raw counts."
      },
      "description": "the corresponding Meikai service"
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from getTopics or user message."
    },
    "brand_category": {
      "type": "string",
      "enum": [
        "target_brand",
        "competitor",
        "all"
      ],
      "description": "Filter by brand category (optional, default: 'target_brand')."
    },
    "limit": {
      "type": "number",
      "description": "Number of top products to return (optional, default: 10)."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Top products (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from getTopics or user message."
    },
    "limit": {
      "type": "number",
      "description": "Number of top retailers to return (optional, default: 10)."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Top retailers (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "sections": {
      "oneOf": [
        {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "field_catalog",
              "enums",
              "construction_recipes",
              "data_collection",
              "field_limits",
              "layout_selection",
              "layout_templates",
              "example",
              "all"
            ]
          }
        },
        {
          "type": "string",
          "enum": [
            "field_catalog",
            "enums",
            "construction_recipes",
            "data_collection",
            "field_limits",
            "layout_selection",
            "layout_templates",
            "example",
            "all"
          ]
        }
      ],
      "description": "Subset of guide sections; omit for full payload."
    }
  }
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "additionalProperties": true
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "data"
      ],
      "description": "Static product documentation payload."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date in YYYY-MM-DD format (optional, defaults to last 7 days)"
    },
    "end_date": {
      "type": "string",
      "description": "End date in YYYY-MM-DD format (optional, defaults to the server's last complete day (yesterday))"
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from the user's message or from previous tool results (e.g., from getTopics)."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage"
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g. 'chatgpt', 'gemini', 'googleaioverview')"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g. 'gpt-5', 'gemini-3.5-flash'). Model names vary by platform"
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter). Use getPromptPersonas to list valid ids for the brand."
    },
    "calculation_mode": {
      "type": "string",
      "enum": [
        "classic",
        "weighted"
      ],
      "description": "Calculation mode for visibility metrics. 'classic' uses unweighted calculations (default). 'weighted' applies Statcounter AI outbound-referral share weighting; this does not represent users or total AI usage."
    },
    "lens_competitor_name": {
      "type": "string",
      "description": "Competitor Lens: analyze this competitor instead of the monitored brand, keeping every other filter identical (same scope as the webapp's Competitor Lens selector). Accepts the competitor's name or any of its aliases, case-insensitive. Use getCompetitorMetrics to list the brand's competitors. Omit to analyze the brand itself."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Citation media-type breakdown (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string",
      "format": "uuid",
      "description": "Company scope; defaults to the current company context."
    },
    "target_type": {
      "type": "string",
      "enum": [
        "BRAND",
        "PROMPT"
      ],
      "description": "Which objects the namespace tags: BRAND for brand tags, PROMPT for prompt tags. Defaults to PROMPT when omitted."
    },
    "namespace_id": {
      "type": "string",
      "format": "uuid",
      "description": "Optionally return values from one visible namespace."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "default": 1
    },
    "page_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 50
    }
  },
  "required": [
    "target_type"
  ],
  "additionalProperties": false
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Visible active Prompt tag namespaces and paginated values for a company."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand context)."
    },
    "topic_id": {
      "type": "string",
      "description": "Optional topic UUID filter."
    },
    "platform": {
      "type": "string",
      "description": "Optional AI platform filter (e.g. chatgpt, gemini, perplexity)."
    },
    "start_date": {
      "type": "string",
      "description": "Optional inclusive response start date (YYYY-MM-DD)."
    },
    "end_date": {
      "type": "string",
      "description": "Optional inclusive response end date (YYYY-MM-DD)."
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Optional topic iteration start date (YYYY-MM-DD)."
    },
    "page": {
      "type": "integer",
      "description": "Optional page number (default 1, min 1)."
    },
    "page_size": {
      "type": "integer",
      "description": "Optional page size (default 20, min 1, max 50 for this tool)."
    },
    "limit": {
      "type": "integer",
      "description": "Optional legacy alias for page_size when page_size is omitted (min 1, max 50)."
    },
    "shrinkage_k": {
      "type": "integer",
      "description": "Optional shrinkage constant (default 100, min 1, max 10000). Higher is more conservative."
    },
    "sort_by": {
      "type": "string",
      "description": "Optional sort field: domain, cited_response_count, not_cited_response_count, visibility_rate_when_cited, raw_visibility_lift, estimated_incremental_visible_answers, whitepress_price."
    },
    "sort_order": {
      "type": "string",
      "description": "Optional sort order: asc or desc."
    },
    "price_availability": {
      "type": "string",
      "description": "Optional price filter: all (default), with, without."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Topic id and label."
          },
          "description": "Brand topics list."
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "data"
      ]
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "context": {
      "type": "string",
      "enum": [
        "brand",
        "company",
        "workspace"
      ]
    },
    "brand_id": {
      "type": "string",
      "format": "uuid"
    },
    "company_id": {
      "type": "string",
      "format": "uuid"
    },
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "scope_id": {
      "type": "string",
      "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
    },
    "locale": {
      "type": "string",
      "description": "UI locale; French uses French content and other supported locales use English.",
      "enum": [
        "en",
        "fr",
        "es",
        "ja",
        "ko",
        "de",
        "pt",
        "pt-BR",
        "nl",
        "it",
        "el"
      ],
      "default": "en"
    },
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "unit_id": {
      "type": "string",
      "maxLength": 128,
      "pattern": "^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)*$"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 50
    },
    "publication_id": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "properties": {
            "schema_version": {
              "type": "integer",
              "const": 2
            },
            "publication_id": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            },
            "scope_id": {
              "type": "string"
            },
            "context": {
              "type": "string",
              "enum": [
                "brand",
                "company"
              ]
            },
            "locale": {
              "type": "string",
              "enum": [
                "en",
                "fr"
              ]
            },
            "requested_locale": {
              "type": "string"
            },
            "title": {
              "type": "string"
            },
            "units": {
              "type": "array",
              "items": {
                "type": "object",
                "additionalProperties": true,
                "description": "Published documentation unit."
              }
            },
            "facets": {
              "type": "object",
              "additionalProperties": true,
              "description": "Facets filtered to returned units."
            },
            "navigation": {
              "type": "array",
              "items": {
                "type": "object",
                "additionalProperties": true,
                "description": "Documentation navigation item."
              }
            },
            "total": {
              "type": "integer",
              "minimum": 0
            }
          },
          "additionalProperties": false,
          "required": [
            "schema_version",
            "publication_id",
            "scope_id",
            "context",
            "locale",
            "requested_locale",
            "title",
            "units",
            "facets",
            "navigation",
            "total"
          ]
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "data"
      ]
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        },
        "code": {
          "type": "string"
        }
      },
      "additionalProperties": true,
      "required": [
        "success",
        "error"
      ]
    }
  ]
}

{
  "type": "object",
  "properties": {
    "page_size": {
      "type": "number",
      "description": "Number of users to return per page"
    },
    "page": {
      "type": "number",
      "description": "Page number for pagination"
    },
    "search": {
      "type": "string",
      "description": "Substring match on email, username, first_name, or last_name"
    },
    "company_id": {
      "type": "string",
      "description": "Company scope (required for company administrators listing another account)"
    },
    "brand_id": {
      "type": "string",
      "description": "Filter to users assigned to this brand"
    },
    "role": {
      "type": "string",
      "description": "Filter by effective role bucket",
      "enum": [
        "company administrators",
        "admin",
        "company_admin",
        "brand_owner",
        "user",
        "editor",
        "viewer",
        "monitor_only",
        "no_brand_access"
      ]
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "username",
        "is_active",
        "last_login"
      ]
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID"
    },
    "start_date": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "end_date": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "group_by": {
      "type": "string",
      "enum": [
        "platform",
        "funnel",
        "topic",
        "model"
      ],
      "description": "Single dimension to group by (required)"
    },
    "topic_id": {
      "type": "string"
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ]
    },
    "platform": {
      "type": "string"
    },
    "model": {
      "type": "string"
    },
    "calculation_mode": {
      "type": "string",
      "enum": [
        "classic",
        "weighted"
      ],
      "description": "Calculation mode for visibility metrics. 'classic' uses unweighted calculations (default). 'weighted' applies Statcounter AI outbound-referral share weighting; this does not represent users or total AI usage."
    },
    "page": {
      "type": "number"
    },
    "page_size": {
      "type": "number"
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "visibility",
        "share_of_voice",
        "mentions",
        "mentions_avg",
        "responses_count",
        "responses_with_mentions",
        "rank",
        "key"
      ]
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    }
  },
  "required": [
    "group_by"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "additionalProperties": true,
          "description": "Visibility breakdown (calculationMode, data rows, pagination, optional weightMetadata). the corresponding Meikai service."
        }
      },
      "additionalProperties": true,
      "required": [
        "success",
        "data"
      ]
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "focus_area": {
      "type": "string",
      "enum": [
        "visibility",
        "citations",
        "share_of_voice",
        "owned_content",
        "earned_media",
        "technical_foundation",
        "shopping",
        "all"
      ],
      "description": "Which improvement angle to emphasize. 'visibility' focuses on mentions and response presence, 'citations' on source inclusion, 'share_of_voice' on competitive standing, 'owned_content' on onsite content actions, 'earned_media' on offsite authority building, 'technical_foundation' on crawlability and structure, 'shopping' on Product Tracker/product visibility, 'all' for a full playbook (default)."
    },
    "time_horizon": {
      "type": "string",
      "enum": [
        "quick_wins",
        "30_day_plan",
        "90_day_plan"
      ],
      "description": "How far ahead to plan. 'quick_wins' focuses on immediate fixes, '30_day_plan' on the next month, '90_day_plan' on strategic improvements. Defaults to '30_day_plan'."
    },
    "include_measurement_plan": {
      "type": "boolean",
      "description": "Whether to include a section mapping actions to Meikai metrics and tools. Defaults to true."
    },
    "scenario": {
      "type": "string",
      "enum": [
        "auto",
        "low_visibility",
        "competitors_cited_more",
        "mentions_without_citations",
        "shopping_visibility_low",
        "all"
      ],
      "description": "Optional scenario-specific playbook. 'low_visibility' for weak mention presence, 'competitors_cited_more' when rivals are cited more often, 'mentions_without_citations' when mentions exist but citations are weak, 'shopping_visibility_low' for Product Tracker / shopping issues, 'all' for all scenarios, 'auto' (default) returns all core scenarios."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "additionalProperties": true
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "data"
      ],
      "description": "Static product documentation payload."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID. Optional when MCP context provides the current brand."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic UUID (comma-separated UUIDs allowed)."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage."
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (maps to query param ai_platform), e.g. chatgpt, gemini, googleaioverview."
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (platform-specific)."
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter). Use getPromptPersonas to list valid ids for the brand."
    },
    "calculation_mode": {
      "type": "string",
      "enum": [
        "classic",
        "weighted"
      ],
      "description": "Calculation mode for visibility metrics. 'classic' uses unweighted calculations (default). 'weighted' applies Statcounter AI outbound-referral share weighting; this does not represent users or total AI usage."
    },
    "lens_competitor_name": {
      "type": "string",
      "description": "Competitor Lens: analyze this competitor instead of the monitored brand, keeping every other filter identical (same scope as the webapp's Competitor Lens selector). Accepts the competitor's name or any of its aliases, case-insensitive. Use getCompetitorMetrics to list the brand's competitors. Omit to analyze the brand itself."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "value": {
            "type": [
              "number",
              "null"
            ],
            "description": "Metric value for the current period."
          },
          "previous_value": {
            "type": [
              "number",
              "null"
            ],
            "description": "Metric value for the previous period of equal length."
          },
          "pct_change": {
            "type": [
              "number",
              "null"
            ],
            "description": "Relative change vs previous_value (decimal, e.g. 0.1 = +10%)."
          },
          "responses_with_mentions": {
            "type": [
              "number",
              "null"
            ],
            "description": "Responses mentioning the target brand (weighted)."
          },
          "total_responses": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total responses analyzed (weighted)."
          }
        },
        "additionalProperties": false,
        "description": "Visibility card row: value = responses_with_mentions / total_responses."
      },
      "description": "Visibility card rows (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date in YYYY-MM-DD format (optional, defaults to last 7 days)"
    },
    "end_date": {
      "type": "string",
      "description": "End date in YYYY-MM-DD format (optional, defaults to the server's last complete day (yesterday))"
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Optional, defaults to current topic from UI context if available."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage"
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g. 'chatgpt', 'gemini', 'googleaioverview')"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g. 'gpt-5', 'gemini-3.5-flash'). Model names vary by platform"
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter). Use getPromptPersonas to list valid ids for the brand."
    },
    "calculation_mode": {
      "type": "string",
      "enum": [
        "classic",
        "weighted"
      ],
      "description": "Calculation mode for visibility metrics. 'classic' uses unweighted calculations (default). 'weighted' applies Statcounter AI outbound-referral share weighting; this does not represent users or total AI usage."
    },
    "lens_competitor_name": {
      "type": "string",
      "description": "Competitor Lens: analyze this competitor instead of the monitored brand, keeping every other filter identical (same scope as the webapp's Competitor Lens selector). Accepts the competitor's name or any of its aliases, case-insensitive. Use getCompetitorMetrics to list the brand's competitors. Omit to analyze the brand itself."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "value": {
            "type": [
              "number",
              "null"
            ],
            "description": "Metric value for the current period."
          },
          "previous_value": {
            "type": [
              "number",
              "null"
            ],
            "description": "Metric value for the previous period of equal length."
          },
          "pct_change": {
            "type": [
              "number",
              "null"
            ],
            "description": "Relative change vs previous_value (decimal, e.g. 0.1 = +10%)."
          },
          "responses_with_mentions": {
            "type": [
              "number",
              "null"
            ],
            "description": "Responses mentioning the target brand (weighted)."
          },
          "total_responses": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total responses analyzed (weighted)."
          }
        },
        "additionalProperties": false,
        "description": "Visibility card row: value = responses_with_mentions / total_responses."
      },
      "description": "Visibility card rows (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "The UUID of the brand (optional, defaults to current brand)"
    },
    "start_date": {
      "type": "string",
      "description": "Start date in YYYY-MM-DD format (optional, defaults to last 7 days)"
    },
    "end_date": {
      "type": "string",
      "description": "End date in YYYY-MM-DD format (optional, defaults to the server's last complete day (yesterday))"
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic ID (UUID). Extract from the user's message or from previous tool results (e.g., from getTopics)."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage"
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (e.g. 'chatgpt', 'gemini', 'googleaioverview')"
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (e.g. 'gpt-5', 'gemini-3.5-flash'). Model names vary by platform"
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter). Use getPromptPersonas to list valid ids for the brand."
    },
    "calculation_mode": {
      "type": "string",
      "enum": [
        "classic",
        "weighted"
      ],
      "description": "Calculation mode for visibility metrics. 'classic' uses unweighted calculations (default). 'weighted' applies Statcounter AI outbound-referral share weighting; this does not represent users or total AI usage."
    },
    "lens_competitor_name": {
      "type": "string",
      "description": "Competitor Lens: analyze this competitor instead of the monitored brand, keeping every other filter identical (same scope as the webapp's Competitor Lens selector). Accepts the competitor's name or any of its aliases, case-insensitive. Use getCompetitorMetrics to list the brand's competitors. Omit to analyze the brand itself."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "description": "Analytics result row."
      },
      "description": "Visibility rank rows (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID. Optional when MCP context provides the current brand."
    },
    "start_date": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided."
    },
    "end_date": {
      "type": "string",
      "description": "End date (YYYY-MM-DD). Omitted dates are resolved server-side from MCP context date_range_preset + reference_end_date, or from lookback_days when provided; otherwise defaults to the server's last complete day (yesterday)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Inclusive lookback window in days (language-agnostic). Ends at reference_end_date from MCP context when available (last available data day / lastRunDate), otherwise at the server's last complete day (yesterday). When set, overrides start_date/end_date. Prefer this alone for relative periods such as 'last 30 days' \u2014 omit start_date and end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Filter by topic UUID (comma-separated UUIDs allowed)."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Filter by funnel stage."
    },
    "platform": {
      "type": "string",
      "description": "Filter by AI platform (maps to query param ai_platform), e.g. chatgpt, gemini, googleaioverview."
    },
    "model": {
      "type": "string",
      "description": "Filter by AI model name (platform-specific)."
    },
    "persona_id": {
      "type": "string",
      "description": "Filter by Prompt Studio persona UUID. Resolves to the persona's assigned active regular prompts (same as Brand Monitor persona filter). Use getPromptPersonas to list valid ids for the brand."
    },
    "calculation_mode": {
      "type": "string",
      "enum": [
        "classic",
        "weighted"
      ],
      "description": "Calculation mode for visibility metrics. 'classic' uses unweighted calculations (default). 'weighted' applies Statcounter AI outbound-referral share weighting; this does not represent users or total AI usage."
    },
    "lens_competitor_name": {
      "type": "string",
      "description": "Competitor Lens: analyze this competitor instead of the monitored brand, keeping every other filter identical (same scope as the webapp's Competitor Lens selector). Accepts the competitor's name or any of its aliases, case-insensitive. Use getCompetitorMetrics to list the brand's competitors. Omit to analyze the brand itself."
    },
    "limit_per_topic": {
      "type": "integer",
      "minimum": 1,
      "maximum": 15,
      "default": 10,
      "description": "Max brands returned per topic (default 10, max 15). The monitored brand is included even when its rank exceeds this."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "default": 1,
      "description": "Page of TOPICS (not of brands)."
    },
    "page_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 10,
      "description": "Topics per page (default and max 10)."
    },
    "sort_topics_by": {
      "type": "string",
      "enum": [
        "responses",
        "name"
      ],
      "default": "responses",
      "description": "Topic ordering: by response volume (default) or alphabetically."
    },
    "favorite_competitors_only": {
      "type": "boolean",
      "default": false,
      "description": "Restrict to the target brand plus favorite competitors. This changes the ranking universe, so ranks differ from the full-market ones."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Per-topic leaderboard groups, each with its own ranking and caps (the corresponding Meikai service)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "description": "Workspace UUID; defaults to the active Workspace."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Relative lookback; overrides explicit dates."
    },
    "start_date": {
      "type": "string",
      "format": "date"
    },
    "end_date": {
      "type": "string",
      "format": "date"
    },
    "countries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional ISO-2 market subset."
    },
    "funnel": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "awareness",
          "consideration",
          "conversion"
        ]
      }
    },
    "platform": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "additionalProperties": true,
          "description": "Global Brand market rows, macro metrics, and coverage."
        },
        "workspace_version": {
          "oneOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "data",
        "workspace_version"
      ]
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "description": "Workspace UUID; defaults to the active Workspace."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Relative lookback; overrides explicit dates."
    },
    "start_date": {
      "type": "string",
      "format": "date"
    },
    "end_date": {
      "type": "string",
      "format": "date"
    },
    "countries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional ISO-2 market subset."
    },
    "funnel": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "awareness",
          "consideration",
          "conversion"
        ]
      }
    },
    "platform": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "additionalProperties": true,
          "description": "Workspace Portfolio KPIs and per-Brand metrics."
        },
        "workspace_version": {
          "oneOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "data",
        "workspace_version"
      ]
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "preview",
        "apply"
      ]
    },
    "confirmation_token": {
      "type": "string"
    },
    "confirmation_phrase": {
      "type": "string",
      "enum": [
        "CONFIRM_MANAGEMENT_CHANGE"
      ]
    },
    "user": {
      "type": "object"
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "User invitation preview or apply result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID (defaults to the context brand)."
    },
    "view": {
      "type": "string",
      "enum": [
        "versions",
        "imported"
      ],
      "description": "'versions' for the version history (default), 'imported' for imported batches."
    },
    "status": {
      "type": "string",
      "description": "Filter versions by status (draft|active|inactive|deleted)."
    },
    "current_step": {
      "type": "string",
      "description": "Filter versions by workflow step (brand_analysis|topics|prompts|review|finalized|imported)."
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "version_number",
        "updated_at",
        "created_at"
      ],
      "description": "Sort field for the versions view."
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort order for the versions view (default desc)."
    },
    "page": {
      "type": "number",
      "description": "Page number (versions view)."
    },
    "page_size": {
      "type": "number",
      "description": "Items per page (max 50)."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "description": "Analytics result row."
          },
          "description": "Result rows."
        },
        "pagination": {
          "type": "object",
          "additionalProperties": true,
          "description": "Pagination metadata (page, page_size, total_count, etc.)."
        }
      },
      "additionalProperties": true,
      "description": "Paginated Meikai API list response."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "preview",
        "apply"
      ]
    },
    "confirmation_token": {
      "type": "string"
    },
    "confirmation_phrase": {
      "type": "string",
      "enum": [
        "CONFIRM_MANAGEMENT_CHANGE"
      ]
    },
    "company_id": {
      "type": "string",
      "format": "uuid",
      "description": "Company scope; defaults to the current company context."
    },
    "operation": {
      "type": "string",
      "enum": [
        "set_tag_targets",
        "set_brand_tags",
        "set_prompt_tags"
      ]
    },
    "tag_id": {
      "type": "string",
      "format": "uuid",
      "description": "Tag to reassign, for set_tag_targets."
    },
    "brand_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "maxItems": 200,
      "description": "Brands carrying the tag, for set_tag_targets on a Brand tag."
    },
    "prompt_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "maxItems": 200,
      "description": "Prompts carrying the tag, for set_tag_targets on a Prompt tag."
    },
    "brand_id": {
      "type": "string",
      "format": "uuid",
      "description": "Brand to retag, for set_brand_tags."
    },
    "prompt_id": {
      "type": "string",
      "format": "uuid",
      "description": "Prompt to retag, for set_prompt_tags."
    },
    "tag_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid"
      },
      "maxItems": 200,
      "description": "Tags carried by the object, for set_brand_tags/set_prompt_tags."
    },
    "access_resolution": {
      "type": "object",
      "description": "How to settle a workspace access impact: {'mode': 'MASK_INELIGIBLE'} or {'mode': 'GRANT_ACCESS', 'grants': [{'user_id', 'brand_id', 'role'}]} with one grant per reported pair. Re-run preview with it, then apply with the new token."
    }
  },
  "required": [
    "operation"
  ],
  "additionalProperties": false
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Tag assignment change preview (added/removed diff) or apply result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "preview",
        "apply"
      ]
    },
    "confirmation_token": {
      "type": "string"
    },
    "confirmation_phrase": {
      "type": "string",
      "enum": [
        "CONFIRM_MANAGEMENT_CHANGE"
      ]
    },
    "company_id": {
      "type": "string",
      "format": "uuid",
      "description": "Company scope; defaults to the current company context."
    },
    "target_type": {
      "type": "string",
      "enum": [
        "BRAND",
        "PROMPT"
      ],
      "description": "Which objects the namespace tags: BRAND for brand tags, PROMPT for prompt tags. Defaults to PROMPT when omitted."
    },
    "operation": {
      "type": "string",
      "enum": [
        "create_namespace",
        "update_namespace",
        "archive_namespace",
        "create_tag",
        "update_tag",
        "archive_tag"
      ]
    },
    "namespace_id": {
      "type": "string",
      "format": "uuid",
      "description": "Required for namespace updates/archives and tag creation."
    },
    "tag_id": {
      "type": "string",
      "format": "uuid",
      "description": "Required for tag updates/archives."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "icon": {
      "type": "string",
      "maxLength": 64
    },
    "color": {
      "type": "string",
      "pattern": "^#[0-9A-Fa-f]{6}$"
    },
    "position": {
      "type": "integer",
      "minimum": 0
    }
  },
  "required": [
    "operation",
    "target_type"
  ],
  "additionalProperties": false
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Prompt tag taxonomy mutation preview or apply result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "preview",
        "apply"
      ]
    },
    "confirmation_token": {
      "type": "string"
    },
    "confirmation_phrase": {
      "type": "string",
      "enum": [
        "CONFIRM_MANAGEMENT_CHANGE"
      ]
    },
    "session_id": {
      "type": "string",
      "description": "Prompt Studio session UUID to publish."
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Monitoring cycle start date YYYY-MM-DD (defaults to today when omitted)."
    },
    "iteration_end_date": {
      "type": "string",
      "description": "Optional monitoring cycle end date YYYY-MM-DD."
    },
    "publication_mode": {
      "type": "string",
      "enum": [
        "deactivate-previous-type",
        "deactivate-all",
        "keep-existing"
      ],
      "description": "How to handle existing prompts. Maps to archive_previous_cycle/deactivate_all_types; explicit flags override this."
    },
    "archive_previous_cycle": {
      "type": "boolean",
      "description": "Archive the previous cycle's prompts of the same type."
    },
    "deactivate_all_types": {
      "type": "boolean",
      "description": "Deactivate all existing prompt types (full replacement)."
    },
    "selected_indices": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Optional subset of prompt indices to import."
    },
    "activate_brand": {
      "type": "boolean",
      "description": "Activate the brand as part of publishing. Publishing to a disabled brand is refused by default because ingestion never dispatches its prompts. Setting this consumes a plan slot and starts LLM spend, so ask the user before enabling it."
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Prompt Studio publish preview (summary + confirmation_token) or apply/import result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "Prompt Studio session UUID."
    },
    "target": {
      "type": "string",
      "enum": [
        "personas",
        "topics",
        "attribute_topics",
        "core_product_topics",
        "prompts",
        "additional_instructions",
        "restore"
      ],
      "description": "Which step to edit."
    },
    "personas": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "description": "Persona objects (target='personas')."
    },
    "topics": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "description": "Regular topics (target='topics')."
    },
    "attribute_topics": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "description": "Attribute perception topics (target='attribute_topics')."
    },
    "core_product_topics": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "description": "Core product perception topics (target='core_product_topics')."
    },
    "prompts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "tag_ids": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "Existing Prompt tag UUIDs."
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Prompt tag UUIDs, unique existing names, or 'Namespace: Value' references. Missing qualified tags are created in the session company for taxonomy managers; unknown bare names are rejected."
          }
        },
        "additionalProperties": true
      },
      "description": "Unbranded prompts (target='prompts'). The response includes canonical prompts with tag_ids and created_tag_namespace_count / created_tag_count."
    },
    "brand_analysis_additional_instructions": {
      "type": "string",
      "description": "Brand-analysis instructions (target='additional_instructions')."
    },
    "prompt_generation_additional_instructions": {
      "type": "string",
      "description": "Prompt-generation instructions (target='additional_instructions')."
    },
    "field_name": {
      "type": "string",
      "enum": [
        "personas_data",
        "topics_data",
        "prompts_data"
      ],
      "description": "Field to restore (target='restore')."
    },
    "version": {
      "type": "number",
      "description": "History version number to restore (target='restore')."
    }
  },
  "required": [
    "session_id",
    "target"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Prompt Studio step update result (may include a forked session_id)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "spec": {
      "type": "object",
      "description": "normalizedSpec from validateSlideDeckSpec.",
      "additionalProperties": true
    },
    "normalizedSpec": {
      "type": "object",
      "description": "Direct normalizedSpec output from validateSlideDeckSpec.",
      "additionalProperties": true
    },
    "downloadFilename": {
      "type": "string",
      "description": "Optional download filename (e.g. hennessy-brand-monitor-2026-05-01_2026-05-26.pptx). Overrides spec.title for the file name only."
    },
    "format": {
      "type": "string",
      "enum": [
        "pptx",
        "pdf"
      ],
      "description": "Output format. Default pptx."
    }
  },
  "oneOf": [
    {
      "required": [
        "spec"
      ]
    },
    {
      "required": [
        "normalizedSpec"
      ]
    }
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "pptxUrl": {
          "type": "string"
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": true,
      "required": [
        "pptxUrl",
        "warnings"
      ],
      "description": "Rendered PPTX download URL and non-fatal warnings."
    },
    {
      "type": "object",
      "properties": {
        "pdfUrl": {
          "type": "string"
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": true,
      "required": [
        "pdfUrl",
        "warnings"
      ],
      "description": "Rendered PDF download URL and non-fatal warnings."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID (optional if present in context)."
    },
    "proposed_ai_guidelines": {
      "type": "string",
      "description": "Proposed brand ai_guidelines content. Use empty string to clear."
    },
    "mode": {
      "type": "string",
      "enum": [
        "preview",
        "apply"
      ],
      "description": "preview validates and returns confirmation_token; apply persists only when confirmation requirements are met."
    },
    "confirmation_token": {
      "type": "string",
      "description": "Token returned by preview; required for apply mode."
    },
    "confirmation_phrase": {
      "type": "string",
      "description": "Must be exactly CONFIRM_AI_GUIDELINES_UPDATE in apply mode."
    }
  },
  "required": [
    "proposed_ai_guidelines"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": true
        },
        "data": {
          "type": "object",
          "additionalProperties": true,
          "description": "Updated brand AI guidelines."
        }
      },
      "additionalProperties": false,
      "required": [
        "success",
        "data"
      ]
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "preview",
        "apply"
      ]
    },
    "confirmation_token": {
      "type": "string"
    },
    "confirmation_phrase": {
      "type": "string",
      "enum": [
        "CONFIRM_MANAGEMENT_CHANGE"
      ]
    },
    "brand_ids": {
      "type": "array",
      "maxItems": 100
    },
    "status": {
      "type": "string"
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Brand status update preview or apply result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "preview",
        "apply"
      ]
    },
    "confirmation_token": {
      "type": "string"
    },
    "confirmation_phrase": {
      "type": "string",
      "enum": [
        "CONFIRM_MANAGEMENT_CHANGE"
      ]
    },
    "updates": {
      "type": "array",
      "maxItems": 100,
      "items": {
        "type": "object",
        "properties": {
          "plan_id": {
            "type": "string",
            "description": "Recommendation plan UUID, the plan_id returned by getRecommendationsList."
          },
          "recommendation_id": {
            "type": "string",
            "description": "Recommendation id inside that plan, for example rec:domain:example.com. Take it from getRecommendationsList; never invent one."
          },
          "completed_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO-8601 completion timestamp, or null to clear it. Cannot be in the future. On a fully finished recommendation, clearing it resets the date to now."
          },
          "tasks": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "task_id": {
                  "type": "string",
                  "description": "Checklist task id on the recommendation, for example t:send_outreach. Read the current task ids from getRecommendationsList; unknown ids are rejected."
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "todo",
                    "done",
                    "skipped"
                  ],
                  "description": "New status for that task."
                },
                "data": {
                  "type": "object",
                  "description": "Optional task payload, same shape the recommendation panel stores."
                }
              },
              "required": [
                "task_id",
                "status"
              ]
            },
            "description": "Task status changes to apply on this recommendation."
          }
        },
        "required": [
          "plan_id",
          "recommendation_id"
        ]
      },
      "description": "Recommendations to update, up to 100 per call, possibly across several plans. Each entry must set completed_at, tasks, or both."
    }
  },
  "required": [
    "updates"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Recommendation progress preview or apply result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "preview",
        "apply"
      ]
    },
    "confirmation_token": {
      "type": "string"
    },
    "confirmation_phrase": {
      "type": "string",
      "enum": [
        "CONFIRM_MANAGEMENT_CHANGE"
      ]
    },
    "user_id": {
      "type": "string"
    },
    "assignments": {
      "type": "array",
      "maxItems": 100,
      "items": {
        "type": "object",
        "properties": {
          "brand_id": {
            "type": "string"
          },
          "role": {
            "type": "string",
            "enum": [
              "OWNER",
              "EDITOR",
              "VIEWER",
              "MONITOR_ONLY"
            ],
            "description": "Brand Owner in the UI is OWNER, not BRAND_OWNER."
          }
        },
        "required": [
          "brand_id",
          "role"
        ]
      }
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "User brand access preview or apply result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "preview",
        "apply"
      ]
    },
    "confirmation_token": {
      "type": "string"
    },
    "confirmation_phrase": {
      "type": "string",
      "enum": [
        "CONFIRM_MANAGEMENT_CHANGE"
      ]
    },
    "user_ids": {
      "type": "array",
      "maxItems": 100
    },
    "emails": {
      "type": "array",
      "maxItems": 100
    },
    "company_id": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "inactive"
      ]
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "User status update preview or apply result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand UUID (optional if context brand is available)."
    },
    "export_type": {
      "type": "string",
      "enum": [
        "citations",
        "prompt_list",
        "prompts",
        "brand_visibility",
        "ads_creatives"
      ],
      "description": "Dataset to export, not a file type: pass csv/xlsx/pdf in 'format' instead. Use 'prompts' for the followed-prompt catalog; use 'prompt_list' for Brand Monitor metrics over a date range; use 'ads_creatives' for the Ad Creative library."
    },
    "format": {
      "type": "string",
      "enum": [
        "csv",
        "xlsx",
        "pdf"
      ],
      "description": "Requested export format. Use pdf for brand_visibility."
    },
    "start_date": {
      "type": "string",
      "description": "Start date YYYY-MM-DD (optional for citations/prompt_list/brand_visibility; required for ads_creatives unless lookback_days/context supplies it)."
    },
    "end_date": {
      "type": "string",
      "description": "End date YYYY-MM-DD (optional for citations/prompt_list/brand_visibility; required for ads_creatives unless lookback_days/context supplies it)."
    },
    "lookback_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Optional inclusive lookback window in days ending on `reference_end_date` when available, otherwise on the server's last complete day (yesterday). When set, overrides start_date/end_date."
    },
    "topic_id": {
      "type": "string",
      "description": "Optional topic UUID or comma-separated UUIDs for prompt_list/brand_visibility/ads_creatives."
    },
    "platform": {
      "type": "string",
      "description": "Optional platform filter for prompt_list/brand_visibility/ads_creatives."
    },
    "model": {
      "type": "string",
      "description": "Optional model filter for prompt_list/brand_visibility/ads_creatives."
    },
    "funnel": {
      "type": "string",
      "enum": [
        "awareness",
        "consideration",
        "conversion"
      ],
      "description": "Optional funnel filter for brand_visibility/ads_creatives."
    },
    "advertiser": {
      "type": "string",
      "description": "Optional advertiser filter for ads_creatives."
    },
    "iteration_start_date": {
      "type": "string",
      "description": "Optional topic iteration start date YYYY-MM-DD for ads_creatives."
    },
    "company_id": {
      "type": "string",
      "description": "Optional company UUID scope for ads_creatives."
    },
    "media_type": {
      "type": "string",
      "description": "Optional citations media type filter."
    },
    "is_mentioning_brand": {
      "type": "string",
      "enum": [
        "true",
        "false",
        "unknown"
      ],
      "description": "Optional citations filter by brand mention state."
    },
    "favorite_competitor_mentioned_not_brand": {
      "type": "string",
      "enum": [
        "true",
        "false",
        "unknown"
      ],
      "description": "Optional citations filter for competitor-only mentions."
    },
    "sort_by": {
      "type": "string",
      "description": "Optional sort field for citations or ads_creatives (ads_creatives default: ad_penetration)."
    },
    "search": {
      "type": "string",
      "description": "Optional search filter for citations/prompt_list/ads_creatives."
    },
    "persona_id": {
      "type": "string",
      "description": "Optional Prompt Studio persona UUID for citations/prompt_list/ads_creatives exports."
    },
    "order_by": {
      "type": "string",
      "description": "Optional prompts sort field (default id)."
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Optional sort order for prompts or ads_creatives."
    },
    "send_email": {
      "type": "boolean",
      "description": "Whether to send completion email. Defaults to true for chat-triggered exports unless explicitly set to false."
    },
    "email": {
      "type": "string",
      "description": "Email destination when send_email=true."
    }
  },
  "required": [
    "export_type"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Async export job created (HTTP 202 payload)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand UUID (defaults to context brand_id when omitted)."
    },
    "super_prompt": {
      "type": "string",
      "description": "SuperPrompt template UUID to base generation on."
    },
    "number_prompts": {
      "type": "number",
      "description": "Target number of prompts to generate."
    },
    "model_name": {
      "type": "string",
      "description": "LLM model name (optional; server default applies)."
    },
    "country": {
      "type": "string",
      "description": "Market/country (defaults from brand)."
    },
    "language": {
      "type": "string",
      "description": "Language (defaults from brand)."
    },
    "brand_website": {
      "type": "string",
      "description": "Brand website (defaults from brand)."
    },
    "prompt_types": {
      "type": "string",
      "enum": [
        "both",
        "standard",
        "perception"
      ],
      "description": "Which prompt types to produce (default both)."
    },
    "brand_analysis_additional_instructions": {
      "type": "string",
      "description": "Extra instructions steering the brand analysis step."
    },
    "prompt_generation_additional_instructions": {
      "type": "string",
      "description": "Extra instructions steering the prompt generation step."
    },
    "multiplier_type": {
      "type": "string",
      "description": "Optional multiplier type."
    },
    "multiplier_values": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional multiplier values."
    },
    "override_attributes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional attribute overrides."
    },
    "override_products": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional product overrides."
    },
    "override_topics": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional topic overrides (null/[]/1-12 names)."
    },
    "version_name": {
      "type": "string",
      "description": "Optional human-readable version name."
    },
    "generate": {
      "type": "boolean",
      "description": "Trigger brand analysis after creating the version (default true)."
    }
  },
  "required": [
    "super_prompt"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Prompt Studio session created and brand analysis dispatched (session_id, current_step)."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "preview",
        "apply"
      ]
    },
    "confirmation_token": {
      "type": "string"
    },
    "confirmation_phrase": {
      "type": "string",
      "enum": [
        "CONFIRM_MANAGEMENT_CHANGE"
      ]
    },
    "brand_id": {
      "type": "string",
      "description": "Brand UUID; defaults to the current brand context."
    },
    "settings": {
      "type": "object",
      "description": "Partial brand settings patch. Send only the fields to change; omitted fields are untouched and every supplied array replaces the stored list, so read the current values with getBrands first when adding to a list. Read-only fields such as favorite_competitors, tags, effective_* and tracking_context_inferred are ignored.",
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 255,
          "description": "Brand display name."
        },
        "website": {
          "type": "string",
          "maxLength": 255,
          "description": "Primary brand website; OnSite falls back to it when owned_domains is empty."
        },
        "country_iso2": {
          "type": "string",
          "pattern": "^[A-Za-z]{2}$",
          "description": "Two-letter ISO 3166-1 market code. Locked while active prompts are in the current cycle (see getBrands locale_lock_reason)."
        },
        "language": {
          "type": "string",
          "maxLength": 5,
          "description": "ISO 639-1 language, optionally with region (for example fr or fr-FR). Same lock as country_iso2."
        },
        "name_variants": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "description": "Aliases that count as mentions of this brand in AI responses."
        },
        "excluded_name_variants": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "description": "Phrases that must not count as mentions of this brand."
        },
        "owned_domains": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 500
          },
          "description": "Web domains the brand itself publishes on, beyond 'website'. Hostnames only, optionally with a scheme, path or '*.' prefix: 'voyages.leclerc', 'https://www.example.com/blog', '*.example.com'. Used to classify citations as Owned Media and to scope the OnSite agent's search for existing pages, so a non-domain value is rejected. For OnSite, a path scopes pages to that section ('https://www.example.com/gb/en' keeps /gb/en pages only); a bare host covers every path. Never put keywords, search terms, product names or competitor brands here; topics belong in 'default_topics' and competitors are set separately."
        },
        "tag_ids": {
          "type": "array",
          "items": {
            "type": "string",
            "format": "uuid"
          },
          "description": "Brand tag UUIDs; replaces all current tags. Prefer manageTagAssignments, which previews the Workspace access impact."
        },
        "tracked_name": {
          "type": [
            "string",
            "null"
          ],
          "maxLength": 255,
          "description": "Exact wording matched in AI responses for this brand (for example 'Lipton' when the display name is 'Lipton (Ice Tea)'). Empty or null uses name."
        },
        "tracking_context": {
          "type": [
            "string",
            "null"
          ],
          "description": "What this brand covers and who it competes with (for example 'Lipton in the ready-to-drink ice tea space'). Fed verbatim to competitor discovery; when empty, the context inferred by Prompt Studio is used."
        },
        "favorite_products": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "maxItems": 5,
          "description": "Product categories used in Brand Perception prompts; overrides company defaults and generated products. Unique non-empty strings."
        },
        "favorite_attributes": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "maxItems": 5,
          "description": "English canonical attribute names for Brand Perception; overrides company defaults. Unique non-empty strings."
        },
        "default_topics": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "maxItems": 12,
          "description": "Topic cluster names used as Prompt Studio defaults instead of generated topics. Unique non-empty strings."
        },
        "ai_guidelines": {
          "type": "string",
          "maxLength": 3000,
          "description": "Persistent brand instructions for AI Chat and content-generation agents. Replaces the stored text; an empty string clears it. Prefer setBrandAIGuidelines, which shows the current text and blocks unsafe patterns."
        },
        "onsite_agent_enabled": {
          "type": "boolean",
          "description": "OnSite content recommendations. Also requires completed clustering. Enabling requires active prompts whose first one is at least 7 days old and generated prompt embeddings. Changing agent settings is reserved for Meikai system administrators and unavailable to client accounts."
        },
        "offsite_agent_enabled": {
          "type": "boolean",
          "description": "OffSite earned media recommendations. Also requires completed clustering. Enabling requires active prompts whose first one is at least 7 days old and generated prompt embeddings. Changing agent settings is reserved for Meikai system administrators and unavailable to client accounts."
        },
        "shared_media_agent_enabled": {
          "type": "boolean",
          "description": "Shared Media (YouTube, Reddit, ...) recommendations. Enabling requires active prompts whose first one is at least 7 days old and generated prompt embeddings. Changing agent settings is reserved for Meikai system administrators and unavailable to client accounts."
        },
        "pdp_agent_enabled": {
          "type": "boolean",
          "description": "Product detail page recommendations. Enabling requires active prompts whose first one is at least 7 days old and generated prompt embeddings. Changing agent settings is reserved for Meikai system administrators and unavailable to client accounts."
        },
        "ads_campaign_planner_enabled": {
          "type": "boolean",
          "description": "Ads campaign planner tab and generated campaign/ad group/ad recommendations. Changing this setting is reserved for Meikai system administrators and unavailable to client accounts."
        },
        "plan": {
          "type": "string",
          "maxLength": 40,
          "description": "Commercial plan; changes entitlements and may consume a plan license slot. A shared catalog code (starter, growth, enterprise) or a company dedicated plan code, validated server-side against the plans that company may assign. Company admins and brand owners only; legacy assignments cannot change here, and 'custom' is reserved for company administrators and partner provisioning."
        },
        "llm_config": {
          "type": "object",
          "additionalProperties": {
            "type": "integer"
          },
          "description": "Per-model prompt limits, for example {\"chatgpt\": 100, \"gemini\": 100}. company administrators and partner provisioning only; every model must be available in the brand's country and within plan caps."
        },
        "status": {
          "type": "string",
          "description": "Brand status. Prefer setBrandStatus, which handles bulk changes and activation checks."
        }
      },
      "additionalProperties": true
    }
  },
  "required": []
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Brand settings update preview or apply result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string",
      "description": "Target company UUID; defaults to the current MCP company context when omitted."
    },
    "auto_purchase_plan_license": {
      "type": "boolean",
      "description": "Explicitly purchase missing plan licenses so imported brands can be active."
    },
    "brands": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 255
          },
          "plan": {
            "type": "string",
            "maxLength": 40,
            "description": "A shared catalog code (starter, growth, enterprise) or a company dedicated plan code. A static enum cannot list dedicated codes, which are created per company, so the value is validated server-side against the plans that company may assign."
          },
          "website": {
            "type": "string",
            "maxLength": 255
          },
          "aliases": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 255
            },
            "description": "Brand aliases; stored and returned as name_variants."
          },
          "country_iso2": {
            "type": "string",
            "pattern": "^[A-Za-z]{2}$",
            "description": "Two-letter ISO 3166-1 market code."
          },
          "language": {
            "type": "string",
            "maxLength": 5,
            "description": "ISO 639-1 language, optionally with region (for example en or en-US)."
          },
          "tracked_name": {
            "type": "string",
            "maxLength": 255
          },
          "tracking_context": {
            "type": "string"
          },
          "excluded_name_variants": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 255
            }
          },
          "favorite_products": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 255
            },
            "maxItems": 5
          },
          "favorite_attributes": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 255
            },
            "maxItems": 5
          },
          "default_topics": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 255
            },
            "maxItems": 12
          },
          "owned_domains": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 500
            },
            "description": "Web domains the brand itself publishes on, beyond 'website'. Hostnames only, optionally with a scheme, path or '*.' prefix: 'voyages.leclerc', 'https://www.example.com/blog', '*.example.com'. Used to classify citations as Owned Media and to scope the OnSite agent's search for existing pages, so a non-domain value is rejected. For OnSite, a path scopes pages to that section ('https://www.example.com/gb/en' keeps /gb/en pages only); a bare host covers every path. Never put keywords, search terms, product names or competitor brands here; topics belong in 'default_topics' and competitors are set separately."
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 255
            },
            "description": "Existing Brand tags, by id, 'Namespace:Value', or bare value when unambiguous. An import never creates a tag: an unknown one rejects its record."
          },
          "llms": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 255
            },
            "description": "Models this brand tracks, overriding its plan catalogue. Requires prompts_per_model, and every listed model must be available in the brand's country."
          },
          "prompts_per_model": {
            "type": "integer",
            "minimum": 1,
            "description": "Prompts each model in llms tracks. Requires llms."
          }
        },
        "required": [
          "name"
        ],
        "additionalProperties": true
      },
      "maxItems": 100
    },
    "user_access_assignments": {
      "type": "array",
      "description": "Optional home-company user grants applied atomically with brand create/import. Company Admins are always granted OWNER even when omitted. Each entry: {user_id, role} where role is OWNER | EDITOR | VIEWER | MONITOR_ONLY. On bulk import, the same assignments apply to every created brand.",
      "items": {
        "type": "object",
        "properties": {
          "user_id": {
            "type": "string",
            "description": "Target user UUID in the brand home company."
          },
          "role": {
            "type": "string",
            "enum": [
              "OWNER",
              "EDITOR",
              "VIEWER",
              "MONITOR_ONLY"
            ]
          }
        },
        "required": [
          "user_id",
          "role"
        ],
        "additionalProperties": false
      }
    },
    "on_invalid_records": {
      "type": "string",
      "enum": [
        "reject",
        "skip"
      ],
      "description": "What to do when some records are invalid: 'reject' (the default) imports nothing, 'skip' imports only the records that hold up. Never pick 'skip' on your own."
    }
  },
  "required": [
    "brands"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Bulk brand creation validation result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string"
    },
    "competitors": {
      "type": "array",
      "maxItems": 100
    },
    "on_invalid_records": {
      "type": "string",
      "enum": [
        "reject",
        "skip"
      ],
      "description": "What to do when some records are invalid: 'reject' (the default) imports nothing, 'skip' imports only the records that hold up. Never pick 'skip' on your own."
    }
  },
  "required": [
    "brand_id",
    "competitors"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Bulk competitor creation validation result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "users": {
      "type": "array",
      "maxItems": 100
    },
    "on_invalid_records": {
      "type": "string",
      "enum": [
        "reject",
        "skip"
      ],
      "description": "What to do when some records are invalid: 'reject' (the default) imports nothing, 'skip' imports only the records that hold up. Never pick 'skip' on your own."
    }
  },
  "required": [
    "users"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Bulk user invitation validation result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string",
      "description": "Target company UUID; defaults to the current MCP company context when omitted."
    },
    "brand": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 255
        },
        "plan": {
          "type": "string",
          "maxLength": 40,
          "description": "A shared catalog code (starter, growth, enterprise) or a company dedicated plan code. A static enum cannot list dedicated codes, which are created per company, so the value is validated server-side against the plans that company may assign."
        },
        "website": {
          "type": "string",
          "maxLength": 255
        },
        "aliases": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "description": "Brand aliases; stored and returned as name_variants."
        },
        "country_iso2": {
          "type": "string",
          "pattern": "^[A-Za-z]{2}$",
          "description": "Two-letter ISO 3166-1 market code."
        },
        "language": {
          "type": "string",
          "maxLength": 5,
          "description": "ISO 639-1 language, optionally with region (for example en or en-US)."
        },
        "tracked_name": {
          "type": "string",
          "maxLength": 255
        },
        "tracking_context": {
          "type": "string"
        },
        "excluded_name_variants": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          }
        },
        "favorite_products": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "maxItems": 5
        },
        "favorite_attributes": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "maxItems": 5
        },
        "default_topics": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "maxItems": 12
        },
        "owned_domains": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 500
          },
          "description": "Web domains the brand itself publishes on, beyond 'website'. Hostnames only, optionally with a scheme, path or '*.' prefix: 'voyages.leclerc', 'https://www.example.com/blog', '*.example.com'. Used to classify citations as Owned Media and to scope the OnSite agent's search for existing pages, so a non-domain value is rejected. For OnSite, a path scopes pages to that section ('https://www.example.com/gb/en' keeps /gb/en pages only); a bare host covers every path. Never put keywords, search terms, product names or competitor brands here; topics belong in 'default_topics' and competitors are set separately."
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "description": "Existing Brand tags, by id, 'Namespace:Value', or bare value when unambiguous. An import never creates a tag: an unknown one rejects its record."
        },
        "llms": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "description": "Models this brand tracks, overriding its plan catalogue. Requires prompts_per_model, and every listed model must be available in the brand's country."
        },
        "prompts_per_model": {
          "type": "integer",
          "minimum": 1,
          "description": "Prompts each model in llms tracks. Requires llms."
        },
        "name_variants": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 255
          },
          "description": "Canonical alias field retained for backward compatibility; prefer aliases."
        },
        "company_id": {
          "type": "string",
          "description": "Backward-compatible nested company ID; prefer top-level company_id."
        },
        "auto_purchase_plan_license": {
          "type": "boolean",
          "description": "Purchase a missing plan license when permitted."
        }
      },
      "required": [
        "name"
      ],
      "additionalProperties": true
    },
    "user_access_assignments": {
      "type": "array",
      "description": "Optional home-company user grants applied atomically with brand create/import. Company Admins are always granted OWNER even when omitted. Each entry: {user_id, role} where role is OWNER | EDITOR | VIEWER | MONITOR_ONLY. On bulk import, the same assignments apply to every created brand.",
      "items": {
        "type": "object",
        "properties": {
          "user_id": {
            "type": "string",
            "description": "Target user UUID in the brand home company."
          },
          "role": {
            "type": "string",
            "enum": [
              "OWNER",
              "EDITOR",
              "VIEWER",
              "MONITOR_ONLY"
            ]
          }
        },
        "required": [
          "user_id",
          "role"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "brand"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Brand creation validation result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "competitor": {
      "type": "object"
    }
  },
  "required": [
    "competitor"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Competitor creation validation result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "user": {
      "type": "object"
    }
  },
  "required": [
    "user"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "User invitation validation result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_ids": {
      "type": "array",
      "maxItems": 100
    },
    "status": {
      "type": "string"
    }
  },
  "required": [
    "brand_ids",
    "status"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Brand status validation result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "user_id": {
      "type": "string"
    },
    "assignments": {
      "type": "array",
      "maxItems": 100
    }
  },
  "required": [
    "user_id",
    "assignments"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "User brand access validation result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "user_ids": {
      "type": "array",
      "maxItems": 100
    },
    "emails": {
      "type": "array",
      "maxItems": 100
    },
    "company_id": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "inactive"
      ]
    }
  },
  "required": [
    "status"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "User status validation result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "spec": {
      "type": "object",
      "description": "Complete SlideDeckSpec (title, slides[]).",
      "additionalProperties": true
    }
  },
  "required": [
    "spec"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "valid": {
          "type": "boolean",
          "const": true
        },
        "normalizedSpec": {
          "type": "object",
          "additionalProperties": true,
          "description": "Validated SlideDeckSpec."
        }
      },
      "additionalProperties": true,
      "required": [
        "valid",
        "normalizedSpec"
      ],
      "description": "Successful validation with normalized spec."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string"
    },
    "settings": {
      "type": "object"
    }
  },
  "required": [
    "brand_id",
    "settings"
  ]
}

{
  "oneOf": [
    {
      "type": "object",
      "additionalProperties": true,
      "description": "Brand settings validation result."
    },
    {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "const": false
        },
        "error": {
          "type": "string"
        }
      },
      "required": [
        "success",
        "error"
      ],
      "additionalProperties": false
    }
  ]
}