mcp-scraper 0.32.2 → 0.32.3

package/docs/mcp-tool-manifest.generated.json

@@ -1,12 +1,12 @@
 {
-  "generatedAt": "2026-07-22T02:43:42.271Z",
+  "generatedAt": "2026-07-22T14:23:17.207Z",
   "generatedFrom": "dist/bin/mcp-stdio-server.js",
   "serverInfo": {
     "name": "mcp-scraper",
-    "version": "0.32.2"
+    "version": "0.32.3"
   },
   "counts": {
-    "unified_stdio": 165
+    "unified_stdio": 166
   },
   "surfaces": {
     "unified_stdio": [
@@ -85,6 +85,7 @@
       "get-schedule-status",
       "get-vault-app-link",
       "get-vault-contract",
+      "gmail_search_contacts",
       "gmail_send_message",
       "google_ads_page_intel",
       "google_ads_search",
@@ -9027,6 +9028,167 @@
         "taskSupport": "forbidden"
       }
     },
+    {
+      "name": "gmail_search_contacts",
+      "title": "Search Gmail Contacts",
+      "description": "Search Gmail with standard Gmail query syntax (e.g. \"from:acme.com after:2026/03/22\") and get back deduplicated sender contacts (email, name, domain, message count, first/last seen, sample subjects) instead of raw messages. Read-only — works on any connected Gmail connection from list_service_connections, no actionsEnabled required. Use this instead of looping list-messages/get-message yourself: those return bare message IDs and full raw MIME per message, which does not scale past a handful of messages. Reports totalMatches and truncated so incomplete coverage from a large result set is never silent — pass the returned nextPageToken to continue.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "connectionId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "A Gmail connectionId from list_service_connections. Read-only — does not require actionsEnabled."
+          },
+          "query": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 500,
+            "description": "Gmail search syntax, e.g. \"from:brandnorth.com after:2026/03/22\" or \"brandnorth.com\"."
+          },
+          "maxMessages": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 150,
+            "default": 50,
+            "description": "Max messages to fetch and aggregate in this call. Paginate with pageToken for more; the response reports totalMatches and truncated so undercoverage is never silent."
+          },
+          "pageToken": {
+            "type": "string",
+            "description": "Continuation token from a prior response to fetch the next page."
+          }
+        },
+        "required": [
+          "connectionId",
+          "query"
+        ],
+        "additionalProperties": false,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "totalMatches": {
+            "type": "number",
+            "description": "Gmail's estimated total matches for the query, independent of how many were fetched this call."
+          },
+          "messagesFetched": {
+            "type": "number"
+          },
+          "truncated": {
+            "type": "boolean",
+            "description": "True when totalMatches exceeds messagesFetched — more results exist, use nextPageToken."
+          },
+          "nextPageToken": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "messages": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "date": {
+                  "$ref": "#/properties/nextPageToken"
+                },
+                "from": {
+                  "$ref": "#/properties/nextPageToken"
+                },
+                "to": {
+                  "$ref": "#/properties/nextPageToken"
+                },
+                "subject": {
+                  "$ref": "#/properties/nextPageToken"
+                },
+                "snippet": {
+                  "$ref": "#/properties/nextPageToken"
+                }
+              },
+              "required": [
+                "id",
+                "date",
+                "from",
+                "to",
+                "subject",
+                "snippet"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "contacts": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "email": {
+                  "type": "string"
+                },
+                "name": {
+                  "$ref": "#/properties/nextPageToken"
+                },
+                "domain": {
+                  "$ref": "#/properties/nextPageToken"
+                },
+                "messageCount": {
+                  "type": "number"
+                },
+                "firstSeen": {
+                  "$ref": "#/properties/nextPageToken"
+                },
+                "lastSeen": {
+                  "$ref": "#/properties/nextPageToken"
+                },
+                "sampleSubjects": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              },
+              "required": [
+                "email",
+                "name",
+                "domain",
+                "messageCount",
+                "firstSeen",
+                "lastSeen",
+                "sampleSubjects"
+              ],
+              "additionalProperties": false
+            },
+            "description": "Messages deduped by sender email address, newest-to-oldest within this fetch only — not the full query result set when truncated."
+          },
+          "error": {
+            "$ref": "#/properties/nextPageToken"
+          }
+        },
+        "required": [
+          "ok",
+          "nextPageToken",
+          "error"
+        ],
+        "additionalProperties": false,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      },
+      "annotations": {
+        "title": "Search Gmail Contacts",
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "execution": {
+        "taskSupport": "forbidden"
+      }
+    },
     {
       "name": "gmail_send_message",
       "title": "Send Gmail Message",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-scraper",
-  "version": "0.32.2",
+  "version": "0.32.3",
   "description": "MCP server for MCP Scraper web intelligence tools",
   "type": "module",
   "main": "./dist/index.cjs",