Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Find which sources support the measured brand statements.
get_grounding_sources. Operation: read. Uses the authorized connection; no project or content changes are made by this tool.
| Name | Type | Required | Default | Meaning and accepted values |
|---|---|---|---|---|
project_id | string | Yes | Required | Project ID from list_projects. Select the project in the intended workspace and environment. |
run_id | string | Yes | Required | Run ID from list_runs for this project. Use the exact returned value and check readiness before reading measurements. |
denominator | string | No | 'grounding_pool' | Use grounding_pool for this workflow. The handler accepts per_source but does not change the numeric calculation; do not present it as a separately calculated rate. |
aggregation_level | string | No | 'domain' | domain requests source-domain results; url requests individual-page results. Keep the same reporting unit when comparing measurements. |
group_by | string[] or null | No | null | Platform grouping is supported on the all-brand, unrestricted-sentiment path. Requests scoped to self, competitors, or a sentiment can drop the grouping with a warning. |
filters | object[] or null | No | null | Select measured answers with objects containing dimension and values. Use labels from list_dimension_options; inspect returned warnings for filters that were not applied. |
brand_subset | string or null | No | null | Select statements about self (the target brand), competitors, or all brands. Omission uses all. |
sentiment_filter | string or null | No | null | Restrict grounding evidence to positive, negative, or neutral sentiment; any leaves sentiment unrestricted. |
params object for MCP tools/call.
{
"name": "get_grounding_sources",
"arguments": {
"project_id": "PROJECT_ID",
"run_id": "RUN_ID",
"denominator": "grounding_pool",
"aggregation_level": "domain",
"brand_subset": "self"
}
}
| Field | Meaning and use |
|---|---|
data.brand_subset | Brand scope used for the returned source rows. |
data.aggregation_level | Requested source reporting unit; verify the returned source keys. |
data.denominator | Accepted label. In this edition, changing it does not calculate a different numeric rate. |
data.rows[].domain_or_url | Source associated with the returned grounding result. |
data.rows[].estimate | Source estimate and uncertainty for the selected scope. This is not the citation-coverage endpoint’s estimate. |
{
"data_ready": true,
"data": {
"aggregation_level": "domain",
"denominator": "grounding_pool",
"brand_subset": "self",
"rows": [
{
"domain_or_url": "allure.com",
"group_by_values": {},
"estimate": {
"value": 1.1,
"ci": {
"lower": 0.3,
"upper": 4,
"level": 0.95
},
"n": 2,
"stability": "insufficient",
"stability_n": 2
}
}
]
}
}