@rekog/mcp-nest 1.9.10-alpha.4 → 2.0.0-alpha.0

package/README.md

@@ -17,7 +17,8 @@ With `@rekog/mcp-nest` you define tools, resources, and prompts in a way that's
 
 ## Features
 
-- 🚀 **[Multi-Transport Support](docs/server-examples.md#multiple-transport-types)**: HTTP+SSE, Streamable HTTP, and STDIO
+- 🧩 **[NestJS Microservice Strategy](docs/migration-to-strategy.md)**: MCP runs as a `CustomTransportStrategy`, so tools/resources/prompts are real `@MessagePattern` handlers — **guards, pipes, interceptors, and exception filters apply to them natively**
+- 🚀 **[Multi-Transport Support](docs/server-examples.md#multiple-transport-types)**: Streamable HTTP and STDIO — selected via the `transports` array
 - 🔧 **[Tools](docs/tools.md)**: Expose NestJS methods as MCP tools with automatic discovery and Zod validation
   - 🛠️ **[Elicitation](docs/tools.md#interactive-tool-calls)**: Interactive tool calls with user input elicitation
   - 🌐 **[HTTP Request Access](docs/tools.md#understanding-tool-method-parameters)**: Full access to request context within MCP handlers
@@ -46,7 +47,13 @@ npm install @rekog/mcp-nest @modelcontextprotocol/sdk zod@^4
 
 ### Optional dependencies
 
-If you use the built-in authorization server with the TypeORM store, install the following optional peer dependencies:
+The built-in authorization server now lives in a separate package. If you use it, install it alongside `@rekog/mcp-nest`:
+
+```bash
+npm install @rekog/mcp-nest-auth
+```
+
+If you additionally use the TypeORM store for the authorization server, install the following optional peer dependencies as well:
 
 ```bash
 npm install @nestjs/typeorm typeorm
@@ -54,48 +61,88 @@ npm install @nestjs/typeorm typeorm
 
 ## Quick Start
 
+MCP-Nest runs as a **NestJS microservice transport strategy**. Tools, resources,
+and prompts live on `@McpController()` classes (so NestJS guards, pipes,
+interceptors, and exception filters apply to them), and the strategy serves them
+over one or more transports (Streamable HTTP, STDIO).
+
+```typescript
+// greeting.controller.ts
+import { McpController, Tool, McpContext } from '@rekog/mcp-nest';
+import { Ctx, Payload } from '@nestjs/microservices';
+import { z } from 'zod';
+
+@McpController()
+export class GreetingController {
+  @Tool({
+    name: 'greeting-tool',
+    description: 'Returns a greeting with progress updates',
+    parameters: z.object({ name: z.string().default('World') }),
+  })
+  async sayHello(
+    @Payload() { name }: { name: string },
+    @Ctx() ctx: McpContext,
+  ) {
+    await ctx.reportProgress({ progress: 50, total: 100 });
+    return { content: [{ type: 'text', text: `Hello, ${name}!` }] };
+  }
+}
+```
+
 ```typescript
 // app.module.ts
 import { Module } from '@nestjs/common';
-import { McpModule } from '@rekog/mcp-nest';
-import { GreetingTool } from './greeting.tool';
+import {
+  McpStrategy,
+  MCP_STRATEGY,
+  StreamableHttpTransport,
+} from '@rekog/mcp-nest';
+import { GreetingController } from './greeting.controller';
+
+// The strategy is the whole configuration — there is no McpModule.
+export const mcp = new McpStrategy({
+  name: 'my-mcp-server',
+  version: '1.0.0',
+  transports: [
+    new StreamableHttpTransport(),
+  ],
+});
 
 @Module({
-  imports: [
-    McpModule.forRoot({
-      name: 'my-mcp-server',
-      version: '1.0.0',
-    }),
-  ],
-  providers: [GreetingTool],
+  controllers: [GreetingController],
+  // Optional: only needed if a provider injects the strategy (e.g. for
+  // runtime/dynamic tool registration).
+  providers: [{ provide: MCP_STRATEGY, useValue: mcp }],
 })
 export class AppModule {}
 ```
 
 ```typescript
-// greeting.tool.ts
-import { Injectable } from '@nestjs/common';
-import { Tool, Context } from '@rekog/mcp-nest';
-import { z } from 'zod';
-
-@Injectable()
-export class GreetingTool {
-  @Tool({
-    name: 'greeting-tool',
-    description: 'Returns a greeting with progress updates',
-    parameters: z.object({
-      name: z.string().default('World'),
-    }),
-  })
-  async sayHello({ name }, context: Context) {
-    await context.reportProgress({ progress: 50, total: 100 });
-    return `Hello, ${name}!`;
-  }
+// main.ts
+import { NestFactory } from '@nestjs/core';
+import { AppModule, mcp } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+  mcp.setHttpAdapter(app.getHttpAdapter()); // needed for HTTP transports
+  app.connectMicroservice({ strategy: mcp });
+  await app.startAllMicroservices(); // mounts the MCP transports
+  await app.listen(3000); // also serves your normal HTTP routes
 }
+void bootstrap();
 ```
 
+> **Order matters:** call `startAllMicroservices()` before `listen()` so the MCP
+> HTTP routes are mounted before the server starts accepting connections.
+
+For an STDIO-only server, skip the HTTP adapter and use
+`NestFactory.createMicroservice(AppModule, { strategy: mcp })` with
+`transports: [new StdioTransport()]` and disable logging (stdout is reserved for
+the protocol).
+
 ## Documentation
 
+- **[Migration to the Strategy API](docs/migration-to-strategy.md)** - Moving from `McpModule.forRoot(options)` to `McpStrategy` + `@McpController`
 - **[Tools Guide](docs/tools.md)** - Define and expose NestJS methods as MCP tools
 - **[Discovery and Registration of Tools](docs/tool-discovery-and-registration.md)** - Automatic discovery and manual registration of tools
 - **[Dynamic Capabilities Guide](docs/dynamic-capabilities.md)** - Register tools, resources, and prompts programmatically at runtime

package/dist/index.d.ts

@@ -1,3 +1,2 @@
 export * from './mcp';
-export * from './authz';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC"}

package/dist/index.js

@@ -15,5 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./mcp"), exports);
-__exportStar(require("./authz"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB;AACtB,0CAAwB","sourcesContent":["export * from './mcp';\nexport * from './authz';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB","sourcesContent":["export * from './mcp';\n"]}

package/dist/mcp/decorators/constants.d.ts

@@ -2,4 +2,5 @@ export declare const MCP_TOOL_METADATA_KEY = "mcp:tool";
 export declare const MCP_RESOURCE_METADATA_KEY = "mcp:resource";
 export declare const MCP_RESOURCE_TEMPLATE_METADATA_KEY = "mcp:resource-template";
 export declare const MCP_PROMPT_METADATA_KEY = "mcp:prompt";
+export declare const MCP_CONTROLLER_METADATA_KEY = "mcp:controller";
 //# sourceMappingURL=constants.d.ts.map

package/dist/mcp/decorators/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/mcp/decorators/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,aAAa,CAAC;AAChD,eAAO,MAAM,yBAAyB,iBAAiB,CAAC;AACxD,eAAO,MAAM,kCAAkC,0BAA0B,CAAC;AAC1E,eAAO,MAAM,uBAAuB,eAAe,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/mcp/decorators/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,aAAa,CAAC;AAChD,eAAO,MAAM,yBAAyB,iBAAiB,CAAC;AACxD,eAAO,MAAM,kCAAkC,0BAA0B,CAAC;AAC1E,eAAO,MAAM,uBAAuB,eAAe,CAAC;AACpD,eAAO,MAAM,2BAA2B,mBAAmB,CAAC"}

package/dist/mcp/decorators/constants.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MCP_PROMPT_METADATA_KEY = exports.MCP_RESOURCE_TEMPLATE_METADATA_KEY = exports.MCP_RESOURCE_METADATA_KEY = exports.MCP_TOOL_METADATA_KEY = void 0;
+exports.MCP_CONTROLLER_METADATA_KEY = exports.MCP_PROMPT_METADATA_KEY = exports.MCP_RESOURCE_TEMPLATE_METADATA_KEY = exports.MCP_RESOURCE_METADATA_KEY = exports.MCP_TOOL_METADATA_KEY = void 0;
 exports.MCP_TOOL_METADATA_KEY = 'mcp:tool';
 exports.MCP_RESOURCE_METADATA_KEY = 'mcp:resource';
 exports.MCP_RESOURCE_TEMPLATE_METADATA_KEY = 'mcp:resource-template';
 exports.MCP_PROMPT_METADATA_KEY = 'mcp:prompt';
+exports.MCP_CONTROLLER_METADATA_KEY = 'mcp:controller';
 //# sourceMappingURL=constants.js.map

package/dist/mcp/decorators/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/mcp/decorators/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,qBAAqB,GAAG,UAAU,CAAC;AACnC,QAAA,yBAAyB,GAAG,cAAc,CAAC;AAC3C,QAAA,kCAAkC,GAAG,uBAAuB,CAAC;AAC7D,QAAA,uBAAuB,GAAG,YAAY,CAAC","sourcesContent":["export const MCP_TOOL_METADATA_KEY = 'mcp:tool';\nexport const MCP_RESOURCE_METADATA_KEY = 'mcp:resource';\nexport const MCP_RESOURCE_TEMPLATE_METADATA_KEY = 'mcp:resource-template';\nexport const MCP_PROMPT_METADATA_KEY = 'mcp:prompt';\n"]}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/mcp/decorators/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,qBAAqB,GAAG,UAAU,CAAC;AACnC,QAAA,yBAAyB,GAAG,cAAc,CAAC;AAC3C,QAAA,kCAAkC,GAAG,uBAAuB,CAAC;AAC7D,QAAA,uBAAuB,GAAG,YAAY,CAAC;AACvC,QAAA,2BAA2B,GAAG,gBAAgB,CAAC","sourcesContent":["export const MCP_TOOL_METADATA_KEY = 'mcp:tool';\nexport const MCP_RESOURCE_METADATA_KEY = 'mcp:resource';\nexport const MCP_RESOURCE_TEMPLATE_METADATA_KEY = 'mcp:resource-template';\nexport const MCP_PROMPT_METADATA_KEY = 'mcp:prompt';\nexport const MCP_CONTROLLER_METADATA_KEY = 'mcp:controller';\n"]}

package/dist/mcp/decorators/index.d.ts

@@ -6,5 +6,7 @@ export * from './prompt.decorator';
 export * from './public.decorator';
 export * from './tool-scopes.decorator';
 export * from './tool-roles.decorator';
-export * from './tool-guards.decorator';
+export * from './mcp-controller.decorator';
+export * from './mcp-message-pattern';
+export * from './raw-request.decorator';
 //# sourceMappingURL=index.d.ts.map

package/dist/mcp/decorators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}

package/dist/mcp/decorators/index.js

@@ -22,5 +22,7 @@ __exportStar(require("./prompt.decorator"), exports);
 __exportStar(require("./public.decorator"), exports);
 __exportStar(require("./tool-scopes.decorator"), exports);
 __exportStar(require("./tool-roles.decorator"), exports);
-__exportStar(require("./tool-guards.decorator"), exports);
+__exportStar(require("./mcp-controller.decorator"), exports);
+__exportStar(require("./mcp-message-pattern"), exports);
+__exportStar(require("./raw-request.decorator"), exports);
 //# sourceMappingURL=index.js.map

package/dist/mcp/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,8CAA4B;AAC5B,uDAAqC;AACrC,gEAA8C;AAC9C,qDAAmC;AACnC,qDAAmC;AACnC,0DAAwC;AACxC,yDAAuC;AACvC,0DAAwC","sourcesContent":["export * from './tool.decorator';\nexport * from './constants';\nexport * from './resource.decorator';\nexport * from './resource-template.decorator';\nexport * from './prompt.decorator';\nexport * from './public.decorator';\nexport * from './tool-scopes.decorator';\nexport * from './tool-roles.decorator';\nexport * from './tool-guards.decorator';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,8CAA4B;AAC5B,uDAAqC;AACrC,gEAA8C;AAC9C,qDAAmC;AACnC,qDAAmC;AACnC,0DAAwC;AACxC,yDAAuC;AACvC,6DAA2C;AAC3C,wDAAsC;AACtC,0DAAwC","sourcesContent":["export * from './tool.decorator';\nexport * from './constants';\nexport * from './resource.decorator';\nexport * from './resource-template.decorator';\nexport * from './prompt.decorator';\nexport * from './public.decorator';\nexport * from './tool-scopes.decorator';\nexport * from './tool-roles.decorator';\nexport * from './mcp-controller.decorator';\nexport * from './mcp-message-pattern';\nexport * from './raw-request.decorator';\n"]}

package/dist/mcp/decorators/mcp-controller.decorator.d.ts

@@ -0,0 +1,6 @@
+import { ControllerOptions } from '@nestjs/common';
+export interface McpControllerOptions extends ControllerOptions {
+    server?: string;
+}
+export declare function McpController(prefixOrOptions?: string | string[] | McpControllerOptions): ClassDecorator;
+//# sourceMappingURL=mcp-controller.decorator.d.ts.map

package/dist/mcp/decorators/mcp-controller.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-controller.decorator.d.ts","sourceRoot":"","sources":["../../../src/mcp/decorators/mcp-controller.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,iBAAiB,EAElB,MAAM,gBAAgB,CAAC;AAkBxB,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAM7D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA+DD,wBAAgB,aAAa,CAC3B,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,oBAAoB,GACzD,cAAc,CA8BhB"}

package/dist/mcp/decorators/mcp-controller.decorator.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpController = McpController;
+const common_1 = require("@nestjs/common");
+const constants_1 = require("./constants");
+const mcp_transport_constants_1 = require("../transport/mcp-transport.constants");
+const PATTERN_EXTRAS_METADATA = 'microservices:pattern_extras';
+const TRANSPORT_METADATA = 'microservices:transport';
+function retagMcpMethodsTransport(target, transportId) {
+    const proto = target.prototype;
+    if (!proto)
+        return;
+    for (const key of Object.getOwnPropertyNames(proto)) {
+        if (key === 'constructor')
+            continue;
+        const fn = proto[key];
+        if (typeof fn !== 'function')
+            continue;
+        const extras = Reflect.getMetadata(PATTERN_EXTRAS_METADATA, fn);
+        if (extras && extras.mcpType) {
+            Reflect.defineMetadata(TRANSPORT_METADATA, transportId, fn);
+        }
+    }
+}
+function McpController(prefixOrOptions) {
+    let server;
+    let controllerOptions = prefixOrOptions;
+    if (prefixOrOptions &&
+        typeof prefixOrOptions === 'object' &&
+        !Array.isArray(prefixOrOptions) &&
+        'server' in prefixOrOptions) {
+        const { server: serverName, ...rest } = prefixOrOptions;
+        server = serverName;
+        controllerOptions = rest;
+    }
+    return (target) => {
+        (0, common_1.applyDecorators)((0, common_1.Controller)(controllerOptions), (0, common_1.SetMetadata)(constants_1.MCP_CONTROLLER_METADATA_KEY, true), (0, common_1.SetMetadata)(mcp_transport_constants_1.MCP_SERVER_NAME_METADATA_KEY, server))(target);
+        if (server) {
+            retagMcpMethodsTransport(target, (0, mcp_transport_constants_1.mcpTransportFor)(server));
+        }
+    };
+}
+//# sourceMappingURL=mcp-controller.decorator.js.map

package/dist/mcp/decorators/mcp-controller.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-controller.decorator.js","sourceRoot":"","sources":["../../../src/mcp/decorators/mcp-controller.decorator.ts"],"names":[],"mappings":";;AA6FA,sCAgCC;AA7HD,2CAKwB;AACxB,2CAA0D;AAC1D,kFAG8C;AAS9C,MAAM,uBAAuB,GAAG,8BAA8B,CAAC;AAC/D,MAAM,kBAAkB,GAAG,yBAAyB,CAAC;AAyBrD,SAAS,wBAAwB,CAC/B,MAAgB,EAChB,WAAmB;IAEnB,MAAM,KAAK,GAAI,MAAkD,CAAC,SAAS,CAAC;IAC5E,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,IAAI,GAAG,KAAK,aAAa;YAAE,SAAS;QACpC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,OAAO,EAAE,KAAK,UAAU;YAAE,SAAS;QACvC,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,EAAE,CAEjD,CAAC;QACd,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC7B,OAAO,CAAC,cAAc,CAAC,kBAAkB,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;AACH,CAAC;AA+BD,SAAgB,aAAa,CAC3B,eAA0D;IAI1D,IAAI,MAA0B,CAAC;IAC/B,IAAI,iBAAiB,GACnB,eAAe,CAAC;IAClB,IACE,eAAe;QACf,OAAO,eAAe,KAAK,QAAQ;QACnC,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC;QAC/B,QAAQ,IAAI,eAAe,EAC3B,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,eAAe,CAAC;QACxD,MAAM,GAAG,UAAU,CAAC;QACpB,iBAAiB,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,IAAA,wBAAe,EACb,IAAA,mBAAU,EAAC,iBAAsC,CAAC,EAClD,IAAA,oBAAW,EAAC,uCAA2B,EAAE,IAAI,CAAC,EAC9C,IAAA,oBAAW,EAAC,sDAA4B,EAAE,MAAM,CAAC,CAClD,CAAC,MAAM,CAAC,CAAC;QAIV,IAAI,MAAM,EAAE,CAAC;YACX,wBAAwB,CAAC,MAAM,EAAE,IAAA,yCAAe,EAAC,MAAM,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import {\n  applyDecorators,\n  Controller,\n  ControllerOptions,\n  SetMetadata,\n} from '@nestjs/common';\nimport { MCP_CONTROLLER_METADATA_KEY } from './constants';\nimport {\n  MCP_SERVER_NAME_METADATA_KEY,\n  mcpTransportFor,\n} from '../transport/mcp-transport.constants';\n\n/**\n * NestJS-internal metadata keys written by `@MessagePattern`. They are NOT\n * re-exported from the `@nestjs/microservices` package entry, so we reference\n * the string literals directly (see `@nestjs/microservices/constants`:\n * `PATTERN_EXTRAS_METADATA` / `TRANSPORT_METADATA`). The multi-server e2e test\n * guards against these drifting on a NestJS bump.\n */\nconst PATTERN_EXTRAS_METADATA = 'microservices:pattern_extras';\nconst TRANSPORT_METADATA = 'microservices:transport';\n\n/** Options for {@link McpController}: standard `@Controller` options plus a server name. */\nexport interface McpControllerOptions extends ControllerOptions {\n  /**\n   * Logical MCP server name. The controller's MCP methods bind ONLY to a\n   * connected `McpStrategy({ server: <name> })`. Omit to use the default shared\n   * server (binds to a plain `McpStrategy()`).\n   */\n  server?: string;\n}\n\n/**\n * Re-tags every MCP capability method on `target`'s prototype with the given\n * transport id, overriding the default {@link MCP_TRANSPORT} that the\n * `@Tool`/`@Resource`/`@Prompt` method decorators wrote.\n *\n * This works because class decorators run AFTER the method decorators, and both\n * `@MessagePattern` and this walk reach the SAME function reference via\n * `prototype[key]` — so re-defining the transport metadata on it wins. We\n * recognize MCP methods by the `mcpType` marker stored in their pattern extras.\n *\n * Note: `Object.getOwnPropertyNames` only sees methods declared on this class,\n * not ones inherited from a base class.\n */\nfunction retagMcpMethodsTransport(\n  target: Function,\n  transportId: symbol,\n): void {\n  const proto = (target as { prototype?: Record<string, unknown> }).prototype;\n  if (!proto) return;\n  for (const key of Object.getOwnPropertyNames(proto)) {\n    if (key === 'constructor') continue;\n    const fn = proto[key];\n    if (typeof fn !== 'function') continue;\n    const extras = Reflect.getMetadata(PATTERN_EXTRAS_METADATA, fn) as\n      | { mcpType?: unknown }\n      | undefined;\n    if (extras && extras.mcpType) {\n      Reflect.defineMetadata(TRANSPORT_METADATA, transportId, fn);\n    }\n  }\n}\n\n/**\n * Marks a class as an MCP capability controller.\n *\n * NestJS only scans classes registered in a module's `controllers` array for\n * microservice (`@MessagePattern`) handlers, so MCP tool/resource/prompt classes\n * MUST be controllers. `@McpController` composes the standard `@Controller()`\n * decorator (so the framework discovers and binds the `@Tool`/`@Resource`/\n * `@Prompt` handlers) and adds a marker the {@link McpStrategy} uses to recognize\n * MCP controllers.\n *\n * Because `@Tool`/`@Resource`/`@Prompt` do not add HTTP route decorators, methods\n * on an `@McpController` are NOT exposed as HTTP routes — they are reachable only\n * through the MCP transport.\n *\n * To run multiple isolated MCP servers in one app, assign a controller to a\n * named server with `@McpController({ server: 'admin' })`; its tools/resources/\n * prompts then bind ONLY to a matching `McpStrategy({ server: 'admin' })`.\n *\n * @example\n * ```typescript\n * @McpController()\n * export class GreetingTool {\n *   @Tool({ name: 'hello', description: 'Say hello', parameters: z.object({ name: z.string() }) })\n *   sayHello(@Payload() { name }: { name: string }, @Ctx() ctx: McpContext) {\n *     return { content: [{ type: 'text', text: `Hello, ${name}!` }] };\n *   }\n * }\n * ```\n */\nexport function McpController(\n  prefixOrOptions?: string | string[] | McpControllerOptions,\n): ClassDecorator {\n  // Extract the MCP-specific `server` name (if any) and forward the remaining\n  // standard controller options to `@Controller`.\n  let server: string | undefined;\n  let controllerOptions: string | string[] | ControllerOptions | undefined =\n    prefixOrOptions;\n  if (\n    prefixOrOptions &&\n    typeof prefixOrOptions === 'object' &&\n    !Array.isArray(prefixOrOptions) &&\n    'server' in prefixOrOptions\n  ) {\n    const { server: serverName, ...rest } = prefixOrOptions;\n    server = serverName;\n    controllerOptions = rest;\n  }\n\n  return (target: Function) => {\n    applyDecorators(\n      Controller(controllerOptions as ControllerOptions),\n      SetMetadata(MCP_CONTROLLER_METADATA_KEY, true),\n      SetMetadata(MCP_SERVER_NAME_METADATA_KEY, server),\n    )(target);\n    // A named server re-tags this controller's MCP methods with that server's\n    // transport id, so NestJS routes them only to the matching strategy. An\n    // unnamed controller keeps the default MCP_TRANSPORT (single-server) behavior.\n    if (server) {\n      retagMcpMethodsTransport(target, mcpTransportFor(server));\n    }\n  };\n}\n"]}

package/dist/mcp/decorators/mcp-message-pattern.d.ts

@@ -0,0 +1,3 @@
+import { McpCapabilityType } from '../transport/mcp-transport.constants';
+export declare function mcpMessagePattern(type: McpCapabilityType, explicitName?: string): MethodDecorator;
+//# sourceMappingURL=mcp-message-pattern.d.ts.map

package/dist/mcp/decorators/mcp-message-pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-message-pattern.d.ts","sourceRoot":"","sources":["../../../src/mcp/decorators/mcp-message-pattern.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,iBAAiB,EAClB,MAAM,sCAAsC,CAAC;AAgB9C,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,iBAAiB,EACvB,YAAY,CAAC,EAAE,MAAM,GACpB,eAAe,CAYjB"}

package/dist/mcp/decorators/mcp-message-pattern.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcpMessagePattern = mcpMessagePattern;
+const microservices_1 = require("@nestjs/microservices");
+const mcp_transport_constants_1 = require("../transport/mcp-transport.constants");
+function mcpMessagePattern(type, explicitName) {
+    return (target, propertyKey, descriptor) => {
+        const methodKey = String(propertyKey);
+        const name = explicitName ?? methodKey;
+        return (0, microservices_1.MessagePattern)((0, mcp_transport_constants_1.buildMcpPattern)(type, name), mcp_transport_constants_1.MCP_TRANSPORT, (0, mcp_transport_constants_1.buildMcpHandlerExtras)(type, name, methodKey, descriptor.value))(target, propertyKey, descriptor);
+    };
+}
+//# sourceMappingURL=mcp-message-pattern.js.map

package/dist/mcp/decorators/mcp-message-pattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-message-pattern.js","sourceRoot":"","sources":["../../../src/mcp/decorators/mcp-message-pattern.ts"],"names":[],"mappings":";;AAsBA,8CAeC;AArCD,yDAAuD;AACvD,kFAK8C;AAgB9C,SAAgB,iBAAiB,CAC/B,IAAuB,EACvB,YAAqB;IAErB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,UAA8B,EAAE,EAAE;QAC7D,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,YAAY,IAAI,SAAS,CAAC;QACvC,OAAO,IAAA,8BAAc,EACnB,IAAA,yCAAe,EAAC,IAAI,EAAE,IAAI,CAAC,EAC3B,uCAAa,EAGb,IAAA,+CAAqB,EAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,CAC/D,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import { MessagePattern } from '@nestjs/microservices';\nimport {\n  buildMcpHandlerExtras,\n  buildMcpPattern,\n  MCP_TRANSPORT,\n  McpCapabilityType,\n} from '../transport/mcp-transport.constants';\n\n/**\n * Builds the `@MessagePattern` half of an MCP capability decorator.\n *\n * The returned method decorator registers a NestJS RPC handler scoped to the\n * {@link MCP_TRANSPORT} identifier, with:\n *  - a structured pattern `{ mcp, name }` so the strategy can deterministically\n *    map a discovered capability back to its handler, and\n *  - `extras` `{ mcpType, mcpName }` so the strategy can recognize/prune MCP\n *    handlers from the shared `messageHandlers` map.\n *\n * When `explicitName` is omitted (e.g. a `@Tool` without `name`), the method\n * name is used — mirroring the name-defaulting in `McpRegistryDiscoveryService`,\n * so the discovered metadata name and the pattern name stay in sync.\n */\nexport function mcpMessagePattern(\n  type: McpCapabilityType,\n  explicitName?: string,\n): MethodDecorator {\n  return (target, propertyKey, descriptor: PropertyDescriptor) => {\n    const methodKey = String(propertyKey);\n    const name = explicitName ?? methodKey;\n    return MessagePattern(\n      buildMcpPattern(type, name),\n      MCP_TRANSPORT,\n      // `descriptor.value` is the decorated method; the strategy reads all MCP\n      // metadata (tool options + security decorators) off it at listen() time.\n      buildMcpHandlerExtras(type, name, methodKey, descriptor.value),\n    )(target, propertyKey, descriptor);\n  };\n}\n"]}

package/dist/mcp/decorators/prompt.decorator.d.ts

@@ -12,5 +12,5 @@ export interface PromptOptions {
     description: string;
     parameters?: ZodObject<PromptArgsRawShape>;
 }
-export declare const Prompt: (options: PromptOptions) => import("@nestjs/common").CustomDecorator<string>;
+export declare const Prompt: (options: PromptOptions) => <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;
 //# sourceMappingURL=prompt.decorator.d.ts.map

package/dist/mcp/decorators/prompt.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.decorator.d.ts","sourceRoot":"","sources":["../../../src/mcp/decorators/prompt.decorator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEzC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,SAAS,CAAC,kBAAkB,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,SAAS,CAAC,kBAAkB,CAAC,CAAC;CAC5C;AAED,eAAO,MAAM,MAAM,GAAI,SAAS,aAAa,qDAE5C,CAAC"}
+{"version":3,"file":"prompt.decorator.d.ts","sourceRoot":"","sources":["../../../src/mcp/decorators/prompt.decorator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAGzC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,SAAS,CAAC,kBAAkB,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,SAAS,CAAC,kBAAkB,CAAC,CAAC;CAC5C;AAED,eAAO,MAAM,MAAM,GAAI,SAAS,aAAa,gJAK5C,CAAC"}

package/dist/mcp/decorators/prompt.decorator.js

@@ -3,8 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Prompt = void 0;
 const common_1 = require("@nestjs/common");
 const constants_1 = require("./constants");
+const mcp_message_pattern_1 = require("./mcp-message-pattern");
 const Prompt = (options) => {
-    return (0, common_1.SetMetadata)(constants_1.MCP_PROMPT_METADATA_KEY, options);
+    return (0, common_1.applyDecorators)((0, common_1.SetMetadata)(constants_1.MCP_PROMPT_METADATA_KEY, options), (0, mcp_message_pattern_1.mcpMessagePattern)('prompt', options.name));
 };
 exports.Prompt = Prompt;
 //# sourceMappingURL=prompt.decorator.js.map

package/dist/mcp/decorators/prompt.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.decorator.js","sourceRoot":"","sources":["../../../src/mcp/decorators/prompt.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAC7C,2CAAsD;AAmB/C,MAAM,MAAM,GAAG,CAAC,OAAsB,EAAE,EAAE;IAC/C,OAAO,IAAA,oBAAW,EAAC,mCAAuB,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC,CAAC;AAFW,QAAA,MAAM,UAEjB","sourcesContent":["import { SetMetadata } from '@nestjs/common';\nimport { MCP_PROMPT_METADATA_KEY } from './constants';\nimport { ZodObject, ZodType } from 'zod';\n\nexport type PromptArgsRawShape = {\n  [k: string]: ZodType;\n};\n\nexport interface PromptMetadata {\n  name: string;\n  description: string;\n  parameters?: ZodObject<PromptArgsRawShape>;\n}\n\nexport interface PromptOptions {\n  name?: string;\n  description: string;\n  parameters?: ZodObject<PromptArgsRawShape>;\n}\n\nexport const Prompt = (options: PromptOptions) => {\n  return SetMetadata(MCP_PROMPT_METADATA_KEY, options);\n};\n"]}
+{"version":3,"file":"prompt.decorator.js","sourceRoot":"","sources":["../../../src/mcp/decorators/prompt.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA8D;AAC9D,2CAAsD;AAEtD,+DAA0D;AAkBnD,MAAM,MAAM,GAAG,CAAC,OAAsB,EAAE,EAAE;IAC/C,OAAO,IAAA,wBAAe,EACpB,IAAA,oBAAW,EAAC,mCAAuB,EAAE,OAAO,CAAC,EAC7C,IAAA,uCAAiB,EAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAC1C,CAAC;AACJ,CAAC,CAAC;AALW,QAAA,MAAM,UAKjB","sourcesContent":["import { applyDecorators, SetMetadata } from '@nestjs/common';\nimport { MCP_PROMPT_METADATA_KEY } from './constants';\nimport { ZodObject, ZodType } from 'zod';\nimport { mcpMessagePattern } from './mcp-message-pattern';\n\nexport type PromptArgsRawShape = {\n  [k: string]: ZodType;\n};\n\nexport interface PromptMetadata {\n  name: string;\n  description: string;\n  parameters?: ZodObject<PromptArgsRawShape>;\n}\n\nexport interface PromptOptions {\n  name?: string;\n  description: string;\n  parameters?: ZodObject<PromptArgsRawShape>;\n}\n\nexport const Prompt = (options: PromptOptions) => {\n  return applyDecorators(\n    SetMetadata(MCP_PROMPT_METADATA_KEY, options),\n    mcpMessagePattern('prompt', options.name),\n  );\n};\n"]}

package/dist/mcp/decorators/public.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"public.decorator.js","sourceRoot":"","sources":["../../../src/mcp/decorators/public.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAKhC,QAAA,uBAAuB,GAAG,iBAAiB,CAAC;AAuBlD,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,IAAA,oBAAW,EAAC,+BAAuB,EAAE,IAAI,CAAC,CAAC;AAA9D,QAAA,UAAU,cAAoD","sourcesContent":["import { SetMetadata } from '@nestjs/common';\n\n/**\n * Metadata key for marking a tool as publicly accessible\n */\nexport const MCP_PUBLIC_METADATA_KEY = 'mcp:public-tool';\n\n/**\n * Decorator to mark a tool as publicly accessible, bypassing authentication requirements.\n *\n * Use this when you want a tool to be available even to unauthenticated users\n * when `allowUnauthenticatedAccess` is enabled in McpModule options.\n *\n * When applied to a tool method, it allows the tool to be called without authentication,\n * even if the module has guards configured.\n *\n * @example\n * ```typescript\n * @Injectable()\n * export class MyTools {\n *   @Tool({ name: 'public-search', description: 'Search publicly' })\n *   @PublicTool()\n *   async search() {\n *     return { content: [{ type: 'text', text: 'Public results' }] };\n *   }\n * }\n * ```\n */\nexport const PublicTool = () => SetMetadata(MCP_PUBLIC_METADATA_KEY, true);\n"]}
+{"version":3,"file":"public.decorator.js","sourceRoot":"","sources":["../../../src/mcp/decorators/public.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAKhC,QAAA,uBAAuB,GAAG,iBAAiB,CAAC;AAuBlD,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,IAAA,oBAAW,EAAC,+BAAuB,EAAE,IAAI,CAAC,CAAC;AAA9D,QAAA,UAAU,cAAoD","sourcesContent":["import { SetMetadata } from '@nestjs/common';\n\n/**\n * Metadata key for marking a tool as publicly accessible\n */\nexport const MCP_PUBLIC_METADATA_KEY = 'mcp:public-tool';\n\n/**\n * Decorator to mark a tool as publicly accessible, bypassing authentication requirements.\n *\n * Use this when you want a tool to be available even to unauthenticated users\n * when `allowUnauthenticatedAccess` is enabled on the {@link McpStrategy}.\n *\n * When applied to a tool method, it allows the tool to be listed and called\n * without authentication, even when other tools on the server require it.\n *\n * @example\n * ```typescript\n * @Injectable()\n * export class MyTools {\n *   @Tool({ name: 'public-search', description: 'Search publicly' })\n *   @PublicTool()\n *   async search() {\n *     return { content: [{ type: 'text', text: 'Public results' }] };\n *   }\n * }\n * ```\n */\nexport const PublicTool = () => SetMetadata(MCP_PUBLIC_METADATA_KEY, true);\n"]}

package/dist/mcp/decorators/raw-request.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare const McpRawRequest: (...dataOrPipes: unknown[]) => ParameterDecorator;
+//# sourceMappingURL=raw-request.decorator.d.ts.map

package/dist/mcp/decorators/raw-request.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-request.decorator.d.ts","sourceRoot":"","sources":["../../../src/mcp/decorators/raw-request.decorator.ts"],"names":[],"mappings":"AA4BA,eAAO,MAAM,aAAa,mDAGzB,CAAC"}

package/dist/mcp/decorators/raw-request.decorator.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpRawRequest = void 0;
+const common_1 = require("@nestjs/common");
+exports.McpRawRequest = (0, common_1.createParamDecorator)((_data, ctx) => ctx.switchToRpc().getContext()?.getRawRequest());
+//# sourceMappingURL=raw-request.decorator.js.map

package/dist/mcp/decorators/raw-request.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-request.decorator.js","sourceRoot":"","sources":["../../../src/mcp/decorators/raw-request.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAAwE;AA4B3D,QAAA,aAAa,GAAG,IAAA,6BAAoB,EAC/C,CAAC,KAAc,EAAE,GAAqB,EAAE,EAAE,CACxC,GAAG,CAAC,WAAW,EAAE,CAAC,UAAU,EAAc,EAAE,aAAa,EAAE,CAC9D,CAAC","sourcesContent":["import { createParamDecorator, ExecutionContext } from '@nestjs/common';\nimport type { McpContext } from '../transport/mcp-context';\n\n/**\n * Injects the raw transport request into an MCP capability handler — the MCP\n * analog of NestJS's `@Req()`.\n *\n * Returns the underlying HTTP request object (Express `Request` / Fastify\n * `FastifyRequest`) for HTTP-based transports, or `undefined` for STDIO, which\n * is stream-oriented and has no per-call request object. Annotate the parameter\n * with your framework's request type — the decorator itself does not type it,\n * exactly like `@Req()`:\n *\n * @example\n * ```typescript\n * import type { Request } from 'express';\n *\n * @Tool({ name: 'whoami', description: 'Echo the caller' })\n * whoami(@McpRawRequest() req?: Request) {\n *   return { content: [{ type: 'text', text: req?.ip ?? 'stdio' }] };\n * }\n * ```\n *\n * This is sugar for `ctx.getRawRequest()` on the `@Ctx()` context; reach for it\n * when the request is all you need from the context. Note that, like every\n * NestJS param decorator, using this means the data parameter must also be\n * annotated (with `@Payload()`).\n */\nexport const McpRawRequest = createParamDecorator(\n  (_data: unknown, ctx: ExecutionContext) =>\n    ctx.switchToRpc().getContext<McpContext>()?.getRawRequest(),\n);\n"]}

package/dist/mcp/decorators/resource-template.decorator.d.ts

@@ -12,5 +12,5 @@ export interface ResourceTemplateMetadata {
     mimeType?: string;
     _meta?: Record<string, any>;
 }
-export declare const ResourceTemplate: (options: ResourceTemplateOptions) => import("@nestjs/common").CustomDecorator<string>;
+export declare const ResourceTemplate: (options: ResourceTemplateOptions) => <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;
 //# sourceMappingURL=resource-template.decorator.d.ts.map

package/dist/mcp/decorators/resource-template.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-template.decorator.d.ts","sourceRoot":"","sources":["../../../src/mcp/decorators/resource-template.decorator.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,uBAAuB,GAEjC;IACE,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B,CAAC;AAEJ,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AASD,eAAO,MAAM,gBAAgB,GAAI,SAAS,uBAAuB,qDAEhE,CAAC"}
+{"version":3,"file":"resource-template.decorator.d.ts","sourceRoot":"","sources":["../../../src/mcp/decorators/resource-template.decorator.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,uBAAuB,GAEjC;IACE,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B,CAAC;AAEJ,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AASD,eAAO,MAAM,gBAAgB,GAAI,SAAS,uBAAuB,gJAKhE,CAAC"}

package/dist/mcp/decorators/resource-template.decorator.js

@@ -3,8 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ResourceTemplate = void 0;
 const common_1 = require("@nestjs/common");
 const constants_1 = require("./constants");
+const mcp_message_pattern_1 = require("./mcp-message-pattern");
 const ResourceTemplate = (options) => {
-    return (0, common_1.SetMetadata)(constants_1.MCP_RESOURCE_TEMPLATE_METADATA_KEY, options);
+    return (0, common_1.applyDecorators)((0, common_1.SetMetadata)(constants_1.MCP_RESOURCE_TEMPLATE_METADATA_KEY, options), (0, mcp_message_pattern_1.mcpMessagePattern)('resource-template', options.uriTemplate));
 };
 exports.ResourceTemplate = ResourceTemplate;
 //# sourceMappingURL=resource-template.decorator.js.map

package/dist/mcp/decorators/resource-template.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource-template.decorator.js","sourceRoot":"","sources":["../../../src/mcp/decorators/resource-template.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAC7C,2CAAiE;AA2B1D,MAAM,gBAAgB,GAAG,CAAC,OAAgC,EAAE,EAAE;IACnE,OAAO,IAAA,oBAAW,EAAC,8CAAkC,EAAE,OAAO,CAAC,CAAC;AAClE,CAAC,CAAC;AAFW,QAAA,gBAAgB,oBAE3B","sourcesContent":["import { SetMetadata } from '@nestjs/common';\nimport { MCP_RESOURCE_TEMPLATE_METADATA_KEY } from './constants';\n\nexport type ResourceTemplateOptions =\n  // https://modelcontextprotocol.io/docs/concepts/resources#resource-templates\n  {\n    uriTemplate: string; // URI template following RFC 6570\n    name?: string; // Human-readable name\n    description?: string; // Optional description\n    mimeType?: string; // Optional MIME type\n    _meta?: Record<string, any>;\n  };\n\nexport interface ResourceTemplateMetadata {\n  uriTemplate: string; // URI template following RFC 6570\n  name: string; // Human-readable name\n  description?: string; // Optional description\n  mimeType?: string; // Optional MIME type\n  _meta?: Record<string, any>;\n}\n\n/**\n * Decorator that marks a controller method as an MCP resource.\n * @param {Object} options - The options for the decorator\n * @param {string} options.name - The name of the resource\n * @param {string} options.uriTemplate - The URI template of the resource\n * @returns {MethodDecorator} - The decorator\n */\nexport const ResourceTemplate = (options: ResourceTemplateOptions) => {\n  return SetMetadata(MCP_RESOURCE_TEMPLATE_METADATA_KEY, options);\n};\n"]}
+{"version":3,"file":"resource-template.decorator.js","sourceRoot":"","sources":["../../../src/mcp/decorators/resource-template.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA8D;AAC9D,2CAAiE;AACjE,+DAA0D;AA2BnD,MAAM,gBAAgB,GAAG,CAAC,OAAgC,EAAE,EAAE;IACnE,OAAO,IAAA,wBAAe,EACpB,IAAA,oBAAW,EAAC,8CAAkC,EAAE,OAAO,CAAC,EACxD,IAAA,uCAAiB,EAAC,mBAAmB,EAAE,OAAO,CAAC,WAAW,CAAC,CAC5D,CAAC;AACJ,CAAC,CAAC;AALW,QAAA,gBAAgB,oBAK3B","sourcesContent":["import { applyDecorators, SetMetadata } from '@nestjs/common';\nimport { MCP_RESOURCE_TEMPLATE_METADATA_KEY } from './constants';\nimport { mcpMessagePattern } from './mcp-message-pattern';\n\nexport type ResourceTemplateOptions =\n  // https://modelcontextprotocol.io/docs/concepts/resources#resource-templates\n  {\n    uriTemplate: string; // URI template following RFC 6570\n    name?: string; // Human-readable name\n    description?: string; // Optional description\n    mimeType?: string; // Optional MIME type\n    _meta?: Record<string, any>;\n  };\n\nexport interface ResourceTemplateMetadata {\n  uriTemplate: string; // URI template following RFC 6570\n  name: string; // Human-readable name\n  description?: string; // Optional description\n  mimeType?: string; // Optional MIME type\n  _meta?: Record<string, any>;\n}\n\n/**\n * Decorator that marks a controller method as an MCP resource.\n * @param {Object} options - The options for the decorator\n * @param {string} options.name - The name of the resource\n * @param {string} options.uriTemplate - The URI template of the resource\n * @returns {MethodDecorator} - The decorator\n */\nexport const ResourceTemplate = (options: ResourceTemplateOptions) => {\n  return applyDecorators(\n    SetMetadata(MCP_RESOURCE_TEMPLATE_METADATA_KEY, options),\n    mcpMessagePattern('resource-template', options.uriTemplate),\n  );\n};\n"]}

package/dist/mcp/decorators/resource.decorator.d.ts

@@ -12,5 +12,5 @@ export interface ResourceMetadata {
     mimeType?: string;
     _meta?: Record<string, any>;
 }
-export declare const Resource: (options: ResourceOptions) => import("@nestjs/common").CustomDecorator<string>;
+export declare const Resource: (options: ResourceOptions) => <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;
 //# sourceMappingURL=resource.decorator.d.ts.map

package/dist/mcp/decorators/resource.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource.decorator.d.ts","sourceRoot":"","sources":["../../../src/mcp/decorators/resource.decorator.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,eAAe,GAEzB;IACE,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B,CAAC;AAEJ,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AASD,eAAO,MAAM,QAAQ,GAAI,SAAS,eAAe,qDAEhD,CAAC"}
+{"version":3,"file":"resource.decorator.d.ts","sourceRoot":"","sources":["../../../src/mcp/decorators/resource.decorator.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAEzB;IACE,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B,CAAC;AAEJ,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AASD,eAAO,MAAM,QAAQ,GAAI,SAAS,eAAe,gJAKhD,CAAC"}

package/dist/mcp/decorators/resource.decorator.js

@@ -3,8 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Resource = void 0;
 const common_1 = require("@nestjs/common");
 const constants_1 = require("./constants");
+const mcp_message_pattern_1 = require("./mcp-message-pattern");
 const Resource = (options) => {
-    return (0, common_1.SetMetadata)(constants_1.MCP_RESOURCE_METADATA_KEY, options);
+    return (0, common_1.applyDecorators)((0, common_1.SetMetadata)(constants_1.MCP_RESOURCE_METADATA_KEY, options), (0, mcp_message_pattern_1.mcpMessagePattern)('resource', options.uri));
 };
 exports.Resource = Resource;
 //# sourceMappingURL=resource.decorator.js.map

package/dist/mcp/decorators/resource.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource.decorator.js","sourceRoot":"","sources":["../../../src/mcp/decorators/resource.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAC7C,2CAAwD;AA2BjD,MAAM,QAAQ,GAAG,CAAC,OAAwB,EAAE,EAAE;IACnD,OAAO,IAAA,oBAAW,EAAC,qCAAyB,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC,CAAC;AAFW,QAAA,QAAQ,YAEnB","sourcesContent":["import { SetMetadata } from '@nestjs/common';\nimport { MCP_RESOURCE_METADATA_KEY } from './constants';\n\nexport type ResourceOptions =\n  // https://modelcontextprotocol.io/docs/concepts/resources#direct-resources\n  {\n    uri: string; // Unique identifier for the resource\n    name?: string; // Human-readable name\n    description?: string; // Optional description\n    mimeType?: string; // Optional MIME type\n    _meta?: Record<string, any>;\n  };\n\nexport interface ResourceMetadata {\n  uri: string; // Unique identifier for the resource\n  name: string; // Human-readable name\n  description?: string; // Optional description\n  mimeType?: string; // Optional MIME type\n  _meta?: Record<string, any>;\n}\n\n/**\n * Decorator that marks a controller method as an MCP resource.\n * @param {Object} options - The options for the decorator\n * @param {string} options.name - The name of the resource\n * @param {string} options.uri - The URI of the resource\n * @returns {MethodDecorator} - The decorator\n */\nexport const Resource = (options: ResourceOptions) => {\n  return SetMetadata(MCP_RESOURCE_METADATA_KEY, options);\n};\n"]}
+{"version":3,"file":"resource.decorator.js","sourceRoot":"","sources":["../../../src/mcp/decorators/resource.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA8D;AAC9D,2CAAwD;AACxD,+DAA0D;AA2BnD,MAAM,QAAQ,GAAG,CAAC,OAAwB,EAAE,EAAE;IACnD,OAAO,IAAA,wBAAe,EACpB,IAAA,oBAAW,EAAC,qCAAyB,EAAE,OAAO,CAAC,EAC/C,IAAA,uCAAiB,EAAC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,CAC3C,CAAC;AACJ,CAAC,CAAC;AALW,QAAA,QAAQ,YAKnB","sourcesContent":["import { applyDecorators, SetMetadata } from '@nestjs/common';\nimport { MCP_RESOURCE_METADATA_KEY } from './constants';\nimport { mcpMessagePattern } from './mcp-message-pattern';\n\nexport type ResourceOptions =\n  // https://modelcontextprotocol.io/docs/concepts/resources#direct-resources\n  {\n    uri: string; // Unique identifier for the resource\n    name?: string; // Human-readable name\n    description?: string; // Optional description\n    mimeType?: string; // Optional MIME type\n    _meta?: Record<string, any>;\n  };\n\nexport interface ResourceMetadata {\n  uri: string; // Unique identifier for the resource\n  name: string; // Human-readable name\n  description?: string; // Optional description\n  mimeType?: string; // Optional MIME type\n  _meta?: Record<string, any>;\n}\n\n/**\n * Decorator that marks a controller method as an MCP resource.\n * @param {Object} options - The options for the decorator\n * @param {string} options.name - The name of the resource\n * @param {string} options.uri - The URI of the resource\n * @returns {MethodDecorator} - The decorator\n */\nexport const Resource = (options: ResourceOptions) => {\n  return applyDecorators(\n    SetMetadata(MCP_RESOURCE_METADATA_KEY, options),\n    mcpMessagePattern('resource', options.uri),\n  );\n};\n"]}

package/dist/mcp/decorators/tool.decorator.d.ts

@@ -1,4 +1,3 @@
-import { CanActivate, Type } from '@nestjs/common';
 import { z } from 'zod';
 import { ToolAnnotations as SdkToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
 export type SecurityScheme = {
@@ -18,7 +17,6 @@ export interface ToolMetadata {
     isPublic?: boolean;
     requiredScopes?: string[];
     requiredRoles?: string[];
-    guards?: Type<CanActivate>[];
 }
 export interface ToolAnnotations extends SdkToolAnnotations {
 }
@@ -30,5 +28,5 @@ export interface ToolOptions {
     annotations?: ToolAnnotations;
     _meta?: Record<string, any>;
 }
-export declare const Tool: (options: ToolOptions) => import("@nestjs/common").CustomDecorator<string>;
+export declare const Tool: (options: ToolOptions) => <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;
 //# sourceMappingURL=tool.decorator.d.ts.map

package/dist/mcp/decorators/tool.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.decorator.d.ts","sourceRoot":"","sources":["../../../src/mcp/decorators/tool.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAe,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,IAAI,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAM3F,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE5B,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;CAC9B;AAGD,MAAM,WAAW,eAAgB,SAAQ,kBAAkB;CAAG;AAE9D,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAWD,eAAO,MAAM,IAAI,GAAI,SAAS,WAAW,qDAMxC,CAAC"}
+{"version":3,"file":"tool.decorator.d.ts","sourceRoot":"","sources":["../../../src/mcp/decorators/tool.decorator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,IAAI,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAO3F,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE5B,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAGD,MAAM,WAAW,eAAgB,SAAQ,kBAAkB;CAAG;AAE9D,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAWD,eAAO,MAAM,IAAI,GAAI,SAAS,WAAW,gJASxC,CAAC"}

package/dist/mcp/decorators/tool.decorator.js

@@ -4,11 +4,12 @@ exports.Tool = void 0;
 const common_1 = require("@nestjs/common");
 const zod_1 = require("zod");
 const constants_1 = require("./constants");
+const mcp_message_pattern_1 = require("./mcp-message-pattern");
 const Tool = (options) => {
     if (options.parameters === undefined) {
         options.parameters = zod_1.z.object({});
     }
-    return (0, common_1.SetMetadata)(constants_1.MCP_TOOL_METADATA_KEY, options);
+    return (0, common_1.applyDecorators)((0, common_1.SetMetadata)(constants_1.MCP_TOOL_METADATA_KEY, options), (0, mcp_message_pattern_1.mcpMessagePattern)('tool', options.name));
 };
 exports.Tool = Tool;
 //# sourceMappingURL=tool.decorator.js.map

package/dist/mcp/decorators/tool.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.decorator.js","sourceRoot":"","sources":["../../../src/mcp/decorators/tool.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAAgE;AAChE,6BAAwB;AAExB,2CAAoD;AA6C7C,MAAM,IAAI,GAAG,CAAC,OAAoB,EAAE,EAAE;IAC3C,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,CAAC,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,IAAA,oBAAW,EAAC,iCAAqB,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC,CAAC;AANW,QAAA,IAAI,QAMf","sourcesContent":["import { CanActivate, SetMetadata, Type } from '@nestjs/common';\nimport { z } from 'zod';\nimport { ToolAnnotations as SdkToolAnnotations } from '@modelcontextprotocol/sdk/types.js';\nimport { MCP_TOOL_METADATA_KEY } from './constants';\n\n/**\n * Security scheme type for MCP tools\n */\nexport type SecurityScheme =\n  | { type: 'noauth' }\n  | { type: 'oauth2'; scopes?: string[] };\n\nexport interface ToolMetadata {\n  name: string;\n  description: string;\n  parameters?: z.ZodType;\n  outputSchema?: z.ZodType;\n  annotations?: SdkToolAnnotations;\n  _meta?: Record<string, any>;\n  // Security-related metadata\n  securitySchemes?: SecurityScheme[];\n  isPublic?: boolean;\n  requiredScopes?: string[];\n  requiredRoles?: string[];\n  guards?: Type<CanActivate>[];\n}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport interface ToolAnnotations extends SdkToolAnnotations {}\n\nexport interface ToolOptions {\n  name?: string;\n  description?: string;\n  parameters?: z.ZodType;\n  outputSchema?: z.ZodType;\n  annotations?: ToolAnnotations;\n  _meta?: Record<string, any>;\n}\n\n/**\n * Decorator that marks a controller method as an MCP tool.\n * @param {Object} options - The options for the decorator\n * @param {string} options.name - The name of the tool\n * @param {string} options.description - The description of the tool\n * @param {z.ZodType} [options.parameters] - The parameters of the tool\n * @param {z.ZodType} [options.outputSchema] - The output schema of the tool\n * @returns {MethodDecorator} - The decorator\n */\nexport const Tool = (options: ToolOptions) => {\n  if (options.parameters === undefined) {\n    options.parameters = z.object({});\n  }\n\n  return SetMetadata(MCP_TOOL_METADATA_KEY, options);\n};\n"]}
+{"version":3,"file":"tool.decorator.js","sourceRoot":"","sources":["../../../src/mcp/decorators/tool.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA8D;AAC9D,6BAAwB;AAExB,2CAAoD;AACpD,+DAA0D;AA4CnD,MAAM,IAAI,GAAG,CAAC,OAAoB,EAAE,EAAE;IAC3C,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,CAAC,UAAU,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,IAAA,wBAAe,EACpB,IAAA,oBAAW,EAAC,iCAAqB,EAAE,OAAO,CAAC,EAC3C,IAAA,uCAAiB,EAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CACxC,CAAC;AACJ,CAAC,CAAC;AATW,QAAA,IAAI,QASf","sourcesContent":["import { applyDecorators, SetMetadata } from '@nestjs/common';\nimport { z } from 'zod';\nimport { ToolAnnotations as SdkToolAnnotations } from '@modelcontextprotocol/sdk/types.js';\nimport { MCP_TOOL_METADATA_KEY } from './constants';\nimport { mcpMessagePattern } from './mcp-message-pattern';\n\n/**\n * Security scheme type for MCP tools\n */\nexport type SecurityScheme =\n  | { type: 'noauth' }\n  | { type: 'oauth2'; scopes?: string[] };\n\nexport interface ToolMetadata {\n  name: string;\n  description: string;\n  parameters?: z.ZodType;\n  outputSchema?: z.ZodType;\n  annotations?: SdkToolAnnotations;\n  _meta?: Record<string, any>;\n  // Security-related metadata\n  securitySchemes?: SecurityScheme[];\n  isPublic?: boolean;\n  requiredScopes?: string[];\n  requiredRoles?: string[];\n}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport interface ToolAnnotations extends SdkToolAnnotations {}\n\nexport interface ToolOptions {\n  name?: string;\n  description?: string;\n  parameters?: z.ZodType;\n  outputSchema?: z.ZodType;\n  annotations?: ToolAnnotations;\n  _meta?: Record<string, any>;\n}\n\n/**\n * Decorator that marks a controller method as an MCP tool.\n * @param {Object} options - The options for the decorator\n * @param {string} options.name - The name of the tool\n * @param {string} options.description - The description of the tool\n * @param {z.ZodType} [options.parameters] - The parameters of the tool\n * @param {z.ZodType} [options.outputSchema] - The output schema of the tool\n * @returns {MethodDecorator} - The decorator\n */\nexport const Tool = (options: ToolOptions) => {\n  if (options.parameters === undefined) {\n    options.parameters = z.object({});\n  }\n\n  return applyDecorators(\n    SetMetadata(MCP_TOOL_METADATA_KEY, options),\n    mcpMessagePattern('tool', options.name),\n  );\n};\n"]}

package/dist/mcp/filters/mcp-exception.filter.d.ts

@@ -0,0 +1,6 @@
+import { ArgumentsHost, RpcExceptionFilter } from '@nestjs/common';
+import { Observable } from 'rxjs';
+export declare class McpExceptionFilter implements RpcExceptionFilter {
+    catch(exception: unknown, _host: ArgumentsHost): Observable<never>;
+}
+//# sourceMappingURL=mcp-exception.filter.d.ts.map

package/dist/mcp/filters/mcp-exception.filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-exception.filter.d.ts","sourceRoot":"","sources":["../../../src/mcp/filters/mcp-exception.filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAS,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAE,UAAU,EAAc,MAAM,MAAM,CAAC;AAiC9C,qBACa,kBAAmB,YAAW,kBAAkB;IAC3D,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC;CASnE"}

package/dist/mcp/filters/mcp-exception.filter.js

@@ -0,0 +1,26 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpExceptionFilter = void 0;
+const common_1 = require("@nestjs/common");
+const microservices_1 = require("@nestjs/microservices");
+const rxjs_1 = require("rxjs");
+let McpExceptionFilter = class McpExceptionFilter {
+    catch(exception, _host) {
+        if (exception instanceof microservices_1.RpcException) {
+            return (0, rxjs_1.throwError)(() => exception.getError());
+        }
+        const message = exception instanceof Error ? exception.message : 'Internal server error';
+        return (0, rxjs_1.throwError)(() => ({ status: 'error', message }));
+    }
+};
+exports.McpExceptionFilter = McpExceptionFilter;
+exports.McpExceptionFilter = McpExceptionFilter = __decorate([
+    (0, common_1.Catch)()
+], McpExceptionFilter);
+//# sourceMappingURL=mcp-exception.filter.js.map

package/dist/mcp/filters/mcp-exception.filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-exception.filter.js","sourceRoot":"","sources":["../../../src/mcp/filters/mcp-exception.filter.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA0E;AAC1E,yDAAqD;AACrD,+BAA8C;AAkCvC,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC7B,KAAK,CAAC,SAAkB,EAAE,KAAoB;QAE5C,IAAI,SAAS,YAAY,4BAAY,EAAE,CAAC;YACtC,OAAO,IAAA,iBAAU,EAAC,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,OAAO,GACX,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC;QAC3E,OAAO,IAAA,iBAAU,EAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;CACF,CAAA;AAVY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,cAAK,GAAE;GACK,kBAAkB,CAU9B","sourcesContent":["import { ArgumentsHost, Catch, RpcExceptionFilter } from '@nestjs/common';\nimport { RpcException } from '@nestjs/microservices';\nimport { Observable, throwError } from 'rxjs';\n\n/**\n * Surfaces the real error message of any exception thrown by an MCP\n * tool/resource/prompt handler, instead of NestJS's default \"Internal server\n * error\" masking.\n *\n * By default NestJS's RPC pipeline masks any non-`RpcException` to a generic\n * \"Internal server error\" before the strategy can read it, so a plain\n * `throw new Error('Order #42 not found')` reaches the agent as an opaque\n * failure. That is a safe default (it avoids leaking internals), but it is poor\n * DX when the message is meant for the caller. Register this filter to opt into\n * passing the original message through:\n *\n * ```typescript\n * // Globally (recommended) — applies to every MCP handler, but never overrides\n * // a more specific `@UseFilters()` you put on a controller/method.\n * providers: [{ provide: APP_FILTER, useClass: McpExceptionFilter }]\n * ```\n *\n * ```typescript\n * // Or per controller/method:\n * @UseFilters(McpExceptionFilter)\n * @McpController()\n * class MyTools { ... }\n * ```\n *\n * The surfaced message becomes an `isError: true` tool result (or a JSON-RPC\n * error for resources/prompts), so the agent can tell a real failure from a\n * successful call. For input problems, prefer the built-in Zod validation\n * (a clear \"Invalid parameters: …\" result) or `throw new RpcException(...)` /\n * a NestJS exception — those are already surfaced without this filter.\n */\n@Catch()\nexport class McpExceptionFilter implements RpcExceptionFilter {\n  catch(exception: unknown, _host: ArgumentsHost): Observable<never> {\n    // RpcException already carries an explicit, client-facing payload.\n    if (exception instanceof RpcException) {\n      return throwError(() => exception.getError());\n    }\n    const message =\n      exception instanceof Error ? exception.message : 'Internal server error';\n    return throwError(() => ({ status: 'error', message }));\n  }\n}\n"]}