Schema | searchconsole-mcp

Server Configuration

Describes the environment variables required to run the server.

Name	Required	Description	Default
`GOOGLE_APPLICATION_CREDENTIALS`	No	Path to your Google Cloud service account key JSON file. This is recommended for automation and is used for authentication if you are not using system-level user credentials.

Capabilities

Features and capabilities supported by this server

Capability	Details
`tools`	{ "listChanged": false }
`prompts`	{ "listChanged": false }
`resources`	{ "subscribe": false, "listChanged": false }
`experimental`	{}

Tools

Functions exposed to the LLM to take actions

Name Description

Name	Description
list_sites	Lists all verified properties in Google Search Console. Returns site URLs and permission levels.
query_search_analytics	Query Google Search Console search analytics data. This is the main keyword research tool. Returns rows with clicks, impressions, CTR, and average position. Args: site_url: The site URL as it appears in Search Console (e.g. "https://mychefai.com" or "sc-domain:mychefai.com"). start_date: Start date in YYYY-MM-DD format. end_date: End date in YYYY-MM-DD format. dimensions: List of dimensions to group by. Options: query, page, date, country, device, searchAppearance. Defaults to ["query"]. row_limit: Max rows to return (1-25000, default 1000). start_row: Starting row offset for pagination (default 0). dimension_filters: Optional list of filter objects. Each filter has: - dimension: the dimension to filter on (e.g. "query", "page") - operator: one of "contains", "equals", "notContains", "notEquals", "includingRegex", "excludingRegex" - expression: the filter value Example: [{"dimension": "query", "operator": "contains", "expression": "keto"}] search_type: Type of search results. One of: web, image, video, news, discover, googleNews. Default "web". aggregation_type: How to aggregate results. One of: auto, byPage, byProperty. If omitted, the API auto-selects.
list_sitemaps	Lists submitted sitemaps for a Search Console property. `Args: site_url: The site URL as it appears in Search Console (e.g. "https://mychefai.com" or "sc-domain:mychefai.com").`

list_sites

Lists all verified properties in Google Search Console.

Returns site URLs and permission levels.

query_search_analytics

Query Google Search Console search analytics data.

This is the main keyword research tool. Returns rows with clicks,
impressions, CTR, and average position.

Args:
    site_url: The site URL as it appears in Search Console
        (e.g. "https://mychefai.com" or "sc-domain:mychefai.com").
    start_date: Start date in YYYY-MM-DD format.
    end_date: End date in YYYY-MM-DD format.
    dimensions: List of dimensions to group by. Options: query, page,
        date, country, device, searchAppearance. Defaults to ["query"].
    row_limit: Max rows to return (1-25000, default 1000).
    start_row: Starting row offset for pagination (default 0).
    dimension_filters: Optional list of filter objects. Each filter has:
        - dimension: the dimension to filter on (e.g. "query", "page")
        - operator: one of "contains", "equals", "notContains",
          "notEquals", "includingRegex", "excludingRegex"
        - expression: the filter value
        Example: [{"dimension": "query", "operator": "contains",
                    "expression": "keto"}]
    search_type: Type of search results. One of: web, image, video,
        news, discover, googleNews. Default "web".
    aggregation_type: How to aggregate results. One of: auto, byPage,
        byProperty. If omitted, the API auto-selects.

list_sitemaps

Lists submitted sitemaps for a Search Console property.

Args:
    site_url: The site URL as it appears in Search Console
        (e.g. "https://mychefai.com" or "sc-domain:mychefai.com").

Prompts

Interactive templates invoked by user choice

Name	Description
No prompts

Resources

Contextual data attached and managed by the client

Name	Description
No resources

searchconsole-mcp

Server Configuration

Capabilities

Tools

Prompts

Resources

Latest Blog Posts

MCP directory API