fix: Update type documentation and deprecate SSE transport in favor of Streamable HTTP (#416)

Author: jirispilka

README.md

@@ -33,6 +33,7 @@ Check out the [MCP clients section](#-mcp-clients) for more details or visit the
 ## Table of Contents
 - [🌐 Introducing the Apify MCP server](#-introducing-the-apify-mcp-server)
 - [🚀 Quickstart](#-quickstart)
+- [⚠️ SSE transport deprecation](#-sse-transport-deprecation)
 - [🤖 MCP clients](#-mcp-clients)
 - [🪄 Try Apify MCP instantly](#-try-apify-mcp-instantly)
 - [🛠️ Tools, resources, and prompts](#-tools-resources-and-prompts)
@@ -69,6 +70,13 @@ You can use the Apify MCP Server in two ways:
 
 You can find detailed instructions for setting up the MCP server in the [Apify documentation](https://docs.apify.com/platform/integrations/mcp).
 
+# ⚠️ SSE transport deprecation on April 1, 2026
+
+Udate your MCP client config before April 1, 2026.
+The Apify MCP server is dropping Server-Sent Events (SSE) transport in favor of Streamable HTTP, in line with the official MCP spec.
+
+Go to [mcp.apify.com](https://mcp.apify.com/) to update the installation for your client of choice, with a valid endpoint.
+
 # 🤖 MCP clients
 
 Apify MCP Server is compatible with any MCP client that adheres to the [Model Context Protocol](https://modelcontextprotocol.org/), but the level of support for dynamic tool discovery and other features may vary between clients.

src/types.ts

@@ -225,9 +225,9 @@ export type ToolSelector = ToolCategory | string;
 
 export type Input = {
     /**
-     * When `actors` is undefined that means the default Actors should be loaded.
-     * If it as empty string or empty array then no Actors should be loaded.
-     * Otherwise the specified Actors should be loaded.
+     * When `actors` is undefined, that means the default Actors should be loaded.
+     * If it is as an empty string or empty array, then no Actors should be loaded.
+     * Otherwise, the specified Actors should be loaded.
      */
     actors?: string[] | string;
     /**
@@ -371,7 +371,7 @@ export type ActorsMcpServerOptions = {
         /**
          * Enable or disable telemetry tracking for tool calls.
          * Must be explicitly set when telemetry object is provided.
-         * When telemetry object is omitted entirely, defaults to true (via env var or default).
+         * When a telemetry object is omitted entirely, defaults to true (via env var or default).
          */
         enabled: boolean;
         /**
@@ -383,11 +383,11 @@ export type ActorsMcpServerOptions = {
     };
     /**
      * Transport type for telemetry tracking.
-     * Important: this is also used for the long running tasks logic
+     * Important: this is also used for the long-running tasks logic
      *  which is different for local and remote server based on the transport type.
      * - 'stdio': Direct/local stdio connection
      * - 'http': Remote HTTP streamable connection
-     * - 'sse': Remote Server-Sent Events (SSE) connection
+     * - 'sse': Remote Server-Sent Events (SSE) connection (deprecated, removal on 2026-04-01)
      */
     transportType?: 'stdio' | 'http' | 'sse';
     /**