@jrmc/adonis-mcp 1.0.0-alpha.7 → 1.0.0-alpha.8

package/README.md

@@ -11,7 +11,7 @@ AdonisJS MCP - Server MCP for your AdonisJS applications.
 - [ ] MCP resources support
 - [ ] MCP prompts support
 - [ ] Alternative transports support (SSE, stdio)
-- [ ] Advanced pagination support
+- [x] Advanced pagination support
 - [ ] Automatic schema validation with Vine ??
 
 ## Installation & Configuration
@@ -276,6 +276,10 @@ export default class AddBookmarkTool implements Tool<Schema> {
 }
 ```
 
+### Pagination
+
+The `tools/list` method supports cursor-based pagination to handle large numbers of tools efficiently. This is particularly useful when you have many tools registered in your application. [More information](https://modelcontextprotocol.io/specification/2025-06-18/server/utilities/pagination)
+
 ## Support
 
 For any questions or issues, please open an issue on the [GitHub repository](https://github.com/batosai/adonis-mcp).

package/build/commands/make/tool.js

@@ -24,8 +24,8 @@ export default class MakeTool extends BaseCommand {
         const codemods = await this.createCodemods();
         const stubPath = `make/mcp/tools/main.ts.stub`;
         await codemods.makeUsingStub(stubsRoot, stubPath, {
-            className: `${string.pascalCase(this.name)}Tool`,
-            basePath: config.path
+            name: string.pascalCase(this.name),
+            basePath: config.path,
         });
         this.logger.success(`Tool created successfully for: ${this.name}`);
     }

package/build/providers/mcp_provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp_provider.d.ts","sourceRoot":"","sources":["../../providers/mcp_provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAKrD,OAAO,SAAS,MAAM,kBAAkB,CAAA;AAExC,MAAM,CAAC,OAAO,OAAO,WAAW;IAClB,SAAS,CAAC,GAAG,EAAE,kBAAkB;gBAAvB,GAAG,EAAE,kBAAkB;IAE7C,QAAQ;IAQF,KAAK;IAeL,aAAa;CA0CpB;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,MAAM;QACd,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,UAAU,CAAA;KACtC;CACF;AAED,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,iBAAiB;QACzB,UAAU,EAAE,SAAS,CAAA;KACtB;CACF"}
+{"version":3,"file":"mcp_provider.d.ts","sourceRoot":"","sources":["../../providers/mcp_provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAKrD,OAAO,SAAS,MAAM,kBAAkB,CAAA;AAExC,MAAM,CAAC,OAAO,OAAO,WAAW;IAClB,SAAS,CAAC,GAAG,EAAE,kBAAkB;gBAAvB,GAAG,EAAE,kBAAkB;IAE7C,QAAQ;IAQF,KAAK;IAeL,aAAa;CA4CpB;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,MAAM;QACd,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,UAAU,CAAA;KACtC;CACF;AAED,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,iBAAiB;QACzB,UAAU,EAAE,SAAS,CAAA;KACtB;CACF"}

package/build/providers/mcp_provider.js

@@ -34,7 +34,7 @@ export default class McpProvider {
         const server = await this.app.container.make('jrmc.mcp');
         const path = this.app.makePath(server.config.path);
         const files = await fsReadAll(path, {
-            filter: (filePath) => filePath.includes('_tool.ts')
+            filter: (filePath) => filePath.includes('_tool.ts'),
         });
         await Promise.all(files.map(async (file) => {
             const path = this.app.makePath(server.config.path, file);

package/build/src/Transport/http_transport.js

@@ -11,11 +11,13 @@ export default class HttpTransport {
     }
     bindBouncer(mcpContext) {
         if ('bouncer' in this.ctx) {
+            ;
             mcpContext.bouncer = this.ctx.bouncer;
         }
     }
     bindAuth(mcpContext) {
         if ('auth' in this.ctx) {
+            ;
             mcpContext.auth = this.ctx.auth;
         }
     }

package/build/src/context.d.ts

@@ -22,5 +22,6 @@ export default class ServerContext implements McpContext {
     request: McpRequest;
     response: McpResponse;
     constructor(options: ServerContextOptions);
+    getPerPage(requestedPerPage?: number): number;
 }
 //# sourceMappingURL=context.d.ts.map

package/build/src/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE3E,OAAO,WAAW,MAAM,eAAe,CAAA;AAEvC,MAAM,CAAC,OAAO,OAAO,aAAc,YAAW,UAAU;IACtD,yBAAyB,EAAE,MAAM,EAAE,CAAA;IACnC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,uBAAuB,EAAE,MAAM,CAAA;IAC/B,KAAK,EAAE,QAAQ,CAAA;IACf,SAAS,EAAE,YAAY,CAAA;IACvB,OAAO,EAAE,UAAU,CAAA;IACnB,OAAO,EAAE,UAAU,CAAA;IACnB,QAAQ,EAAE,WAAW,CAAA;gBAET,OAAO,EAAE,oBAAoB;CAc1C"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE3E,OAAO,WAAW,MAAM,eAAe,CAAA;AAEvC,MAAM,CAAC,OAAO,OAAO,aAAc,YAAW,UAAU;IACtD,yBAAyB,EAAE,MAAM,EAAE,CAAA;IACnC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,uBAAuB,EAAE,MAAM,CAAA;IAC/B,KAAK,EAAE,QAAQ,CAAA;IACf,SAAS,EAAE,YAAY,CAAA;IACvB,OAAO,EAAE,UAAU,CAAA;IACnB,OAAO,EAAE,UAAU,CAAA;IACnB,QAAQ,EAAE,WAAW,CAAA;gBAET,OAAO,EAAE,oBAAoB;IAelC,UAAU,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM;CAGrD"}

package/build/src/context.js

@@ -26,4 +26,7 @@ export default class ServerContext {
         this.request = options.request;
         this.response = new McpResponse();
     }
+    getPerPage(requestedPerPage) {
+        return Math.min(requestedPerPage ?? this.defaultPaginationLength, this.maxPaginationLength);
+    }
 }

package/build/src/enums/error.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @jrmc/adonis-mcp
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+export declare enum ErrorCode {
+    ConnectionClosed = -32000,
+    RequestTimeout = -32001,
+    ParseError = -32700,
+    InvalidRequest = -32600,
+    MethodNotFound = -32601,
+    InvalidParams = -32602,
+    InternalError = -32603
+}
+//# sourceMappingURL=error.d.ts.map

package/build/src/enums/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/enums/error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oBAAY,SAAS;IAEnB,gBAAgB,SAAS;IACzB,cAAc,SAAS;IAGvB,UAAU,SAAS;IACnB,cAAc,SAAS;IACvB,cAAc,SAAS;IACvB,aAAa,SAAS;IACtB,aAAa,SAAS;CACvB"}

package/build/src/enums/error.js

@@ -0,0 +1,18 @@
+/**
+ * @jrmc/adonis-mcp
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+export var ErrorCode;
+(function (ErrorCode) {
+    // SDK error codes
+    ErrorCode[ErrorCode["ConnectionClosed"] = -32000] = "ConnectionClosed";
+    ErrorCode[ErrorCode["RequestTimeout"] = -32001] = "RequestTimeout";
+    // Standard JSON-RPC error codes
+    ErrorCode[ErrorCode["ParseError"] = -32700] = "ParseError";
+    ErrorCode[ErrorCode["InvalidRequest"] = -32600] = "InvalidRequest";
+    ErrorCode[ErrorCode["MethodNotFound"] = -32601] = "MethodNotFound";
+    ErrorCode[ErrorCode["InvalidParams"] = -32602] = "InvalidParams";
+    ErrorCode[ErrorCode["InternalError"] = -32603] = "InternalError";
+})(ErrorCode || (ErrorCode = {}));

package/build/src/request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/request.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,OAAO;CAE3B"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/request.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,OAAO;CAAG"}

package/build/src/response.d.ts

@@ -4,29 +4,29 @@
  * @license MIT
  * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
  */
-export default class Response {
-    static notification(_method: string, _params: Record<string, any>): void;
+import type { JsonRpcResponse, McpResponse } from './types/response.js';
+export default class Response implements McpResponse {
     text(text: string): {
-        content: {
-            type: "text";
-            text: string;
-        }[];
+        type: "text";
+        text: string;
     };
-    static json(_content: Record<string, any>): void;
-    static blob(_content: string): void;
-    static error(_text: string): void;
-    content(): void;
-    static audio(): void;
-    static image(): void;
-    asAssistant(): void;
-    isNotification(): void;
-    isError(): void;
-    role(): void;
-    static result(id: number | string, result: Record<string, any>): {
-        readonly jsonrpc: "2.0";
+    image(data: string, mimeType: string, _meta?: Record<string, unknown>): {
+        type: "image";
+        data: string;
+        mimeType: string;
+        _meta: Record<string, unknown> | undefined;
     };
-    static resultRpc(result: Record<string, any>): {
-        readonly jsonrpc: "2.0";
+    audio(data: string, mimeType: string, _meta?: Record<string, unknown>): {
+        type: "audio";
+        data: string;
+        mimeType: string;
+        _meta: Record<string, unknown> | undefined;
     };
+    error(message: string, code?: number, data?: Record<string, unknown>): {
+        message: string;
+        code: number;
+        data: Record<string, unknown> | undefined;
+    };
+    static toJsonRpc({ id, result, error }: Omit<JsonRpcResponse, 'jsonrpc'>): JsonRpcResponse;
 }
 //# sourceMappingURL=response.d.ts.map

package/build/src/response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/response.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,CAAC,OAAO,OAAO,QAAQ;IAI3B,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAEjE,IAAI,CAAC,IAAI,EAAE,MAAM;;;;;;IAMjB,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAEzC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM;IAE5B,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM;IAE1B,OAAO;IAEP,MAAM,CAAC,KAAK;IAEZ,MAAM,CAAC,KAAK;IAEZ,WAAW;IAEX,cAAc;IAEd,OAAO;IAEP,IAAI;IAEJ,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;;IAO9D,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;;CAM7C"}
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/response.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEvE,MAAM,CAAC,OAAO,OAAO,QAAS,YAAW,WAAW;IAClD,IAAI,CAAC,IAAI,EAAE,MAAM;;;;IAIjB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IAIrE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;IAIrE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;IAQpE,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,GAAG,eAAe;CAQ3F"}

package/build/src/response.js

@@ -4,35 +4,30 @@
  * @license MIT
  * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
  */
-// import Role from './enums/role.js'
+import { ErrorCode } from './enums/error.js';
 export default class Response {
-    // constructor(_content: string, _role: Role = Role.USER) {}
-    static notification(_method, _params) { }
     text(text) {
+        return { type: 'text', text };
+    }
+    image(data, mimeType, _meta) {
+        return { type: 'image', data, mimeType, _meta };
+    }
+    audio(data, mimeType, _meta) {
+        return { type: 'audio', data, mimeType, _meta };
+    }
+    error(message, code, data) {
         return {
-            content: [{ type: 'text', text }],
+            message,
+            code: code ?? ErrorCode.InternalError,
+            data,
         };
     }
-    static json(_content) { }
-    static blob(_content) { }
-    static error(_text) { }
-    content() { }
-    static audio() { }
-    static image() { }
-    asAssistant() { }
-    isNotification() { }
-    isError() { }
-    role() { }
-    static result(id, result) {
-        return this.resultRpc({
-            id,
-            result,
-        });
-    }
-    static resultRpc(result) {
+    static toJsonRpc({ id, result, error }) {
         return {
             jsonrpc: '2.0',
-            ...result,
+            id,
+            result,
+            error,
         };
     }
 }

package/build/src/server/methods/call_tool.d.ts

@@ -7,8 +7,6 @@
 import type { Method } from '../../types/method.js';
 import type { McpContext } from '../../types/context.js';
 export default class CallTool implements Method {
-    handle(ctx: McpContext): Promise<{
-        readonly jsonrpc: "2.0";
-    }>;
+    handle(ctx: McpContext): Promise<import("../../types/response.js").JsonRpcResponse>;
 }
 //# sourceMappingURL=call_tool.d.ts.map

package/build/src/server/methods/call_tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"call_tool.d.ts","sourceRoot":"","sources":["../../../../src/server/methods/call_tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAKxD,MAAM,CAAC,OAAO,OAAO,QAAS,YAAW,MAAM;IACvC,MAAM,CAAC,GAAG,EAAE,UAAU;;;CAuC7B"}
+{"version":3,"file":"call_tool.d.ts","sourceRoot":"","sources":["../../../../src/server/methods/call_tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAKxD,MAAM,CAAC,OAAO,OAAO,QAAS,YAAW,MAAM;IACvC,MAAM,CAAC,GAAG,EAAE,UAAU;CAyC7B"}

package/build/src/server/methods/call_tool.js

@@ -22,7 +22,18 @@ export default class CallTool {
         const { default: Tool } = await import(ctx.tools[item]);
         ctx.args = params.arguments ?? {};
         const tool = new Tool(ctx);
-        const content = await tool.handle(ctx);
-        return Response.result(ctx.request.id, content);
+        const data = await tool.handle(ctx);
+        let result;
+        let error;
+        if (Array.isArray(data)) {
+            result = { content: data };
+        }
+        else if (data.code) {
+            error = data;
+        }
+        else {
+            result = { content: [data] };
+        }
+        return Response.toJsonRpc({ id: ctx.request.id, result, error });
     }
 }

package/build/src/server/methods/get_prompt.d.ts

@@ -7,8 +7,6 @@
 import type { Method } from '../../types/method.js';
 import type { McpContext } from '../../types/context.js';
 export default class GetPrompt implements Method {
-    handle(ctx: McpContext): {
-        readonly jsonrpc: "2.0";
-    };
+    handle(ctx: McpContext): import("../../types/response.js").JsonRpcResponse;
 }
 //# sourceMappingURL=get_prompt.d.ts.map

package/build/src/server/methods/get_prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get_prompt.d.ts","sourceRoot":"","sources":["../../../../src/server/methods/get_prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAIxD,MAAM,CAAC,OAAO,OAAO,SAAU,YAAW,MAAM;IAC9C,MAAM,CAAC,GAAG,EAAE,UAAU;;;CAGvB"}
+{"version":3,"file":"get_prompt.d.ts","sourceRoot":"","sources":["../../../../src/server/methods/get_prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAIxD,MAAM,CAAC,OAAO,OAAO,SAAU,YAAW,MAAM;IAC9C,MAAM,CAAC,GAAG,EAAE,UAAU;CAGvB"}

package/build/src/server/methods/get_prompt.js

@@ -7,6 +7,6 @@
 import Response from '../../response.js';
 export default class GetPrompt {
     handle(ctx) {
-        return Response.result(ctx.request.id, {});
+        return Response.toJsonRpc({ id: ctx.request.id });
     }
 }

package/build/src/server/methods/initialize.d.ts

@@ -7,8 +7,6 @@
 import type { Method } from '../../types/method.js';
 import type { McpContext } from '../../types/context.js';
 export default class Initialize implements Method {
-    handle(ctx: McpContext): {
-        readonly jsonrpc: "2.0";
-    };
+    handle(ctx: McpContext): import("../../types/response.js").JsonRpcResponse;
 }
 //# sourceMappingURL=initialize.d.ts.map

package/build/src/server/methods/initialize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initialize.d.ts","sourceRoot":"","sources":["../../../../src/server/methods/initialize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAKxD,MAAM,CAAC,OAAO,OAAO,UAAW,YAAW,MAAM;IAC/C,MAAM,CAAC,GAAG,EAAE,UAAU;;;CAyBvB"}
+{"version":3,"file":"initialize.d.ts","sourceRoot":"","sources":["../../../../src/server/methods/initialize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAKxD,MAAM,CAAC,OAAO,OAAO,UAAW,YAAW,MAAM;IAC/C,MAAM,CAAC,GAAG,EAAE,UAAU;CA4BvB"}

package/build/src/server/methods/initialize.js

@@ -16,7 +16,7 @@ export default class Initialize {
             throw createError('Unsupported protocol version', 'E_JSON_RPC_ERROR', -32000);
         }
         const protocolVersion = requestedVersion ?? ctx.supportedProtocolVersions[0];
-        const initResult = {
+        const result = {
             protocolVersion,
             capabilities: ctx.serverCapabilities,
             serverInfo: {
@@ -25,6 +25,6 @@ export default class Initialize {
             },
             instructions: ctx.instructions,
         };
-        return Response.result(ctx.request.id, initResult);
+        return Response.toJsonRpc({ id: ctx.request.id, result });
     }
 }

package/build/src/server/methods/list_prompts.d.ts

@@ -7,8 +7,6 @@
 import type { Method } from '../../types/method.js';
 import type { McpContext } from '../../types/context.js';
 export default class ListPrompts implements Method {
-    handle(ctx: McpContext): {
-        readonly jsonrpc: "2.0";
-    };
+    handle(ctx: McpContext): import("../../types/response.js").JsonRpcResponse;
 }
 //# sourceMappingURL=list_prompts.d.ts.map

package/build/src/server/methods/list_prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list_prompts.d.ts","sourceRoot":"","sources":["../../../../src/server/methods/list_prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAIxD,MAAM,CAAC,OAAO,OAAO,WAAY,YAAW,MAAM;IAChD,MAAM,CAAC,GAAG,EAAE,UAAU;;;CAGvB"}
+{"version":3,"file":"list_prompts.d.ts","sourceRoot":"","sources":["../../../../src/server/methods/list_prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAIxD,MAAM,CAAC,OAAO,OAAO,WAAY,YAAW,MAAM;IAChD,MAAM,CAAC,GAAG,EAAE,UAAU;CAGvB"}

package/build/src/server/methods/list_prompts.js

@@ -7,6 +7,6 @@
 import Response from '../../response.js';
 export default class ListPrompts {
     handle(ctx) {
-        return Response.result(ctx.request.id, { prompts: ctx.prompts });
+        return Response.toJsonRpc({ id: ctx.request.id, result: { prompts: ctx.prompts } });
     }
 }

package/build/src/server/methods/list_resources.d.ts

@@ -7,8 +7,6 @@
 import type { Method } from '../../types/method.js';
 import type { McpContext } from '../../types/context.js';
 export default class ListResources implements Method {
-    handle(ctx: McpContext): {
-        readonly jsonrpc: "2.0";
-    };
+    handle(ctx: McpContext): import("../../types/response.js").JsonRpcResponse;
 }
 //# sourceMappingURL=list_resources.d.ts.map

package/build/src/server/methods/list_resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list_resources.d.ts","sourceRoot":"","sources":["../../../../src/server/methods/list_resources.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAIxD,MAAM,CAAC,OAAO,OAAO,aAAc,YAAW,MAAM;IAClD,MAAM,CAAC,GAAG,EAAE,UAAU;;;CAGvB"}
+{"version":3,"file":"list_resources.d.ts","sourceRoot":"","sources":["../../../../src/server/methods/list_resources.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAIxD,MAAM,CAAC,OAAO,OAAO,aAAc,YAAW,MAAM;IAClD,MAAM,CAAC,GAAG,EAAE,UAAU;CAGvB"}

package/build/src/server/methods/list_resources.js

@@ -7,6 +7,6 @@
 import Response from '../../response.js';
 export default class ListResources {
     handle(ctx) {
-        return Response.result(ctx.request.id, { resources: ctx.resources });
+        return Response.toJsonRpc({ id: ctx.request.id, result: { resources: ctx.resources } });
     }
 }

package/build/src/server/methods/list_tools.d.ts

@@ -7,8 +7,6 @@
 import type { Method } from '../../types/method.js';
 import type { McpContext } from '../../types/context.js';
 export default class ListTools implements Method {
-    handle(ctx: McpContext): Promise<{
-        readonly jsonrpc: "2.0";
-    }>;
+    handle(ctx: McpContext): Promise<import("../../types/response.js").JsonRpcResponse>;
 }
 //# sourceMappingURL=list_tools.d.ts.map

package/build/src/server/methods/list_tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list_tools.d.ts","sourceRoot":"","sources":["../../../../src/server/methods/list_tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAKxD,MAAM,CAAC,OAAO,OAAO,SAAU,YAAW,MAAM;IACxC,MAAM,CAAC,GAAG,EAAE,UAAU;;;CAmC7B"}
+{"version":3,"file":"list_tools.d.ts","sourceRoot":"","sources":["../../../../src/server/methods/list_tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAKxD,MAAM,CAAC,OAAO,OAAO,SAAU,YAAW,MAAM;IACxC,MAAM,CAAC,GAAG,EAAE,UAAU;CAwD7B"}

package/build/src/server/methods/list_tools.js

@@ -4,18 +4,24 @@
  * @license MIT
  * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
  */
-// import { createError } from '@adonisjs/core/exceptions'
+import { CursorPaginator } from '../pagination/cursor_paginator.js';
 import Response from '../../response.js';
 export default class ListTools {
     async handle(ctx) {
-        const tools = await Promise.all(Object.values(ctx.tools).map(async (filepath) => {
+        let error = false;
+        let nextCursor;
+        const paginator = new CursorPaginator(Object.values(ctx.tools), ctx.getPerPage(), ctx.request.params?.cursor);
+        const paginatedTools = paginator.paginate('tools');
+        const tools = await Promise.all(paginatedTools['tools'].map(async (filepath) => {
             try {
                 const { default: Tool } = await import(filepath);
                 const tool = new Tool();
-                const schema = tool.schema() ?? {
-                    type: 'object',
-                    properties: {},
-                };
+                const schema = tool.schema
+                    ? tool.schema()
+                    : {
+                        type: 'object',
+                        properties: {},
+                    };
                 return {
                     name: tool.name,
                     title: tool.title,
@@ -24,18 +30,25 @@ export default class ListTools {
                         type: schema.type,
                         properties: schema.properties,
                         required: schema.required ?? [],
-                    }
+                    },
                 };
             }
             catch (error) {
-                console.error(error);
-                // throw createError(
-                //   `Error listing tool ${tool.name}`,
-                //   'E_LIST_TOOLS_ERROR',
-                //   -32601,
-                // )
+                error = true;
             }
         }));
-        return Response.result(ctx.request.id, { tools });
+        if (error) {
+            return Response.toJsonRpc({
+                id: ctx.request.id,
+                error: {
+                    code: -32601,
+                    message: `Error listing tool`,
+                },
+            });
+        }
+        if (paginatedTools.nextCursor) {
+            nextCursor = paginatedTools.nextCursor;
+        }
+        return Response.toJsonRpc({ id: ctx.request.id, result: { tools, nextCursor } });
     }
 }

package/build/src/server/methods/ping.d.ts

@@ -7,8 +7,6 @@
 import type { Method } from '../../types/method.js';
 import type { McpContext } from '../../types/context.js';
 export default class Ping implements Method {
-    handle(ctx: McpContext): {
-        readonly jsonrpc: "2.0";
-    };
+    handle(ctx: McpContext): import("../../types/response.js").JsonRpcResponse;
 }
 //# sourceMappingURL=ping.d.ts.map

package/build/src/server/methods/ping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ping.d.ts","sourceRoot":"","sources":["../../../../src/server/methods/ping.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAIxD,MAAM,CAAC,OAAO,OAAO,IAAK,YAAW,MAAM;IACzC,MAAM,CAAC,GAAG,EAAE,UAAU;;;CAGvB"}
+{"version":3,"file":"ping.d.ts","sourceRoot":"","sources":["../../../../src/server/methods/ping.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAIxD,MAAM,CAAC,OAAO,OAAO,IAAK,YAAW,MAAM;IACzC,MAAM,CAAC,GAAG,EAAE,UAAU;CAGvB"}

package/build/src/server/methods/ping.js

@@ -7,6 +7,6 @@
 import Response from '../../response.js';
 export default class Ping {
     handle(ctx) {
-        return Response.result(ctx.request.id, {});
+        return Response.toJsonRpc({ id: ctx.request.id });
     }
 }

package/build/src/server/methods/read_resource.d.ts

@@ -7,8 +7,6 @@
 import type { Method } from '../../types/method.js';
 import type { McpContext } from '../../types/context.js';
 export default class ReadResource implements Method {
-    handle(ctx: McpContext): {
-        readonly jsonrpc: "2.0";
-    };
+    handle(ctx: McpContext): import("../../types/response.js").JsonRpcResponse;
 }
 //# sourceMappingURL=read_resource.d.ts.map

package/build/src/server/methods/read_resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read_resource.d.ts","sourceRoot":"","sources":["../../../../src/server/methods/read_resource.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAIxD,MAAM,CAAC,OAAO,OAAO,YAAa,YAAW,MAAM;IACjD,MAAM,CAAC,GAAG,EAAE,UAAU;;;CAGvB"}
+{"version":3,"file":"read_resource.d.ts","sourceRoot":"","sources":["../../../../src/server/methods/read_resource.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAIxD,MAAM,CAAC,OAAO,OAAO,YAAa,YAAW,MAAM;IACjD,MAAM,CAAC,GAAG,EAAE,UAAU;CAGvB"}

package/build/src/server/methods/read_resource.js

@@ -7,6 +7,6 @@
 import Response from '../../response.js';
 export default class ReadResource {
     handle(ctx) {
-        return Response.result(ctx.request.id, {});
+        return Response.toJsonRpc({ id: ctx.request.id });
     }
 }

package/build/src/server/pagination/cursor_paginator.d.ts

@@ -0,0 +1,12 @@
+export declare class CursorPaginator {
+    private items;
+    private perPage;
+    private cursor?;
+    constructor(items: unknown[], perPage: number, cursor?: string | undefined);
+    paginate(key?: string): {
+        [key: string]: unknown;
+    };
+    protected getStartOffsetFromCursor(): number;
+    protected createCursor(offset: number): string;
+}
+//# sourceMappingURL=cursor_paginator.d.ts.map

package/build/src/server/pagination/cursor_paginator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor_paginator.d.ts","sourceRoot":"","sources":["../../../../src/server/pagination/cursor_paginator.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAe;IAExB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM,CAAC;gBAFP,KAAK,EAAE,OAAO,EAAE,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,YAAA;IAGlB,QAAQ,CAAC,GAAG,GAAE,MAAgB,GAAG;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE;IAmBlE,SAAS,CAAC,wBAAwB;IA0BlC,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM;CAGtC"}

package/build/src/server/pagination/cursor_paginator.js

@@ -0,0 +1,48 @@
+export class CursorPaginator {
+    items;
+    perPage;
+    cursor;
+    constructor(items, perPage, cursor) {
+        this.items = items;
+        this.perPage = perPage;
+        this.cursor = cursor;
+    }
+    paginate(key = 'items') {
+        const startOffset = this.getStartOffsetFromCursor();
+        console.log('startOffset', startOffset);
+        const paginatedItems = this.items.slice(startOffset, startOffset + this.perPage);
+        const hasMorePages = this.items.length > startOffset + this.perPage;
+        console.log('hasMorePages', hasMorePages);
+        console.log('paginatedItems', paginatedItems.length);
+        const result = {
+            [key]: paginatedItems,
+        };
+        if (hasMorePages) {
+            result.nextCursor = this.createCursor(startOffset + this.perPage);
+        }
+        return result;
+    }
+    getStartOffsetFromCursor() {
+        if (!this.cursor) {
+            return 0;
+        }
+        try {
+            const decodedCursor = Buffer.from(this.cursor, 'base64').toString('utf-8');
+            if (!decodedCursor) {
+                return 0;
+            }
+            const cursorData = JSON.parse(decodedCursor);
+            if (!cursorData.hasOwnProperty('offset')) {
+                return 0;
+            }
+            return parseInt(cursorData.offset);
+        }
+        catch (error) {
+            //
+        }
+        return 0;
+    }
+    createCursor(offset) {
+        return Buffer.from(JSON.stringify({ offset })).toString('base64');
+    }
+}

package/build/src/server/tool.d.ts

@@ -10,11 +10,9 @@ export declare abstract class Tool<S extends JSONSchema> {
     abstract name: string;
     abstract title?: string;
     abstract description?: string;
-    /** Schema retourné par la classe */
-    abstract schema(): S;
-    /** handle typé automatiquement depuis le schema */
+    abstract schema?(): S;
     abstract handle(ctx?: McpContext & {
         args: InferJSONSchema<S>;
-    }): Record<string, unknown> | Promise<Record<string, unknown>>;
+    }): Record<string, unknown> | Record<string, unknown>[] | Promise<Record<string, unknown> | Record<string, unknown>[]>;
 }
 //# sourceMappingURL=tool.d.ts.map

package/build/src/server/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/server/tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAErD,8BAAsB,IAAI,CAAC,CAAC,SAAS,UAAU;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAE7B,oCAAoC;IACpC,QAAQ,CAAC,MAAM,IAAI,CAAC;IAEpB,mDAAmD;IACnD,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,UAAU,GAAG;QAAE,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7H"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/server/tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAErD,8BAAsB,IAAI,CAAC,CAAC,SAAS,UAAU;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAE7B,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;IAErB,QAAQ,CAAC,MAAM,CACb,GAAG,CAAC,EAAE,UAAU,GAAG;QAAE,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;KAAE,GAE7C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACjE"}