@mastra/client-js 0.0.0-mcp-schema-serializer-20250430202337 → 0.0.0-mcp-server-deploy-20250507160341

package/CHANGELOG.md

@@ -1,18 +1,60 @@
 # @mastra/client-js
 
-## 0.0.0-mcp-schema-serializer-20250430202337
+## 0.0.0-mcp-server-deploy-20250507160341
 
 ### Patch Changes
 
+- 4155f47: Add parameters to filter workflow runs
+  Add fromDate and toDate to telemetry parameters
 - 254f5c3: Audit, cleanup MastraClient
 - 0097d50: Add serializedStepGraph to vNext workflow
   Return serializedStepGraph from vNext workflow
   Use serializedStepGraph in vNext workflow graph
 - 2429c74: Add get workflow runs api to client-js
-- Updated dependencies [5316795]
+- Updated dependencies [967b41c]
+- Updated dependencies [26738f4]
+- Updated dependencies [4155f47]
 - Updated dependencies [b804723]
+- Updated dependencies [ccef9f9]
 - Updated dependencies [0097d50]
-  - @mastra/core@0.0.0-mcp-schema-serializer-20250430202337
+- Updated dependencies [17826a9]
+- Updated dependencies [51e6923]
+  - @mastra/core@0.0.0-mcp-server-deploy-20250507160341
+
+## 0.1.20-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [ccef9f9]
+- Updated dependencies [51e6923]
+  - @mastra/core@0.9.2-alpha.4
+
+## 0.1.20-alpha.3
+
+### Patch Changes
+
+- 4155f47: Add parameters to filter workflow runs
+  Add fromDate and toDate to telemetry parameters
+- Updated dependencies [967b41c]
+- Updated dependencies [4155f47]
+- Updated dependencies [17826a9]
+  - @mastra/core@0.9.2-alpha.3
+
+## 0.1.20-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [26738f4]
+  - @mastra/core@0.9.2-alpha.2
+
+## 0.1.20-alpha.1
+
+### Patch Changes
+
+- 254f5c3: Audit, cleanup MastraClient
+- 2429c74: Add get workflow runs api to client-js
+- Updated dependencies [b804723]
+  - @mastra/core@0.9.2-alpha.1
 
 ## 0.1.20-alpha.0
 

package/dist/index.cjs

@@ -375,10 +375,31 @@ var Workflow = class extends BaseResource {
   }
   /**
    * Retrieves all runs for a workflow
+   * @param params - Parameters for filtering runs
    * @returns Promise containing workflow runs array
    */
-  runs() {
-    return this.request(`/api/workflows/${this.workflowId}/runs`);
+  runs(params) {
+    const searchParams = new URLSearchParams();
+    if (params?.fromDate) {
+      searchParams.set("fromDate", params.fromDate.toISOString());
+    }
+    if (params?.toDate) {
+      searchParams.set("toDate", params.toDate.toISOString());
+    }
+    if (params?.limit) {
+      searchParams.set("limit", String(params.limit));
+    }
+    if (params?.offset) {
+      searchParams.set("offset", String(params.offset));
+    }
+    if (params?.resourceId) {
+      searchParams.set("resourceId", params.resourceId);
+    }
+    if (searchParams.size) {
+      return this.request(`/api/workflows/${this.workflowId}/runs?${searchParams}`);
+    } else {
+      return this.request(`/api/workflows/${this.workflowId}/runs`);
+    }
   }
   /**
    * @deprecated Use `startAsync` instead
@@ -622,10 +643,31 @@ var VNextWorkflow = class extends BaseResource {
   }
   /**
    * Retrieves all runs for a vNext workflow
+   * @param params - Parameters for filtering runs
    * @returns Promise containing vNext workflow runs array
    */
-  runs() {
-    return this.request(`/api/workflows/v-next/${this.workflowId}/runs`);
+  runs(params) {
+    const searchParams = new URLSearchParams();
+    if (params?.fromDate) {
+      searchParams.set("fromDate", params.fromDate.toISOString());
+    }
+    if (params?.toDate) {
+      searchParams.set("toDate", params.toDate.toISOString());
+    }
+    if (params?.limit) {
+      searchParams.set("limit", String(params.limit));
+    }
+    if (params?.offset) {
+      searchParams.set("offset", String(params.offset));
+    }
+    if (params?.resourceId) {
+      searchParams.set("resourceId", params.resourceId);
+    }
+    if (searchParams.size) {
+      return this.request(`/api/workflows/v-next/${this.workflowId}/runs?${searchParams}`);
+    } else {
+      return this.request(`/api/workflows/v-next/${this.workflowId}/runs`);
+    }
   }
   /**
    * Creates a new vNext workflow run
@@ -724,6 +766,21 @@ var VNextWorkflow = class extends BaseResource {
   }
 };
 
+// src/resources/mcp.ts
+var MCPServer = class extends BaseResource {
+  constructor(options, serverId) {
+    super(options);
+    this.serverId = serverId;
+  }
+  /**
+   * Get details about the MCP server
+   * @returns Promise containing server details
+   */
+  details() {
+    return this.request(`/api/mcp/servers/${this.serverId}`);
+  }
+};
+
 // src/client.ts
 var MastraClient = class extends BaseResource {
   constructor(options) {
@@ -868,7 +925,7 @@ var MastraClient = class extends BaseResource {
    * @returns Promise containing telemetry data
    */
   getTelemetry(params) {
-    const { name, scope, page, perPage, attribute } = params || {};
+    const { name, scope, page, perPage, attribute, fromDate, toDate } = params || {};
     const _attribute = attribute ? Object.entries(attribute).map(([key, value]) => `${key}:${value}`) : [];
     const searchParams = new URLSearchParams();
     if (name) {
@@ -892,6 +949,12 @@ var MastraClient = class extends BaseResource {
         searchParams.set("attribute", _attribute);
       }
     }
+    if (fromDate) {
+      searchParams.set("fromDate", fromDate.toISOString());
+    }
+    if (toDate) {
+      searchParams.set("toDate", toDate.toISOString());
+    }
     if (searchParams.size) {
       return this.request(`/api/telemetry?${searchParams}`);
     } else {
@@ -913,6 +976,21 @@ var MastraClient = class extends BaseResource {
   getNetwork(networkId) {
     return new Network(this.options, networkId);
   }
+  /**
+   * Retrieves all available MCP servers
+   * @returns Promise containing map of MCP server IDs to server details
+   */
+  getMCPServers() {
+    return this.request("/api/mcp/servers");
+  }
+  /**
+   * Gets an MCP server instance by ID
+   * @param serverId - ID of the MCP server to retrieve
+   * @returns MCPServer instance
+   */
+  getMCPServer(serverId) {
+    return new MCPServer(this.options, serverId);
+  }
 };
 
 exports.MastraClient = MastraClient;

package/dist/index.d.cts

@@ -58,6 +58,13 @@ interface GetWorkflowResponse {
     stepSubscriberGraph: Record<string, StepGraph>;
     workflowId?: string;
 }
+interface GetWorkflowRunsParams {
+    fromDate?: Date;
+    toDate?: Date;
+    limit?: number;
+    offset?: number;
+    resourceId?: string;
+}
 type GetWorkflowRunsResponse = WorkflowRuns;
 type WorkflowRunResult = {
     activePaths: Record<string, {
@@ -197,6 +204,8 @@ interface GetTelemetryParams {
     page?: number;
     perPage?: number;
     attribute?: Record<string, string>;
+    fromDate?: Date;
+    toDate?: Date;
 }
 interface GetNetworkResponse {
     name: string;
@@ -212,6 +221,16 @@ interface GetNetworkResponse {
     };
     state?: Record<string, any>;
 }
+interface GetMCPServerResponse {
+    id: string;
+    name: string;
+    description?: string;
+    tools: Array<{
+        name: string;
+        description: string;
+        parameters: Record<string, any>;
+    }>;
+}
 
 declare class BaseResource {
     readonly options: ClientOptions;
@@ -404,9 +423,10 @@ declare class Workflow extends BaseResource {
     details(): Promise<GetWorkflowResponse>;
     /**
      * Retrieves all runs for a workflow
+     * @param params - Parameters for filtering runs
      * @returns Promise containing workflow runs array
      */
-    runs(): Promise<GetWorkflowRunsResponse>;
+    runs(params?: GetWorkflowRunsParams): Promise<GetWorkflowRunsResponse>;
     /**
      * @deprecated Use `startAsync` instead
      * Executes the workflow with the provided parameters
@@ -522,9 +542,10 @@ declare class VNextWorkflow extends BaseResource {
     details(): Promise<GetVNextWorkflowResponse>;
     /**
      * Retrieves all runs for a vNext workflow
+     * @param params - Parameters for filtering runs
      * @returns Promise containing vNext workflow runs array
      */
-    runs(): Promise<GetWorkflowRunsResponse>;
+    runs(params?: GetWorkflowRunsParams): Promise<GetWorkflowRunsResponse>;
     /**
      * Creates a new vNext workflow run
      * @param params - Optional object containing the optional runId
@@ -591,6 +612,19 @@ declare class VNextWorkflow extends BaseResource {
     }, onRecord: (record: VNextWorkflowWatchResult) => void): Promise<void>;
 }
 
+/**
+ * MCP Server resource for interacting with MCP servers
+ */
+declare class MCPServer extends BaseResource {
+    private serverId;
+    constructor(options: ClientOptions, serverId: string);
+    /**
+     * Get details about the MCP server
+     * @returns Promise containing server details
+     */
+    details(): Promise<GetMCPServerResponse>;
+}
+
 declare class MastraClient extends BaseResource {
     constructor(options: ClientOptions);
     /**
@@ -710,6 +744,17 @@ declare class MastraClient extends BaseResource {
      * @returns Network instance
      */
     getNetwork(networkId: string): Network;
+    /**
+     * Retrieves all available MCP servers
+     * @returns Promise containing map of MCP server IDs to server details
+     */
+    getMCPServers(): Promise<Record<string, GetMCPServerResponse>>;
+    /**
+     * Gets an MCP server instance by ID
+     * @param serverId - ID of the MCP server to retrieve
+     * @returns MCPServer instance
+     */
+    getMCPServer(serverId: string): MCPServer;
 }
 
-export { type ClientOptions, type CreateIndexParams, type CreateMemoryThreadParams, type CreateMemoryThreadResponse, type GenerateParams, type GetAgentResponse, type GetEvalsByAgentIdResponse, type GetLogParams, type GetLogsParams, type GetLogsResponse, type GetMemoryThreadMessagesResponse, type GetMemoryThreadParams, type GetMemoryThreadResponse, type GetNetworkResponse, type GetTelemetryParams, type GetTelemetryResponse, type GetToolResponse, type GetVNextWorkflowResponse, type GetVectorIndexResponse, type GetWorkflowResponse, type GetWorkflowRunsResponse, MastraClient, type QueryVectorParams, type QueryVectorResponse, type RequestFunction, type RequestOptions, type SaveMessageToMemoryParams, type SaveMessageToMemoryResponse, type StreamParams, type UpdateMemoryThreadParams, type UpsertVectorParams, type VNextWorkflowRunResult, type VNextWorkflowWatchResult, type WorkflowRunResult };
+export { type ClientOptions, type CreateIndexParams, type CreateMemoryThreadParams, type CreateMemoryThreadResponse, type GenerateParams, type GetAgentResponse, type GetEvalsByAgentIdResponse, type GetLogParams, type GetLogsParams, type GetLogsResponse, type GetMCPServerResponse, type GetMemoryThreadMessagesResponse, type GetMemoryThreadParams, type GetMemoryThreadResponse, type GetNetworkResponse, type GetTelemetryParams, type GetTelemetryResponse, type GetToolResponse, type GetVNextWorkflowResponse, type GetVectorIndexResponse, type GetWorkflowResponse, type GetWorkflowRunsParams, type GetWorkflowRunsResponse, MastraClient, type QueryVectorParams, type QueryVectorResponse, type RequestFunction, type RequestOptions, type SaveMessageToMemoryParams, type SaveMessageToMemoryResponse, type StreamParams, type UpdateMemoryThreadParams, type UpsertVectorParams, type VNextWorkflowRunResult, type VNextWorkflowWatchResult, type WorkflowRunResult };

package/dist/index.d.ts

@@ -58,6 +58,13 @@ interface GetWorkflowResponse {
     stepSubscriberGraph: Record<string, StepGraph>;
     workflowId?: string;
 }
+interface GetWorkflowRunsParams {
+    fromDate?: Date;
+    toDate?: Date;
+    limit?: number;
+    offset?: number;
+    resourceId?: string;
+}
 type GetWorkflowRunsResponse = WorkflowRuns;
 type WorkflowRunResult = {
     activePaths: Record<string, {
@@ -197,6 +204,8 @@ interface GetTelemetryParams {
     page?: number;
     perPage?: number;
     attribute?: Record<string, string>;
+    fromDate?: Date;
+    toDate?: Date;
 }
 interface GetNetworkResponse {
     name: string;
@@ -212,6 +221,16 @@ interface GetNetworkResponse {
     };
     state?: Record<string, any>;
 }
+interface GetMCPServerResponse {
+    id: string;
+    name: string;
+    description?: string;
+    tools: Array<{
+        name: string;
+        description: string;
+        parameters: Record<string, any>;
+    }>;
+}
 
 declare class BaseResource {
     readonly options: ClientOptions;
@@ -404,9 +423,10 @@ declare class Workflow extends BaseResource {
     details(): Promise<GetWorkflowResponse>;
     /**
      * Retrieves all runs for a workflow
+     * @param params - Parameters for filtering runs
      * @returns Promise containing workflow runs array
      */
-    runs(): Promise<GetWorkflowRunsResponse>;
+    runs(params?: GetWorkflowRunsParams): Promise<GetWorkflowRunsResponse>;
     /**
      * @deprecated Use `startAsync` instead
      * Executes the workflow with the provided parameters
@@ -522,9 +542,10 @@ declare class VNextWorkflow extends BaseResource {
     details(): Promise<GetVNextWorkflowResponse>;
     /**
      * Retrieves all runs for a vNext workflow
+     * @param params - Parameters for filtering runs
      * @returns Promise containing vNext workflow runs array
      */
-    runs(): Promise<GetWorkflowRunsResponse>;
+    runs(params?: GetWorkflowRunsParams): Promise<GetWorkflowRunsResponse>;
     /**
      * Creates a new vNext workflow run
      * @param params - Optional object containing the optional runId
@@ -591,6 +612,19 @@ declare class VNextWorkflow extends BaseResource {
     }, onRecord: (record: VNextWorkflowWatchResult) => void): Promise<void>;
 }
 
+/**
+ * MCP Server resource for interacting with MCP servers
+ */
+declare class MCPServer extends BaseResource {
+    private serverId;
+    constructor(options: ClientOptions, serverId: string);
+    /**
+     * Get details about the MCP server
+     * @returns Promise containing server details
+     */
+    details(): Promise<GetMCPServerResponse>;
+}
+
 declare class MastraClient extends BaseResource {
     constructor(options: ClientOptions);
     /**
@@ -710,6 +744,17 @@ declare class MastraClient extends BaseResource {
      * @returns Network instance
      */
     getNetwork(networkId: string): Network;
+    /**
+     * Retrieves all available MCP servers
+     * @returns Promise containing map of MCP server IDs to server details
+     */
+    getMCPServers(): Promise<Record<string, GetMCPServerResponse>>;
+    /**
+     * Gets an MCP server instance by ID
+     * @param serverId - ID of the MCP server to retrieve
+     * @returns MCPServer instance
+     */
+    getMCPServer(serverId: string): MCPServer;
 }
 
-export { type ClientOptions, type CreateIndexParams, type CreateMemoryThreadParams, type CreateMemoryThreadResponse, type GenerateParams, type GetAgentResponse, type GetEvalsByAgentIdResponse, type GetLogParams, type GetLogsParams, type GetLogsResponse, type GetMemoryThreadMessagesResponse, type GetMemoryThreadParams, type GetMemoryThreadResponse, type GetNetworkResponse, type GetTelemetryParams, type GetTelemetryResponse, type GetToolResponse, type GetVNextWorkflowResponse, type GetVectorIndexResponse, type GetWorkflowResponse, type GetWorkflowRunsResponse, MastraClient, type QueryVectorParams, type QueryVectorResponse, type RequestFunction, type RequestOptions, type SaveMessageToMemoryParams, type SaveMessageToMemoryResponse, type StreamParams, type UpdateMemoryThreadParams, type UpsertVectorParams, type VNextWorkflowRunResult, type VNextWorkflowWatchResult, type WorkflowRunResult };
+export { type ClientOptions, type CreateIndexParams, type CreateMemoryThreadParams, type CreateMemoryThreadResponse, type GenerateParams, type GetAgentResponse, type GetEvalsByAgentIdResponse, type GetLogParams, type GetLogsParams, type GetLogsResponse, type GetMCPServerResponse, type GetMemoryThreadMessagesResponse, type GetMemoryThreadParams, type GetMemoryThreadResponse, type GetNetworkResponse, type GetTelemetryParams, type GetTelemetryResponse, type GetToolResponse, type GetVNextWorkflowResponse, type GetVectorIndexResponse, type GetWorkflowResponse, type GetWorkflowRunsParams, type GetWorkflowRunsResponse, MastraClient, type QueryVectorParams, type QueryVectorResponse, type RequestFunction, type RequestOptions, type SaveMessageToMemoryParams, type SaveMessageToMemoryResponse, type StreamParams, type UpdateMemoryThreadParams, type UpsertVectorParams, type VNextWorkflowRunResult, type VNextWorkflowWatchResult, type WorkflowRunResult };

package/dist/index.js

@@ -373,10 +373,31 @@ var Workflow = class extends BaseResource {
   }
   /**
    * Retrieves all runs for a workflow
+   * @param params - Parameters for filtering runs
    * @returns Promise containing workflow runs array
    */
-  runs() {
-    return this.request(`/api/workflows/${this.workflowId}/runs`);
+  runs(params) {
+    const searchParams = new URLSearchParams();
+    if (params?.fromDate) {
+      searchParams.set("fromDate", params.fromDate.toISOString());
+    }
+    if (params?.toDate) {
+      searchParams.set("toDate", params.toDate.toISOString());
+    }
+    if (params?.limit) {
+      searchParams.set("limit", String(params.limit));
+    }
+    if (params?.offset) {
+      searchParams.set("offset", String(params.offset));
+    }
+    if (params?.resourceId) {
+      searchParams.set("resourceId", params.resourceId);
+    }
+    if (searchParams.size) {
+      return this.request(`/api/workflows/${this.workflowId}/runs?${searchParams}`);
+    } else {
+      return this.request(`/api/workflows/${this.workflowId}/runs`);
+    }
   }
   /**
    * @deprecated Use `startAsync` instead
@@ -620,10 +641,31 @@ var VNextWorkflow = class extends BaseResource {
   }
   /**
    * Retrieves all runs for a vNext workflow
+   * @param params - Parameters for filtering runs
    * @returns Promise containing vNext workflow runs array
    */
-  runs() {
-    return this.request(`/api/workflows/v-next/${this.workflowId}/runs`);
+  runs(params) {
+    const searchParams = new URLSearchParams();
+    if (params?.fromDate) {
+      searchParams.set("fromDate", params.fromDate.toISOString());
+    }
+    if (params?.toDate) {
+      searchParams.set("toDate", params.toDate.toISOString());
+    }
+    if (params?.limit) {
+      searchParams.set("limit", String(params.limit));
+    }
+    if (params?.offset) {
+      searchParams.set("offset", String(params.offset));
+    }
+    if (params?.resourceId) {
+      searchParams.set("resourceId", params.resourceId);
+    }
+    if (searchParams.size) {
+      return this.request(`/api/workflows/v-next/${this.workflowId}/runs?${searchParams}`);
+    } else {
+      return this.request(`/api/workflows/v-next/${this.workflowId}/runs`);
+    }
   }
   /**
    * Creates a new vNext workflow run
@@ -722,6 +764,21 @@ var VNextWorkflow = class extends BaseResource {
   }
 };
 
+// src/resources/mcp.ts
+var MCPServer = class extends BaseResource {
+  constructor(options, serverId) {
+    super(options);
+    this.serverId = serverId;
+  }
+  /**
+   * Get details about the MCP server
+   * @returns Promise containing server details
+   */
+  details() {
+    return this.request(`/api/mcp/servers/${this.serverId}`);
+  }
+};
+
 // src/client.ts
 var MastraClient = class extends BaseResource {
   constructor(options) {
@@ -866,7 +923,7 @@ var MastraClient = class extends BaseResource {
    * @returns Promise containing telemetry data
    */
   getTelemetry(params) {
-    const { name, scope, page, perPage, attribute } = params || {};
+    const { name, scope, page, perPage, attribute, fromDate, toDate } = params || {};
     const _attribute = attribute ? Object.entries(attribute).map(([key, value]) => `${key}:${value}`) : [];
     const searchParams = new URLSearchParams();
     if (name) {
@@ -890,6 +947,12 @@ var MastraClient = class extends BaseResource {
         searchParams.set("attribute", _attribute);
       }
     }
+    if (fromDate) {
+      searchParams.set("fromDate", fromDate.toISOString());
+    }
+    if (toDate) {
+      searchParams.set("toDate", toDate.toISOString());
+    }
     if (searchParams.size) {
       return this.request(`/api/telemetry?${searchParams}`);
     } else {
@@ -911,6 +974,21 @@ var MastraClient = class extends BaseResource {
   getNetwork(networkId) {
     return new Network(this.options, networkId);
   }
+  /**
+   * Retrieves all available MCP servers
+   * @returns Promise containing map of MCP server IDs to server details
+   */
+  getMCPServers() {
+    return this.request("/api/mcp/servers");
+  }
+  /**
+   * Gets an MCP server instance by ID
+   * @param serverId - ID of the MCP server to retrieve
+   * @returns MCPServer instance
+   */
+  getMCPServer(serverId) {
+    return new MCPServer(this.options, serverId);
+  }
 };
 
 export { MastraClient };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/client-js",
-  "version": "0.0.0-mcp-schema-serializer-20250430202337",
+  "version": "0.0.0-mcp-server-deploy-20250507160341",
   "description": "The official TypeScript library for the Mastra Client API",
   "author": "",
   "type": "module",
@@ -26,7 +26,7 @@
     "json-schema": "^0.4.0",
     "zod": "^3.24.2",
     "zod-to-json-schema": "^3.24.3",
-    "@mastra/core": "0.0.0-mcp-schema-serializer-20250430202337"
+    "@mastra/core": "0.0.0-mcp-server-deploy-20250507160341"
   },
   "peerDependencies": {
     "zod": "^3.24.2"

package/src/client.ts

@@ -1,4 +1,14 @@
-import { Agent, MemoryThread, Tool, Workflow, Vector, BaseResource, Network, VNextWorkflow } from './resources';
+import {
+  Agent,
+  MemoryThread,
+  Tool,
+  Workflow,
+  Vector,
+  BaseResource,
+  Network,
+  VNextWorkflow,
+  MCPServer,
+} from './resources';
 import type {
   ClientOptions,
   CreateMemoryThreadParams,
@@ -7,6 +17,7 @@ import type {
   GetLogParams,
   GetLogsParams,
   GetLogsResponse,
+  GetMCPServerResponse,
   GetMemoryThreadParams,
   GetMemoryThreadResponse,
   GetNetworkResponse,
@@ -180,7 +191,7 @@ export class MastraClient extends BaseResource {
    * @returns Promise containing telemetry data
    */
   public getTelemetry(params?: GetTelemetryParams): Promise<GetTelemetryResponse> {
-    const { name, scope, page, perPage, attribute } = params || {};
+    const { name, scope, page, perPage, attribute, fromDate, toDate } = params || {};
     const _attribute = attribute ? Object.entries(attribute).map(([key, value]) => `${key}:${value}`) : [];
 
     const searchParams = new URLSearchParams();
@@ -205,6 +216,12 @@ export class MastraClient extends BaseResource {
         searchParams.set('attribute', _attribute);
       }
     }
+    if (fromDate) {
+      searchParams.set('fromDate', fromDate.toISOString());
+    }
+    if (toDate) {
+      searchParams.set('toDate', toDate.toISOString());
+    }
 
     if (searchParams.size) {
       return this.request(`/api/telemetry?${searchParams}`);
@@ -229,4 +246,21 @@ export class MastraClient extends BaseResource {
   public getNetwork(networkId: string) {
     return new Network(this.options, networkId);
   }
+
+  /**
+   * Retrieves all available MCP servers
+   * @returns Promise containing map of MCP server IDs to server details
+   */
+  public getMCPServers(): Promise<Record<string, GetMCPServerResponse>> {
+    return this.request('/api/mcp/servers');
+  }
+
+  /**
+   * Gets an MCP server instance by ID
+   * @param serverId - ID of the MCP server to retrieve
+   * @returns MCPServer instance
+   */
+  public getMCPServer(serverId: string) {
+    return new MCPServer(this.options, serverId);
+  }
 }

package/src/resources/index.ts

@@ -6,3 +6,4 @@ export * from './workflow';
 export * from './tool';
 export * from './base';
 export * from './vnext-workflow';
+export * from './mcp';

package/src/resources/mcp.ts

@@ -0,0 +1,22 @@
+import type { ClientOptions, GetMCPServerResponse } from '../types';
+import { BaseResource } from './base';
+
+/**
+ * MCP Server resource for interacting with MCP servers
+ */
+export class MCPServer extends BaseResource {
+  constructor(
+    options: ClientOptions,
+    private serverId: string,
+  ) {
+    super(options);
+  }
+
+  /**
+   * Get details about the MCP server
+   * @returns Promise containing server details
+   */
+  details(): Promise<GetMCPServerResponse> {
+    return this.request(`/api/mcp/servers/${this.serverId}`);
+  }
+}

package/src/resources/vnext-workflow.ts

@@ -2,6 +2,7 @@ import type { RuntimeContext } from '@mastra/core/runtime-context';
 import type {
   ClientOptions,
   GetVNextWorkflowResponse,
+  GetWorkflowRunsParams,
   GetWorkflowRunsResponse,
   VNextWorkflowRunResult,
   VNextWorkflowWatchResult,
@@ -100,10 +101,32 @@ export class VNextWorkflow extends BaseResource {
 
   /**
    * Retrieves all runs for a vNext workflow
+   * @param params - Parameters for filtering runs
    * @returns Promise containing vNext workflow runs array
    */
-  runs(): Promise<GetWorkflowRunsResponse> {
-    return this.request(`/api/workflows/v-next/${this.workflowId}/runs`);
+  runs(params?: GetWorkflowRunsParams): Promise<GetWorkflowRunsResponse> {
+    const searchParams = new URLSearchParams();
+    if (params?.fromDate) {
+      searchParams.set('fromDate', params.fromDate.toISOString());
+    }
+    if (params?.toDate) {
+      searchParams.set('toDate', params.toDate.toISOString());
+    }
+    if (params?.limit) {
+      searchParams.set('limit', String(params.limit));
+    }
+    if (params?.offset) {
+      searchParams.set('offset', String(params.offset));
+    }
+    if (params?.resourceId) {
+      searchParams.set('resourceId', params.resourceId);
+    }
+
+    if (searchParams.size) {
+      return this.request(`/api/workflows/v-next/${this.workflowId}/runs?${searchParams}`);
+    } else {
+      return this.request(`/api/workflows/v-next/${this.workflowId}/runs`);
+    }
   }
 
   /**

package/src/resources/workflow.ts

@@ -1,4 +1,10 @@
-import type { GetWorkflowResponse, ClientOptions, WorkflowRunResult, GetWorkflowRunsResponse } from '../types';
+import type {
+  GetWorkflowResponse,
+  ClientOptions,
+  WorkflowRunResult,
+  GetWorkflowRunsResponse,
+  GetWorkflowRunsParams,
+} from '../types';
 
 import { BaseResource } from './base';
 
@@ -22,10 +28,32 @@ export class Workflow extends BaseResource {
 
   /**
    * Retrieves all runs for a workflow
+   * @param params - Parameters for filtering runs
    * @returns Promise containing workflow runs array
    */
-  runs(): Promise<GetWorkflowRunsResponse> {
-    return this.request(`/api/workflows/${this.workflowId}/runs`);
+  runs(params?: GetWorkflowRunsParams): Promise<GetWorkflowRunsResponse> {
+    const searchParams = new URLSearchParams();
+    if (params?.fromDate) {
+      searchParams.set('fromDate', params.fromDate.toISOString());
+    }
+    if (params?.toDate) {
+      searchParams.set('toDate', params.toDate.toISOString());
+    }
+    if (params?.limit) {
+      searchParams.set('limit', String(params.limit));
+    }
+    if (params?.offset) {
+      searchParams.set('offset', String(params.offset));
+    }
+    if (params?.resourceId) {
+      searchParams.set('resourceId', params.resourceId);
+    }
+
+    if (searchParams.size) {
+      return this.request(`/api/workflows/${this.workflowId}/runs?${searchParams}`);
+    } else {
+      return this.request(`/api/workflows/${this.workflowId}/runs`);
+    }
   }
 
   /**

package/src/types.ts

@@ -77,6 +77,14 @@ export interface GetWorkflowResponse {
   workflowId?: string;
 }
 
+export interface GetWorkflowRunsParams {
+  fromDate?: Date;
+  toDate?: Date;
+  limit?: number;
+  offset?: number;
+  resourceId?: string;
+}
+
 export type GetWorkflowRunsResponse = WorkflowRuns;
 
 export type WorkflowRunResult = {
@@ -234,6 +242,8 @@ export interface GetTelemetryParams {
   page?: number;
   perPage?: number;
   attribute?: Record<string, string>;
+  fromDate?: Date;
+  toDate?: Date;
 }
 
 export interface GetNetworkResponse {
@@ -250,3 +260,14 @@ export interface GetNetworkResponse {
   };
   state?: Record<string, any>;
 }
+
+export interface GetMCPServerResponse {
+  id: string;
+  name: string;
+  description?: string;
+  tools: Array<{
+    name: string;
+    description: string;
+    parameters: Record<string, any>;
+  }>;
+}