IT WORKS

Author: jahands

apps/workers-builds/src/index.ts

@@ -15,7 +15,7 @@ import { registerAccountTools } from '@repo/mcp-common/src/tools/account'
 import { registerWorkersTools } from '@repo/mcp-common/src/tools/worker'
 
 import { MetricsTracker } from '../../../packages/mcp-observability/src'
-import { registerBuildsTools } from './tools/builds'
+import { registerBuildsTools } from './tools/workers-builds.tools'
 
 import type { AuthProps } from '@repo/mcp-common/src/cloudflare-oauth-handler'
 import type { Env } from './context'

apps/workers-builds/src/tools/builds.ts

@@ -0,0 +1,122 @@
+import { z } from 'zod'
+
+import {
+	getBuildErrorReason,
+	getLatestWorkersBuild,
+} from '@repo/mcp-common/src/api/workers-builds.api'
+
+import type { BuildsMCP } from '../index'
+
+/**
+ * Registers the logs analysis tool with the MCP server
+ * @param server The MCP server instance
+ * @param accountId Cloudflare account ID
+ * @param apiToken Cloudflare API token
+ */
+export function registerBuildsTools(agent: BuildsMCP) {
+	agent.server.tool(
+		'get_latest_workers_build',
+		`
+Use the Workers Builds API to get the latest build for a Cloudflare Worker.
+
+If the build failed, use get_workers_build_failure_reason to determine why it failed.
+`.trim(),
+
+		{
+			scriptId: z.string(),
+		},
+		async ({ scriptId }) => {
+			const accountId = await agent.getActiveAccountId()
+			if (!accountId) {
+				return {
+					content: [
+						{
+							type: 'text',
+							text: 'No currently active accountId. Try listing your accounts (accounts_list) and then setting an active account (set_active_account)',
+						},
+					],
+				}
+			}
+
+			try {
+				const res = await getLatestWorkersBuild({
+					apiToken: agent.props.accessToken,
+					accountId,
+					scriptId,
+				})
+				return {
+					content: [
+						{
+							type: 'text',
+							text: JSON.stringify(res),
+						},
+					],
+				}
+			} catch (error) {
+				return {
+					content: [
+						{
+							type: 'text',
+							text: JSON.stringify({
+								error: `Error getting build: ${error instanceof Error && error.message}`,
+							}),
+						},
+					],
+				}
+			}
+		}
+	)
+
+	agent.server.tool(
+		'get_workers_build_failure_reason',
+		`
+Use the Workers Builds API to get the latest build for a Cloudflare Worker.
+
+If the build failed, use get_build_failure_reason to determine why it failed.
+`.trim(),
+
+		{
+			buildUUID: z.string(),
+		},
+		async ({ buildUUID }) => {
+			const accountId = await agent.getActiveAccountId()
+			if (!accountId) {
+				return {
+					content: [
+						{
+							type: 'text',
+							text: 'No currently active accountId. Try listing your accounts (accounts_list) and then setting an active account (set_active_account)',
+						},
+					],
+				}
+			}
+
+			try {
+				const res = await getBuildErrorReason({
+					apiToken: agent.props.accessToken,
+					accountId,
+					buildUUID,
+				})
+				return {
+					content: [
+						{
+							type: 'text',
+							text: res,
+						},
+					],
+				}
+			} catch (error) {
+				return {
+					content: [
+						{
+							type: 'text',
+							text: JSON.stringify({
+								error: `Error getting build failure reason: ${error instanceof Error && error.message}`,
+							}),
+						},
+					],
+				}
+			}
+		}
+	)
+}

apps/workers-builds/src/tools/workers-builds.tools.ts

@@ -29,3 +29,37 @@ export async function getLatestWorkersBuild({
 	}
 	return build
 }
+
+export async function getBuildErrorReason({
+	apiToken,
+	accountId,
+	buildUUID,
+}: {
+	apiToken: string
+	accountId: string
+	buildUUID: string
+}) {
+	return `
+You are a debugging machine!
+
+You will be provided information about a Cloudflare Workers Build and you will need to debug it.
+
+For now, you can only validate that the user has remembered to provide a wrangler configuration file.
+If the build failed for an unrelated reason, just say "build failed for an unknown reason. check logs for more info".
+
+If the user forgot the wrangler file, suggest a new 'wrangler.jsonc' based on the following template.
+Use the build details and local files (if available) to determine the correct entrypoint.
+
+If you have access to create the file, go ahead and create it instead of just suggesting it.
+
+{
+  "name": "<fill in the name of the worker>",
+  "main": "<find the correct main entrypoint file based on the framework>",
+  "compatibility_date": "2025-04-28",
+  "compatibility_flags": ["nodejs_compat"],
+  "observability": {
+    "enabled": true
+  }
+}
+	`.trim()
+}