@zuplo/runtime 6.54.21 → 6.54.22

package/out/types/index.d.ts

@@ -1,6 +1,8 @@
+import { CallToolResult } from "@zuplo/mcp/types";
 import { KeyLike } from "jose";
 import { RequestGeneric as RequestGeneric_2 } from "../../request.js";
 import type { ValidateFunction } from "ajv";
+import { z } from "zod/v4";
 
 /**
  * Entry format for Akamai API Security logger
@@ -4640,6 +4642,101 @@ declare type LokiTransportVersion = 1 | 2;
 
 /* Excluded from this release type: LookupResult */
 
+/**
+ * Plugin for adding MCP (Model Context Protocol) custom tools to Zuplo
+ *
+ * This plugin allows end users to create custom MCP tools using a simple SDK
+ * that can perform complex operations including invoking multiple routes on the gateway or
+ * implementing custom logic beyond simple route mapping.
+ */
+export declare class McpCustomToolsPlugin extends SystemRuntimePlugin {
+  private options;
+  private mcpServer;
+  private transport;
+  constructor(options: McpCustomToolsPluginOptions);
+  private validateTools;
+  registerRoutes(options: {
+    router: Router;
+    runtimeSettings: RuntimeSettings;
+  }): void;
+  private createMcpHandler;
+  /**
+   * Lazy loads the MCP server, http transport, and tools on first call
+   */
+  private initializeMcpServer;
+  /**
+   * Registers individual custom tools from users given a McpToolDefinion
+   */
+  private registerTool;
+}
+
+/**
+ * Configuration options for the MCP Custom Tools Plugin
+ */
+export declare interface McpCustomToolsPluginOptions {
+  /**
+   * Name of the MCP server
+   */
+  name?: string;
+  /**
+   * Version of the MCP server
+   */
+  version?: string;
+  /**
+   * The endpoint path where the MCP server will be registered on the gateway
+   * Default: "/mcp"
+   */
+  endpoint?: string;
+  /**
+   * Custom tools to register with the MCP server
+   */
+  tools: McpToolDefinition[];
+}
+
+/**
+ * SDK for creating and managing MCP custom tools
+ *
+ * Provides a fluent API for defining custom MCP tools that can perform
+ * complex operations including calling multiple routes or implementing
+ * custom logic beyond simple route mapping.
+ */
+export declare class McpCustomToolsSDK {
+  /**
+   * Create a new tool builder
+   */
+  createTool(): McpToolBuilder;
+  /**
+   * Define a tool with a configuration object
+   */
+  defineTool<TSchema extends z.ZodType>(config: {
+    name: string;
+    description: string;
+    schema?: TSchema;
+    outputSchema?: TSchema;
+    handler: McpToolHandler<z.infer<TSchema>>;
+  }): McpToolDefinition<z.infer<TSchema>>;
+  /**
+   * Create a text response
+   */
+  textResponse(text: string): CallToolResult;
+  /**
+   * Create a JSON response (automatically stringified and put in structured content)
+   */
+  jsonResponse(data: any): CallToolResult;
+  /**
+   * Create an error response
+   */
+  errorResponse(message: string): CallToolResult;
+  /**
+   * Create an image response
+   */
+  imageResponse(data: string, mimeType: string): CallToolResult;
+  /**
+   * Create a resource response
+   */
+  resourceResponse(uri: string, mimeType?: string): CallToolResult;
+}
+
 /**
  * An MCP Server handler for Zuplo
  * Only POST requests are supported for the HTTP streamable MCP transport.
@@ -4654,6 +4751,56 @@ export declare function mcpServerHandler(
   context: ZuploContext
 ): Promise<Response>;
 
+/**
+ * Builder for creating MCP tools with type safety
+ */
+export declare class McpToolBuilder<TSchema extends z.ZodSchema = z.ZodAny> {
+  private config;
+  /**
+   * Set the tool name
+   */
+  name(name: string): this;
+  /**
+   * Set the tool description
+   */
+  description(description: string): this;
+  /**
+   * Set the input schema for the tool
+   */
+  schema<S extends z.ZodSchema>(schema: S): McpToolBuilder<S>;
+  /**
+   * Set the output schema for the tool
+   */
+  outSchema<S extends z.ZodSchema>(schema: S): McpToolBuilder<S>;
+  /**
+   * Set the handler function for the tool
+   */
+  handler(handler: McpToolHandler<z.infer<TSchema>>): this;
+  /**
+   * Build the tool definition
+   */
+  build(): McpToolDefinition<z.infer<TSchema>>;
+}
+
+/**
+ * Definition of a custom MCP tool
+ */
+export declare interface McpToolDefinition<TSchema = any> {
+  name: string;
+  description: string;
+  schema?: z.ZodType<TSchema>;
+  outputSchema?: z.ZodType<TSchema>;
+  handler: McpToolHandler<TSchema>;
+}
+
+/**
+ * Handler function for MCP tools
+ */
+export declare type McpToolHandler<TArgs = any> = (
+  args: TArgs,
+  context: ZuploContext
+) => Promise<CallToolResult> | CallToolResult;
+
 /**
  * A two-tier cache that combines in-memory caching with zone-level caching.
  * Data is first checked in memory cache for fastest access, then falls back to

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zuplo/runtime",
   "type": "module",
-  "version": "6.54.21",
+  "version": "6.54.22",
   "repository": "https://github.com/zuplo/zuplo",
   "author": "Zuplo, Inc.",
   "exports": {