@apify/actors-mcp-server 0.9.8-beta.1 → 0.9.9-beta.0

package/dist/types.d.ts

@@ -304,11 +304,11 @@ export type DatasetItem = Record<number | string, unknown>;
 /**
  * Apify token type.
  *
- * Can be null or undefined in case of Skyfire requests.
+ * Can be null or undefined in the case of Skyfire requests.
  */
 export type ApifyToken = string | null | undefined;
 /**
- * Unified status type for tool execution lifecycle.
+ * Unified status type for the tool execution lifecycle.
  * Derived from TOOL_STATUS to ensure type safety and avoid duplication.
  */
 export type ToolStatus = (typeof TOOL_STATUS)[keyof typeof TOOL_STATUS];

package/dist/utils/mcp.d.ts

@@ -13,13 +13,19 @@ export declare function buildUsageMeta(source: {
 }): Record<string, unknown> | undefined;
 /**
  * Helper to build a response for MCP from an array of text strings.
+ *
+ * Status model used by this project:
+ * - `isError` is MCP-visible and returned to the client.
+ * - `toolStatus` is an internal helper input for server telemetry.
+ * - `internalToolStatus` is the transient wire field carrying `toolStatus`
+ *   from tool helpers back to the server, and is stripped before client response.
+ *
  * @param options - Object containing response configuration
  * @param options.texts - Array of text strings to include in the response
  * @param options.isError - Optional flag to mark the response as an error (default: false).
  *                          This must remain MCP compliant: true for any tool-level error.
  * @param options.toolStatus - Optional internal tool status used for telemetry. When provided,
- *                             it will be attached as `_toolStatus` so the server can read it
- *                             and strip it before sending the response to the MCP client.
+ *                             it is attached as `internalToolStatus` for server-side processing only.
  * @param options.structuredContent - Optional structured content of unknown type
  * @param options._meta - Optional metadata for widget rendering (e.g., OpenAI widget metadata)
  */
@@ -30,13 +36,13 @@ export declare function buildMCPResponse(options: {
     structuredContent?: unknown;
     _meta?: Record<string, unknown>;
 }): {
+    _meta?: Record<string, unknown> | undefined;
+    structuredContent?: {} | null | undefined;
+    internalToolStatus?: ToolStatus | undefined;
     content: {
         type: "text";
         text: string;
     }[];
     isError: boolean;
-    internalToolStatus?: ToolStatus;
-    structuredContent?: unknown;
-    _meta?: Record<string, unknown>;
 };
 //# sourceMappingURL=mcp.d.ts.map

package/dist/utils/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/utils/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAQtC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACtC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;aAUgB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;aAChC,OAAO;yBACK,UAAU;wBACX,OAAO;YACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAsBtC"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/utils/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAQtC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACtC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;;;;;;;;;EAgBA"}

package/dist/utils/mcp.js

@@ -17,34 +17,30 @@ export function buildUsageMeta(source) {
 }
 /**
  * Helper to build a response for MCP from an array of text strings.
+ *
+ * Status model used by this project:
+ * - `isError` is MCP-visible and returned to the client.
+ * - `toolStatus` is an internal helper input for server telemetry.
+ * - `internalToolStatus` is the transient wire field carrying `toolStatus`
+ *   from tool helpers back to the server, and is stripped before client response.
+ *
  * @param options - Object containing response configuration
  * @param options.texts - Array of text strings to include in the response
  * @param options.isError - Optional flag to mark the response as an error (default: false).
  *                          This must remain MCP compliant: true for any tool-level error.
  * @param options.toolStatus - Optional internal tool status used for telemetry. When provided,
- *                             it will be attached as `_toolStatus` so the server can read it
- *                             and strip it before sending the response to the MCP client.
+ *                             it is attached as `internalToolStatus` for server-side processing only.
  * @param options.structuredContent - Optional structured content of unknown type
  * @param options._meta - Optional metadata for widget rendering (e.g., OpenAI widget metadata)
  */
 export function buildMCPResponse(options) {
     const { texts, isError = false, toolStatus, structuredContent, _meta, } = options;
-    const response = {
+    return {
         content: texts.map((text) => ({ type: 'text', text })),
         isError,
+        ...(toolStatus && { internalToolStatus: toolStatus }),
+        ...(structuredContent !== undefined && { structuredContent }),
+        ...(_meta !== undefined && { _meta }),
     };
-    // Attach internal tool status for telemetry; server will read and strip it
-    if (toolStatus) {
-        response.internalToolStatus = toolStatus;
-    }
-    // Add structured content if provided
-    if (structuredContent !== undefined) {
-        response.structuredContent = structuredContent;
-    }
-    // Add metadata if provided (e.g., for widget rendering)
-    if (_meta !== undefined) {
-        response._meta = _meta;
-    }
-    return response;
 }
 //# sourceMappingURL=mcp.js.map

package/dist/utils/mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/utils/mcp.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,MAG9B;IACG,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAC3C,OAAO,aAAa,KAAK,SAAS;QAC9B,CAAC,CAAC;YACE,aAAa;YACb,QAAQ;SACX;QACD,CAAC,CAAC,SAAS,CAAC;AACpB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAMhC;IACG,MAAM,EACF,KAAK,EACL,OAAO,GAAG,KAAK,EACf,UAAU,EACV,iBAAiB,EACjB,KAAK,GACR,GAAG,OAAO,CAAC;IAEZ,MAAM,QAAQ,GAMV;QACA,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,OAAO;KACV,CAAC;IAEF,2EAA2E;IAC3E,IAAI,UAAU,EAAE,CAAC;QACb,QAAQ,CAAC,kBAAkB,GAAG,UAAU,CAAC;IAC7C,CAAC;IAED,qCAAqC;IACrC,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;QAClC,QAAQ,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IACnD,CAAC;IAED,wDAAwD;IACxD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC"}
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/utils/mcp.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,MAG9B;IACG,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAC3C,OAAO,aAAa,KAAK,SAAS;QAC9B,CAAC,CAAC;YACE,aAAa;YACb,QAAQ;SACX;QACD,CAAC,CAAC,SAAS,CAAC;AACpB,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAMhC;IACG,MAAM,EACF,KAAK,EACL,OAAO,GAAG,KAAK,EACf,UAAU,EACV,iBAAiB,EACjB,KAAK,GACR,GAAG,OAAO,CAAC;IAEZ,OAAO;QACH,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,OAAO;QACP,GAAG,CAAC,UAAU,IAAI,EAAE,kBAAkB,EAAE,UAAU,EAAE,CAAC;QACrD,GAAG,CAAC,iBAAiB,KAAK,SAAS,IAAI,EAAE,iBAAiB,EAAE,CAAC;QAC7D,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;KACxC,CAAC;AACN,CAAC"}

package/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.2",
   "name": "apify-mcp-server",
   "display_name": "Apify MCP server",
-  "version": "0.9.8",
+  "version": "0.9.9",
   "description": "Extract data from any website using thousands of tools from the Apify Store.",
   "long_description": "Apify is the world's largest marketplace of tools for web scraping, data extraction, and web automation. You can extract structured data from social media, e-commerce, search engines, maps, travel sites, or any other website.",
   "keywords": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apify/actors-mcp-server",
-  "version": "0.9.8-beta.1",
+  "version": "0.9.9-beta.0",
   "type": "module",
   "description": "Apify MCP Server",
   "mcpName": "com.apify/apify-mcp-server",

package/server.json

@@ -6,7 +6,7 @@
     "url": "https://github.com/apify/apify-mcp-server",
     "source": "github"
   },
-  "version": "0.9.8",
+  "version": "0.9.9",
   "remotes": [
     {
       "type": "streamable-http",