hono-mcp-server 0.0.1 → 0.0.2

package/README.md

@@ -6,20 +6,25 @@ Expose your [Hono](https://hono.dev) API endpoints as [MCP](https://modelcontext
 
 ```ts
 import { Hono } from "hono";
-import { mcp, describe } from "hono-mcp-server";
+import { z } from "zod";
+import { mcp, registerTool } from "hono-mcp-server";
 
 const app = new Hono()
-  .get(
-    "/users",
-    describe("List all users", (c) => c.json([{ id: 1, name: "Alice" }])),
-  )
-  .get(
-    "/users/:id",
-    describe("Get user by ID", (c) => c.json({ id: c.req.param("id") })),
-  )
+  .get("/users", registerTool("List all users"), (c) => c.json([{ id: 1, name: "Alice" }]))
+  .get("/users/:id", registerTool("Get user by ID"), (c) => c.json({ id: c.req.param("id") }))
   .post(
     "/users",
-    describe("Create a user", async (c) => c.json(await c.req.json(), 201)),
+    registerTool({
+      description: "Create a new user",
+      inputSchema: {
+        name: z.string().describe("User's full name"),
+        email: z.string().email().describe("User's email address"),
+      },
+    }),
+    async (c) => {
+      const { name } = c.req.valid("json"); // typed!
+      return c.json({ id: 1, name });
+    },
   );
 
 export default mcp(app, {
@@ -30,6 +35,35 @@ export default mcp(app, {
 
 This adds an `/mcp` endpoint that exposes your routes as MCP tools.
 
+## Input & Output Schemas
+
+Use `registerTool()` with `inputSchema` for validated, typed input. Access validated data with `c.req.valid('json')`:
+
+```ts
+import { z } from "zod";
+import { registerTool } from "hono-mcp-server";
+
+app.post(
+  "/search",
+  registerTool({
+    description: "Search for items",
+    inputSchema: {
+      query: z.string().describe("Search query"),
+      limit: z.number().optional().describe("Max results"),
+    },
+    outputSchema: {
+      results: z.array(z.object({ id: z.string(), title: z.string() })),
+    },
+  }),
+  async (c) => {
+    const { query, limit } = c.req.valid("json"); // typed!
+    return c.json({ results: [] });
+  },
+);
+```
+
+When `outputSchema` is defined, the tool returns structured content that MCP clients can parse.
+
 ## Options
 
 ```ts

package/dist/index.d.mts

@@ -1,15 +1,48 @@
-import { Env, Handler, Hono } from "hono";
+import { z } from "zod";
+import { Env, Hono, MiddlewareHandler } from "hono";
+import { ToolAnnotations } from "@modelcontextprotocol/sdk/types.js";
 
 //#region src/mcp.d.ts
+interface DescribeConfig<TInput extends z.ZodRawShape = z.ZodRawShape, TOutput extends z.ZodRawShape = z.ZodRawShape> {
+  description: string;
+  inputSchema?: TInput;
+  outputSchema?: TOutput;
+  annotations?: ToolAnnotations;
+}
 /**
- * Add a description to a route handler for MCP tool generation.
+ * Register a route as an MCP tool with description and optional schemas.
+ * Always returns middleware - the actual handler should be a separate function.
  *
  * @example
  * ```ts
- * app.get('/users', describe('List all users', (c) => c.json([])))
+ * // Simple description
+ * app.get('/users', registerTool('List all users'), (c) => c.json([]))
+ *
+ * // With config
+ * app.get('/users', registerTool({ description: 'List all users' }), (c) => c.json([]))
+ *
+ * // With inputSchema - use c.req.valid('json') for typed input
+ * app.post('/users',
+ *   registerTool({ description: 'Create a user', inputSchema: { name: z.string() } }),
+ *   async (c) => {
+ *     const { name } = c.req.valid('json') // typed!
+ *     return c.json({ id: 1, name })
+ *   }
+ * )
  * ```
  */
-declare function describe<H extends Handler>(description: string, handler: H): H;
+declare function registerTool(description: string): MiddlewareHandler;
+declare function registerTool<TInput extends z.ZodRawShape, TOutput extends z.ZodRawShape = z.ZodRawShape>(config: DescribeConfig<TInput, TOutput> & {
+  inputSchema: TInput;
+}): MiddlewareHandler<Env, string, {
+  in: {
+    json: z.infer<z.ZodObject<TInput>>;
+  };
+  out: {
+    json: z.infer<z.ZodObject<TInput>>;
+  };
+}>;
+declare function registerTool<TOutput extends z.ZodRawShape>(config: DescribeConfig<z.ZodRawShape, TOutput>): MiddlewareHandler;
 interface McpOptions {
   name: string;
   version: string;
@@ -44,5 +77,5 @@ interface McpOptions {
  */
 declare function mcp<E extends Env>(app: Hono<E>, options: McpOptions): Hono<E>;
 //#endregion
-export { type McpOptions, describe, mcp };
+export { type DescribeConfig, type McpOptions, mcp, registerTool };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/mcp.ts"],"mappings":";;;;AAgBA;;;;;AAsBA;AA6DA;iBAnFgB,QAAA,WAAmB,OAAA,CAAA,CAAA,WAAA,UAAA,OAAA,EAAuC,CAAA,GAAI,CAAA;AAAA,UAsB7D,UAAA;EAAA,IAAA;EAAA,OAAA;EAAA,KAAA;EAAA,WAAA;EAAA,YAAA;EAAA,OAAA;EAAA;EAAA,QAAA;EAAA;EAAA,aAAA;AAAA;AAAA;AA6DjB;;;;;;;;;;;;;;;;;;;AA7DiB,iBA6DD,GAAA,WAAc,GAAA,CAAA,CAAA,GAAA,EAAU,IAAA,CAAK,CAAA,GAAA,OAAA,EAAa,UAAA,GAAa,IAAA,CAAK,CAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/mcp.ts"],"mappings":";;;;;UAUiB,cAAA,gBACA,CAAA,CAAE,WAAA,GAAc,CAAA,CAAE,WAAA,kBACjB,CAAA,CAAE,WAAA,GAAc,CAAA,CAAE,WAAA;EAAA,WAAA;EAAA,WAAA,GAGpB,MAAA;EAAA,YAAA,GACC,OAAA;EAAA,WAAA,GACD,eAAA;AAAA;AAAA;;AAoChB;AAIA;;;;;;;;;;;;;;;;;AAIA;;AA5CgB,iBAoCA,YAAA,CAAA,WAAA,WAEb,iBAAA;AAAA,iBAEa,YAAA,gBAA4B,CAAA,CAAE,WAAA,kBAA6B,CAAA,CAAE,WAAA,GAAc,CAAA,CAAE,WAAA,CAAA,CAAA,MAAA,EACnF,cAAA,CAAe,MAAA,EAAQ,OAAA;EAAA,WAAA,EAA0B,MAAA;AAAA,IACxD,iBAAA,CAAkB,GAAA;EAAA,EAAA;IAAA,IAAA,EAA2B,CAAA,CAAE,KAAA,CAAM,CAAA,CAAE,SAAA,CAAU,MAAA;EAAA;EAAA,GAAA;IAAA,IAAA,EAAyB,CAAA,CAAE,KAAA,CAAM,CAAA,CAAE,SAAA,CAAU,MAAA;EAAA;AAAA;AAAA,iBAEjG,YAAA,iBAA6B,CAAA,CAAE,WAAA,CAAA,CAAA,MAAA,EACrC,cAAA,CAAe,CAAA,CAAE,WAAA,EAAa,OAAA,IACrC,iBAAA;AAAA,UA6Dc,UAAA;EAAA,IAAA;EAAA,OAAA;EAAA,KAAA;EAAA,WAAA;EAAA,YAAA;EAAA,OAAA;EAAA;EAAA,QAAA;EAAA;EAAA,aAAA;AAAA;AAAA;AA8DjB;;;;;;;;;;;;;;;;;;;AA9DiB,iBA8DD,GAAA,WAAc,GAAA,CAAA,CAAA,GAAA,EAAU,IAAA,CAAK,CAAA,GAAA,OAAA,EAAa,UAAA,GAAa,IAAA,CAAK,CAAA"}

package/dist/index.mjs

@@ -1,23 +1,38 @@
+import { validator } from "hono/validator";
 import { z } from "zod";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
 
 //#region src/mcp.ts
-const MCP_DESCRIPTION = Symbol("mcp_description");
-/**
-* Add a description to a route handler for MCP tool generation.
-*
-* @example
-* ```ts
-* app.get('/users', describe('List all users', (c) => c.json([])))
-* ```
-*/
-function describe(description, handler) {
-	handler[MCP_DESCRIPTION] = description;
-	return handler;
+const toolMetadata = /* @__PURE__ */ new WeakMap();
+function registerTool(descriptionOrConfig) {
+	const metadata = typeof descriptionOrConfig === "string" ? { description: descriptionOrConfig } : {
+		description: descriptionOrConfig.description,
+		inputSchema: descriptionOrConfig.inputSchema,
+		outputSchema: descriptionOrConfig.outputSchema,
+		annotations: descriptionOrConfig.annotations
+	};
+	if (metadata.inputSchema) {
+		const schema = z.object(metadata.inputSchema);
+		const middleware$1 = validator("json", (value) => {
+			const result = schema.safeParse(value);
+			if (!result.success) throw new Error(result.error.message);
+			return result.data;
+		});
+		toolMetadata.set(middleware$1, metadata);
+		return middleware$1;
+	}
+	const middleware = async (_c, next) => {
+		await next();
+	};
+	toolMetadata.set(middleware, metadata);
+	return middleware;
+}
+function getToolMetadata(handler) {
+	if (typeof handler === "function") return toolMetadata.get(handler);
 }
 function getDescription(handler) {
-	return handler?.[MCP_DESCRIPTION];
+	return getToolMetadata(handler)?.description;
 }
 const CORS_HEADERS = {
 	"Access-Control-Allow-Origin": "*",
@@ -77,7 +92,7 @@ function mcp(app, options) {
 	} : async (c) => {
 		if (c.req.method === "OPTIONS") return new Response(null, { headers: CORS_HEADERS });
 		const server = createServer();
-		for (const route of routes) registerTool(server, route, app);
+		for (const route of routes) registerRouteAsTool(server, route, app);
 		const transport = new WebStandardStreamableHTTPServerTransport();
 		server.connect(transport);
 		return withCors(await transport.handleRequest(c.req.raw));
@@ -108,7 +123,8 @@ function extractRoutes(app) {
 		routes.push({
 			method,
 			path: route.path,
-			description
+			description,
+			handler: route.handler
 		});
 	}
 	return routes;
@@ -131,20 +147,29 @@ function extractPathParams(path) {
 	const matches = path.match(/:([^/]+)/g);
 	return matches ? matches.map((m) => m.slice(1)) : [];
 }
-function registerTool(server, route, app) {
+function registerRouteAsTool(server, route, app) {
 	const toolName = generateToolName(route.method, route.path);
 	const pathParams = extractPathParams(route.path);
-	const inputShape = {};
-	for (const param of pathParams) inputShape[param] = z.string().describe(`Path parameter: ${param}`);
-	if ([
-		"POST",
-		"PUT",
-		"PATCH"
-	].includes(route.method)) inputShape["body"] = z.record(z.unknown()).optional().describe("Request body as JSON object");
-	if (["GET", "DELETE"].includes(route.method)) inputShape["query"] = z.record(z.string()).optional().describe("Query parameters");
+	const metadata = getToolMetadata(route.handler);
+	let inputShape;
+	if (metadata?.inputSchema) {
+		inputShape = { ...metadata.inputSchema };
+		for (const param of pathParams) if (!(param in inputShape)) inputShape[param] = z.string().describe(`Path parameter: ${param}`);
+	} else {
+		inputShape = {};
+		for (const param of pathParams) inputShape[param] = z.string().describe(`Path parameter: ${param}`);
+		if ([
+			"POST",
+			"PUT",
+			"PATCH"
+		].includes(route.method)) inputShape["body"] = z.record(z.unknown()).optional().describe("Request body as JSON object");
+		if (["GET", "DELETE"].includes(route.method)) inputShape["query"] = z.record(z.string()).optional().describe("Query parameters");
+	}
 	server.registerTool(toolName, {
 		description: `${route.description}\n\n${route.method} ${route.path}`,
-		inputSchema: Object.keys(inputShape).length > 0 ? inputShape : void 0
+		inputSchema: Object.keys(inputShape).length > 0 ? inputShape : void 0,
+		...metadata?.outputSchema && { outputSchema: metadata.outputSchema },
+		...metadata?.annotations && { annotations: metadata.annotations }
 	}, async (params) => {
 		let url = route.path;
 		for (const param of pathParams) {
@@ -168,10 +193,28 @@ function registerTool(server, route, app) {
 		].includes(route.method)) init.body = JSON.stringify(body);
 		try {
 			const response = await app.fetch(new Request(`http://internal${url}`, init));
+			if ((response.headers.get("content-type") || "").includes("application/json")) {
+				const json = await response.json();
+				if (metadata?.outputSchema) return {
+					structuredContent: json,
+					content: [{
+						type: "text",
+						text: JSON.stringify(json, null, 2)
+					}],
+					isError: !response.ok
+				};
+				return {
+					content: [{
+						type: "text",
+						text: JSON.stringify(json, null, 2)
+					}],
+					isError: !response.ok
+				};
+			}
 			return {
 				content: [{
 					type: "text",
-					text: (response.headers.get("content-type") || "").includes("application/json") ? JSON.stringify(await response.json(), null, 2) : await response.text()
+					text: await response.text()
 				}],
 				isError: !response.ok
 			};
@@ -306,5 +349,5 @@ Example:
 }
 
 //#endregion
-export { describe, mcp };
+export { mcp, registerTool };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/mcp.ts"],"sourcesContent":["import { Hono } from \"hono\";\nimport type { Env, Handler } from \"hono\";\nimport { z } from \"zod\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { WebStandardStreamableHTTPServerTransport } from \"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js\";\n\nconst MCP_DESCRIPTION = Symbol(\"mcp_description\");\n\n/**\n * Add a description to a route handler for MCP tool generation.\n *\n * @example\n * ```ts\n * app.get('/users', describe('List all users', (c) => c.json([])))\n * ```\n */\nexport function describe<H extends Handler>(description: string, handler: H): H {\n  (handler as any)[MCP_DESCRIPTION] = description;\n  return handler;\n}\n\nfunction getDescription(handler: unknown): string | undefined {\n  return (handler as any)?.[MCP_DESCRIPTION];\n}\n\n// WorkerLoader interface (matches @cloudflare/workers-types)\ninterface WorkerLoader {\n  get(\n    id: string,\n    factory: () => {\n      compatibilityDate: string;\n      compatibilityFlags?: string[];\n      mainModule: string;\n      modules: Record<string, string>;\n    },\n  ): { getEntrypoint(): { evaluate: (...args: unknown[]) => Promise<unknown> } };\n}\n\nexport interface McpOptions {\n  name: string;\n  version: string;\n  title?: string;\n  description?: string;\n  instructions?: string;\n  mcpPath?: string;\n  /** Enable codemode - exposes search/execute tools instead of per-route tools. Requires LOADER binding. */\n  codemode?: boolean;\n  /** Binding name for Worker Loader (default: \"LOADER\"). Only used when codemode is true. */\n  loaderBinding?: string;\n}\n\ntype HttpMethod = \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n\ninterface Route {\n  method: HttpMethod;\n  path: string;\n  description: string;\n}\n\nconst CORS_HEADERS = {\n  \"Access-Control-Allow-Origin\": \"*\",\n  \"Access-Control-Allow-Methods\": \"GET, POST, DELETE, OPTIONS\",\n  \"Access-Control-Allow-Headers\": \"Content-Type, Accept, mcp-session-id, mcp-protocol-version\",\n  \"Access-Control-Expose-Headers\": \"mcp-session-id\",\n  \"Access-Control-Max-Age\": \"86400\",\n};\n\nfunction withCors(response: Response): Response {\n  const newHeaders = new Headers(response.headers);\n  for (const [key, value] of Object.entries(CORS_HEADERS)) {\n    newHeaders.set(key, value);\n  }\n  return new Response(response.body, {\n    status: response.status,\n    statusText: response.statusText,\n    headers: newHeaders,\n  });\n}\n\n/**\n * Wraps a Hono app to add an MCP endpoint that exposes routes as tools.\n *\n * @example\n * ```ts\n * import { mcp, describe } from 'hono-mcp'\n *\n * const app = new Hono()\n *   .get('/users', describe('List all users', (c) => c.json([])))\n *   .get('/users/:id', describe('Get user by ID', (c) => c.json({ id: c.req.param('id') })));\n *\n * export default mcp(app, { name: 'Users API', version: '1.0.0' });\n * ```\n *\n * @example Codemode (requires Worker Loader binding)\n * ```ts\n * export default mcp(app, { name: 'API', version: '1.0.0', codemode: true });\n * ```\n *\n */\nexport function mcp<E extends Env>(app: Hono<E>, options: McpOptions): Hono<E> {\n  const { mcpPath = \"/mcp\", codemode = false, loaderBinding = \"LOADER\" } = options;\n  const routes = extractRoutes(app);\n  const serverInfo = {\n    name: options.name,\n    version: options.version,\n    ...(options.title && { title: options.title }),\n    ...(options.description && { description: options.description }),\n  };\n\n  const createServer = () =>\n    new McpServer(\n      serverInfo,\n      options.instructions\n        ? { instructions: options.instructions }\n        : codemode\n          ? {\n              instructions:\n                \"Use 'search' to find available endpoints, then 'execute' to run code against the API.\",\n            }\n          : undefined,\n    );\n\n  const handleMcp = codemode\n    ? async (c: any) => {\n        if (c.req.method === \"OPTIONS\") return new Response(null, { headers: CORS_HEADERS });\n\n        const loader = c.env?.[loaderBinding] as WorkerLoader | undefined;\n        if (!loader) {\n          return new Response(\n            `Codemode requires ${loaderBinding} binding. Add worker_loaders to wrangler.jsonc.`,\n            { status: 500 },\n          );\n        }\n\n        const server = createServer();\n        registerCodemodeTools(server, routes, app, loader);\n\n        const transport = new WebStandardStreamableHTTPServerTransport();\n        server.connect(transport);\n        return withCors(await transport.handleRequest(c.req.raw));\n      }\n    : async (c: any) => {\n        if (c.req.method === \"OPTIONS\") return new Response(null, { headers: CORS_HEADERS });\n\n        const server = createServer();\n        for (const route of routes) registerTool(server, route, app);\n\n        const transport = new WebStandardStreamableHTTPServerTransport();\n        server.connect(transport);\n        return withCors(await transport.handleRequest(c.req.raw));\n      };\n\n  app.all(`${mcpPath}/*`, handleMcp);\n  app.all(mcpPath, handleMcp);\n\n  return app;\n}\n\nfunction extractRoutes(app: Hono<any>): Route[] {\n  const routes: Route[] = [];\n  const seen = new Set<string>();\n\n  const honoRoutes = (app as any).routes as Array<{\n    path: string;\n    method: string;\n    handler: Function;\n  }>;\n\n  if (!honoRoutes) return routes;\n\n  for (const route of honoRoutes) {\n    const method = route.method.toUpperCase();\n    if (![\"GET\", \"POST\", \"PUT\", \"PATCH\", \"DELETE\"].includes(method)) continue;\n    if (route.path.startsWith(\"/mcp\")) continue;\n\n    const key = `${method} ${route.path}`;\n    if (seen.has(key)) continue;\n    seen.add(key);\n\n    const description = getDescription(route.handler) || generateDescription(method, route.path);\n    routes.push({ method: method as HttpMethod, path: route.path, description });\n  }\n\n  return routes;\n}\n\nfunction generateDescription(method: string, path: string): string {\n  const resource =\n    path\n      .split(\"/\")\n      .filter((p) => p && !p.startsWith(\":\"))\n      .pop() || \"resource\";\n  const action =\n    {\n      GET: path.includes(\":\") ? \"Get\" : \"List\",\n      POST: \"Create\",\n      PUT: \"Update\",\n      PATCH: \"Update\",\n      DELETE: \"Delete\",\n    }[method] || method;\n  return `${action} ${resource}`;\n}\n\nfunction generateToolName(method: string, path: string): string {\n  const cleanPath = path\n    .replace(/^\\//, \"\")\n    .replace(/\\/:([^/]+)/g, \"_by_$1\")\n    .replace(/\\//g, \"_\")\n    .replace(/[^a-zA-Z0-9_]/g, \"\");\n  return `${method.toLowerCase()}_${cleanPath || \"root\"}`;\n}\n\nfunction extractPathParams(path: string): string[] {\n  const matches = path.match(/:([^/]+)/g);\n  return matches ? matches.map((m) => m.slice(1)) : [];\n}\n\nfunction registerTool(server: McpServer, route: Route, app: Hono<any>): void {\n  const toolName = generateToolName(route.method, route.path);\n  const pathParams = extractPathParams(route.path);\n\n  const inputShape: Record<string, z.ZodType> = {};\n  for (const param of pathParams) {\n    inputShape[param] = z.string().describe(`Path parameter: ${param}`);\n  }\n  if ([\"POST\", \"PUT\", \"PATCH\"].includes(route.method)) {\n    inputShape[\"body\"] = z.record(z.unknown()).optional().describe(\"Request body as JSON object\");\n  }\n  if ([\"GET\", \"DELETE\"].includes(route.method)) {\n    inputShape[\"query\"] = z.record(z.string()).optional().describe(\"Query parameters\");\n  }\n\n  server.registerTool(\n    toolName,\n    {\n      description: `${route.description}\\n\\n${route.method} ${route.path}`,\n      inputSchema: Object.keys(inputShape).length > 0 ? inputShape : undefined,\n    },\n    async (params: Record<string, unknown>) => {\n      let url = route.path;\n      for (const param of pathParams) {\n        const value = params[param];\n        if (value !== undefined) {\n          url = url.replace(`:${param}`, encodeURIComponent(String(value)));\n        }\n      }\n\n      const query = params[\"query\"] as Record<string, string> | undefined;\n      if (query && Object.keys(query).length > 0) {\n        url = `${url}?${new URLSearchParams(query).toString()}`;\n      }\n\n      const body = params[\"body\"] as Record<string, unknown> | undefined;\n      const init: RequestInit = {\n        method: route.method,\n        headers: { \"Content-Type\": \"application/json\", Accept: \"application/json\" },\n      };\n      if (body && [\"POST\", \"PUT\", \"PATCH\"].includes(route.method)) {\n        init.body = JSON.stringify(body);\n      }\n\n      try {\n        const response = await app.fetch(new Request(`http://internal${url}`, init));\n        const contentType = response.headers.get(\"content-type\") || \"\";\n        const text = contentType.includes(\"application/json\")\n          ? JSON.stringify(await response.json(), null, 2)\n          : await response.text();\n        return { content: [{ type: \"text\" as const, text }], isError: !response.ok };\n      } catch (error) {\n        return {\n          content: [\n            {\n              type: \"text\" as const,\n              text: `Error: ${error instanceof Error ? error.message : String(error)}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n    },\n  );\n}\n\n// Codemode: search and execute tools\ninterface ApiEndpoint {\n  method: string;\n  path: string;\n  description: string;\n  body?: string;\n}\n\nfunction routesToApiSchema(routes: Route[]): ApiEndpoint[] {\n  return routes.map((route) => {\n    const endpoint: ApiEndpoint = {\n      method: route.method,\n      path: route.path,\n      description: route.description,\n    };\n    if ([\"POST\", \"PUT\", \"PATCH\"].includes(route.method)) {\n      endpoint.body = \"JSON object\";\n    }\n    return endpoint;\n  });\n}\n\nasync function executeSearch(\n  loader: WorkerLoader,\n  code: string,\n  apiSchema: ApiEndpoint[],\n): Promise<{ result?: unknown; error?: string }> {\n  const workerId = `search-${crypto.randomUUID()}`;\n\n  const worker = loader.get(workerId, () => ({\n    compatibilityDate: \"2026-01-14\",\n    compatibilityFlags: [\"nodejs_compat\"],\n    mainModule: \"worker.js\",\n    modules: {\n      \"worker.js\": `\n        import { WorkerEntrypoint } from \"cloudflare:workers\";\n        const endpoints = ${JSON.stringify(apiSchema)};\n        export default class SearchExecutor extends WorkerEntrypoint {\n          async evaluate() {\n            try {\n              const result = await (${code})();\n              return { result };\n            } catch (err) {\n              return { error: err.message };\n            }\n          }\n        }\n      `,\n    },\n  }));\n\n  const entrypoint = worker.getEntrypoint();\n  return (await entrypoint.evaluate()) as { result?: unknown; error?: string };\n}\n\nasync function executeCode(\n  loader: WorkerLoader,\n  code: string,\n  app: Hono<any>,\n): Promise<{ result?: unknown; error?: string }> {\n  const workerId = `execute-${crypto.randomUUID()}`;\n\n  const worker = loader.get(workerId, () => ({\n    compatibilityDate: \"2026-01-14\",\n    compatibilityFlags: [\"nodejs_compat\"],\n    mainModule: \"worker.js\",\n    modules: {\n      \"worker.js\": `\n        import { WorkerEntrypoint } from \"cloudflare:workers\";\n\n        export default class ExecuteWorker extends WorkerEntrypoint {\n          async evaluate(fetch) {\n            try {\n              const result = await (${code})();\n              return { result };\n            } catch (err) {\n              return { error: err.message };\n            }\n          }\n        }\n      `,\n    },\n  }));\n\n  const fetch = async (path: string, options: RequestInit = {}) => {\n    const response = await app.fetch(new Request(`http://internal${path}`, options));\n    const contentType = response.headers.get(\"content-type\") || \"\";\n    return contentType.includes(\"application/json\") ? response.json() : response.text();\n  };\n\n  const entrypoint = worker.getEntrypoint();\n  return (await entrypoint.evaluate(fetch)) as { result?: unknown; error?: string };\n}\n\nfunction registerCodemodeTools(\n  server: McpServer,\n  routes: Route[],\n  app: Hono<any>,\n  loader: WorkerLoader,\n): void {\n  const apiSchema = routesToApiSchema(routes);\n\n  // Search tool - discover available endpoints\n  server.registerTool(\n    \"search\",\n    {\n      description: `Search available API endpoints.\n\nAvailable in your code:\n  const endpoints = [...] // Array of { method, path, description, body? }\n\nExample:\n  async () => endpoints.filter(e => e.path.includes('users'))`,\n      inputSchema: {\n        code: z.string().describe(\"JavaScript async arrow function to search endpoints\"),\n      },\n    },\n    async ({ code }) => {\n      const result = await executeSearch(loader, code as string, apiSchema);\n      if (result.error) {\n        return {\n          content: [{ type: \"text\" as const, text: `Error: ${result.error}` }],\n          isError: true,\n        };\n      }\n      return { content: [{ type: \"text\" as const, text: JSON.stringify(result.result, null, 2) }] };\n    },\n  );\n\n  // Execute tool - run code against the API\n  server.registerTool(\n    \"execute\",\n    {\n      description: `Execute code against the API.\n\nTypes:\n  interface RequestInit {\n    method?: string;\n    headers?: Record<string, string>;\n    body?: string;\n  }\n  declare function fetch(path: string, options?: RequestInit): Promise<unknown>;\n\nExample:\n  async () => await fetch('/users')`,\n      inputSchema: { code: z.string().describe(\"JavaScript async arrow function to execute\") },\n    },\n    async ({ code }) => {\n      const result = await executeCode(loader, code as string, app);\n      if (result.error) {\n        return {\n          content: [{ type: \"text\" as const, text: `Error: ${result.error}` }],\n          isError: true,\n        };\n      }\n      return { content: [{ type: \"text\" as const, text: JSON.stringify(result.result, null, 2) }] };\n    },\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["middleware"],"sources":["../src/mcp.ts"],"sourcesContent":["import { Hono } from \"hono\";\nimport type { Context, Env, Handler, MiddlewareHandler, ValidationTargets } from \"hono\";\nimport type { RouterRoute, H } from \"hono/types\";\nimport { validator } from \"hono/validator\";\nimport { z } from \"zod\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { ToolAnnotations } from \"@modelcontextprotocol/sdk/types.js\";\nimport { WebStandardStreamableHTTPServerTransport } from \"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js\";\n\n// Configuration for registerTool()\nexport interface DescribeConfig<\n  TInput extends z.ZodRawShape = z.ZodRawShape,\n  TOutput extends z.ZodRawShape = z.ZodRawShape,\n> {\n  description: string;\n  inputSchema?: TInput;\n  outputSchema?: TOutput;\n  annotations?: ToolAnnotations;\n}\n\n// Internal metadata storage\ninterface ToolMetadata {\n  description: string;\n  inputSchema?: z.ZodRawShape;\n  outputSchema?: z.ZodRawShape;\n  annotations?: ToolAnnotations;\n}\n\nconst toolMetadata = new WeakMap<Function, ToolMetadata>();\n\n/**\n * Register a route as an MCP tool with description and optional schemas.\n * Always returns middleware - the actual handler should be a separate function.\n *\n * @example\n * ```ts\n * // Simple description\n * app.get('/users', registerTool('List all users'), (c) => c.json([]))\n *\n * // With config\n * app.get('/users', registerTool({ description: 'List all users' }), (c) => c.json([]))\n *\n * // With inputSchema - use c.req.valid('json') for typed input\n * app.post('/users',\n *   registerTool({ description: 'Create a user', inputSchema: { name: z.string() } }),\n *   async (c) => {\n *     const { name } = c.req.valid('json') // typed!\n *     return c.json({ id: 1, name })\n *   }\n * )\n * ```\n */\n// Overload: string description\nexport function registerTool(\n  description: string,\n): MiddlewareHandler;\n// Overload: config with inputSchema - provides typed validation\nexport function registerTool<TInput extends z.ZodRawShape, TOutput extends z.ZodRawShape = z.ZodRawShape>(\n  config: DescribeConfig<TInput, TOutput> & { inputSchema: TInput },\n): MiddlewareHandler<Env, string, { in: { json: z.infer<z.ZodObject<TInput>> }; out: { json: z.infer<z.ZodObject<TInput>> } }>;\n// Overload: config without inputSchema\nexport function registerTool<TOutput extends z.ZodRawShape>(\n  config: DescribeConfig<z.ZodRawShape, TOutput>,\n): MiddlewareHandler;\n// Implementation\nexport function registerTool(\n  descriptionOrConfig: string | DescribeConfig,\n): MiddlewareHandler {\n  const metadata: ToolMetadata =\n    typeof descriptionOrConfig === \"string\"\n      ? { description: descriptionOrConfig }\n      : {\n          description: descriptionOrConfig.description,\n          inputSchema: descriptionOrConfig.inputSchema,\n          outputSchema: descriptionOrConfig.outputSchema,\n          annotations: descriptionOrConfig.annotations,\n        };\n\n  // If inputSchema is defined, return validating middleware\n  if (metadata.inputSchema) {\n    const schema = z.object(metadata.inputSchema);\n    const middleware = validator(\"json\", (value) => {\n      const result = schema.safeParse(value);\n      if (!result.success) {\n        throw new Error(result.error.message);\n      }\n      return result.data;\n    });\n    toolMetadata.set(middleware, metadata);\n    return middleware;\n  }\n\n  // Otherwise return pass-through middleware that just stores metadata\n  const middleware: MiddlewareHandler = async (_c, next) => {\n    await next();\n  };\n  toolMetadata.set(middleware, metadata);\n  return middleware;\n}\n\nfunction getToolMetadata(handler: unknown): ToolMetadata | undefined {\n  if (typeof handler === \"function\") {\n    return toolMetadata.get(handler);\n  }\n  return undefined;\n}\n\nfunction getDescription(handler: unknown): string | undefined {\n  return getToolMetadata(handler)?.description;\n}\n\n// WorkerLoader interface (matches @cloudflare/workers-types)\ninterface WorkerLoader {\n  get(\n    id: string,\n    factory: () => {\n      compatibilityDate: string;\n      compatibilityFlags?: string[];\n      mainModule: string;\n      modules: Record<string, string>;\n    },\n  ): { getEntrypoint(): { evaluate: (...args: unknown[]) => Promise<unknown> } };\n}\n\nexport interface McpOptions {\n  name: string;\n  version: string;\n  title?: string;\n  description?: string;\n  instructions?: string;\n  mcpPath?: string;\n  /** Enable codemode - exposes search/execute tools instead of per-route tools. Requires LOADER binding. */\n  codemode?: boolean;\n  /** Binding name for Worker Loader (default: \"LOADER\"). Only used when codemode is true. */\n  loaderBinding?: string;\n}\n\ntype HttpMethod = \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n\ninterface Route {\n  method: HttpMethod;\n  path: string;\n  description: string;\n  handler: H;\n}\n\nconst CORS_HEADERS = {\n  \"Access-Control-Allow-Origin\": \"*\",\n  \"Access-Control-Allow-Methods\": \"GET, POST, DELETE, OPTIONS\",\n  \"Access-Control-Allow-Headers\": \"Content-Type, Accept, mcp-session-id, mcp-protocol-version\",\n  \"Access-Control-Expose-Headers\": \"mcp-session-id\",\n  \"Access-Control-Max-Age\": \"86400\",\n};\n\nfunction withCors(response: Response): Response {\n  const newHeaders = new Headers(response.headers);\n  for (const [key, value] of Object.entries(CORS_HEADERS)) {\n    newHeaders.set(key, value);\n  }\n  return new Response(response.body, {\n    status: response.status,\n    statusText: response.statusText,\n    headers: newHeaders,\n  });\n}\n\n/**\n * Wraps a Hono app to add an MCP endpoint that exposes routes as tools.\n *\n * @example\n * ```ts\n * import { mcp, describe } from 'hono-mcp'\n *\n * const app = new Hono()\n *   .get('/users', describe('List all users', (c) => c.json([])))\n *   .get('/users/:id', describe('Get user by ID', (c) => c.json({ id: c.req.param('id') })));\n *\n * export default mcp(app, { name: 'Users API', version: '1.0.0' });\n * ```\n *\n * @example Codemode (requires Worker Loader binding)\n * ```ts\n * export default mcp(app, { name: 'API', version: '1.0.0', codemode: true });\n * ```\n *\n */\nexport function mcp<E extends Env>(app: Hono<E>, options: McpOptions): Hono<E> {\n  const { mcpPath = \"/mcp\", codemode = false, loaderBinding = \"LOADER\" } = options;\n  const routes = extractRoutes(app);\n  const serverInfo = {\n    name: options.name,\n    version: options.version,\n    ...(options.title && { title: options.title }),\n    ...(options.description && { description: options.description }),\n  };\n\n  const createServer = () =>\n    new McpServer(\n      serverInfo,\n      options.instructions\n        ? { instructions: options.instructions }\n        : codemode\n          ? {\n              instructions:\n                \"Use 'search' to find available endpoints, then 'execute' to run code against the API.\",\n            }\n          : undefined,\n    );\n\n  const handleMcp = codemode\n    ? async (c: Context<E>) => {\n        if (c.req.method === \"OPTIONS\") return new Response(null, { headers: CORS_HEADERS });\n\n        const env = c.env as Record<string, unknown> | undefined;\n        const loader = env?.[loaderBinding] as WorkerLoader | undefined;\n        if (!loader) {\n          return new Response(\n            `Codemode requires ${loaderBinding} binding. Add worker_loaders to wrangler.jsonc.`,\n            { status: 500 },\n          );\n        }\n\n        const server = createServer();\n        registerCodemodeTools(server, routes, app, loader);\n\n        const transport = new WebStandardStreamableHTTPServerTransport();\n        server.connect(transport);\n        return withCors(await transport.handleRequest(c.req.raw));\n      }\n    : async (c: Context<E>) => {\n        if (c.req.method === \"OPTIONS\") return new Response(null, { headers: CORS_HEADERS });\n\n        const server = createServer();\n        for (const route of routes) registerRouteAsTool(server, route, app);\n\n        const transport = new WebStandardStreamableHTTPServerTransport();\n        server.connect(transport);\n        return withCors(await transport.handleRequest(c.req.raw));\n      };\n\n  app.all(`${mcpPath}/*`, handleMcp);\n  app.all(mcpPath, handleMcp);\n\n  return app;\n}\n\nfunction extractRoutes<E extends Env>(app: Hono<E>): Route[] {\n  const routes: Route[] = [];\n  const seen = new Set<string>();\n\n  const honoRoutes: RouterRoute[] = app.routes;\n\n  if (!honoRoutes) return routes;\n\n  for (const route of honoRoutes) {\n    const method = route.method.toUpperCase();\n    if (![\"GET\", \"POST\", \"PUT\", \"PATCH\", \"DELETE\"].includes(method)) continue;\n    if (route.path.startsWith(\"/mcp\")) continue;\n\n    const key = `${method} ${route.path}`;\n    if (seen.has(key)) continue;\n    seen.add(key);\n\n    const description = getDescription(route.handler) || generateDescription(method, route.path);\n    routes.push({ method: method as HttpMethod, path: route.path, description, handler: route.handler });\n  }\n\n  return routes;\n}\n\nfunction generateDescription(method: string, path: string): string {\n  const resource =\n    path\n      .split(\"/\")\n      .filter((p) => p && !p.startsWith(\":\"))\n      .pop() || \"resource\";\n  const action =\n    {\n      GET: path.includes(\":\") ? \"Get\" : \"List\",\n      POST: \"Create\",\n      PUT: \"Update\",\n      PATCH: \"Update\",\n      DELETE: \"Delete\",\n    }[method] || method;\n  return `${action} ${resource}`;\n}\n\nfunction generateToolName(method: string, path: string): string {\n  const cleanPath = path\n    .replace(/^\\//, \"\")\n    .replace(/\\/:([^/]+)/g, \"_by_$1\")\n    .replace(/\\//g, \"_\")\n    .replace(/[^a-zA-Z0-9_]/g, \"\");\n  return `${method.toLowerCase()}_${cleanPath || \"root\"}`;\n}\n\nfunction extractPathParams(path: string): string[] {\n  const matches = path.match(/:([^/]+)/g);\n  return matches ? matches.map((m) => m.slice(1)) : [];\n}\n\nfunction registerRouteAsTool<E extends Env>(server: McpServer, route: Route, app: Hono<E>): void {\n  const toolName = generateToolName(route.method, route.path);\n  const pathParams = extractPathParams(route.path);\n  const metadata = getToolMetadata(route.handler);\n\n  // Use metadata.inputSchema if available, otherwise generate default schema\n  let inputShape: Record<string, z.ZodType>;\n\n  if (metadata?.inputSchema) {\n    // Use the provided input schema from metadata\n    inputShape = { ...metadata.inputSchema };\n    // Still need to add path params if not already present\n    for (const param of pathParams) {\n      if (!(param in inputShape)) {\n        inputShape[param] = z.string().describe(`Path parameter: ${param}`);\n      }\n    }\n  } else {\n    // Generate default schema\n    inputShape = {};\n    for (const param of pathParams) {\n      inputShape[param] = z.string().describe(`Path parameter: ${param}`);\n    }\n    if ([\"POST\", \"PUT\", \"PATCH\"].includes(route.method)) {\n      inputShape[\"body\"] = z.record(z.unknown()).optional().describe(\"Request body as JSON object\");\n    }\n    if ([\"GET\", \"DELETE\"].includes(route.method)) {\n      inputShape[\"query\"] = z.record(z.string()).optional().describe(\"Query parameters\");\n    }\n  }\n\n  server.registerTool(\n    toolName,\n    {\n      description: `${route.description}\\n\\n${route.method} ${route.path}`,\n      inputSchema: Object.keys(inputShape).length > 0 ? inputShape : undefined,\n      ...(metadata?.outputSchema && { outputSchema: metadata.outputSchema }),\n      ...(metadata?.annotations && { annotations: metadata.annotations }),\n    },\n    async (params: Record<string, unknown>) => {\n      let url = route.path;\n      for (const param of pathParams) {\n        const value = params[param];\n        if (value !== undefined) {\n          url = url.replace(`:${param}`, encodeURIComponent(String(value)));\n        }\n      }\n\n      const query = params[\"query\"] as Record<string, string> | undefined;\n      if (query && Object.keys(query).length > 0) {\n        url = `${url}?${new URLSearchParams(query).toString()}`;\n      }\n\n      const body = params[\"body\"] as Record<string, unknown> | undefined;\n      const init: RequestInit = {\n        method: route.method,\n        headers: { \"Content-Type\": \"application/json\", Accept: \"application/json\" },\n      };\n      if (body && [\"POST\", \"PUT\", \"PATCH\"].includes(route.method)) {\n        init.body = JSON.stringify(body);\n      }\n\n      try {\n        const response = await app.fetch(new Request(`http://internal${url}`, init));\n        const contentType = response.headers.get(\"content-type\") || \"\";\n        const isJson = contentType.includes(\"application/json\");\n\n        if (isJson) {\n          const json = await response.json();\n          // Return structured content if outputSchema is defined\n          if (metadata?.outputSchema) {\n            return {\n              structuredContent: json,\n              content: [{ type: \"text\" as const, text: JSON.stringify(json, null, 2) }],\n              isError: !response.ok,\n            };\n          }\n          return {\n            content: [{ type: \"text\" as const, text: JSON.stringify(json, null, 2) }],\n            isError: !response.ok,\n          };\n        }\n\n        // Plain text response\n        const text = await response.text();\n        return { content: [{ type: \"text\" as const, text }], isError: !response.ok };\n      } catch (error) {\n        return {\n          content: [\n            {\n              type: \"text\" as const,\n              text: `Error: ${error instanceof Error ? error.message : String(error)}`,\n            },\n          ],\n          isError: true,\n        };\n      }\n    },\n  );\n}\n\n// Codemode: search and execute tools\ninterface ApiEndpoint {\n  method: string;\n  path: string;\n  description: string;\n  body?: string;\n}\n\nfunction routesToApiSchema(routes: Route[]): ApiEndpoint[] {\n  return routes.map((route) => {\n    const endpoint: ApiEndpoint = {\n      method: route.method,\n      path: route.path,\n      description: route.description,\n    };\n    if ([\"POST\", \"PUT\", \"PATCH\"].includes(route.method)) {\n      endpoint.body = \"JSON object\";\n    }\n    return endpoint;\n  });\n}\n\nasync function executeSearch(\n  loader: WorkerLoader,\n  code: string,\n  apiSchema: ApiEndpoint[],\n): Promise<{ result?: unknown; error?: string }> {\n  const workerId = `search-${crypto.randomUUID()}`;\n\n  const worker = loader.get(workerId, () => ({\n    compatibilityDate: \"2026-01-14\",\n    compatibilityFlags: [\"nodejs_compat\"],\n    mainModule: \"worker.js\",\n    modules: {\n      \"worker.js\": `\n        import { WorkerEntrypoint } from \"cloudflare:workers\";\n        const endpoints = ${JSON.stringify(apiSchema)};\n        export default class SearchExecutor extends WorkerEntrypoint {\n          async evaluate() {\n            try {\n              const result = await (${code})();\n              return { result };\n            } catch (err) {\n              return { error: err.message };\n            }\n          }\n        }\n      `,\n    },\n  }));\n\n  const entrypoint = worker.getEntrypoint();\n  return (await entrypoint.evaluate()) as { result?: unknown; error?: string };\n}\n\nasync function executeCode<E extends Env>(\n  loader: WorkerLoader,\n  code: string,\n  app: Hono<E>,\n): Promise<{ result?: unknown; error?: string }> {\n  const workerId = `execute-${crypto.randomUUID()}`;\n\n  const worker = loader.get(workerId, () => ({\n    compatibilityDate: \"2026-01-14\",\n    compatibilityFlags: [\"nodejs_compat\"],\n    mainModule: \"worker.js\",\n    modules: {\n      \"worker.js\": `\n        import { WorkerEntrypoint } from \"cloudflare:workers\";\n\n        export default class ExecuteWorker extends WorkerEntrypoint {\n          async evaluate(fetch) {\n            try {\n              const result = await (${code})();\n              return { result };\n            } catch (err) {\n              return { error: err.message };\n            }\n          }\n        }\n      `,\n    },\n  }));\n\n  const fetch = async (path: string, options: RequestInit = {}) => {\n    const response = await app.fetch(new Request(`http://internal${path}`, options));\n    const contentType = response.headers.get(\"content-type\") || \"\";\n    return contentType.includes(\"application/json\") ? response.json() : response.text();\n  };\n\n  const entrypoint = worker.getEntrypoint();\n  return (await entrypoint.evaluate(fetch)) as { result?: unknown; error?: string };\n}\n\nfunction registerCodemodeTools<E extends Env>(\n  server: McpServer,\n  routes: Route[],\n  app: Hono<E>,\n  loader: WorkerLoader,\n): void {\n  const apiSchema = routesToApiSchema(routes);\n\n  // Search tool - discover available endpoints\n  server.registerTool(\n    \"search\",\n    {\n      description: `Search available API endpoints.\n\nAvailable in your code:\n  const endpoints = [...] // Array of { method, path, description, body? }\n\nExample:\n  async () => endpoints.filter(e => e.path.includes('users'))`,\n      inputSchema: {\n        code: z.string().describe(\"JavaScript async arrow function to search endpoints\"),\n      },\n    },\n    async ({ code }) => {\n      const result = await executeSearch(loader, code as string, apiSchema);\n      if (result.error) {\n        return {\n          content: [{ type: \"text\" as const, text: `Error: ${result.error}` }],\n          isError: true,\n        };\n      }\n      return { content: [{ type: \"text\" as const, text: JSON.stringify(result.result, null, 2) }] };\n    },\n  );\n\n  // Execute tool - run code against the API\n  server.registerTool(\n    \"execute\",\n    {\n      description: `Execute code against the API.\n\nTypes:\n  interface RequestInit {\n    method?: string;\n    headers?: Record<string, string>;\n    body?: string;\n  }\n  declare function fetch(path: string, options?: RequestInit): Promise<unknown>;\n\nExample:\n  async () => await fetch('/users')`,\n      inputSchema: { code: z.string().describe(\"JavaScript async arrow function to execute\") },\n    },\n    async ({ code }) => {\n      const result = await executeCode(loader, code as string, app);\n      if (result.error) {\n        return {\n          content: [{ type: \"text\" as const, text: `Error: ${result.error}` }],\n          isError: true,\n        };\n      }\n      return { content: [{ type: \"text\" as const, text: JSON.stringify(result.result, null, 2) }] };\n    },\n  );\n}\n"],"mappings":";;;;;;AA4BA,MAAM,+BAAe,IAAI,SAAiC;AAqC1D,SAAgB,aACd,qBACmB;CACnB,MAAM,WACJ,OAAO,wBAAwB,WAC3B,EAAE,aAAa,qBAAqB,GACpC;EACE,aAAa,oBAAoB;EACjC,aAAa,oBAAoB;EACjC,cAAc,oBAAoB;EAClC,aAAa,oBAAoB;EAClC;AAGP,KAAI,SAAS,aAAa;EACxB,MAAM,SAAS,EAAE,OAAO,SAAS,YAAY;EAC7C,MAAMA,eAAa,UAAU,SAAS,UAAU;GAC9C,MAAM,SAAS,OAAO,UAAU,MAAM;AACtC,OAAI,CAAC,OAAO,QACV,OAAM,IAAI,MAAM,OAAO,MAAM,QAAQ;AAEvC,UAAO,OAAO;IACd;AACF,eAAa,IAAIA,cAAY,SAAS;AACtC,SAAOA;;CAIT,MAAM,aAAgC,OAAO,IAAI,SAAS;AACxD,QAAM,MAAM;;AAEd,cAAa,IAAI,YAAY,SAAS;AACtC,QAAO;;AAGT,SAAS,gBAAgB,SAA4C;AACnE,KAAI,OAAO,YAAY,WACrB,QAAO,aAAa,IAAI,QAAQ;;AAKpC,SAAS,eAAe,SAAsC;AAC5D,QAAO,gBAAgB,QAAQ,EAAE;;AAsCnC,MAAM,eAAe;CACnB,+BAA+B;CAC/B,gCAAgC;CAChC,gCAAgC;CAChC,iCAAiC;CACjC,0BAA0B;CAC3B;AAED,SAAS,SAAS,UAA8B;CAC9C,MAAM,aAAa,IAAI,QAAQ,SAAS,QAAQ;AAChD,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,aAAa,CACrD,YAAW,IAAI,KAAK,MAAM;AAE5B,QAAO,IAAI,SAAS,SAAS,MAAM;EACjC,QAAQ,SAAS;EACjB,YAAY,SAAS;EACrB,SAAS;EACV,CAAC;;;;;;;;;;;;;;;;;;;;;;AAuBJ,SAAgB,IAAmB,KAAc,SAA8B;CAC7E,MAAM,EAAE,UAAU,QAAQ,WAAW,OAAO,gBAAgB,aAAa;CACzE,MAAM,SAAS,cAAc,IAAI;CACjC,MAAM,aAAa;EACjB,MAAM,QAAQ;EACd,SAAS,QAAQ;EACjB,GAAI,QAAQ,SAAS,EAAE,OAAO,QAAQ,OAAO;EAC7C,GAAI,QAAQ,eAAe,EAAE,aAAa,QAAQ,aAAa;EAChE;CAED,MAAM,qBACJ,IAAI,UACF,YACA,QAAQ,eACJ,EAAE,cAAc,QAAQ,cAAc,GACtC,WACE,EACE,cACE,yFACH,GACD,OACP;CAEH,MAAM,YAAY,WACd,OAAO,MAAkB;AACvB,MAAI,EAAE,IAAI,WAAW,UAAW,QAAO,IAAI,SAAS,MAAM,EAAE,SAAS,cAAc,CAAC;EAGpF,MAAM,SADM,EAAE,MACO;AACrB,MAAI,CAAC,OACH,QAAO,IAAI,SACT,qBAAqB,cAAc,kDACnC,EAAE,QAAQ,KAAK,CAChB;EAGH,MAAM,SAAS,cAAc;AAC7B,wBAAsB,QAAQ,QAAQ,KAAK,OAAO;EAElD,MAAM,YAAY,IAAI,0CAA0C;AAChE,SAAO,QAAQ,UAAU;AACzB,SAAO,SAAS,MAAM,UAAU,cAAc,EAAE,IAAI,IAAI,CAAC;KAE3D,OAAO,MAAkB;AACvB,MAAI,EAAE,IAAI,WAAW,UAAW,QAAO,IAAI,SAAS,MAAM,EAAE,SAAS,cAAc,CAAC;EAEpF,MAAM,SAAS,cAAc;AAC7B,OAAK,MAAM,SAAS,OAAQ,qBAAoB,QAAQ,OAAO,IAAI;EAEnE,MAAM,YAAY,IAAI,0CAA0C;AAChE,SAAO,QAAQ,UAAU;AACzB,SAAO,SAAS,MAAM,UAAU,cAAc,EAAE,IAAI,IAAI,CAAC;;AAG/D,KAAI,IAAI,GAAG,QAAQ,KAAK,UAAU;AAClC,KAAI,IAAI,SAAS,UAAU;AAE3B,QAAO;;AAGT,SAAS,cAA6B,KAAuB;CAC3D,MAAM,SAAkB,EAAE;CAC1B,MAAM,uBAAO,IAAI,KAAa;CAE9B,MAAM,aAA4B,IAAI;AAEtC,KAAI,CAAC,WAAY,QAAO;AAExB,MAAK,MAAM,SAAS,YAAY;EAC9B,MAAM,SAAS,MAAM,OAAO,aAAa;AACzC,MAAI,CAAC;GAAC;GAAO;GAAQ;GAAO;GAAS;GAAS,CAAC,SAAS,OAAO,CAAE;AACjE,MAAI,MAAM,KAAK,WAAW,OAAO,CAAE;EAEnC,MAAM,MAAM,GAAG,OAAO,GAAG,MAAM;AAC/B,MAAI,KAAK,IAAI,IAAI,CAAE;AACnB,OAAK,IAAI,IAAI;EAEb,MAAM,cAAc,eAAe,MAAM,QAAQ,IAAI,oBAAoB,QAAQ,MAAM,KAAK;AAC5F,SAAO,KAAK;GAAU;GAAsB,MAAM,MAAM;GAAM;GAAa,SAAS,MAAM;GAAS,CAAC;;AAGtG,QAAO;;AAGT,SAAS,oBAAoB,QAAgB,MAAsB;CACjE,MAAM,WACJ,KACG,MAAM,IAAI,CACV,QAAQ,MAAM,KAAK,CAAC,EAAE,WAAW,IAAI,CAAC,CACtC,KAAK,IAAI;AASd,QAAO,GAPL;EACE,KAAK,KAAK,SAAS,IAAI,GAAG,QAAQ;EAClC,MAAM;EACN,KAAK;EACL,OAAO;EACP,QAAQ;EACT,CAAC,WAAW,OACE,GAAG;;AAGtB,SAAS,iBAAiB,QAAgB,MAAsB;CAC9D,MAAM,YAAY,KACf,QAAQ,OAAO,GAAG,CAClB,QAAQ,eAAe,SAAS,CAChC,QAAQ,OAAO,IAAI,CACnB,QAAQ,kBAAkB,GAAG;AAChC,QAAO,GAAG,OAAO,aAAa,CAAC,GAAG,aAAa;;AAGjD,SAAS,kBAAkB,MAAwB;CACjD,MAAM,UAAU,KAAK,MAAM,YAAY;AACvC,QAAO,UAAU,QAAQ,KAAK,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE;;AAGtD,SAAS,oBAAmC,QAAmB,OAAc,KAAoB;CAC/F,MAAM,WAAW,iBAAiB,MAAM,QAAQ,MAAM,KAAK;CAC3D,MAAM,aAAa,kBAAkB,MAAM,KAAK;CAChD,MAAM,WAAW,gBAAgB,MAAM,QAAQ;CAG/C,IAAI;AAEJ,KAAI,UAAU,aAAa;AAEzB,eAAa,EAAE,GAAG,SAAS,aAAa;AAExC,OAAK,MAAM,SAAS,WAClB,KAAI,EAAE,SAAS,YACb,YAAW,SAAS,EAAE,QAAQ,CAAC,SAAS,mBAAmB,QAAQ;QAGlE;AAEL,eAAa,EAAE;AACf,OAAK,MAAM,SAAS,WAClB,YAAW,SAAS,EAAE,QAAQ,CAAC,SAAS,mBAAmB,QAAQ;AAErE,MAAI;GAAC;GAAQ;GAAO;GAAQ,CAAC,SAAS,MAAM,OAAO,CACjD,YAAW,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,UAAU,CAAC,SAAS,8BAA8B;AAE/F,MAAI,CAAC,OAAO,SAAS,CAAC,SAAS,MAAM,OAAO,CAC1C,YAAW,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,SAAS,mBAAmB;;AAItF,QAAO,aACL,UACA;EACE,aAAa,GAAG,MAAM,YAAY,MAAM,MAAM,OAAO,GAAG,MAAM;EAC9D,aAAa,OAAO,KAAK,WAAW,CAAC,SAAS,IAAI,aAAa;EAC/D,GAAI,UAAU,gBAAgB,EAAE,cAAc,SAAS,cAAc;EACrE,GAAI,UAAU,eAAe,EAAE,aAAa,SAAS,aAAa;EACnE,EACD,OAAO,WAAoC;EACzC,IAAI,MAAM,MAAM;AAChB,OAAK,MAAM,SAAS,YAAY;GAC9B,MAAM,QAAQ,OAAO;AACrB,OAAI,UAAU,OACZ,OAAM,IAAI,QAAQ,IAAI,SAAS,mBAAmB,OAAO,MAAM,CAAC,CAAC;;EAIrE,MAAM,QAAQ,OAAO;AACrB,MAAI,SAAS,OAAO,KAAK,MAAM,CAAC,SAAS,EACvC,OAAM,GAAG,IAAI,GAAG,IAAI,gBAAgB,MAAM,CAAC,UAAU;EAGvD,MAAM,OAAO,OAAO;EACpB,MAAM,OAAoB;GACxB,QAAQ,MAAM;GACd,SAAS;IAAE,gBAAgB;IAAoB,QAAQ;IAAoB;GAC5E;AACD,MAAI,QAAQ;GAAC;GAAQ;GAAO;GAAQ,CAAC,SAAS,MAAM,OAAO,CACzD,MAAK,OAAO,KAAK,UAAU,KAAK;AAGlC,MAAI;GACF,MAAM,WAAW,MAAM,IAAI,MAAM,IAAI,QAAQ,kBAAkB,OAAO,KAAK,CAAC;AAI5E,QAHoB,SAAS,QAAQ,IAAI,eAAe,IAAI,IACjC,SAAS,mBAAmB,EAE3C;IACV,MAAM,OAAO,MAAM,SAAS,MAAM;AAElC,QAAI,UAAU,aACZ,QAAO;KACL,mBAAmB;KACnB,SAAS,CAAC;MAAE,MAAM;MAAiB,MAAM,KAAK,UAAU,MAAM,MAAM,EAAE;MAAE,CAAC;KACzE,SAAS,CAAC,SAAS;KACpB;AAEH,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAiB,MAAM,KAAK,UAAU,MAAM,MAAM,EAAE;MAAE,CAAC;KACzE,SAAS,CAAC,SAAS;KACpB;;AAKH,UAAO;IAAE,SAAS,CAAC;KAAE,MAAM;KAAiB,MAD/B,MAAM,SAAS,MAAM;KACgB,CAAC;IAAE,SAAS,CAAC,SAAS;IAAI;WACrE,OAAO;AACd,UAAO;IACL,SAAS,CACP;KACE,MAAM;KACN,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;KACvE,CACF;IACD,SAAS;IACV;;GAGN;;AAWH,SAAS,kBAAkB,QAAgC;AACzD,QAAO,OAAO,KAAK,UAAU;EAC3B,MAAM,WAAwB;GAC5B,QAAQ,MAAM;GACd,MAAM,MAAM;GACZ,aAAa,MAAM;GACpB;AACD,MAAI;GAAC;GAAQ;GAAO;GAAQ,CAAC,SAAS,MAAM,OAAO,CACjD,UAAS,OAAO;AAElB,SAAO;GACP;;AAGJ,eAAe,cACb,QACA,MACA,WAC+C;CAC/C,MAAM,WAAW,UAAU,OAAO,YAAY;AAyB9C,QAAQ,MAvBO,OAAO,IAAI,iBAAiB;EACzC,mBAAmB;EACnB,oBAAoB,CAAC,gBAAgB;EACrC,YAAY;EACZ,SAAS,EACP,aAAa;;4BAES,KAAK,UAAU,UAAU,CAAC;;;;sCAIhB,KAAK;;;;;;;SAQtC;EACF,EAAE,CAEuB,eAAe,CAChB,UAAU;;AAGrC,eAAe,YACb,QACA,MACA,KAC+C;CAC/C,MAAM,WAAW,WAAW,OAAO,YAAY;CAE/C,MAAM,SAAS,OAAO,IAAI,iBAAiB;EACzC,mBAAmB;EACnB,oBAAoB,CAAC,gBAAgB;EACrC,YAAY;EACZ,SAAS,EACP,aAAa;;;;;;sCAMmB,KAAK;;;;;;;SAQtC;EACF,EAAE;CAEH,MAAM,QAAQ,OAAO,MAAc,UAAuB,EAAE,KAAK;EAC/D,MAAM,WAAW,MAAM,IAAI,MAAM,IAAI,QAAQ,kBAAkB,QAAQ,QAAQ,CAAC;AAEhF,UADoB,SAAS,QAAQ,IAAI,eAAe,IAAI,IACzC,SAAS,mBAAmB,GAAG,SAAS,MAAM,GAAG,SAAS,MAAM;;AAIrF,QAAQ,MADW,OAAO,eAAe,CAChB,SAAS,MAAM;;AAG1C,SAAS,sBACP,QACA,QACA,KACA,QACM;CACN,MAAM,YAAY,kBAAkB,OAAO;AAG3C,QAAO,aACL,UACA;EACE,aAAa;;;;;;;EAOb,aAAa,EACX,MAAM,EAAE,QAAQ,CAAC,SAAS,sDAAsD,EACjF;EACF,EACD,OAAO,EAAE,WAAW;EAClB,MAAM,SAAS,MAAM,cAAc,QAAQ,MAAgB,UAAU;AACrE,MAAI,OAAO,MACT,QAAO;GACL,SAAS,CAAC;IAAE,MAAM;IAAiB,MAAM,UAAU,OAAO;IAAS,CAAC;GACpE,SAAS;GACV;AAEH,SAAO,EAAE,SAAS,CAAC;GAAE,MAAM;GAAiB,MAAM,KAAK,UAAU,OAAO,QAAQ,MAAM,EAAE;GAAE,CAAC,EAAE;GAEhG;AAGD,QAAO,aACL,WACA;EACE,aAAa;;;;;;;;;;;;EAYb,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,SAAS,6CAA6C,EAAE;EACzF,EACD,OAAO,EAAE,WAAW;EAClB,MAAM,SAAS,MAAM,YAAY,QAAQ,MAAgB,IAAI;AAC7D,MAAI,OAAO,MACT,QAAO;GACL,SAAS,CAAC;IAAE,MAAM;IAAiB,MAAM,UAAU,OAAO;IAAS,CAAC;GACpE,SAAS;GACV;AAEH,SAAO,EAAE,SAAS,CAAC;GAAE,MAAM;GAAiB,MAAM,KAAK,UAAU,OAAO,QAAQ,MAAM,EAAE;GAAE,CAAC,EAAE;GAEhG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hono-mcp-server",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "hono app as mcp server",
   "keywords": [
     "api",

package/src/index.ts

@@ -1,2 +1,2 @@
-export { mcp, describe } from "./mcp";
-export type { McpOptions } from "./mcp";
+export { mcp, registerTool } from "./mcp";
+export type { McpOptions, DescribeConfig } from "./mcp";

package/src/mcp.test.ts

@@ -1,6 +1,7 @@
 import { describe as testDescribe, it, expect } from "vitest";
 import { Hono } from "hono";
-import { mcp, describe } from "./mcp";
+import { z } from "zod";
+import { mcp, registerTool } from "./mcp";
 
 testDescribe("mcp", () => {
   it("adds /mcp endpoint to app", async () => {
@@ -64,10 +65,7 @@ testDescribe("mcp", () => {
   });
 
   it("uses custom descriptions from describe()", async () => {
-    const app = new Hono().get(
-      "/users",
-      describe("My custom description", (c) => c.json([])),
-    );
+    const app = new Hono().get("/users", registerTool("My custom description"), (c) => c.json([]));
 
     const wrapped = mcp(app, { name: "Test", version: "1.0.0" });
 
@@ -138,7 +136,6 @@ testDescribe("mcp", () => {
     );
 
     const text = await res.text();
-    // JSON is escaped in the MCP response
     expect(text).toContain('\\"id\\": \\"42\\"');
     expect(text).toContain("Bob");
   });
@@ -493,12 +490,117 @@ testDescribe("mcp", () => {
   });
 });
 
-testDescribe("describe", () => {
-  it("attaches description to handler", () => {
-    const handler = (c: any) => c.json([]);
-    const described = describe("Test description", handler);
+testDescribe("registerTool", () => {
+  it("returns middleware with string description", () => {
+    const middleware = registerTool("Test description");
+    expect(typeof middleware).toBe("function");
+  });
+
+  it("returns middleware with config object", () => {
+    const middleware = registerTool({ description: "Test description" });
+    expect(typeof middleware).toBe("function");
+  });
+
+  it("uses inputSchema from describe config", async () => {
+    const app = new Hono().post(
+      "/users",
+      registerTool({
+        description: "Create a new user",
+        inputSchema: {
+          name: z.string().describe("User name"),
+          email: z.string().email().describe("User email"),
+        },
+      }),
+      async (c) => {
+        const { name } = c.req.valid("json");
+        return c.json({ id: 1, name });
+      },
+    );
+
+    const wrapped = mcp(app, { name: "Test", version: "1.0.0" });
+
+    const res = await wrapped.fetch(
+      new Request("http://localhost/mcp", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Accept: "application/json, text/event-stream",
+        },
+        body: JSON.stringify({
+          jsonrpc: "2.0",
+          id: 1,
+          method: "tools/list",
+          params: {},
+        }),
+      }),
+    );
+
+    const text = await res.text();
+    expect(text).toContain("Create a new user");
+    expect(text).toContain("name");
+    expect(text).toContain("email");
+    expect(text).toContain("User name");
+    expect(text).toContain("User email");
+  });
+
+  it("returns structuredContent when outputSchema is defined", async () => {
+    const app = new Hono().get(
+      "/users",
+      registerTool({
+        description: "List users",
+        outputSchema: {
+          users: z.array(z.object({ id: z.number(), name: z.string() })),
+        },
+      }),
+      (c) => c.json({ users: [{ id: 1, name: "Alice" }] }),
+    );
+
+    const wrapped = mcp(app, { name: "Test", version: "1.0.0" });
 
-    expect(described).toBe(handler);
-    // The description is stored on the handler
+    const res = await wrapped.fetch(
+      new Request("http://localhost/mcp", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Accept: "application/json, text/event-stream",
+        },
+        body: JSON.stringify({
+          jsonrpc: "2.0",
+          id: 1,
+          method: "tools/call",
+          params: { name: "get_users", arguments: {} },
+        }),
+      }),
+    );
+
+    const text = await res.text();
+    expect(text).toContain("structuredContent");
+    expect(text).toContain("Alice");
+  });
+
+  it("returns plain text for text responses", async () => {
+    const app = new Hono().get("/hello", registerTool("Say hello"), (c) => c.text("Hello, World!"));
+
+    const wrapped = mcp(app, { name: "Test", version: "1.0.0" });
+
+    const res = await wrapped.fetch(
+      new Request("http://localhost/mcp", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Accept: "application/json, text/event-stream",
+        },
+        body: JSON.stringify({
+          jsonrpc: "2.0",
+          id: 1,
+          method: "tools/call",
+          params: { name: "get_hello", arguments: {} },
+        }),
+      }),
+    );
+
+    const text = await res.text();
+    expect(text).toContain("Hello, World!");
+    expect(text).not.toContain("structuredContent");
   });
 });

package/src/mcp.ts

@@ -1,26 +1,112 @@
 import { Hono } from "hono";
-import type { Env, Handler } from "hono";
+import type { Context, Env, Handler, MiddlewareHandler, ValidationTargets } from "hono";
+import type { RouterRoute, H } from "hono/types";
+import { validator } from "hono/validator";
 import { z } from "zod";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolAnnotations } from "@modelcontextprotocol/sdk/types.js";
 import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
 
-const MCP_DESCRIPTION = Symbol("mcp_description");
+// Configuration for registerTool()
+export interface DescribeConfig<
+  TInput extends z.ZodRawShape = z.ZodRawShape,
+  TOutput extends z.ZodRawShape = z.ZodRawShape,
+> {
+  description: string;
+  inputSchema?: TInput;
+  outputSchema?: TOutput;
+  annotations?: ToolAnnotations;
+}
+
+// Internal metadata storage
+interface ToolMetadata {
+  description: string;
+  inputSchema?: z.ZodRawShape;
+  outputSchema?: z.ZodRawShape;
+  annotations?: ToolAnnotations;
+}
+
+const toolMetadata = new WeakMap<Function, ToolMetadata>();
 
 /**
- * Add a description to a route handler for MCP tool generation.
+ * Register a route as an MCP tool with description and optional schemas.
+ * Always returns middleware - the actual handler should be a separate function.
  *
  * @example
  * ```ts
- * app.get('/users', describe('List all users', (c) => c.json([])))
+ * // Simple description
+ * app.get('/users', registerTool('List all users'), (c) => c.json([]))
+ *
+ * // With config
+ * app.get('/users', registerTool({ description: 'List all users' }), (c) => c.json([]))
+ *
+ * // With inputSchema - use c.req.valid('json') for typed input
+ * app.post('/users',
+ *   registerTool({ description: 'Create a user', inputSchema: { name: z.string() } }),
+ *   async (c) => {
+ *     const { name } = c.req.valid('json') // typed!
+ *     return c.json({ id: 1, name })
+ *   }
+ * )
  * ```
  */
-export function describe<H extends Handler>(description: string, handler: H): H {
-  (handler as any)[MCP_DESCRIPTION] = description;
-  return handler;
+// Overload: string description
+export function registerTool(
+  description: string,
+): MiddlewareHandler;
+// Overload: config with inputSchema - provides typed validation
+export function registerTool<TInput extends z.ZodRawShape, TOutput extends z.ZodRawShape = z.ZodRawShape>(
+  config: DescribeConfig<TInput, TOutput> & { inputSchema: TInput },
+): MiddlewareHandler<Env, string, { in: { json: z.infer<z.ZodObject<TInput>> }; out: { json: z.infer<z.ZodObject<TInput>> } }>;
+// Overload: config without inputSchema
+export function registerTool<TOutput extends z.ZodRawShape>(
+  config: DescribeConfig<z.ZodRawShape, TOutput>,
+): MiddlewareHandler;
+// Implementation
+export function registerTool(
+  descriptionOrConfig: string | DescribeConfig,
+): MiddlewareHandler {
+  const metadata: ToolMetadata =
+    typeof descriptionOrConfig === "string"
+      ? { description: descriptionOrConfig }
+      : {
+          description: descriptionOrConfig.description,
+          inputSchema: descriptionOrConfig.inputSchema,
+          outputSchema: descriptionOrConfig.outputSchema,
+          annotations: descriptionOrConfig.annotations,
+        };
+
+  // If inputSchema is defined, return validating middleware
+  if (metadata.inputSchema) {
+    const schema = z.object(metadata.inputSchema);
+    const middleware = validator("json", (value) => {
+      const result = schema.safeParse(value);
+      if (!result.success) {
+        throw new Error(result.error.message);
+      }
+      return result.data;
+    });
+    toolMetadata.set(middleware, metadata);
+    return middleware;
+  }
+
+  // Otherwise return pass-through middleware that just stores metadata
+  const middleware: MiddlewareHandler = async (_c, next) => {
+    await next();
+  };
+  toolMetadata.set(middleware, metadata);
+  return middleware;
+}
+
+function getToolMetadata(handler: unknown): ToolMetadata | undefined {
+  if (typeof handler === "function") {
+    return toolMetadata.get(handler);
+  }
+  return undefined;
 }
 
 function getDescription(handler: unknown): string | undefined {
-  return (handler as any)?.[MCP_DESCRIPTION];
+  return getToolMetadata(handler)?.description;
 }
 
 // WorkerLoader interface (matches @cloudflare/workers-types)
@@ -55,6 +141,7 @@ interface Route {
   method: HttpMethod;
   path: string;
   description: string;
+  handler: H;
 }
 
 const CORS_HEADERS = {
@@ -121,10 +208,11 @@ export function mcp<E extends Env>(app: Hono<E>, options: McpOptions): Hono<E> {
     );
 
   const handleMcp = codemode
-    ? async (c: any) => {
+    ? async (c: Context<E>) => {
         if (c.req.method === "OPTIONS") return new Response(null, { headers: CORS_HEADERS });
 
-        const loader = c.env?.[loaderBinding] as WorkerLoader | undefined;
+        const env = c.env as Record<string, unknown> | undefined;
+        const loader = env?.[loaderBinding] as WorkerLoader | undefined;
         if (!loader) {
           return new Response(
             `Codemode requires ${loaderBinding} binding. Add worker_loaders to wrangler.jsonc.`,
@@ -139,11 +227,11 @@ export function mcp<E extends Env>(app: Hono<E>, options: McpOptions): Hono<E> {
         server.connect(transport);
         return withCors(await transport.handleRequest(c.req.raw));
       }
-    : async (c: any) => {
+    : async (c: Context<E>) => {
         if (c.req.method === "OPTIONS") return new Response(null, { headers: CORS_HEADERS });
 
         const server = createServer();
-        for (const route of routes) registerTool(server, route, app);
+        for (const route of routes) registerRouteAsTool(server, route, app);
 
         const transport = new WebStandardStreamableHTTPServerTransport();
         server.connect(transport);
@@ -156,15 +244,11 @@ export function mcp<E extends Env>(app: Hono<E>, options: McpOptions): Hono<E> {
   return app;
 }
 
-function extractRoutes(app: Hono<any>): Route[] {
+function extractRoutes<E extends Env>(app: Hono<E>): Route[] {
   const routes: Route[] = [];
   const seen = new Set<string>();
 
-  const honoRoutes = (app as any).routes as Array<{
-    path: string;
-    method: string;
-    handler: Function;
-  }>;
+  const honoRoutes: RouterRoute[] = app.routes;
 
   if (!honoRoutes) return routes;
 
@@ -178,7 +262,7 @@ function extractRoutes(app: Hono<any>): Route[] {
     seen.add(key);
 
     const description = getDescription(route.handler) || generateDescription(method, route.path);
-    routes.push({ method: method as HttpMethod, path: route.path, description });
+    routes.push({ method: method as HttpMethod, path: route.path, description, handler: route.handler });
   }
 
   return routes;
@@ -215,19 +299,35 @@ function extractPathParams(path: string): string[] {
   return matches ? matches.map((m) => m.slice(1)) : [];
 }
 
-function registerTool(server: McpServer, route: Route, app: Hono<any>): void {
+function registerRouteAsTool<E extends Env>(server: McpServer, route: Route, app: Hono<E>): void {
   const toolName = generateToolName(route.method, route.path);
   const pathParams = extractPathParams(route.path);
-
-  const inputShape: Record<string, z.ZodType> = {};
-  for (const param of pathParams) {
-    inputShape[param] = z.string().describe(`Path parameter: ${param}`);
-  }
-  if (["POST", "PUT", "PATCH"].includes(route.method)) {
-    inputShape["body"] = z.record(z.unknown()).optional().describe("Request body as JSON object");
-  }
-  if (["GET", "DELETE"].includes(route.method)) {
-    inputShape["query"] = z.record(z.string()).optional().describe("Query parameters");
+  const metadata = getToolMetadata(route.handler);
+
+  // Use metadata.inputSchema if available, otherwise generate default schema
+  let inputShape: Record<string, z.ZodType>;
+
+  if (metadata?.inputSchema) {
+    // Use the provided input schema from metadata
+    inputShape = { ...metadata.inputSchema };
+    // Still need to add path params if not already present
+    for (const param of pathParams) {
+      if (!(param in inputShape)) {
+        inputShape[param] = z.string().describe(`Path parameter: ${param}`);
+      }
+    }
+  } else {
+    // Generate default schema
+    inputShape = {};
+    for (const param of pathParams) {
+      inputShape[param] = z.string().describe(`Path parameter: ${param}`);
+    }
+    if (["POST", "PUT", "PATCH"].includes(route.method)) {
+      inputShape["body"] = z.record(z.unknown()).optional().describe("Request body as JSON object");
+    }
+    if (["GET", "DELETE"].includes(route.method)) {
+      inputShape["query"] = z.record(z.string()).optional().describe("Query parameters");
+    }
   }
 
   server.registerTool(
@@ -235,6 +335,8 @@ function registerTool(server: McpServer, route: Route, app: Hono<any>): void {
     {
       description: `${route.description}\n\n${route.method} ${route.path}`,
       inputSchema: Object.keys(inputShape).length > 0 ? inputShape : undefined,
+      ...(metadata?.outputSchema && { outputSchema: metadata.outputSchema }),
+      ...(metadata?.annotations && { annotations: metadata.annotations }),
     },
     async (params: Record<string, unknown>) => {
       let url = route.path;
@@ -262,9 +364,26 @@ function registerTool(server: McpServer, route: Route, app: Hono<any>): void {
       try {
         const response = await app.fetch(new Request(`http://internal${url}`, init));
         const contentType = response.headers.get("content-type") || "";
-        const text = contentType.includes("application/json")
-          ? JSON.stringify(await response.json(), null, 2)
-          : await response.text();
+        const isJson = contentType.includes("application/json");
+
+        if (isJson) {
+          const json = await response.json();
+          // Return structured content if outputSchema is defined
+          if (metadata?.outputSchema) {
+            return {
+              structuredContent: json,
+              content: [{ type: "text" as const, text: JSON.stringify(json, null, 2) }],
+              isError: !response.ok,
+            };
+          }
+          return {
+            content: [{ type: "text" as const, text: JSON.stringify(json, null, 2) }],
+            isError: !response.ok,
+          };
+        }
+
+        // Plain text response
+        const text = await response.text();
         return { content: [{ type: "text" as const, text }], isError: !response.ok };
       } catch (error) {
         return {
@@ -336,10 +455,10 @@ async function executeSearch(
   return (await entrypoint.evaluate()) as { result?: unknown; error?: string };
 }
 
-async function executeCode(
+async function executeCode<E extends Env>(
   loader: WorkerLoader,
   code: string,
-  app: Hono<any>,
+  app: Hono<E>,
 ): Promise<{ result?: unknown; error?: string }> {
   const workerId = `execute-${crypto.randomUUID()}`;
 
@@ -375,10 +494,10 @@ async function executeCode(
   return (await entrypoint.evaluate(fetch)) as { result?: unknown; error?: string };
 }
 
-function registerCodemodeTools(
+function registerCodemodeTools<E extends Env>(
   server: McpServer,
   routes: Route[],
-  app: Hono<any>,
+  app: Hono<E>,
   loader: WorkerLoader,
 ): void {
   const apiSchema = routesToApiSchema(routes);