mcp-scraper 0.15.1 → 0.17.0

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

@@ -1,12 +1,12 @@
 {
-  "generatedAt": "2026-07-12T04:55:40.299Z",
+  "generatedAt": "2026-07-12T21:11:03.690Z",
   "generatedFrom": "dist/bin/mcp-stdio-server.js",
   "serverInfo": {
     "name": "mcp-scraper",
-    "version": "0.15.1"
+    "version": "0.17.0"
   },
   "counts": {
-    "unified_stdio": 156
+    "unified_stdio": 157
   },
   "surfaces": {
     "unified_stdio": [
@@ -87,6 +87,7 @@
       "google_ads_transcribe",
       "google_calendar_create_event",
       "harvest_paa",
+      "import_service_connection_to_memory",
       "instagram_media_download",
       "instagram_profile_content",
       "library-ingest",
@@ -4173,7 +4174,7 @@
     {
       "name": "call_service_connection_action",
       "title": "Run Connected Service Action",
-      "description": "Run one explicitly allowlisted write or mutation on a tenant-owned OAuth or remote MCP connection. First call list_service_connections, use a connection with actionsEnabled true, choose one exact actionTools entry, and supply that action's arguments. The server rejects arbitrary action names, inactive or foreign connections, disabled actions, and every adminBlockedTools entry. This includes Resend sends, broadcasts, contacts and templates plus GitHub issue, pull-request, repository-content, release, and workflow actions when exposed. Sends, deletes, merges, review submissions, workflow execution, and content changes are high impact.",
+      "description": "Run one explicitly allowlisted write or mutation on a tenant-owned OAuth or remote MCP connection. First call list_service_connections, use a connection with actionsEnabled true, describe the exact actionTools entry to obtain its live schema, and supply only that action's arguments. The server rejects arbitrary action names, inactive or foreign connections, disabled actions, and every adminBlockedTools entry. This can include Google Drive folder creation or file copies, Resend delivery, and GitHub mutations only when those exact actions are live and approved. Sends, deletes, merges, workflow execution, and content changes are high impact.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -5445,7 +5446,7 @@
     {
       "name": "describe_service_connection_tool",
       "title": "Describe Connected Service Tool",
-      "description": "Get the title, description, read/action classification, and exact JSON input schema for one tool exposed by a tenant-owned service connection. Call list_service_connections first, then describe the selected readTools or actionTools name before constructing arguments. Arbitrary names and permanently blocked administrative tools are rejected. This is especially useful for broad official remote MCP connections such as Resend, whose provider-native tools are intentionally exposed through generic bridges instead of dozens of new top-level MCP names.",
+      "description": "Fetch the sanitized live MCP Tool definition for one exact tool exposed by a tenant-owned Nango OAuth or official remote MCP connection. Returns provider-native title, description, read/action classification, current callability, input schema, optional output schema, safe annotations, and a schema hash. Call list_service_connections first, then describe a listed readTools or actionTools name before constructing arguments. This is a compatibility tool on MCP Scraper's fixed root MCP; protocol-native connection endpoints discover the same definitions through MCP tools/list, not a custom tools/describe method. Arbitrary names and permanently blocked administrative tools are rejected.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -5458,6 +5459,10 @@
             "type": "string",
             "minLength": 1,
             "description": "One exact name from that connection's readTools or actionTools. Admin-blocked and arbitrary names are rejected."
+          },
+          "fresh": {
+            "type": "boolean",
+            "description": "Bypass the short-lived sanitized schema cache. Ownership, connection state, and tool policy are still rechecked; use only when a provider tool catalog just changed."
           }
         },
         "required": [
@@ -5495,10 +5500,126 @@
                   "action"
                 ]
               },
+              "callable": {
+                "type": "boolean",
+                "description": "Whether the tool is callable now. A gated action can be described while actions are off and return false."
+              },
+              "blockedReason": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "enum": [
+                      "actions_disabled",
+                      "inactive_connection"
+                    ]
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "transport": {
+                "type": "string",
+                "enum": [
+                  "nango",
+                  "remote_mcp"
+                ]
+              },
+              "providerConfigKey": {
+                "type": "string"
+              },
+              "protocolVersion": {
+                "$ref": "#/properties/tool/properties/title"
+              },
+              "schemaSource": {
+                "type": "string",
+                "const": "live_tools_list"
+              },
               "inputSchema": {
                 "type": "object",
                 "additionalProperties": {},
                 "description": "JSON Schema for the exact connected-provider tool arguments."
+              },
+              "outputSchema": {
+                "type": "object",
+                "additionalProperties": {},
+                "description": "Provider-native JSON output schema when the live MCP tool publishes one."
+              },
+              "annotations": {
+                "type": "object",
+                "properties": {
+                  "title": {
+                    "type": "string"
+                  },
+                  "readOnlyHint": {
+                    "type": "boolean"
+                  },
+                  "destructiveHint": {
+                    "type": "boolean"
+                  },
+                  "idempotentHint": {
+                    "type": "boolean"
+                  },
+                  "openWorldHint": {
+                    "type": "boolean"
+                  }
+                },
+                "additionalProperties": false
+              },
+              "icons": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "src": {
+                      "type": "string"
+                    },
+                    "mimeType": {
+                      "type": "string"
+                    },
+                    "sizes": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "theme": {
+                      "type": "string",
+                      "enum": [
+                        "light",
+                        "dark"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "src"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "execution": {
+                "type": "object",
+                "properties": {
+                  "taskSupport": {
+                    "type": "string",
+                    "enum": [
+                      "forbidden",
+                      "optional",
+                      "required"
+                    ]
+                  }
+                },
+                "required": [
+                  "taskSupport"
+                ],
+                "additionalProperties": false
+              },
+              "schemaHash": {
+                "type": "string",
+                "description": "SHA-256 of the sanitized live Tool definition."
+              },
+              "fetchedAt": {
+                "type": "string"
               }
             },
             "required": [
@@ -5510,6 +5631,12 @@
             ],
             "additionalProperties": false
           },
+          "retryable": {
+            "type": "boolean"
+          },
+          "errorCode": {
+            "type": "string"
+          },
           "error": {
             "$ref": "#/properties/tool/properties/title"
           }
@@ -8824,6 +8951,144 @@
         "taskSupport": "forbidden"
       }
     },
+    {
+      "name": "import_service_connection_to_memory",
+      "title": "Import Connected Service Snapshot to Memory",
+      "description": "Run exactly one bounded, approved read on a tenant-owned connected service and upsert the redacted result into an existing ordinary Memory vault at a server-generated stable path. The saved document is embedded for RAG and marked as untrusted provider data, never instructions. This is a one-result snapshot: it does not paginate, bulk-import an account, continuously sync changes, propagate deletions, or create normalized tables. Use list_service_connections first and supply an exact current readTools entry; action and admin tools are rejected.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "connectionId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200,
+            "description": "A tenant-owned connectionId from list_service_connections."
+          },
+          "providerConfigKey": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200,
+            "description": "The exact providerConfigKey returned with that connection. It is matched together with connectionId against the authenticated caller."
+          },
+          "tool": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200,
+            "description": "One exact current readTools entry for that connection. Actions, admin tools, and unlisted names are rejected."
+          },
+          "args": {
+            "type": "object",
+            "additionalProperties": {},
+            "description": "JSON arguments for one bounded provider read. The serialized object may be at most 64 KiB."
+          },
+          "vault": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100,
+            "description": "An existing ordinary Memory vault the caller can write and index. Secure and channel vaults are rejected because this tool creates searchable RAG content."
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200,
+            "description": "Optional human-readable snapshot title. The server always chooses the stable storage path."
+          }
+        },
+        "required": [
+          "connectionId",
+          "providerConfigKey",
+          "tool",
+          "vault"
+        ],
+        "additionalProperties": false,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "stored": {
+            "type": "boolean"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "search_ready",
+              "stored_not_indexed"
+            ]
+          },
+          "searchReady": {
+            "type": "boolean"
+          },
+          "providerConfigKey": {
+            "type": "string"
+          },
+          "connectionId": {
+            "type": "string"
+          },
+          "tool": {
+            "type": "string"
+          },
+          "vault": {
+            "type": "string"
+          },
+          "path": {
+            "type": "string"
+          },
+          "sourceBytes": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "contentSha256": {
+            "type": "string"
+          },
+          "indexedChunks": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "importedAt": {
+            "type": "string"
+          },
+          "untrustedContent": {
+            "type": "boolean",
+            "const": true
+          },
+          "warning": {
+            "type": "string"
+          },
+          "errorCode": {
+            "type": "string"
+          },
+          "retryable": {
+            "type": "boolean"
+          },
+          "error": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "ok",
+          "error"
+        ],
+        "additionalProperties": false,
+        "$schema": "http://json-schema.org/draft-07/schema#"
+      },
+      "annotations": {
+        "title": "Import Connected Service Snapshot to Memory",
+        "readOnlyHint": false,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "execution": {
+        "taskSupport": "forbidden"
+      }
+    },
     {
       "name": "instagram_media_download",
       "title": "Instagram Post/Reel Media Download",
@@ -9703,7 +9968,7 @@
     {
       "name": "list_service_connections",
       "title": "List Connected Services",
-      "description": "List every third-party service connection this MCP Scraper account has authorized, including Resend, GitHub, Google Analytics, YouTube, Facebook Pages, LinkedIn, X, Meta Marketing, Slack, Gmail, Calendar, Drive, Zoom, Xero, and others. Returns the tenant-scoped connectionId, credential transport, exact readTools and actionTools, and permanently blocked administrative tools. Get a connectionId and exact tool name here before calling read_service_connection or call_service_connection_action. Nango OAuth and official remote MCP connections use the same provider-neutral bridges; mutations still require the account action switch and an exact allowed action. For already-digested history, prefer the returned vaultName or tableName.",
+      "description": "List every third-party service connection this MCP Scraper account has authorized, including Resend, GitHub, Google Analytics, YouTube, Facebook Pages, LinkedIn, X, Meta Marketing, Slack, Gmail, Calendar, Google Drive, Zoom, Xero, and others. Returns the tenant-scoped connectionId, credential transport, exact live readTools and gated actionTools, permanently blocked administrative tools, and schema-discovery metadata. Get a connectionId and exact tool name here before calling describe_service_connection_tool, read_service_connection, or call_service_connection_action. Nango OAuth and official remote MCP connections use the same provider-neutral bridges; mutations still require the account action switch and an exact allowed action. For already-digested history, prefer the returned vaultName or tableName.",
       "inputSchema": {
         "type": "object",
         "properties": {},
@@ -9770,6 +10035,33 @@
                   },
                   "description": "Credential, OAuth-grant, or other administrative tools permanently blocked from the MCP and scheduler."
                 },
+                "mcpEndpoint": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "format": "uri"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Authenticated connection-scoped MCP endpoint when native provider tools/list projection is available. Null means use describe_service_connection_tool on this root MCP."
+                },
+                "schemaDiscovery": {
+                  "type": "string",
+                  "enum": [
+                    "connection_tools_list",
+                    "compatibility_describe"
+                  ],
+                  "description": "How clients discover this connection's exact live provider schemas."
+                },
+                "toolRevision": {
+                  "type": [
+                    "string",
+                    "null"
+                  ],
+                  "description": "Opaque revision of the resolved live tool catalog, when available. It changes when provider tools or policy change."
+                },
                 "vaultName": {
                   "type": [
                     "string",
@@ -9795,6 +10087,9 @@
                 "readTools",
                 "actionTools",
                 "adminBlockedTools",
+                "mcpEndpoint",
+                "schemaDiscovery",
+                "toolRevision",
                 "vaultName",
                 "tableName"
               ],
@@ -14335,7 +14630,7 @@
     {
       "name": "read_service_connection",
       "title": "Read Connected Service",
-      "description": "Call one small live, read-only operation on any connected service, including Resend, GitHub repository, issue, pull-request, release, and workflow reads. Do not loop this tool to fetch a time range or collection: use export_connected_service_data for Gmail, calendar, Zoom, or Resend datasets. Requires a connectionId and an exact name from that connection's readTools in list_service_connections; an unlisted tool is rejected server-side.",
+      "description": "Call one small live, read-only operation on any connected service, including Google Drive metadata/search tools, Resend, GitHub, Gmail, Calendar, Zoom, and other approved providers. Call describe_service_connection_tool first when arguments are not already known. Do not loop this tool once per file or record to fetch a corpus: use export_connected_service_data when that provider/dataset supports bulk delivery. Requires a connectionId and an exact name from that connection's live readTools in list_service_connections; an unlisted tool is rejected server-side.",
       "inputSchema": {
         "type": "object",
         "properties": {