# gsc_cluster_queries

> Cluster Search Console queries by simple tokens and intent signals: brand/non-brand, question, category, and topic tokens.

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources) / [Search Console](https://www.getmcpads.com/docs/sources/search-console)

Cluster Search Console queries by simple tokens and intent signals: brand/non-brand, question, category, and topic tokens.

|  |  |
| --- | --- |
| Source | [Search Console](https://www.getmcpads.com/docs/sources/search-console) |
| Kind | Read |
| Discovery | Reachable through `search_tools` and `run_tool` |
| Account parameter | `siteUrl` |
| Endpoint | https://mcp.getmcpads.com/search-console/mcp |

## Parameters

| Name | Type | Required | Notes |
| --- | --- | --- | --- |
| `siteUrl` | string | Optional | Search Console property URL, e.g. https://example.com/ or sc-domain:example.com. Uses GSC_SITE_URL when omitted. |
| `searchType` | string | Optional | One of: `web`, `image`, `video`, `news`, `discover`, `googleNews`. Default: `"web"`. |
| `datePreset` | string | Optional | One of: `today`, `yesterday`, `last7days`, `last28days`, `last3months`, `last6months`, `last12months`, `last16months`. Default: `"last28days"`. |
| `dateRange` | object | Optional |  |
| `brandTerms` | array | Optional | Optional brand terms. Defaults to terms derived from the property domain. Default: `[]`. |
| `categoryRules` | object | Optional | Optional map of category name to matching tokens/phrases. |
| `limit` | integer | Optional | Default: `5000`. |
| `maxClusters` | integer | Optional | Default: `25`. |
| `topQueriesPerCluster` | integer | Optional | Default: `10`. |

## Calling it

Through run_tool, since it is not announced

```json
{
  "name": "run_tool",
  "arguments": {
    "name": "gsc_cluster_queries",
    "args": {}
  }
}
```

- [Search Console metrics](https://www.getmcpads.com/docs/sources/search-console/metrics): What you can ask for.
- [Search Console dimensions](https://www.getmcpads.com/docs/sources/search-console/dimensions): How you can break it down.

---

This page as HTML: https://www.getmcpads.com/docs/sources/search-console/tools/gsc_cluster_queries
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.