@loopstack/mcp-module 0.2.1 → 0.3.0

package/README.md

@@ -39,16 +39,18 @@ flow through headers.
 
 ## Authentication
 
-Configure auth headers via `@InjectTool(...)`:
+Configure auth headers via constructor injection config:
 
 ```ts
-@InjectTool({
-  allowedHosts: ['mcp.linear.app'],
-  hostHeaderEnv: {
-    'mcp.linear.app': { Authorization: 'LINEAR_MCP_TOKEN' },
+constructor(private readonly mcpCallTool: McpCallTool) {}
+
+// Configure allowedHosts and hostHeaderEnv via call config:
+await this.mcpCallTool.call(args, {
+  config: {
+    allowedHosts: ['mcp.linear.app'],
+    hostHeaderEnv: { 'mcp.linear.app': { Authorization: 'LINEAR_MCP_TOKEN' } },
   },
-})
-private readonly mcpCallTool: McpCallTool;
+});
 ```
 
 Three knobs, in increasing specificity:
@@ -76,10 +78,10 @@ LINEAR_MCP_TOKEN="Bearer lin_oauth_..."
 ## Registering the tools (workspace vs workflow)
 
 Import `McpModule` in your Nest module so the tool classes are available. Then
-register **instances** with `@InjectTool()` — where you put that decorator
+register **instances** via the constructor — where you inject them
 depends on how you run the LLM loop.
 
-| How you run the agent                                                                                                                              | Where to `@InjectTool` MCP tools                                                                                                                                             |
+| How you run the agent                                                                                                                              | Where to injection MCP tools                                                                                                                                                 |
 | -------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **`ChatAgentWorkflow` / `AgentWorkflow` as a sub-workflow** (`this.agent.run({ tools: [...] })`)                                                   | **Workspace** — the child agent resolves tools from the executing workflow first, then the workspace. Tools on the parent workflow are not visible while the sub-agent runs. |
 | **Inline agent loop in one workflow** (your transitions call `this.llmGenerateText.call()` / `this.llmDelegateToolCalls.call()` on the same class) | **That workflow** — same pattern as other registry agents (e.g. Google Workspace).                                                                                           |
@@ -110,19 +112,17 @@ const mcpToolConfig = {
 @Injectable()
 @Workspace({ uiConfig: { title: 'My Workspace' } })
 export class MyWorkspace {
-  @InjectWorkflow() mcpAgent: MyMcpWorkflow;
-
-  @InjectTool(mcpToolConfig)
-  mcpListTools: McpListToolsTool;
-
-  @InjectTool(mcpToolConfig)
-  mcpCallTool: McpCallTool;
+  constructor(
+    public readonly mcpAgent: MyMcpWorkflow,
+    public readonly mcpListTools: McpListToolsTool,
+    public readonly mcpCallTool: McpCallTool,
+  ) {}
 }
 ```
 
 ```ts
 // my-mcp.workflow.ts — parent only starts the sub-agent
-@InjectWorkflow({ model: 'claude-sonnet-4-6' }) private agent: ChatAgentWorkflow;
+constructor(private readonly agent: ChatAgentWorkflow) { super(); }
 
 await this.agent.run({
   system: '...',
@@ -145,7 +145,7 @@ allowlisted hosts within the same chat.
 `serverUrl` is a per-call argument. **An agent can reach any host listed in
 `allowedHosts`** — there is no "primary" server. To add a new server:
 
-1. Add its hostname to `allowedHosts` on both `@InjectTool` configs.
+1. Add its hostname to `allowedHosts` on both injection configs.
 2. Add its auth mapping to `hostHeaderEnv`.
 3. Set the corresponding env var.
 

package/dist/config/mcp-tool-config.schema.d.ts

@@ -8,4 +8,5 @@ export declare const McpToolConfigSchema: z.ZodObject<{
     hostHeaderEnv: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>>;
 }, z.core.$strict>;
 export type McpToolConfig = z.infer<typeof McpToolConfigSchema>;
+export type McpToolConfigInput = z.input<typeof McpToolConfigSchema>;
 //# sourceMappingURL=mcp-tool-config.schema.d.ts.map

package/dist/config/mcp-tool-config.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-tool-config.schema.d.ts","sourceRoot":"","sources":["../../src/config/mcp-tool-config.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuBxB,eAAO,MAAM,mBAAmB;;;;;;;kBAiC5B,CAAC;AAEL,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}
+{"version":3,"file":"mcp-tool-config.schema.d.ts","sourceRoot":"","sources":["../../src/config/mcp-tool-config.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuBxB,eAAO,MAAM,mBAAmB;;;;;;;kBAiC5B,CAAC;AAEL,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from './config/mcp-tool-config.schema.js';
 export * from './errors.js';
 export * from './mcp.module.js';
+export * from './tokens.js';
 export * from './services/index.js';
 export * from './tools/index.js';
 export * from './types.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC;AACnD,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC;AACnD,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -1,6 +1,7 @@
 export * from './config/mcp-tool-config.schema.js';
 export * from './errors.js';
 export * from './mcp.module.js';
+export * from './tokens.js';
 export * from './services/index.js';
 export * from './tools/index.js';
 export * from './types.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC;AACnD,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oCAAoC,CAAC;AACnD,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC"}

package/dist/mcp.module.d.ts

@@ -1,3 +1,6 @@
+import { type DynamicModule } from '@nestjs/common';
+import type { McpToolConfigInput } from './config/mcp-tool-config.schema.js';
 export declare class McpModule {
+    static forRoot(config?: McpToolConfigInput): DynamicModule;
 }
 //# sourceMappingURL=mcp.module.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mcp.module.d.ts","sourceRoot":"","sources":["../src/mcp.module.ts"],"names":[],"mappings":"AAiBA,qBAKa,SAAS;CAAG"}
+{"version":3,"file":"mcp.module.d.ts","sourceRoot":"","sources":["../src/mcp.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,gBAAgB,CAAC;AAG5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAO7E,qBACa,SAAS;IACpB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,aAAa;CAiB3D"}

package/dist/mcp.module.js

@@ -4,28 +4,36 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     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;
 };
+var McpModule_1;
 import { Module } from '@nestjs/common';
 import { LoopCoreModule } from '@loopstack/core';
+import { McpToolConfigSchema } from './config/mcp-tool-config.schema.js';
 import { MCP_ENV_READER, ProcessEnvReader } from './services/env-reader.js';
 import { McpClientService } from './services/index.js';
 import { MCP_METRICS, NoopMcpMetrics } from './services/metrics-port.js';
+import { MCP_DEFAULT_CONFIG } from './tokens.js';
 import { McpCallTool, McpListToolsTool } from './tools/index.js';
-const envReaderProvider = {
-    provide: MCP_ENV_READER,
-    useClass: ProcessEnvReader,
+let McpModule = McpModule_1 = class McpModule {
+    static forRoot(config) {
+        const parsed = config ? McpToolConfigSchema.parse(config) : null;
+        return {
+            global: true,
+            module: McpModule_1,
+            imports: [LoopCoreModule],
+            providers: [
+                { provide: MCP_ENV_READER, useClass: ProcessEnvReader },
+                { provide: MCP_METRICS, useClass: NoopMcpMetrics },
+                { provide: MCP_DEFAULT_CONFIG, useValue: parsed },
+                McpClientService,
+                McpListToolsTool,
+                McpCallTool,
+            ],
+            exports: [MCP_DEFAULT_CONFIG, MCP_ENV_READER, MCP_METRICS, McpClientService, McpListToolsTool, McpCallTool],
+        };
+    }
 };
-const metricsProvider = {
-    provide: MCP_METRICS,
-    useClass: NoopMcpMetrics,
-};
-let McpModule = class McpModule {
-};
-McpModule = __decorate([
-    Module({
-        imports: [LoopCoreModule],
-        providers: [envReaderProvider, metricsProvider, McpClientService, McpListToolsTool, McpCallTool],
-        exports: [MCP_ENV_READER, MCP_METRICS, McpClientService, McpListToolsTool, McpCallTool],
-    })
+McpModule = McpModule_1 = __decorate([
+    Module({})
 ], McpModule);
 export { McpModule };
 //# sourceMappingURL=mcp.module.js.map

package/dist/mcp.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.module.js","sourceRoot":"","sources":["../src/mcp.module.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,MAAM,EAAY,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEjE,MAAM,iBAAiB,GAAa;IAClC,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,gBAAgB;CAC3B,CAAC;AAEF,MAAM,eAAe,GAAa;IAChC,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,cAAc;CACzB,CAAC;AAOK,IAAM,SAAS,GAAf,MAAM,SAAS;CAAG,CAAA;AAAZ,SAAS;IALrB,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,cAAc,CAAC;QACzB,SAAS,EAAE,CAAC,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,CAAC;QAChG,OAAO,EAAE,CAAC,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,CAAC;KACxF,CAAC;GACW,SAAS,CAAG"}
+{"version":3,"file":"mcp.module.js","sourceRoot":"","sources":["../src/mcp.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAsB,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,IAAM,SAAS,iBAAf,MAAM,SAAS;IACpB,MAAM,CAAC,OAAO,CAAC,MAA2B;QACxC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACjE,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,WAAS;YACjB,OAAO,EAAE,CAAC,cAAc,CAAC;YACzB,SAAS,EAAE;gBACT,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE;gBACvD,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE;gBAClD,EAAE,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,EAAE;gBACjD,gBAAgB;gBAChB,gBAAgB;gBAChB,WAAW;aACZ;YACD,OAAO,EAAE,CAAC,kBAAkB,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,CAAC;SAC5G,CAAC;IACJ,CAAC;CACF,CAAA;AAlBY,SAAS;IADrB,MAAM,CAAC,EAAE,CAAC;GACE,SAAS,CAkBrB"}

package/dist/tokens.d.ts

@@ -0,0 +1,2 @@
+export declare const MCP_DEFAULT_CONFIG: unique symbol;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,eAA+B,CAAC"}

package/dist/tokens.js

@@ -0,0 +1,2 @@
+export const MCP_DEFAULT_CONFIG = Symbol('MCP_DEFAULT_CONFIG');
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC"}

package/dist/tools/mcp-call.tool.d.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { ToolCallOptions, ToolResult } from '@loopstack/common';
+import type { LoopstackContext } from '@loopstack/common';
 import type { McpToolConfig } from '../config/mcp-tool-config.schema.js';
 import { McpToolBase } from './mcp-tool-base.js';
 export declare const McpCallToolArgsSchema: z.ZodObject<{
@@ -14,6 +15,6 @@ export declare const McpCallToolArgsSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type McpCallToolArgs = z.infer<typeof McpCallToolArgsSchema>;
 export declare class McpCallTool extends McpToolBase<McpCallToolArgs> {
-    call(args: McpCallToolArgs, options?: ToolCallOptions<McpToolConfig>): Promise<ToolResult>;
+    protected handle(args: McpCallToolArgs, ctx: LoopstackContext, options?: ToolCallOptions<McpToolConfig>): Promise<ToolResult>;
 }
 //# sourceMappingURL=mcp-call.tool.d.ts.map

package/dist/tools/mcp-call.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-call.tool.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-call.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAQ,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEzE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,eAAO,MAAM,qBAAqB;;;;;;;;;kBAGvB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,qBAQa,WAAY,SAAQ,WAAW,CAAC,eAAe,CAAC;IACrD,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAUjG"}
+{"version":3,"file":"mcp-call.tool.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-call.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAQ,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEzE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,eAAO,MAAM,qBAAqB;;;;;;;;;kBAGvB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,qBAOa,WAAY,SAAQ,WAAW,CAAC,eAAe,CAAC;cAC3C,MAAM,CACpB,IAAI,EAAE,eAAe,EACrB,GAAG,EAAE,gBAAgB,EACrB,OAAO,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,GACvC,OAAO,CAAC,UAAU,CAAC;CAUvB"}

package/dist/tools/mcp-call.tool.js

@@ -14,7 +14,7 @@ export const McpCallToolArgsSchema = McpConnectionArgsSchema.extend({
     arguments: z.record(z.string(), z.unknown()).optional().default({}).describe('JSON object passed to the tool.'),
 }).strict();
 let McpCallTool = class McpCallTool extends McpToolBase {
-    async call(args, options) {
+    async handle(args, ctx, options) {
         const cfg = this.requireConfig(options?.config);
         const result = await this.mcp.callTool(args.serverUrl, cfg, args.toolName, args.arguments, {
             timeoutMs: args.timeoutMs,
@@ -25,9 +25,8 @@ let McpCallTool = class McpCallTool extends McpToolBase {
 };
 McpCallTool = __decorate([
     Tool({
-        uiConfig: {
-            description: 'Calls a tool on a remote MCP server over HTTPS (Streamable HTTP or legacy SSE). Requires `allowedHosts` and optional `headerEnv`/`hostHeaderEnv` via `@InjectTool`.',
-        },
+        name: 'mcp_call',
+        description: 'Calls a tool on a remote MCP server over HTTPS (Streamable HTTP or legacy SSE). Requires `allowedHosts` and optional `headerEnv`/`hostHeaderEnv` via tool config.',
         schema: McpCallToolArgsSchema,
         configSchema: McpToolConfigSchema,
     })

package/dist/tools/mcp-call.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-call.tool.js","sourceRoot":"","sources":["../../src/tools/mcp-call.tool.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAA+B,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAClE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IAC9E,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;CAChH,CAAC,CAAC,MAAM,EAAE,CAAC;AAYL,IAAM,WAAW,GAAjB,MAAM,WAAY,SAAQ,WAA4B;IAC3D,KAAK,CAAC,IAAI,CAAC,IAAqB,EAAE,OAAwC;QACxE,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE;YACzF,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;CACF,CAAA;AAXY,WAAW;IARvB,IAAI,CAAC;QACJ,QAAQ,EAAE;YACR,WAAW,EACT,qKAAqK;SACxK;QACD,MAAM,EAAE,qBAAqB;QAC7B,YAAY,EAAE,mBAAmB;KAClC,CAAC;GACW,WAAW,CAWvB"}
+{"version":3,"file":"mcp-call.tool.js","sourceRoot":"","sources":["../../src/tools/mcp-call.tool.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAA+B,MAAM,mBAAmB,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAClE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IAC9E,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;CAChH,CAAC,CAAC,MAAM,EAAE,CAAC;AAWL,IAAM,WAAW,GAAjB,MAAM,WAAY,SAAQ,WAA4B;IACjD,KAAK,CAAC,MAAM,CACpB,IAAqB,EACrB,GAAqB,EACrB,OAAwC;QAExC,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE;YACzF,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;CACF,CAAA;AAfY,WAAW;IAPvB,IAAI,CAAC;QACJ,IAAI,EAAE,UAAU;QAChB,WAAW,EACT,mKAAmK;QACrK,MAAM,EAAE,qBAAqB;QAC7B,YAAY,EAAE,mBAAmB;KAClC,CAAC;GACW,WAAW,CAevB"}

package/dist/tools/mcp-list-tools.tool.d.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { ToolCallOptions, ToolResult } from '@loopstack/common';
+import type { LoopstackContext } from '@loopstack/common';
 import type { McpToolConfig } from '../config/mcp-tool-config.schema.js';
 import { McpToolBase } from './mcp-tool-base.js';
 export declare const McpListToolsArgsSchema: z.ZodObject<{
@@ -12,6 +13,6 @@ export declare const McpListToolsArgsSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type McpListToolsArgs = z.infer<typeof McpListToolsArgsSchema>;
 export declare class McpListToolsTool extends McpToolBase<McpListToolsArgs> {
-    call(args: McpListToolsArgs, options?: ToolCallOptions<McpToolConfig>): Promise<ToolResult>;
+    protected handle(args: McpListToolsArgs, ctx: LoopstackContext, options?: ToolCallOptions<McpToolConfig>): Promise<ToolResult>;
 }
 //# sourceMappingURL=mcp-list-tools.tool.d.ts.map

package/dist/tools/mcp-list-tools.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-list-tools.tool.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-list-tools.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAQ,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEzE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,eAAO,MAAM,sBAAsB;;;;;;;kBAA0B,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,qBAQa,gBAAiB,SAAQ,WAAW,CAAC,gBAAgB,CAAC;IAC3D,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAUlG"}
+{"version":3,"file":"mcp-list-tools.tool.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-list-tools.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAQ,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEzE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,eAAO,MAAM,sBAAsB;;;;;;;kBAA0B,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,qBAOa,gBAAiB,SAAQ,WAAW,CAAC,gBAAgB,CAAC;cACjD,MAAM,CACpB,IAAI,EAAE,gBAAgB,EACtB,GAAG,EAAE,gBAAgB,EACrB,OAAO,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,GACvC,OAAO,CAAC,UAAU,CAAC;CAUvB"}

package/dist/tools/mcp-list-tools.tool.js

@@ -10,7 +10,7 @@ import { McpConnectionArgsSchema } from './mcp-connection-args.schema.js';
 import { McpToolBase } from './mcp-tool-base.js';
 export const McpListToolsArgsSchema = McpConnectionArgsSchema;
 let McpListToolsTool = class McpListToolsTool extends McpToolBase {
-    async call(args, options) {
+    async handle(args, ctx, options) {
         const cfg = this.requireConfig(options?.config);
         const result = await this.mcp.listTools(args.serverUrl, cfg, {
             timeoutMs: args.timeoutMs,
@@ -21,9 +21,8 @@ let McpListToolsTool = class McpListToolsTool extends McpToolBase {
 };
 McpListToolsTool = __decorate([
     Tool({
-        uiConfig: {
-            description: 'Lists tool definitions exposed by a remote MCP server (Streamable HTTP or legacy SSE). Requires `allowedHosts` (and optional auth headers) via `@InjectTool`.',
-        },
+        name: 'mcp_list_tools',
+        description: 'Lists tool definitions exposed by a remote MCP server (Streamable HTTP or legacy SSE). Requires `allowedHosts` (and optional auth headers) via tool config.',
         schema: McpListToolsArgsSchema,
         configSchema: McpToolConfigSchema,
     })

package/dist/tools/mcp-list-tools.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-list-tools.tool.js","sourceRoot":"","sources":["../../src/tools/mcp-list-tools.tool.ts"],"names":[],"mappings":";;;;;;AACA,OAAO,EAAE,IAAI,EAA+B,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,MAAM,sBAAsB,GAAG,uBAAuB,CAAC;AAYvD,IAAM,gBAAgB,GAAtB,MAAM,gBAAiB,SAAQ,WAA6B;IACjE,KAAK,CAAC,IAAI,CAAC,IAAsB,EAAE,OAAwC;QACzE,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YAC3D,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,OAAO,EAAE,IAAI,EAAE,MAAiC,EAAE,CAAC;IACrD,CAAC;CACF,CAAA;AAXY,gBAAgB;IAR5B,IAAI,CAAC;QACJ,QAAQ,EAAE;YACR,WAAW,EACT,+JAA+J;SAClK;QACD,MAAM,EAAE,sBAAsB;QAC9B,YAAY,EAAE,mBAAmB;KAClC,CAAC;GACW,gBAAgB,CAW5B"}
+{"version":3,"file":"mcp-list-tools.tool.js","sourceRoot":"","sources":["../../src/tools/mcp-list-tools.tool.ts"],"names":[],"mappings":";;;;;;AACA,OAAO,EAAE,IAAI,EAA+B,MAAM,mBAAmB,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,MAAM,sBAAsB,GAAG,uBAAuB,CAAC;AAWvD,IAAM,gBAAgB,GAAtB,MAAM,gBAAiB,SAAQ,WAA6B;IACvD,KAAK,CAAC,MAAM,CACpB,IAAsB,EACtB,GAAqB,EACrB,OAAwC;QAExC,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YAC3D,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,OAAO,EAAE,IAAI,EAAE,MAAiC,EAAE,CAAC;IACrD,CAAC;CACF,CAAA;AAfY,gBAAgB;IAP5B,IAAI,CAAC;QACJ,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,6JAA6J;QAC/J,MAAM,EAAE,sBAAsB;QAC9B,YAAY,EAAE,mBAAmB;KAClC,CAAC;GACW,gBAAgB,CAe5B"}

package/dist/tools/mcp-tool-base.d.ts

@@ -3,6 +3,7 @@ import type { McpToolConfig } from '../config/mcp-tool-config.schema.js';
 import { McpClientService } from '../services/mcp-client.service.js';
 export declare abstract class McpToolBase<TArgs extends object> extends BaseTool<TArgs, McpToolConfig> {
     protected readonly mcp: McpClientService;
+    private readonly defaultConfig?;
     protected requireConfig(config: McpToolConfig | undefined): McpToolConfig;
 }
 //# sourceMappingURL=mcp-tool-base.d.ts.map

package/dist/tools/mcp-tool-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-tool-base.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-tool-base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAMrE,8BAAsB,WAAW,CAAC,KAAK,SAAS,MAAM,CAAE,SAAQ,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAClF,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAG,gBAAgB,CAAC;IAEpD,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,aAAa;CAM1E"}
+{"version":3,"file":"mcp-tool-base.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-tool-base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAOrE,8BAAsB,WAAW,CAAC,KAAK,SAAS,MAAM,CAAE,SAAQ,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAClF,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAG,gBAAgB,CAAC;IACZ,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAuB;IAE9F,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,aAAa;CAS1E"}

package/dist/tools/mcp-tool-base.js

@@ -7,20 +7,28 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { Inject } from '@nestjs/common';
+import { Inject, Optional } from '@nestjs/common';
 import { BaseTool } from '@loopstack/common';
 import { McpClientService } from '../services/mcp-client.service.js';
+import { MCP_DEFAULT_CONFIG } from '../tokens.js';
 export class McpToolBase extends BaseTool {
     mcp;
+    defaultConfig;
     requireConfig(config) {
-        if (!config?.allowedHosts?.length) {
-            throw new Error(`${this.constructor.name} requires @InjectTool({ allowedHosts: [...] }) configuration.`);
+        const resolved = config ?? this.defaultConfig ?? undefined;
+        if (!resolved?.allowedHosts?.length) {
+            throw new Error(`${this.constructor.name} requires config with allowedHosts: [...] (via options.config or McpModule.forRoot()).`);
         }
-        return config;
+        return resolved;
     }
 }
 __decorate([
     Inject(),
     __metadata("design:type", McpClientService)
 ], McpToolBase.prototype, "mcp", void 0);
+__decorate([
+    Optional(),
+    Inject(MCP_DEFAULT_CONFIG),
+    __metadata("design:type", Object)
+], McpToolBase.prototype, "defaultConfig", void 0);
 //# sourceMappingURL=mcp-tool-base.js.map

package/dist/tools/mcp-tool-base.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-tool-base.js","sourceRoot":"","sources":["../../src/tools/mcp-tool-base.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAMrE,MAAM,OAAgB,WAAkC,SAAQ,QAA8B;IAC/D,GAAG,CAAoB;IAE1C,aAAa,CAAC,MAAiC;QACvD,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,+DAA+D,CAAC,CAAC;QAC3G,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAR8B;IAA5B,MAAM,EAAE;8BAA0B,gBAAgB;wCAAC"}
+{"version":3,"file":"mcp-tool-base.js","sourceRoot":"","sources":["../../src/tools/mcp-tool-base.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAMlD,MAAM,OAAgB,WAAkC,SAAQ,QAA8B;IAC/D,GAAG,CAAoB;IACK,aAAa,CAAwB;IAEpF,aAAa,CAAC,MAAiC;QACvD,MAAM,QAAQ,GAAG,MAAM,IAAI,IAAI,CAAC,aAAa,IAAI,SAAS,CAAC;QAC3D,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,wFAAwF,CACjH,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAZ8B;IAA5B,MAAM,EAAE;8BAA0B,gBAAgB;wCAAC;AACK;IAAxD,QAAQ,EAAE;IAAE,MAAM,CAAC,kBAAkB,CAAC;;kDAAuD"}

package/package.json

@@ -8,7 +8,7 @@
     "loopstack",
     "tool"
   ],
-  "version": "0.2.1",
+  "version": "0.3.0",
   "license": "MIT",
   "author": {
     "name": "Jakob Klippel",
@@ -32,8 +32,8 @@
     "watch": "nest build --watch"
   },
   "dependencies": {
-    "@loopstack/common": "^0.31.0",
-    "@loopstack/core": "^0.31.0",
+    "@loopstack/common": "^0.32.0",
+    "@loopstack/core": "^0.32.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@nestjs/common": "^11.1.19",
     "@nestjs/core": "^11.1.19",