@getmcpads/google-search-console-mcp-server 1.0.2 → 2.0.0

package/dist/index.js

@@ -1,8 +1,290 @@
+// src/parameter-descriptions.ts
+var PARAMETER_DESCRIPTIONS = {
+  "filters": "Filters combined according to this tool's query schema. Use provider field names and the declared operators.",
+  "searchType": "Search surface to report, such as web, image, video, news or Discover. Availability depends on the property.",
+  "searchTypes": "Search surfaces to compare. Each surface is queried separately; do not sum overlapping surfaces.",
+  "datePreset": "Named reporting period. Use the custom date range when you need exact start and end dates.",
+  "dateRange": "Explicit reporting start and end dates in YYYY-MM-DD format.",
+  "timeRange": "Explicit provider reporting period with since and until dates.",
+  "startDate": "First date of the reporting period, in YYYY-MM-DD format.",
+  "endDate": "Last date of the reporting period, in YYYY-MM-DD format, on or after startDate.",
+  "since": "Beginning of the requested reporting period; use the format accepted by the provider.",
+  "until": "End of the requested reporting period; use the format accepted by the provider.",
+  "orderBy": "Field used to order report rows.",
+  "orderField": "Provider field used to order report rows.",
+  "orderDirection": "Sort direction for the selected ordering field.",
+  "orderType": "Sort direction for the selected ordering field.",
+  "sortBy": "Metric or dimension used to rank the returned results.",
+  "sort": "Native provider ordering expressions.",
+  "limit": "Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results.",
+  "topN": "Maximum number of highest-ranked results to return.",
+  "pageSize": "Maximum items requested per page. Follow the returned pagination information for remaining results.",
+  "page": "Page number to request, starting at 1.",
+  "offset": "Zero-based number of rows to skip before returning results.",
+  "bookmark": "Opaque Pinterest pagination bookmark returned by the previous response. Omit on the first request.",
+  "after": "Opaque cursor for the next page returned by Meta.",
+  "before": "Opaque cursor for the previous page returned by Meta.",
+  "includeUnchanged": "Include entries with no observed change in the comparison.",
+  "minImpressions": "Minimum reported impressions required for a row to enter the analysis.",
+  "objectives": "Analysis goals that determine the recommended large-site sampling strategy.",
+  "pageLimit": "Maximum number of pages considered for the sampling plan.",
+  "maxInspectionUrls": "Maximum URL Inspection candidates included in the plan; inspection calls consume provider quota.",
+  "minImpressionsForLowCtr": "Minimum impressions before a page is considered for low-CTR analysis.",
+  "staleSitemapDays": "Number of days after which a sitemap's last download is considered stale.",
+  "continueOnError": "Continue with other URLs when one inspection fails, returning individual failures.",
+  "dimension": "Reporting dimension used to group and compare results.",
+  "maxClusters": "Maximum query clusters to return.",
+  "topQueriesPerCluster": "Maximum example queries returned for each cluster.",
+  "minPages": "Minimum distinct pages ranking for a query before it is considered a cannibalization candidate.",
+  "adAccountId": "Owning advertising account ID. Use the exact ID returned by account discovery; do not substitute a campaign or business ID.",
+  "advertiserId": "TikTok advertiser account ID as a string.",
+  "customerId": "Google Ads customer ID, without hyphens.",
+  "propertyId": "Google Analytics property ID; use the property, not the account or measurement ID.",
+  "level": "Entity or aggregation level for the requested report.",
+  "dataLevel": "TikTok reporting aggregation level. Metrics and dimensions must be compatible with this level.",
+  "granularity": "Time bucket used to aggregate reporting rows.",
+  "columns": "Native Pinterest reporting column names. Discover supported columns before selecting metrics.",
+  "executionMode": "Choose the supported synchronous, asynchronous or automatic report execution strategy.",
+  "entityIds": "Exact IDs of the entities to include in the selected reporting level.",
+  "targetingTypes": "Native targeting categories used to break down delivery.",
+  "clickWindowDays": "Click-through attribution window, in days.",
+  "engagementWindowDays": "Engagement-through attribution window, in days.",
+  "viewWindowDays": "View-through attribution window, in days.",
+  "conversionReportTime": "Whether conversions are assigned to the ad action date or the conversion date.",
+  "attributionTypes": "Provider attribution categories included in the report.",
+  "reportingTimezone": "Provider reporting timezone selector. Keep it consistent when comparing periods.",
+  "campaignIds": "Restrict results to these campaign IDs.",
+  "adGroupIds": "Restrict results to these ad group IDs.",
+  "adgroupIds": "Restrict TikTok results to these ad group IDs.",
+  "adIds": "Restrict results to these ad IDs.",
+  "campaignId": "Exact campaign ID in the selected advertising account.",
+  "adGroupId": "Exact ad group ID in the selected advertising account.",
+  "adSetId": "Exact Meta ad set ID in the selected advertising account.",
+  "adId": "Exact ad ID in the selected advertising account.",
+  "entityId": "Exact ID of the entity selected by this operation. It must belong to the selected account.",
+  "onlyWithPeriodDelivery": "Keep only creatives with observed delivery in the requested date range.",
+  "breakdown": "Native reporting breakdown used to group results.",
+  "breakdowns": "Native reporting breakdowns. Check compatibility before combining them.",
+  "productGroupIds": "Restrict reporting to these product group IDs.",
+  "productItemIds": "Restrict reporting to these product item IDs.",
+  "includeProductSamples": "Include a limited sample of product records alongside inventory diagnostics.",
+  "sampleProductGroups": "Maximum product groups to sample for inventory diagnostics.",
+  "reportName": "Provider report name identifying the requested report recipe.",
+  "conversionProductAttributionType": "Pinterest product-conversion attribution category.",
+  "conversionProductBreakdown": "Pinterest product-conversion grouping level.",
+  "productSkuIds": "Restrict product-conversion reporting to these SKU IDs.",
+  "request": "Exact request schema name to inspect before composing a write payload.",
+  "entity": "Entity collection or level to inspect.",
+  "entityType": "Provider entity type to retrieve.",
+  "entityStatuses": "Native status values used to filter the entity collection.",
+  "statusFilter": "Native status values used to filter the returned entities.",
+  "targetingType": "Targeting dictionary to inspect, such as interests, locations or demographics.",
+  "interestId": "Native interest ID for the targeting lookup.",
+  "mode": "Operation or analysis mode. Only the values declared in this schema are supported.",
+  "matchTypes": "Keyword match types included in the lookup.",
+  "countryCode": "Country code used to localize keyword or targeting results.",
+  "keywords": "Keyword phrases to analyze; use the language and market of the intended audience.",
+  "term": "Search term used for the keyword lookup.",
+  "terms": "Search terms used for the keyword lookup.",
+  "audienceId": "Exact ID of the audience to inspect or modify.",
+  "customerListId": "Exact customer-list ID. Reading metadata does not upload customer data.",
+  "businessId": "Exact business account ID used for the lookup.",
+  "accountType": "Provider account category used to filter results.",
+  "ownershipType": "Filter audiences by provider ownership category.",
+  "excludeNca": "Whether to exclude Pinterest new-customer-acquisition audiences from this lookup.",
+  "audienceInsightType": "Pinterest audience-insights category to request.",
+  "surfaces": "Conversion-setup surfaces to inspect, according to the supported values.",
+  "includeDeletedTags": "Include deleted conversion tags in diagnostics.",
+  "lookbackPeriod": "Provider lookback period used for conversion diagnostics.",
+  "sourcePlatform": "Filter conversion data by source platform.",
+  "ingestionSource": "Filter conversion events by ingestion source.",
+  "catalogId": "Exact product catalog ID accessible to the selected account.",
+  "feedId": "Exact catalog feed ID.",
+  "processingResultId": "Exact catalog feed processing result ID to inspect.",
+  "productGroupId": "Exact product group ID.",
+  "productSetId": "Exact Meta product set ID belonging to the selected catalog.",
+  "exportType": "Provider export category to request.",
+  "action": "Supported operation within this tool's scoped provider surface.",
+  "includeDetails": "Include detailed provider records in addition to summary information.",
+  "leadFormId": "Exact lead form ID to inspect.",
+  "subscriptionId": "Exact subscription ID to inspect.",
+  "assetId": "Exact provider asset ID.",
+  "memberId": "Exact business member ID used for the read lookup.",
+  "partnerId": "Exact business partner ID used for the read lookup.",
+  "pinId": "Exact Pinterest pin ID.",
+  "pinIds": "Exact Pinterest pin IDs to include.",
+  "metrics": "Native or documented calculated metric names to request. Check compatibility with the selected dimensions.",
+  "metric": "Metric used for the analysis; use a name from the platform metric catalogue.",
+  "boardId": "Exact Pinterest board ID.",
+  "searchTerm": "Text used to filter or search the selected collection.",
+  "region": "Provider region selector used to localize trends.",
+  "productRegion": "Region used for product trend analysis.",
+  "trendType": "Provider trend category to return.",
+  "interests": "Native interest categories used to filter trends.",
+  "genders": "Native gender categories used to filter aggregate trends.",
+  "ageBuckets": "Native age groups used to filter aggregate trends.",
+  "includeKeywords": "Include related keyword details in the trend response.",
+  "includeDemographics": "Include available aggregate demographic breakdowns.",
+  "productCategories": "Native product category IDs or values used to filter trends.",
+  "verticals": "Native business verticals used to filter trends.",
+  "productLookbackDays": "Product-trend lookback window, in days.",
+  "productEngagementType": "Engagement signal used for product-trend analysis.",
+  "featuredInterest": "Featured interest category for the trends lookup.",
+  "reportType": "Native provider report type; determines supported metrics and dimensions.",
+  "promotionId": "Exact Pinterest product-group promotion ID.",
+  "type": "Provider object or operation type selected from this schema's allowed values.",
+  "productBreakdown": "Native product grouping used to join catalog items with reported insights.",
+  "catalogProductLimit": "Maximum catalog product records read for the join.",
+  "includeAdsets": "Include ad set configuration when checking brand safety.",
+  "includeBlockLists": "Include accessible brand-safety block-list metadata.",
+  "includeRawTargeting": "Include the native targeting specification for diagnostics.",
+  "cellEntityType": "Entity type represented by experiment cells.",
+  "includePagePosts": "Read related Facebook Page posts when the token has permission.",
+  "includeInstagramMedia": "Read related Instagram media when the token has permission.",
+  "includeInsights": "Include available insight metrics; additional provider permissions may be required.",
+  "edge": "Allowlisted Meta Graph edge to read on the selected node.",
+  "fields": "Native provider fields to return. Select only fields supported by the chosen object or report.",
+  "filtering": "Native provider filter expressions; credentials and account overrides are not allowed.",
+  "includeSummary": "Request the provider's available summary or total-count metadata.",
+  "actionBreakdowns": "Meta action-level breakdowns, subject to Insights compatibility rules.",
+  "actionAttributionWindows": "Meta attribution windows used to attribute action metrics.",
+  "timeIncrement": "Provider time-bucket size or supported aggregate value.",
+  "locationTypes": "Location dictionary categories to include in targeting search.",
+  "adFormat": "Native Meta ad preview format; must be compatible with this ad's creative.",
+  "handle": "Asynchronous catalog batch handle returned by the submission to inspect.",
+  "keepEmptyRows": "Keep provider rows whose selected metrics are all zero, where supported.",
+  "sampleLimit": "Maximum records included in the diagnostic sample.",
+  "isOpenFunnel": "Allow users to enter at any funnel step instead of requiring the first step.",
+  "visualizationType": "Supported funnel visualization mode.",
+  "breakdownLimit": "Maximum breakdown values to include in the funnel response.",
+  "nextActionLimit": "Maximum next actions returned for each funnel step.",
+  "fallbackToStepCounts": "If the advanced funnel is unavailable, return independent step counts with the limitation made explicit.",
+  "report": "Native GA4 report request object for this endpoint.",
+  "reports": "Native GA4 report request objects to execute in one batch.",
+  "dimensions": "Native reporting dimensions. Validate compatibility with the selected metrics.",
+  "compatibilityFilter": "Limit compatibility results to the requested GA4 compatibility category.",
+  "collection": "Allowlisted administrative resource collection to read.",
+  "settings": "Property configuration surfaces to inspect.",
+  "includeRecurring": "Include recurring audience-export configurations.",
+  "audienceExportName": "Full GA4 audience-export resource name returned by list_audience_exports.",
+  "queryLifetime": "Request lifetime reporting instead of the explicit reporting period where TikTok supports it.",
+  "declineThresholdPct": "Percentage decline used as a candidate signal for creative fatigue, requiring further evidence.",
+  "includeSavedAudiences": "Include accessible saved-audience metadata in the overlap analysis.",
+  "overlapThreshold": "Overlap threshold used to flag audience pairs, in the units declared by this schema.",
+  "serviceType": "TikTok report service category.",
+  "catalog": "Allowlisted targeting dictionary or catalog to inspect.",
+  "query": "Search text used to find matching entries in the selected catalogue.",
+  "parameters": "Native query parameters for this allowlisted read endpoint. Do not provide credentials or account overrides.",
+  "account_id": "Exact account ID selected for this platform in the GetMCPAds workspace.",
+  "platform": "Platform key identifying the connected advertising or analytics source.",
+  "id": "Exact saved object ID returned by the corresponding create or list tool.",
+  "revision": "Last known object revision, used to reject conflicting updates. Read the object before editing.",
+  "name": "Human-readable name for this object.",
+  "title": "Human-readable title for the resulting object or review.",
+  "clientLabel": "Display label identifying the client in the saved view.",
+  "config": "Complete saved-view configuration, including source, selected account, period and display options.",
+  "subject": "Entity or creative subject whose dated performance will be analyzed.",
+  "compare_previous": "Include the immediately preceding period of equal duration for comparison.",
+  "profile": "Creative brief profile containing the client's business context and analysis preferences.",
+  "primaryMetric": "Metric used to rank or evaluate the review; it must be available for the selected platform.",
+  "direction": "Whether higher or lower values of the primary metric represent improvement.",
+  "creative_ids": "Exact creative IDs to include in this review.",
+  "request_id": "Caller-generated request identifier. Reuse it for a retry of the same operation to avoid duplicate work.",
+  "expiresInDays": "Number of days before the public review sharing link expires.",
+  "client_id": "Exact saved business-client workspace ID.",
+  "review_id": "Exact review ID returned by the review creation or listing tool.",
+  "page_id": "Exact page identifier within the landing-page review.",
+  "entity_id": "Exact entity identifier in the selected review or platform context.",
+  "source_key": "Source identifier returned by the business review; keep the platform/account association intact.",
+  "metric_key": "Exact metric key in the review evidence.",
+  "follow_up_on": "Follow-up date for the decision, using the format declared in this schema.",
+  "hypothesis": "Specific hypothesis to record, supported by the review evidence.",
+  "successCriterion": "Measurable condition used to decide whether the recorded action succeeded.",
+  "outcome": "Observed outcome to record; distinguish evidence from an untested expectation.",
+  "status": "Status selected from the allowed values for this object or operation.",
+  "retry_source": "Source identifier to retry after reviewing its reported error.",
+  "site_origin": "Website origin to analyze, including https:// and hostname, without credentials or a path.",
+  "matchType": "Google Ads keyword match type for the forecast.",
+  "negativeKeywords": "Keyword phrases excluded from the keyword forecast.",
+  "negativeMatchType": "Match type applied to the negative keywords.",
+  "geoTargetIds": "Google Ads geo-target constant IDs for the intended locations.",
+  "languageId": "Google Ads language constant ID for the keyword request.",
+  "languageIds": "Google Ads language constant IDs for the intended audience.",
+  "network": "Google Ads search network selector used for planning.",
+  "biddingStrategy": "Supported bidding strategy for this temporary forecast. The request does not create a live campaign.",
+  "includeAdultKeywords": "Allow adult keyword ideas where supported by the provider and the selected market.",
+  "seedKeywords": "Seed keyword phrases from which Google generates keyword ideas.",
+  "includeAverageCpc": "Request average cost-per-click metrics when available.",
+  "includeDeviceBreakdown": "Include device-specific planning metrics when supported.",
+  "includeKeywordConcepts": "Include Google's keyword concept grouping metadata.",
+  "startYearMonth": "First year and month of the historical metrics period.",
+  "endYearMonth": "Last year and month of the historical metrics period.",
+  "includeDismissed": "Include recommendations already dismissed in the account.",
+  "operation": "Exact allowlisted operation to execute. Arbitrary provider operations are not accepted.",
+  "category": "Category selected from the provider dictionary or field catalogue.",
+  "selectable": "Filter the field catalogue by whether the field can appear in SELECT.",
+  "filterable": "Filter the field catalogue by whether the field can appear in WHERE.",
+  "sortable": "Filter the field catalogue by whether the field can appear in ORDER BY.",
+  "pageToken": "Opaque continuation token returned by the preceding provider response.",
+  "locationNames": "Human-readable location names for Google to resolve into geo-target constants.",
+  "locale": "Locale used for human-readable lookup results.",
+  "resource": "Native Google Ads resource from which the GAQL query selects rows.",
+  "cursor": "Opaque pagination cursor returned by the preceding response; omit for the first page.",
+  "kind": "Entity or request kind whose schema or data is being requested.",
+  "startTime": "Beginning of the reporting period as an ISO 8601 timestamp with an explicit timezone.",
+  "endTime": "End of the reporting period as an ISO 8601 timestamp with an explicit timezone, after startTime.",
+  "reportDimension": "Native dimension used to break down the Snapchat report."
+};
+
+// src/tool-quality.ts
+import { z } from "zod";
+var RESULT_SCHEMA = {
+  type: "object",
+  properties: {
+    result: {
+      description: "Original tool result: parsed JSON when the text is JSON, otherwise the text or multiple MCP content blocks. Provider fields depend on the selected query.",
+      type: ["object", "array", "string", "number", "boolean", "null"]
+    }
+  },
+  required: ["result"],
+  additionalProperties: true
+};
+function toolAnnotations(write) {
+  return { readOnlyHint: !write, destructiveHint: write, idempotentHint: !write, openWorldHint: true };
+}
+function structuredResult(value) {
+  if (value.isError) return value;
+  let result = value.content;
+  const first = value.content[0];
+  if (value.content.length === 1 && first?.type === "text" && typeof first.text === "string") {
+    result = first.text;
+    try {
+      result = JSON.parse(first.text);
+    } catch {
+    }
+  }
+  return { ...value, structuredContent: { ...value.structuredContent, result } };
+}
+var resultShape = { result: z.union([z.object({}).passthrough(), z.array(z.unknown()), z.string(), z.number(), z.boolean(), z.null()]).describe(RESULT_SCHEMA.properties.result.description) };
+function installToolQuality(server) {
+  server.tool = ((name, description, inputSchema, handler) => {
+    const write = Object.hasOwn(inputSchema, "confirm");
+    inputSchema = Object.fromEntries(Object.entries(inputSchema).map(([key, schema]) => [key, schema.description || PARAMETER_DESCRIPTIONS[key] ? schema.describe(schema.description || PARAMETER_DESCRIPTIONS[key]) : schema]));
+    return server.registerTool(name, {
+      title: name.replace(/_/g, " "),
+      description,
+      inputSchema,
+      outputSchema: resultShape,
+      annotations: toolAnnotations(write)
+    }, async (...args) => structuredResult(await handler(...args)));
+  });
+}
+
 // src/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 // src/platforms/gsc/tools.ts
-import { z } from "zod";
+import { z as z2 } from "zod";
 
 // src/core/errors.ts
 var PlatformApiError = class extends Error {
@@ -17,13 +299,6 @@ var PlatformApiError = class extends Error {
     this.retryAfter = retryAfter;
     this.name = "PlatformApiError";
   }
-  platform;
-  code;
-  isRateLimit;
-  isAuth;
-  isPermission;
-  suggestion;
-  retryAfter;
   toMcpError() {
     return {
       error: this.message,
@@ -210,6 +485,33 @@ function flattenSearchAnalyticsResponse(response, dimensions) {
 }
 
 // src/platforms/gsc/gscClient.ts
+function gscRouteClass(rawUrl) {
+  try {
+    const parsed = new URL(rawUrl);
+    if (parsed.pathname.endsWith("/searchAnalytics/query")) return "search_analytics";
+    if (parsed.pathname.endsWith("/urlInspection/index:inspect")) return "url_inspection";
+    if (parsed.pathname.includes("/sitemaps")) return "sitemaps";
+    if (parsed.pathname.includes("/sites")) return "sites";
+  } catch {
+  }
+  return "gsc_api";
+}
+function codeOwnedApiFailure(status) {
+  if (status === 401 || status === 403) {
+    return { message: "GSC API authorization failed.", status: "AUTHORIZATION_FAILED" };
+  }
+  if (status === 429) {
+    return { message: "GSC API rate limit was reached.", status: "RATE_LIMITED" };
+  }
+  if (status >= 500) {
+    return { message: "GSC API is temporarily unavailable.", status: "UPSTREAM_UNAVAILABLE" };
+  }
+  return { message: "GSC API rejected the request.", status: "REQUEST_REJECTED" };
+}
+var GSC_AUTO_PAGINATION_MAX_PAGES = 4;
+var GSC_AUTO_PAGINATION_MAX_ROWS = 1e5;
+var GSC_AUTO_PAGINATION_DEADLINE_MS = 3e4;
+var GSC_SINGLE_REQUEST_TIMEOUT_MS = 9e4;
 function getAuthorizationUrl(clientId, redirectUri, state) {
   const params = new URLSearchParams({
     client_id: clientId,
@@ -283,16 +585,16 @@ var GSCClient = class {
   // ============================================
   // PRIVATE METHODS
   // ============================================
-  async request(url, options = {}) {
+  async request(url, options = {}, timeoutMs = GSC_SINGLE_REQUEST_TIMEOUT_MS) {
+    if (!Number.isFinite(timeoutMs) || timeoutMs < 1) {
+      throw new GSCApiException("GSC request deadline expired before dispatch", 408, "TIMEOUT");
+    }
     const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), 9e4);
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
     try {
       const response = await fetch(url, {
         ...options,
         signal: controller.signal,
-        // Forced after the spread: once a bearer token is attached, a redirect
-        // must never be followed, or the credential would be forwarded to
-        // whatever host the redirect names.
         redirect: "error",
         headers: {
           Authorization: `Bearer ${this.accessToken}`,
@@ -301,21 +603,22 @@ var GSCClient = class {
         }
       });
       if (!response.ok) {
-        const errorBody = await response.json().catch(() => ({}));
-        const errorDetails = errorBody?.error;
-        console.error("[GSCClient] API Error:", response.status, JSON.stringify(errorBody, null, 2));
-        const detailedMessage = errorDetails?.message || `Request failed: ${response.statusText}`;
+        const failure = codeOwnedApiFailure(response.status);
+        console.error("[GSCClient] API error", {
+          status: response.status,
+          route: gscRouteClass(url)
+        });
         throw new GSCApiException(
-          detailedMessage,
+          failure.message,
           response.status,
-          errorDetails?.status
+          failure.status
         );
       }
-      return response.json();
+      return await response.json();
     } catch (error) {
       if (error instanceof DOMException && error.name === "AbortError") {
         throw new GSCApiException(
-          "GSC API request timed out after 90 seconds",
+          "GSC API request exceeded its bounded deadline",
           408,
           "TIMEOUT"
         );
@@ -365,39 +668,80 @@ var GSCClient = class {
     const url = `${GSC_API_BASE}/webmasters/v3/sites/${encodedSiteUrl}/searchAnalytics/query`;
     const MAX_ROWS_PER_REQUEST = 25e3;
     const rowLimit = request.rowLimit ?? MAX_ROWS_PER_REQUEST;
-    const initialOffset = request.startRow ?? 0;
+    const autoPaginate = request.rowLimit === void 0;
+    const paginationDeadline = Date.now() + GSC_AUTO_PAGINATION_DEADLINE_MS;
+    const remainingPaginationMs = () => {
+      const remaining = paginationDeadline - Date.now();
+      if (remaining < 1) {
+        throw new GSCApiException(
+          "GSC auto-pagination exceeded its 30-second total deadline",
+          408,
+          "PAGINATION_DEADLINE"
+        );
+      }
+      return remaining;
+    };
     const firstResponse = await this.request(url, {
       method: "POST",
       body: JSON.stringify({
         ...request,
         rowLimit: Math.min(rowLimit, MAX_ROWS_PER_REQUEST),
-        startRow: initialOffset
+        startRow: request.startRow ?? 0
       })
-    });
+    }, autoPaginate ? remainingPaginationMs() : GSC_SINGLE_REQUEST_TIMEOUT_MS);
+    if (autoPaginate) remainingPaginationMs();
     const returnedRows = firstResponse.rows?.length ?? 0;
     if (request.rowLimit || returnedRows < MAX_ROWS_PER_REQUEST) {
-      return firstResponse;
+      return {
+        ...firstResponse,
+        pagination: {
+          mode: autoPaginate ? "bounded_auto" : "single_page",
+          pageCount: 1,
+          rowCount: returnedRows,
+          maximumPages: autoPaginate ? GSC_AUTO_PAGINATION_MAX_PAGES : 1,
+          maximumRows: autoPaginate ? GSC_AUTO_PAGINATION_MAX_ROWS : rowLimit,
+          deadlineMs: autoPaginate ? GSC_AUTO_PAGINATION_DEADLINE_MS : GSC_SINGLE_REQUEST_TIMEOUT_MS,
+          truncated: false
+        }
+      };
     }
     const allRows = [...firstResponse.rows ?? []];
-    let currentOffset = initialOffset + returnedRows;
-    while (true) {
+    let currentOffset = (request.startRow ?? 0) + returnedRows;
+    let pageCount = 1;
+    let lastPageWasFull = returnedRows === MAX_ROWS_PER_REQUEST;
+    while (pageCount < GSC_AUTO_PAGINATION_MAX_PAGES && allRows.length < GSC_AUTO_PAGINATION_MAX_ROWS) {
+      const remainingRows = GSC_AUTO_PAGINATION_MAX_ROWS - allRows.length;
+      const requestedRows = Math.min(MAX_ROWS_PER_REQUEST, remainingRows);
       const pageResponse = await this.request(url, {
         method: "POST",
         body: JSON.stringify({
           ...request,
-          rowLimit: MAX_ROWS_PER_REQUEST,
+          rowLimit: requestedRows,
           startRow: currentOffset
         })
-      });
+      }, remainingPaginationMs());
+      remainingPaginationMs();
       const pageRows = pageResponse.rows?.length ?? 0;
+      pageCount += 1;
+      lastPageWasFull = pageRows === requestedRows;
       if (pageRows === 0) break;
-      allRows.push(...pageResponse.rows ?? []);
+      allRows.push(...(pageResponse.rows ?? []).slice(0, remainingRows));
       currentOffset += pageRows;
-      if (pageRows < MAX_ROWS_PER_REQUEST) break;
+      if (pageRows < requestedRows) break;
     }
+    remainingPaginationMs();
     return {
       ...firstResponse,
-      rows: allRows
+      rows: allRows.slice(0, GSC_AUTO_PAGINATION_MAX_ROWS),
+      pagination: {
+        mode: "bounded_auto",
+        pageCount,
+        rowCount: Math.min(allRows.length, GSC_AUTO_PAGINATION_MAX_ROWS),
+        maximumPages: GSC_AUTO_PAGINATION_MAX_PAGES,
+        maximumRows: GSC_AUTO_PAGINATION_MAX_ROWS,
+        deadlineMs: GSC_AUTO_PAGINATION_DEADLINE_MS,
+        truncated: lastPageWasFull && (pageCount >= GSC_AUTO_PAGINATION_MAX_PAGES || allRows.length >= GSC_AUTO_PAGINATION_MAX_ROWS)
+      }
     };
   }
   // ============================================
@@ -838,36 +1182,37 @@ function planGSCQuery(params) {
 }
 
 // src/platforms/gsc/tools.ts
-var siteUrlSchema = z.string().optional().describe("Search Console property URL, e.g. https://example.com/ or sc-domain:example.com. Uses GSC_SITE_URL when omitted.");
-var datePresetSchema = z.enum(["today", "yesterday", "last7days", "last28days", "last3months", "last6months", "last12months", "last16months"]);
-var searchTypeSchema = z.enum(["web", "image", "video", "news", "discover", "googleNews"]);
-var dataStateSchema = z.enum(["final", "all", "hourly_all"]);
-var aggregationTypeSchema = z.enum(["auto", "byPage", "byProperty", "byNewsShowcasePanel"]);
-var limitSchema = z.number().int().min(1).max(25e3).optional().default(1e3);
-var dateRangeSchema = z.object({
-  startDate: z.string().describe("Start date YYYY-MM-DD"),
-  endDate: z.string().describe("End date YYYY-MM-DD")
+var siteUrlSchema = z2.string().optional().describe("Search Console property URL, e.g. https://example.com/ or sc-domain:example.com. Uses GSC_SITE_URL when omitted.");
+var datePresetSchema = z2.enum(["today", "yesterday", "last7days", "last28days", "last3months", "last6months", "last12months", "last16months"]);
+var searchTypeSchema = z2.enum(["web", "image", "video", "news", "discover", "googleNews"]);
+var dataStateSchema = z2.enum(["final", "all", "hourly_all"]);
+var aggregationTypeSchema = z2.enum(["auto", "byPage", "byProperty", "byNewsShowcasePanel"]);
+var CompareSearchTypesSchema = z2.array(searchTypeSchema).min(1).max(6).refine((items) => new Set(items).size === items.length, "searchTypes must be unique");
+var limitSchema = z2.number().int().min(1).max(25e3).optional().default(1e3);
+var dateRangeSchema = z2.object({
+  startDate: z2.string().describe("Start date YYYY-MM-DD"),
+  endDate: z2.string().describe("End date YYYY-MM-DD")
 });
-var comparisonDimensionSchema = z.enum(["query", "page"]);
-var sitemapBaselineSchema = z.object({
-  path: z.string().describe("Sitemap URL/path returned by GSC."),
-  submitted: z.number().int().min(0).optional().default(0),
-  indexed: z.number().int().min(0).optional().default(0),
-  warnings: z.number().int().min(0).optional().default(0),
-  errors: z.number().int().min(0).optional().default(0),
-  lastSubmitted: z.string().optional(),
-  lastDownloaded: z.string().optional()
+var comparisonDimensionSchema = z2.enum(["query", "page"]);
+var sitemapBaselineSchema = z2.object({
+  path: z2.string().describe("Sitemap URL/path returned by GSC."),
+  submitted: z2.number().int().min(0).optional().default(0),
+  indexed: z2.number().int().min(0).optional().default(0),
+  warnings: z2.number().int().min(0).optional().default(0),
+  errors: z2.number().int().min(0).optional().default(0),
+  lastSubmitted: z2.string().optional(),
+  lastDownloaded: z2.string().optional()
 });
-var watchlistUrlSchema = z.object({
-  url: z.string().url(),
-  label: z.string().optional(),
-  priority: z.enum(["low", "medium", "high", "critical"]).optional().default("medium"),
-  tags: z.array(z.string()).optional().default([]),
-  expectedVerdict: z.enum(["PASS", "PARTIAL", "FAIL", "NEUTRAL", "VERDICT_UNSPECIFIED"]).optional().default("PASS"),
-  expectedCanonical: z.string().url().optional(),
-  expectedCoverageState: z.string().optional()
+var watchlistUrlSchema = z2.object({
+  url: z2.string().url(),
+  label: z2.string().optional(),
+  priority: z2.enum(["low", "medium", "high", "critical"]).optional().default("medium"),
+  tags: z2.array(z2.string()).optional().default([]),
+  expectedVerdict: z2.enum(["PASS", "PARTIAL", "FAIL", "NEUTRAL", "VERDICT_UNSPECIFIED"]).optional().default("PASS"),
+  expectedCanonical: z2.string().url().optional(),
+  expectedCoverageState: z2.string().optional()
 });
-var samplingObjectiveSchema = z.enum(["topTraffic", "lowCtr", "declining", "sitemapRisk", "staleSitemaps"]);
+var samplingObjectiveSchema = z2.enum(["topTraffic", "lowCtr", "declining", "sitemapRisk", "staleSitemaps"]);
 var BULK_URL_INSPECTION_LIMIT = 10;
 var URL_INSPECTION_DAILY_QUOTA = 2e3;
 var DEFAULT_FRESHNESS_LAG_WARNING_DAYS = 3;
@@ -998,7 +1343,6 @@ var AuthenticatedGSCClient = class {
       this.tokenExpiresAt = Date.now() + 45 * 60 * 1e3;
     }
   }
-  config;
   accessToken;
   tokenExpiresAt = 0;
   rateLimiter = new RateLimiter();
@@ -1528,26 +1872,26 @@ function registerGSCTools(server, config) {
 Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for available fields and rules.`,
     {
       siteUrl: siteUrlSchema,
-      metrics: z.array(z.string()).optional().describe("Native: clicks, impressions, ctr, position. Calculated: ctrOpportunity, clicksPerImpression, impressionShare, clickShare."),
-      dimensions: z.array(z.string()).max(5).optional().describe("Up to 5 dimensions selected from query, page, country, device, date, hour, searchAppearance."),
-      filters: z.array(z.object({
-        field: z.string(),
-        operator: z.enum(["contains", "equals", "notContains", "notEquals", "includingRegex", "excludingRegex"]),
-        value: z.union([z.string(), z.number(), z.boolean()])
+      metrics: z2.array(z2.string()).optional().describe("Native: clicks, impressions, ctr, position. Calculated: ctrOpportunity, clicksPerImpression, impressionShare, clickShare."),
+      dimensions: z2.array(z2.string()).max(5).optional().describe("Up to 5 dimensions selected from query, page, country, device, date, hour, searchAppearance."),
+      filters: z2.array(z2.object({
+        field: z2.string(),
+        operator: z2.enum(["contains", "equals", "notContains", "notEquals", "includingRegex", "excludingRegex"]),
+        value: z2.union([z2.string(), z2.number(), z2.boolean()])
       })).optional(),
       searchType: searchTypeSchema.optional().default("web"),
       dataState: dataStateSchema.optional().default("all").describe("final=stable data, all=fresh daily data, hourly_all=fresh hourly data (use hour dimension)."),
       aggregationType: aggregationTypeSchema.optional().default("auto").describe("Official GSC aggregation. byProperty is incompatible with page grouping/filtering and Discover/Google News. byNewsShowcasePanel requires discover/googleNews plus searchAppearance equals NEWS_SHOWCASE, and forbids page grouping/filtering or another searchAppearance filter."),
       datePreset: datePresetSchema.optional().default("last28days"),
-      dateRange: z.object({
-        startDate: z.string().describe("Start date YYYY-MM-DD"),
-        endDate: z.string().describe("End date YYYY-MM-DD")
+      dateRange: z2.object({
+        startDate: z2.string().describe("Start date YYYY-MM-DD"),
+        endDate: z2.string().describe("End date YYYY-MM-DD")
       }).optional(),
-      orderBy: z.enum(["clicks", "impressions", "ctr", "position", "ctrOpportunity", "clicksPerImpression", "impressionShare", "clickShare"]).optional().default("clicks"),
-      orderDirection: z.enum(["ASC", "DESC"]).optional().default("DESC"),
+      orderBy: z2.enum(["clicks", "impressions", "ctr", "position", "ctrOpportunity", "clicksPerImpression", "impressionShare", "clickShare"]).optional().default("clicks"),
+      orderDirection: z2.enum(["ASC", "DESC"]).optional().default("DESC"),
       limit: limitSchema,
-      startRow: z.number().int().min(0).optional().describe("Optional 0-based row offset for explicit pagination."),
-      autoPaginate: z.boolean().optional().default(false).describe("When true, omit rowLimit so the GSC client auto-paginates until exhaustion.")
+      startRow: z2.number().int().min(0).optional().describe("Optional 0-based row offset for explicit pagination."),
+      autoPaginate: z2.boolean().optional().default(false).describe("When true, omit rowLimit so the GSC client auto-paginates until exhaustion.")
     },
     async ({ siteUrl, metrics, dimensions, filters, searchType, dataState, aggregationType, datePreset, dateRange, orderBy, orderDirection, limit, startRow, autoPaginate }) => {
       try {
@@ -1597,6 +1941,11 @@ Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for
               mode: autoPaginate ? "auto_startRow" : "single_page",
               autoPaginate,
               startRow: startRow ?? 0,
+              pageCount: response.pagination?.pageCount ?? 1,
+              maximumPages: response.pagination?.maximumPages ?? 1,
+              maximumRows: response.pagination?.maximumRows ?? limit,
+              deadlineMs: response.pagination?.deadlineMs ?? 9e4,
+              truncated: response.pagination?.truncated ?? false,
               limit: autoPaginate ? null : limit
             },
             dataState,
@@ -1613,8 +1962,8 @@ Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for
     "Inspect a URL for Google indexing status, crawl info, mobile usability, AMP, and rich results. Quota: 2000 requests/day/property.",
     {
       siteUrl: siteUrlSchema,
-      url: z.string().url().describe("Full URL to inspect."),
-      languageCode: z.string().optional().describe("Optional IETF language tag, e.g. en-US or fr-FR.")
+      url: z2.string().url().describe("Full URL to inspect."),
+      languageCode: z2.string().optional().describe("Optional IETF language tag, e.g. en-US or fr-FR.")
     },
     async ({ siteUrl, url, languageCode }) => {
       try {
@@ -1639,9 +1988,9 @@ Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for
     "Inspect multiple URLs with a conservative sequential limit and normalized URL Inspection results. Quota: 2000 requests/day/property.",
     {
       siteUrl: siteUrlSchema,
-      urls: z.array(z.string().url()).min(1).max(BULK_URL_INSPECTION_LIMIT).describe(`Full URLs to inspect. Maximum ${BULK_URL_INSPECTION_LIMIT} per call to protect URL Inspection quota.`),
-      languageCode: z.string().optional().describe("Optional IETF language tag, e.g. en-US or fr-FR."),
-      continueOnError: z.boolean().optional().default(true).describe("When true, returns per-URL errors instead of failing the entire batch.")
+      urls: z2.array(z2.string().url()).min(1).max(BULK_URL_INSPECTION_LIMIT).describe(`Full URLs to inspect. Maximum ${BULK_URL_INSPECTION_LIMIT} per call to protect URL Inspection quota.`),
+      languageCode: z2.string().optional().describe("Optional IETF language tag, e.g. en-US or fr-FR."),
+      continueOnError: z2.boolean().optional().default(true).describe("When true, returns per-URL errors instead of failing the entire batch.")
     },
     async ({ siteUrl, urls, languageCode, continueOnError }) => {
       try {
@@ -1681,7 +2030,7 @@ Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for
     "List sitemaps submitted for a Search Console property, including processing status and submitted/indexed counts.",
     {
       siteUrl: siteUrlSchema,
-      sitemapIndex: z.string().url().optional().describe("Optional sitemap index URL used to return only its child sitemaps.")
+      sitemapIndex: z2.string().url().optional().describe("Optional sitemap index URL used to return only its child sitemaps.")
     },
     async ({ siteUrl, sitemapIndex }) => {
       try {
@@ -1709,7 +2058,7 @@ Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for
     "Get one submitted sitemap by full feed path, including type, fetch state, warnings/errors, and submitted/indexed content totals.",
     {
       siteUrl: siteUrlSchema,
-      feedpath: z.string().url().describe("Full sitemap URL exactly as submitted to Search Console.")
+      feedpath: z2.string().url().describe("Full sitemap URL exactly as submitted to Search Console.")
     },
     async ({ siteUrl, feedpath }) => {
       try {
@@ -1786,9 +2135,9 @@ Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for
     "Compare performance across Search Console search types: web, image, video, news, discover, and Google News.",
     {
       siteUrl: siteUrlSchema,
-      searchTypes: z.array(searchTypeSchema).optional().default(["web", "image", "video", "discover"]),
+      searchTypes: CompareSearchTypesSchema.optional().default(["web", "image", "video", "discover"]),
       datePreset: datePresetSchema.optional().default("last28days"),
-      dateRange: z.object({ startDate: z.string(), endDate: z.string() }).optional()
+      dateRange: z2.object({ startDate: z2.string(), endDate: z2.string() }).optional()
     },
     async ({ siteUrl, searchTypes, datePreset, dateRange }) => {
       try {
@@ -1839,7 +2188,7 @@ Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for
     {
       siteUrl: siteUrlSchema,
       searchType: searchTypeSchema.optional().default("web"),
-      lookbackDays: z.number().int().min(3).max(30).optional().default(14).describe("Recent days to scan for daily data. Max 30.")
+      lookbackDays: z2.number().int().min(3).max(30).optional().default(14).describe("Recent days to scan for daily data. Max 30.")
     },
     async ({ siteUrl, searchType, lookbackDays }) => {
       try {
@@ -1897,11 +2246,11 @@ Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for
     "Read-only monitoring snapshot for Search Analytics freshness, sitemap indexation totals, and an optional small URL Inspection sample.",
     {
       siteUrl: siteUrlSchema,
-      searchTypes: z.array(searchTypeSchema).min(1).max(6).optional().default(["web"]),
-      lookbackDays: z.number().int().min(3).max(30).optional().default(14).describe("Recent days to scan for Search Analytics freshness."),
-      freshnessLagWarningDays: z.number().int().min(1).max(14).optional().default(DEFAULT_FRESHNESS_LAG_WARNING_DAYS).describe("Maximum acceptable lag in days before freshness is marked delayed/stale."),
-      inspectUrls: z.array(z.string().url()).max(BULK_URL_INSPECTION_LIMIT).optional().default([]).describe(`Optional URLs to inspect. Maximum ${BULK_URL_INSPECTION_LIMIT} to protect URL Inspection quota.`),
-      languageCode: z.string().optional().describe("Optional IETF language tag for URL Inspection, e.g. en-US or fr-FR.")
+      searchTypes: z2.array(searchTypeSchema).min(1).max(6).optional().default(["web"]),
+      lookbackDays: z2.number().int().min(3).max(30).optional().default(14).describe("Recent days to scan for Search Analytics freshness."),
+      freshnessLagWarningDays: z2.number().int().min(1).max(14).optional().default(DEFAULT_FRESHNESS_LAG_WARNING_DAYS).describe("Maximum acceptable lag in days before freshness is marked delayed/stale."),
+      inspectUrls: z2.array(z2.string().url()).max(BULK_URL_INSPECTION_LIMIT).optional().default([]).describe(`Optional URLs to inspect. Maximum ${BULK_URL_INSPECTION_LIMIT} to protect URL Inspection quota.`),
+      languageCode: z2.string().optional().describe("Optional IETF language tag for URL Inspection, e.g. en-US or fr-FR.")
     },
     async ({ siteUrl, searchTypes, lookbackDays, freshnessLagWarningDays, inspectUrls, languageCode }) => {
       try {
@@ -2004,9 +2353,9 @@ Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for
     "Read-only sitemap delta tracker. Fetches the current sitemap snapshot and compares it to an agent-provided baseline; no state is written.",
     {
       siteUrl: siteUrlSchema,
-      baseline: z.array(sitemapBaselineSchema).optional().default([]).describe("Previous snapshot entries from this tool's snapshot output."),
-      includeUnchanged: z.boolean().optional().default(false),
-      minAbsIndexedDelta: z.number().int().min(0).optional().default(1).describe("Minimum absolute indexed URL delta to include otherwise unchanged sitemaps.")
+      baseline: z2.array(sitemapBaselineSchema).optional().default([]).describe("Previous snapshot entries from this tool's snapshot output."),
+      includeUnchanged: z2.boolean().optional().default(false),
+      minAbsIndexedDelta: z2.number().int().min(0).optional().default(1).describe("Minimum absolute indexed URL delta to include otherwise unchanged sitemaps.")
     },
     async ({ siteUrl, baseline, includeUnchanged, minAbsIndexedDelta }) => {
       try {
@@ -2101,11 +2450,11 @@ Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for
       datePreset: datePresetSchema.optional().default("last28days"),
       currentDateRange: dateRangeSchema.optional().describe("Current period. Defaults to datePreset."),
       previousDateRange: dateRangeSchema.optional().describe("Previous period. Defaults to the immediately preceding period with the same length."),
-      includePages: z.boolean().optional().default(false).describe("When true, groups by searchAppearance + page for page-level rich result trends."),
-      limit: z.number().int().min(1).max(25e3).optional().default(5e3),
-      topN: z.number().int().min(1).max(100).optional().default(50),
-      minImpressions: z.number().int().min(0).optional().default(0),
-      sortBy: z.enum(["currentClicks", "currentImpressions", "clicksDelta", "impressionsDelta", "positionDelta"]).optional().default("impressionsDelta")
+      includePages: z2.boolean().optional().default(false).describe("When true, groups by searchAppearance + page for page-level rich result trends."),
+      limit: z2.number().int().min(1).max(25e3).optional().default(5e3),
+      topN: z2.number().int().min(1).max(100).optional().default(50),
+      minImpressions: z2.number().int().min(0).optional().default(0),
+      sortBy: z2.enum(["currentClicks", "currentImpressions", "clicksDelta", "impressionsDelta", "positionDelta"]).optional().default("impressionsDelta")
     },
     async ({ siteUrl, searchType, datePreset, currentDateRange, previousDateRange, includePages, limit, topN, minImpressions, sortBy }) => {
       try {
@@ -2215,11 +2564,11 @@ Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for
       searchType: searchTypeSchema.optional().default("web"),
       datePreset: datePresetSchema.optional().default("last28days"),
       dateRange: dateRangeSchema.optional(),
-      objectives: z.array(samplingObjectiveSchema).min(1).max(5).optional().default(["topTraffic", "lowCtr", "declining", "sitemapRisk", "staleSitemaps"]),
-      pageLimit: z.number().int().min(1).max(25e3).optional().default(5e3),
-      maxInspectionUrls: z.number().int().min(1).max(BULK_URL_INSPECTION_LIMIT).optional().default(BULK_URL_INSPECTION_LIMIT),
-      minImpressionsForLowCtr: z.number().int().min(1).optional().default(100),
-      staleSitemapDays: z.number().int().min(1).max(180).optional().default(14)
+      objectives: z2.array(samplingObjectiveSchema).min(1).max(5).optional().default(["topTraffic", "lowCtr", "declining", "sitemapRisk", "staleSitemaps"]),
+      pageLimit: z2.number().int().min(1).max(25e3).optional().default(5e3),
+      maxInspectionUrls: z2.number().int().min(1).max(BULK_URL_INSPECTION_LIMIT).optional().default(BULK_URL_INSPECTION_LIMIT),
+      minImpressionsForLowCtr: z2.number().int().min(1).optional().default(100),
+      staleSitemapDays: z2.number().int().min(1).max(180).optional().default(14)
     },
     async ({ siteUrl, searchType, datePreset, dateRange, objectives, pageLimit, maxInspectionUrls, minImpressionsForLowCtr, staleSitemapDays }) => {
       try {
@@ -2348,9 +2697,9 @@ Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for
     "Read-only URL Inspection watchlist for critical URLs. Inspects up to 10 URLs and returns alert/review/ok assessments without storing state.",
     {
       siteUrl: siteUrlSchema,
-      urls: z.array(watchlistUrlSchema).min(1).max(BULK_URL_INSPECTION_LIMIT).describe(`Watchlist entries. Maximum ${BULK_URL_INSPECTION_LIMIT} per call to protect URL Inspection quota.`),
-      languageCode: z.string().optional().describe("Optional IETF language tag, e.g. en-US or fr-FR."),
-      continueOnError: z.boolean().optional().default(true)
+      urls: z2.array(watchlistUrlSchema).min(1).max(BULK_URL_INSPECTION_LIMIT).describe(`Watchlist entries. Maximum ${BULK_URL_INSPECTION_LIMIT} per call to protect URL Inspection quota.`),
+      languageCode: z2.string().optional().describe("Optional IETF language tag, e.g. en-US or fr-FR."),
+      continueOnError: z2.boolean().optional().default(true)
     },
     async ({ siteUrl, urls, languageCode, continueOnError }) => {
       try {
@@ -2417,10 +2766,10 @@ Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for
       datePreset: datePresetSchema.optional().default("last28days"),
       currentDateRange: dateRangeSchema.optional().describe("Current period. Defaults to datePreset."),
       previousDateRange: dateRangeSchema.optional().describe("Previous period. Defaults to the immediately preceding period with the same length."),
-      limit: z.number().int().min(1).max(25e3).optional().default(5e3).describe("Rows to fetch for each period."),
-      topN: z.number().int().min(1).max(100).optional().default(25),
-      minAbsClickDelta: z.number().min(0).optional().default(0).describe("Filter out rows with smaller absolute click delta."),
-      sortBy: z.enum(["clicksDelta", "impressionsDelta", "ctrDelta", "positionDelta"]).optional().default("clicksDelta")
+      limit: z2.number().int().min(1).max(25e3).optional().default(5e3).describe("Rows to fetch for each period."),
+      topN: z2.number().int().min(1).max(100).optional().default(25),
+      minAbsClickDelta: z2.number().min(0).optional().default(0).describe("Filter out rows with smaller absolute click delta."),
+      sortBy: z2.enum(["clicksDelta", "impressionsDelta", "ctrDelta", "positionDelta"]).optional().default("clicksDelta")
     },
     async ({ siteUrl, dimension, searchType, datePreset, currentDateRange, previousDateRange, limit, topN, minAbsClickDelta, sortBy }) => {
       try {
@@ -2536,11 +2885,11 @@ Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for
       searchType: searchTypeSchema.optional().default("web"),
       datePreset: datePresetSchema.optional().default("last28days"),
       dateRange: dateRangeSchema.optional(),
-      brandTerms: z.array(z.string()).optional().default([]).describe("Optional brand terms. Defaults to terms derived from the property domain."),
-      categoryRules: z.record(z.array(z.string())).optional().describe("Optional map of category name to matching tokens/phrases."),
-      limit: z.number().int().min(1).max(25e3).optional().default(5e3),
-      maxClusters: z.number().int().min(1).max(100).optional().default(25),
-      topQueriesPerCluster: z.number().int().min(1).max(25).optional().default(10)
+      brandTerms: z2.array(z2.string()).optional().default([]).describe("Optional brand terms. Defaults to terms derived from the property domain."),
+      categoryRules: z2.record(z2.array(z2.string())).optional().describe("Optional map of category name to matching tokens/phrases."),
+      limit: z2.number().int().min(1).max(25e3).optional().default(5e3),
+      maxClusters: z2.number().int().min(1).max(100).optional().default(25),
+      topQueriesPerCluster: z2.number().int().min(1).max(25).optional().default(10)
     },
     async ({ siteUrl, searchType, datePreset, dateRange, brandTerms, categoryRules, limit, maxClusters, topQueriesPerCluster }) => {
       try {
@@ -2617,11 +2966,11 @@ Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for
       searchType: searchTypeSchema.optional().default("web"),
       datePreset: datePresetSchema.optional().default("last28days"),
       dateRange: dateRangeSchema.optional(),
-      limit: z.number().int().min(1).max(25e3).optional().default(5e3),
-      minPages: z.number().int().min(2).max(10).optional().default(2),
-      minImpressions: z.number().int().min(0).optional().default(100),
-      maxTopPageClickShare: z.number().min(0.1).max(0.99).optional().default(0.8).describe("Only flag queries where the top page owns less than or equal to this click share."),
-      topN: z.number().int().min(1).max(100).optional().default(25)
+      limit: z2.number().int().min(1).max(25e3).optional().default(5e3),
+      minPages: z2.number().int().min(2).max(10).optional().default(2),
+      minImpressions: z2.number().int().min(0).optional().default(100),
+      maxTopPageClickShare: z2.number().min(0.1).max(0.99).optional().default(0.8).describe("Only flag queries where the top page owns less than or equal to this click share."),
+      topN: z2.number().int().min(1).max(100).optional().default(25)
     },
     async ({ siteUrl, searchType, datePreset, dateRange, limit, minPages, minImpressions, maxTopPageClickShare, topN }) => {
       try {
@@ -2717,9 +3066,9 @@ Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for
     "gsc_validate_query",
     "Validate a Search Console metric/dimension/search type combination before executing it.",
     {
-      dimensions: z.array(z.string()).optional().describe("Dimensions to validate."),
+      dimensions: z2.array(z2.string()).optional().describe("Dimensions to validate."),
       searchType: searchTypeSchema.optional().default("web"),
-      dateRange: z.object({ startDate: z.string(), endDate: z.string() }).optional()
+      dateRange: z2.object({ startDate: z2.string(), endDate: z2.string() }).optional()
     },
     async ({ dimensions, searchType, dateRange }) => {
       try {
@@ -3002,26 +3351,27 @@ function registerGSC(server, config) {
 }
 
 // src/server.ts
-var PACKAGE_VERSION = "1.0.2";
+var PACKAGE_VERSION = "2.0.0";
 function createServer(config) {
   const server = new McpServer(
-    { name: "google-search-console-mcp", version: PACKAGE_VERSION },
+    { name: "google-search-console-mcp", version: PACKAGE_VERSION, title: "Google Search Console", websiteUrl: "https://www.getmcpads.com/tools/search-console", icons: [{ src: "https://mcp.getmcpads.com/icon.svg", mimeType: "image/svg+xml" }] },
     { capabilities: { tools: { listChanged: true }, resources: { subscribe: false, listChanged: true } } }
   );
+  installToolQuality(server);
   registerGSC(server, config);
   logger.system(`google-search-console-mcp v${PACKAGE_VERSION} ready, read-only`);
   return server;
 }
 
 // src/config.ts
-import { z as z2 } from "zod";
-var configSchema = z2.object({
-  clientId: z2.string().optional(),
-  clientSecret: z2.string().optional(),
-  refreshToken: z2.string().optional(),
-  accessToken: z2.string().optional(),
-  defaultSiteUrl: z2.string().optional(),
-  logLevel: z2.enum(["debug", "info", "warn", "error"]).default("info")
+import { z as z3 } from "zod";
+var configSchema = z3.object({
+  clientId: z3.string().optional(),
+  clientSecret: z3.string().optional(),
+  refreshToken: z3.string().optional(),
+  accessToken: z3.string().optional(),
+  defaultSiteUrl: z3.string().optional(),
+  logLevel: z3.enum(["debug", "info", "warn", "error"]).default("info")
 });
 function loadConfig() {
   const raw = {