devtune_get_visibility_summary
Get AI search visibility summary metrics for a project. The default aggregates only the project’s currently active platforms and returns measurement metadata; use only measurement.reportablePlatforms for current per-platform reporting. This excludes configured onboarding platforms that have no measurements in the window. measurement.dataStatus=no_data means the platform was not measured in the window, not that visibility was zero. Inactive historical data is excluded unless explicitly requested. Organic percentage fields use 0 to 100; citationPresence and shareOfVoice are null when no response has usable citation data, shareOfVoice also when neither the primary brand nor a competitor was cited, and brandAwareness is null when no answer was measured. shareOfVoiceRange, citationPresenceRange and brandAwarenessRange hold the rate as value with a 90% range as low and high in percent, successes, the answer or citation count n and nEffective; directional true means too few to rely on. advertising reports separate forward-only ads detected, measuredResponses coverage, and primaryRate/competitorRate fractions from 0 to 1, null when unmeasured, each with a primaryRateRange/competitorRateRange 90% range in the same unit. Never combine advertising with organic Presence. platformCadences lists each platform’s cadenceDays; window figures include weekly platforms, and lastCheckedOn gives the last date a weekly platform was checked. promptScope=unbranded leaves out topics whose every prompt names the project’s own brand, as the dashboard headline does; the default all counts every topic. advertising counts every topic whatever promptScope is.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "devtune_get_visibility_summary"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topicId | No | Filter by topic UUID. | |
| platform | No | Filter by AI platform (e.g. chatgpt, perplexity, gemini). | |
| windowDays | No | Rolling window in days: 30 or 90. Defaults to 30. | |
| promptScope | No | Which topics to count: all (default), branded (only topics whose every prompt names the project’s own brand) or unbranded (every other topic, mixed ones included). Prompts that name the brand usually get it mentioned, so unbranded matches the dashboard headline. Applies together with topicId. | |
| includeHistoricalPlatforms | No | Include data from a requested inactive platform. Defaults to false and should only be enabled when the user explicitly asks for historical platform data. |