Get scoped visibility score
get-visibility-scoreGet the exact visibility score for the scope you name: prompt type, topic, custom filters and engine, in one run or a date window. Every figure is scoped to the arguments given and matches the dashboard for the same selection. Each field matches a dashboard name: score = AI AuraScore (0-100), coverage = Mention Rate (a 0-1 ratio, mentions / answers), share_of_voice = Share of Voice (a 0-1 ratio), mentions = answers that mention you, mention_count = mentions and citations behind Share of Voice; answers and prompts are the counts in scope. It is NOT equivalent to averaging get-prompt-scores: per-prompt scores do not average into the scoped score, and this tool returns the scoped figure directly. Scope is run_id when given, else the latest completed run of run_date, else the latest completed run for range latest_run, else the last range days (default 15d, the same default period as the dashboard). prompt_type defaults to non_branded (prompts naming neither us nor a competitor); branded names only us, competitor_branded names a competitor with or without us, and each prompt is in exactly one. Valid filters keys and value slugs are the ones list-prompt-filters returns; an undeclared key is rejected with the valid options. Score and share_of_voice are null when the scope has nothing to score. The response scope.run_id is the run scored (null for a date window). compare-visibility-runs compares runs or slices side by side; get-visibility-summary gives the stored summary of a run.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"domain_id": "<domain_id>"
},
"name": "get-visibility-score"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| range | No | Pool every run in the last N days (defaults to 15d), or latest_run for the newest completed run alone. Ignored with run_id or run_date. | |
| engine | No | Narrow to one engine. Omit for all engines. | |
| run_id | No | Completed visibility run ID. Overrides range and run_date. | |
| filters | No | {filterKey: valueSlug} from list-prompt-filters, ANDed | |
| run_date | No | A day (YYYY-MM-DD in time_zone): scores that day's latest completed run. Overrides range. | |
| topic_id | No | Topic ID from list-prompt-topics | |
| domain_id | Yes | Domain ID from list-domains | |
| time_zone | No | IANA time zone that decides which day a run belongs to. Defaults to UTC. | |
| prompt_type | No | Prompt Type segment. Defaults to non_branded. | non_branded |