List Search Console properties
list_sitesUse this when the user asks which Search Console properties they can analyze. Lists all Google Search Console properties connected to the authenticated GSC Wizard account: the site URL (a domain property prefixed with sc-domain: or a URL prefix property), tags, and which data source backs the property. Properties another user has shared with you are included too, badged with sharedBy (the owner) and accessLevel (READ_ONLY or FULL). Each property row carries permissionLevel, readable and activated; a table view shows the last two as its Status column ("Not verified in GSC" for readable: false, "Not activated" for activated: false, empty when both are true). permissionLevel is the Google Search Console permission (siteOwner / siteFullUser / siteRestrictedUser / siteUnverifiedUser), and readable: false means Google will refuse every data request for that property: it is listed in Search Console but not verified, so the user must verify it at search.google.com/search-console before any report will work, and other tools refuse it with reason property_not_verified. Do not attempt reads on a property with readable: false; tell the user to verify it instead. Activating it does not help. activated: false means the property is connected but is not shown on the account dashboard and is not synced to full storage, or is shown but past the plan's dashboard property limit, so every other property-scoped tool will refuse it (reason property_not_selected or over_api_property_limit). Do not attempt reads on those either: where this connection offers it, call set_dashboard_visibility to activate the property first (hiding another one if the plan is at its limit), or choose one with activated: true. Properties shared with the caller are always activated: true, because the grant is itself the selection; a share whose owner no longer has an active GSC Wizard plan is left out, since no tool can read it. gscScope is the Search Console access of the Google connection behind the property: "full" allows submit_sitemap and create_gsc_property, "readonly" means Google will refuse those two (reads still work); absent when unknown. Not for Bing, Yandex or GA4: use list_bing_sites, list_yandex_sites or list_ga4_properties. Owned properties come first, then shared ones, each by siteUrl ascending.
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": "list_sites"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| new | No | ||
| hint | No | ||
| kind | No | Widget variant: "kpis", "table", or "sections". | |
| kpis | No | KPI cards (kind="kpis"). | |
| lost | No | ||
| note | No | Caveat about the result, when the tool returned one. | |
| rows | No | Data rows (kind="table"), each with every field of the tool's own row; columns name the ones drawn. | |
| notes | No | Caveats about the result, when the tool returned several. | |
| range | No | The window the numbers cover. | |
| scope | No | The brand, content group or topic cluster filter these numbers are narrowed to; absent when the call was unscoped and the numbers cover the whole property. | |
| title | No | ||
| blocks | No | Stacked sub-blocks (kind="sections"). | |
| counts | No | get_ranking_changes: the full size of each bucket before `limit`. | |
| deltas | No | get_site_summary: current minus previous (ctrPoints in percentage points). | |
| reason | No | ||
| source | No | ||
| thenBy | No | Secondary sort field, when the tool states one. | |
| account | No | ||
| columns | No | Column defs (kind="table"). | |
| current | No | get_site_summary: the window's totals (ctr 0-100, impression-weighted avgPosition). | |
| summary | No | Metric totals keyed by GA4 metric name. | |
| warning | No | A caveat that changes how the numbers read. | |
| coverage | No | How much of the property total the returned rows cover, with the property totals inline. Quote totals from here; do not sum the rows. | |
| declined | No | ||
| improved | No | ||
| nextStep | No | ||
| ordering | No | Sort order per list, when the result holds several lists. | |
| previous | No | get_site_summary: the comparison window's totals. | |
| sortedBy | No | Row field the rows are sorted by. | |
| timeZone | No | GA4 property's IANA reporting time zone. | |
| dailyRows | No | get_site_summary: the window day by day, oldest first. | |
| dimension | No | ||
| emptyText | No | ||
| scanLimit | No | ||
| siteScope | No | Set when GA4 numbers were narrowed to this site's hostnames because the property is shared with other sites. | |
| sortOrder | No | "asc" or "desc". | |
| thenOrder | No | The tie-break's direction, present only when it differs from sortOrder. | |
| totalRows | No | ||
| assistants | No | get_ga4_llm_traffic: one row per AI assistant (the table rows). | |
| comparison | No | The comparison window (get_site_summary, get_ranking_changes). | |
| dataSource | No | Where the numbers were read from: the warehouse or the live API. | |
| hasRevenue | No | ||
| pagination | No | Where this page of rows sits in the whole result, and how to fetch the next one. | |
| timeseries | No | get_ga4_overview with includeTimeseries: daily points, oldest first. | |
| partialDays | No | Requested days after settledThrough; their numbers are still incomplete. | |
| prevSummary | No | The comparison period's totals; null when it has no GA4 data. | |
| currencyCode | No | ||
| dataMaturity | No | ||
| emptyBecause | No | ||
| ga4OnlyCount | No | ||
| gscOnlyCount | No | ||
| hasEcommerce | No | ||
| landingPages | No | get_ga4_llm_traffic: landing pages of AI assistant sessions. | |
| matchedCount | No | ||
| methodLimits | No | ||
| hasComparison | No | ||
| notConfigured | No | ||
| totalSessions | No | ||
| prevTimeseries | No | The comparison period's daily points; null when it has no GA4 data. | |
| reauthRequired | No | ||
| settledThrough | No | Last day the data is complete through. | |
| comparisonRange | No | The comparison window of a GA4 view tool; null when there is none. | |
| ecommerceSummary | No | ||
| sourceTimeseries | No | get_ga4_llm_traffic with includeDailySplit: daily sessions per assistant. | |
| comparisonHasData | No | false when the comparison period has no data at all, so there is no comparison. | |
| matchedClickShare | No | A 0-1 fraction of the named-query clicks the estimates cover. | |
| prevTotalSessions | No | ||
| previousDailyRows | No | get_site_summary: the comparison window day by day, oldest first; absent for a window over 180 days. | |
| llmShareOfSessions | No | A 0-1 fraction. | |
| coverageUnavailable | No | Why coverage is null, when it is. | |
| warehouseLatestDate | No | Newest day the warehouse holds for the property; days after it in the range are missing, not zero. | |
| prevEcommerceSummary | No | ||
| prevLlmShareOfSessions | No |