@cronwatch/mcp 0.1.0

package/README.md

@@ -0,0 +1,37 @@
+# @cronwatch/mcp
+
+An MCP server for apps that use [`@cronwatch/sdk`](https://www.npmjs.com/package/@cronwatch/sdk). It talks to the JSON API the app mounts with `cw.routes()`, so Claude Code, Cursor or any MCP client can list jobs, read a failing run's error and output, run a check, and silence a job during a fix.
+
+```bash
+claude mcp add cronwatch \
+  -e CRONWATCH_URL=https://app.example.com/cronwatch \
+  -e CRONWATCH_TOKEN=your-token \
+  -- npx -y @cronwatch/mcp
+```
+
+Any stdio MCP client:
+
+```json
+{
+  "mcpServers": {
+    "cronwatch": {
+      "command": "npx",
+      "args": ["-y", "@cronwatch/mcp"],
+      "env": { "CRONWATCH_URL": "https://app.example.com/cronwatch", "CRONWATCH_TOKEN": "your-token" }
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | |
+|---|---|
+| `list_jobs` | every job with health, schedule, last run and next due |
+| `get_job` | one job with recent runs: errors, output tails, metrics |
+| `run_check` | look for missed and stuck runs now and send due alerts |
+| `silence_job`, `unsilence_job` | pause and resume alerts for a job |
+| `forget_job` | remove a job that no longer exists in the code |
+| `get_setup_guide` | the code to add CronWatch to a job |
+
+The token grants everything the dashboard can do. Docs: [cronwatch.dev/docs/mcp](https://cronwatch.dev/docs/mcp/). MIT.

package/dist/cli.js

@@ -0,0 +1,285 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+// src/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+
+// src/client.ts
+var ApiError = class extends Error {
+  constructor(message, status) {
+    super(message);
+    this.status = status;
+    this.name = "ApiError";
+  }
+  status;
+};
+var ApiClient = class {
+  base;
+  token;
+  fetchFn;
+  constructor(options) {
+    this.base = options.baseUrl.replace(/\/+$/, "");
+    this.token = options.token;
+    this.fetchFn = options.fetch ?? fetch;
+  }
+  async call(method, path, body) {
+    const headers = { accept: "application/json" };
+    if (this.token) headers.authorization = `Bearer ${this.token}`;
+    if (body !== void 0) headers["content-type"] = "application/json";
+    const response = await this.fetchFn(`${this.base}/api${path}`, {
+      method,
+      headers,
+      body: body === void 0 ? void 0 : JSON.stringify(body)
+    });
+    const text = await response.text();
+    let data = null;
+    try {
+      data = text ? JSON.parse(text) : null;
+    } catch {
+      throw new ApiError(`${method} ${path} answered ${response.status} with a non-JSON body: ${text.slice(0, 200)}`, response.status);
+    }
+    if (!response.ok) {
+      const message = typeof data === "object" && data && "error" in data ? String(data.error) : response.statusText;
+      throw new ApiError(`${method} ${path} failed (${response.status}): ${message}`, response.status);
+    }
+    return data;
+  }
+};
+
+// src/server.ts
+var VERSION = "0.1.0";
+function iso(at) {
+  return at === null ? "never" : new Date(at).toISOString();
+}
+function ms(v) {
+  if (v === null) return "?";
+  if (v < 1e3) return `${v}ms`;
+  if (v < 6e4) return `${(v / 1e3).toFixed(1)}s`;
+  return `${Math.round(v / 6e4)}m`;
+}
+function summarizeJob(j) {
+  const bits = [
+    `${j.name}: ${j.health}${j.open.length ? ` (open: ${j.open.join(", ")})` : ""}`,
+    `  schedule: ${j.definition.schedule ?? "none"}`,
+    `  last run: ${j.lastRun ? j.lastRun.status === "running" ? `running since ${iso(j.lastRun.startedAt)}` : `${j.lastRun.status} at ${iso(j.lastRun.startedAt)}, ${ms(j.lastRun.durationMs)}` : "never"}`,
+    `  next due: ${iso(j.nextExpectedAt)}`,
+    `  last ${j.stats.runs} runs: ${Math.round(j.stats.okRate * 100)}% ok, p50 ${ms(j.stats.p50Ms)}, p95 ${ms(j.stats.p95Ms)}`
+  ];
+  if (j.consecutiveFailures) bits.push(`  consecutive failures: ${j.consecutiveFailures}`);
+  if (j.silencedUntil && j.silencedUntil > Date.now()) bits.push(`  silenced until ${iso(j.silencedUntil)}`);
+  if (j.definition.description) bits.push(`  ${j.definition.description}`);
+  return bits.join("\n");
+}
+function summarizeRun(r) {
+  const head = `${r.status} at ${iso(r.startedAt)}, ${ms(r.durationMs)}, trigger ${r.trigger}, id ${r.id}`;
+  const parts = [head];
+  if (Object.keys(r.metrics).length) parts.push(`  metrics: ${JSON.stringify(r.metrics)}`);
+  if (r.error) parts.push(`  error: ${r.error.split("\n").slice(0, 6).join("\n    ")}`);
+  if (r.output) {
+    const lines = r.output.trimEnd().split("\n");
+    parts.push(`  output (${lines.length} lines, tail):
+    ${lines.slice(-12).join("\n    ")}`);
+  }
+  return parts.join("\n");
+}
+var SETUP_GUIDE = `# Adding CronWatch to a job
+
+CronWatch is a library, not a service. Install @cronwatch/sdk, declare each job once, wrap the work, and mount the routes.
+
+\`\`\`ts
+// lib/cronwatch.ts
+import { cronwatch } from "@cronwatch/sdk";
+import { sqlite } from "@cronwatch/sdk/sqlite";      // or "@cronwatch/sdk/postgres"
+import { slack } from "@cronwatch/sdk/slack";        // or discord, webhook
+
+export const cw = cronwatch({
+  store: sqlite({ path: "./data/cronwatch.db" }),
+  alerts: [slack({ webhookUrl: process.env.SLACK_WEBHOOK_URL! })],
+});
+
+export const nightlyReport = cw.job("nightly-report", {
+  schedule: "0 2 * * *",   // cron, "@hourly", or "every 15m"
+  timezone: "UTC",         // Vercel and GitHub Actions crons run in UTC
+  grace: "15m",            // how late a start may be before it is "missed"
+  timeout: "30m",          // a run still going after this is "stuck"
+  expect: "Report written", // the output must contain this, or the run failed
+  budget: { cost: 2 },     // a run reporting cost above 2 is "over budget"
+});
+\`\`\`
+
+\`\`\`ts
+// app/api/cron/nightly-report/route.ts  (Vercel cron hits this; Authorization: Bearer CRON_SECRET is checked)
+import { nightlyReport } from "@/lib/cronwatch";
+export const GET = nightlyReport.handler(async (job) => {
+  const result = await buildReport();
+  job.log("Report written:", result.path);
+  job.metric("cost", result.usdCost);
+});
+\`\`\`
+
+\`\`\`ts
+// app/cronwatch/[[...path]]/route.ts  (dashboard + JSON API; set CRONWATCH_TOKEN)
+import { cw } from "@/lib/cronwatch";
+export const { GET, POST, DELETE } = cw.routes();
+\`\`\`
+
+Missed runs are found by \`cw.check()\`. Either call \`cw.start()\` once in a long-running server (instrumentation.ts in Next.js), or point a cron at \`GET /cronwatch/api/check\` every few minutes with the bearer token.
+
+For a plain function outside HTTP: \`await nightlyReport.run(async (job) => { ... })\`. The function's exception is recorded as a failure and rethrown.
+
+Docs: https://cronwatch.dev/docs`;
+function createServer(options) {
+  const api = new ApiClient({ baseUrl: options.baseUrl, token: options.token, fetch: options.fetch });
+  const server2 = new McpServer({ name: "cronwatch", version: VERSION });
+  const text = (t) => ({ content: [{ type: "text", text: t }] });
+  const failure = (e) => ({
+    content: [{ type: "text", text: e instanceof ApiError ? e.message : `Error: ${e.message}` }],
+    isError: true
+  });
+  server2.registerTool(
+    "list_jobs",
+    {
+      title: "List jobs",
+      description: "Every scheduled job CronWatch knows about in this app, with its health (healthy, late, failing, stuck, silenced, never_ran), schedule, last run and next due time. Start here.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        const { jobs } = await api.call("GET", "/jobs");
+        if (jobs.length === 0) return text("No jobs yet. Declare one with cw.job() and run it once; see get_setup_guide.");
+        const unhealthy = jobs.filter((j) => j.health !== "healthy");
+        const head = `${jobs.length} job${jobs.length === 1 ? "" : "s"}, ${unhealthy.length} needing attention.`;
+        return text([head, "", ...jobs.map(summarizeJob)].join("\n"));
+      } catch (e) {
+        return failure(e);
+      }
+    }
+  );
+  server2.registerTool(
+    "get_job",
+    {
+      title: "Get job",
+      description: "One job in detail: definition, health, open conditions and its recent runs with errors, output tails and metrics. Use it to work out why a job failed.",
+      inputSchema: { name: z.string().describe("The job name"), runs: z.number().int().min(1).max(100).optional().describe("How many recent runs to include (default 10)") }
+    },
+    async ({ name, runs }) => {
+      try {
+        const data = await api.call("GET", `/jobs/${encodeURIComponent(name)}?runs=${runs ?? 10}`);
+        const def = JSON.stringify(data.job.definition, null, 2);
+        return text([summarizeJob(data.job), "", `definition: ${def}`, "", `recent runs (${data.runs.length}):`, ...data.runs.map((r) => summarizeRun(r))].join("\n"));
+      } catch (e) {
+        return failure(e);
+      }
+    }
+  );
+  server2.registerTool(
+    "run_check",
+    {
+      title: "Run check now",
+      description: "Look for missed and stuck runs across every job right now and send any alerts that are due. Returns what it found.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        const result = await api.call("POST", "/check");
+        const lines = [`Checked ${result.jobs.length} jobs at ${iso(result.checkedAt)}.`];
+        if (result.alerts.length) lines.push(`Alerts sent: ${result.alerts.map((a) => `${a.job} ${a.type}`).join(", ")}`);
+        else lines.push("No new alerts.");
+        const bad = result.jobs.filter((j) => j.health !== "healthy");
+        if (bad.length) lines.push("", ...bad.map(summarizeJob));
+        return text(lines.join("\n"));
+      } catch (e) {
+        return failure(e);
+      }
+    }
+  );
+  server2.registerTool(
+    "silence_job",
+    {
+      title: "Silence a job",
+      description: "Stop alerts for a job for a while, for example during a migration. Runs keep being recorded.",
+      inputSchema: { name: z.string(), for: z.string().default("1h").describe('A duration like "30m", "2h", "1d"') }
+    },
+    async ({ name, for: duration }) => {
+      try {
+        const { state } = await api.call("POST", `/jobs/${encodeURIComponent(name)}/silence`, { for: duration });
+        return text(`${name} is silenced until ${iso(state.silencedUntil)}.`);
+      } catch (e) {
+        return failure(e);
+      }
+    }
+  );
+  server2.registerTool(
+    "unsilence_job",
+    { title: "Unsilence a job", description: "Resume alerts for a silenced job.", inputSchema: { name: z.string() } },
+    async ({ name }) => {
+      try {
+        await api.call("POST", `/jobs/${encodeURIComponent(name)}/unsilence`);
+        return text(`${name} alerts are back on.`);
+      } catch (e) {
+        return failure(e);
+      }
+    }
+  );
+  server2.registerTool(
+    "forget_job",
+    {
+      title: "Forget a job",
+      description: "Remove a job and its run history from the store. For jobs that no longer exist in the code. A job still declared in code comes back on its next run.",
+      inputSchema: { name: z.string() }
+    },
+    async ({ name }) => {
+      try {
+        await api.call("DELETE", `/jobs/${encodeURIComponent(name)}`);
+        return text(`${name} removed.`);
+      } catch (e) {
+        return failure(e);
+      }
+    }
+  );
+  server2.registerTool(
+    "get_setup_guide",
+    {
+      title: "How to add a job",
+      description: "The code to add CronWatch monitoring to a scheduled job in this app: declaring the job, wrapping a route handler or function, mounting the dashboard, and running the missed-run check. Read it before writing any CronWatch code.",
+      inputSchema: {}
+    },
+    async () => text(SETUP_GUIDE)
+  );
+  return server2;
+}
+
+// src/cli.ts
+var args = process.argv.slice(2);
+var flag = (name) => {
+  const i = args.indexOf(name);
+  return i >= 0 ? args[i + 1] : void 0;
+};
+if (args.includes("--help") || args.includes("-h")) {
+  console.log(`cronwatch-mcp: an MCP server for an app that uses @cronwatch/sdk.
+
+  CRONWATCH_URL    where cw.routes() is mounted, e.g. https://app.example.com/cronwatch
+  CRONWATCH_TOKEN  the token those routes expect
+
+Or pass --url and --token. Add it to Claude Code with:
+
+  claude mcp add cronwatch -e CRONWATCH_URL=https://app.example.com/cronwatch -e CRONWATCH_TOKEN=... -- npx -y @cronwatch/mcp
+`);
+  process.exit(0);
+}
+var baseUrl = flag("--url") ?? process.env.CRONWATCH_URL;
+var token = flag("--token") ?? process.env.CRONWATCH_TOKEN ?? null;
+if (!baseUrl) {
+  console.error("cronwatch-mcp: set CRONWATCH_URL (or pass --url) to where cw.routes() is mounted, e.g. https://app.example.com/cronwatch");
+  process.exit(2);
+}
+if (!token) {
+  console.error("cronwatch-mcp: no CRONWATCH_TOKEN given; this only works if the app's routes are unprotected (development).");
+}
+var server = createServer({ baseUrl, token });
+var transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts","../src/server.ts","../src/client.ts"],"sourcesContent":["import { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { createServer } from \"./server.js\";\n\nconst args = process.argv.slice(2);\nconst flag = (name: string): string | undefined => {\n  const i = args.indexOf(name);\n  return i >= 0 ? args[i + 1] : undefined;\n};\n\nif (args.includes(\"--help\") || args.includes(\"-h\")) {\n  console.log(`cronwatch-mcp: an MCP server for an app that uses @cronwatch/sdk.\n\n  CRONWATCH_URL    where cw.routes() is mounted, e.g. https://app.example.com/cronwatch\n  CRONWATCH_TOKEN  the token those routes expect\n\nOr pass --url and --token. Add it to Claude Code with:\n\n  claude mcp add cronwatch -e CRONWATCH_URL=https://app.example.com/cronwatch -e CRONWATCH_TOKEN=... -- npx -y @cronwatch/mcp\n`);\n  process.exit(0);\n}\n\nconst baseUrl = flag(\"--url\") ?? process.env.CRONWATCH_URL;\nconst token = flag(\"--token\") ?? process.env.CRONWATCH_TOKEN ?? null;\n\nif (!baseUrl) {\n  console.error(\"cronwatch-mcp: set CRONWATCH_URL (or pass --url) to where cw.routes() is mounted, e.g. https://app.example.com/cronwatch\");\n  process.exit(2);\n}\nif (!token) {\n  console.error(\"cronwatch-mcp: no CRONWATCH_TOKEN given; this only works if the app's routes are unprotected (development).\");\n}\n\nconst server = createServer({ baseUrl, token });\nconst transport = new StdioServerTransport();\nawait server.connect(transport);\n","import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport { ApiClient, ApiError } from \"./client.js\";\n\nconst VERSION = \"0.1.0\";\n\nexport interface ServerOptions {\n  baseUrl: string;\n  token: string | null;\n  fetch?: typeof fetch;\n}\n\ninterface Run {\n  id: string;\n  status: string;\n  startedAt: number;\n  finishedAt: number | null;\n  durationMs: number | null;\n  error: string | null;\n  output: string | null;\n  metrics: Record<string, number>;\n  trigger: string;\n}\n\ninterface JobSummary {\n  name: string;\n  definition: Record<string, unknown> & { schedule?: string; description?: string };\n  health: string;\n  open: string[];\n  lastRun: Run | null;\n  nextExpectedAt: number | null;\n  consecutiveFailures: number;\n  silencedUntil: number | null;\n  stats: { runs: number; okRate: number; p50Ms: number | null; p95Ms: number | null };\n}\n\nfunction iso(at: number | null): string {\n  return at === null ? \"never\" : new Date(at).toISOString();\n}\n\nfunction ms(v: number | null): string {\n  if (v === null) return \"?\";\n  if (v < 1000) return `${v}ms`;\n  if (v < 60_000) return `${(v / 1000).toFixed(1)}s`;\n  return `${Math.round(v / 60_000)}m`;\n}\n\nfunction summarizeJob(j: JobSummary): string {\n  const bits = [\n    `${j.name}: ${j.health}${j.open.length ? ` (open: ${j.open.join(\", \")})` : \"\"}`,\n    `  schedule: ${j.definition.schedule ?? \"none\"}`,\n    `  last run: ${j.lastRun ? (j.lastRun.status === \"running\" ? `running since ${iso(j.lastRun.startedAt)}` : `${j.lastRun.status} at ${iso(j.lastRun.startedAt)}, ${ms(j.lastRun.durationMs)}`) : \"never\"}`,\n    `  next due: ${iso(j.nextExpectedAt)}`,\n    `  last ${j.stats.runs} runs: ${Math.round(j.stats.okRate * 100)}% ok, p50 ${ms(j.stats.p50Ms)}, p95 ${ms(j.stats.p95Ms)}`,\n  ];\n  if (j.consecutiveFailures) bits.push(`  consecutive failures: ${j.consecutiveFailures}`);\n  if (j.silencedUntil && j.silencedUntil > Date.now()) bits.push(`  silenced until ${iso(j.silencedUntil)}`);\n  if (j.definition.description) bits.push(`  ${j.definition.description}`);\n  return bits.join(\"\\n\");\n}\n\nfunction summarizeRun(r: Run): string {\n  const head = `${r.status} at ${iso(r.startedAt)}, ${ms(r.durationMs)}, trigger ${r.trigger}, id ${r.id}`;\n  const parts = [head];\n  if (Object.keys(r.metrics).length) parts.push(`  metrics: ${JSON.stringify(r.metrics)}`);\n  if (r.error) parts.push(`  error: ${r.error.split(\"\\n\").slice(0, 6).join(\"\\n    \")}`);\n  if (r.output) {\n    const lines = r.output.trimEnd().split(\"\\n\");\n    parts.push(`  output (${lines.length} lines, tail):\\n    ${lines.slice(-12).join(\"\\n    \")}`);\n  }\n  return parts.join(\"\\n\");\n}\n\nconst SETUP_GUIDE = `# Adding CronWatch to a job\n\nCronWatch is a library, not a service. Install @cronwatch/sdk, declare each job once, wrap the work, and mount the routes.\n\n\\`\\`\\`ts\n// lib/cronwatch.ts\nimport { cronwatch } from \"@cronwatch/sdk\";\nimport { sqlite } from \"@cronwatch/sdk/sqlite\";      // or \"@cronwatch/sdk/postgres\"\nimport { slack } from \"@cronwatch/sdk/slack\";        // or discord, webhook\n\nexport const cw = cronwatch({\n  store: sqlite({ path: \"./data/cronwatch.db\" }),\n  alerts: [slack({ webhookUrl: process.env.SLACK_WEBHOOK_URL! })],\n});\n\nexport const nightlyReport = cw.job(\"nightly-report\", {\n  schedule: \"0 2 * * *\",   // cron, \"@hourly\", or \"every 15m\"\n  timezone: \"UTC\",         // Vercel and GitHub Actions crons run in UTC\n  grace: \"15m\",            // how late a start may be before it is \"missed\"\n  timeout: \"30m\",          // a run still going after this is \"stuck\"\n  expect: \"Report written\", // the output must contain this, or the run failed\n  budget: { cost: 2 },     // a run reporting cost above 2 is \"over budget\"\n});\n\\`\\`\\`\n\n\\`\\`\\`ts\n// app/api/cron/nightly-report/route.ts  (Vercel cron hits this; Authorization: Bearer CRON_SECRET is checked)\nimport { nightlyReport } from \"@/lib/cronwatch\";\nexport const GET = nightlyReport.handler(async (job) => {\n  const result = await buildReport();\n  job.log(\"Report written:\", result.path);\n  job.metric(\"cost\", result.usdCost);\n});\n\\`\\`\\`\n\n\\`\\`\\`ts\n// app/cronwatch/[[...path]]/route.ts  (dashboard + JSON API; set CRONWATCH_TOKEN)\nimport { cw } from \"@/lib/cronwatch\";\nexport const { GET, POST, DELETE } = cw.routes();\n\\`\\`\\`\n\nMissed runs are found by \\`cw.check()\\`. Either call \\`cw.start()\\` once in a long-running server (instrumentation.ts in Next.js), or point a cron at \\`GET /cronwatch/api/check\\` every few minutes with the bearer token.\n\nFor a plain function outside HTTP: \\`await nightlyReport.run(async (job) => { ... })\\`. The function's exception is recorded as a failure and rethrown.\n\nDocs: https://cronwatch.dev/docs`;\n\nexport function createServer(options: ServerOptions): McpServer {\n  const api = new ApiClient({ baseUrl: options.baseUrl, token: options.token, fetch: options.fetch });\n  const server = new McpServer({ name: \"cronwatch\", version: VERSION });\n\n  const text = (t: string) => ({ content: [{ type: \"text\" as const, text: t }] });\n  const failure = (e: unknown) => ({\n    content: [{ type: \"text\" as const, text: e instanceof ApiError ? e.message : `Error: ${(e as Error).message}` }],\n    isError: true,\n  });\n\n  server.registerTool(\n    \"list_jobs\",\n    {\n      title: \"List jobs\",\n      description: \"Every scheduled job CronWatch knows about in this app, with its health (healthy, late, failing, stuck, silenced, never_ran), schedule, last run and next due time. Start here.\",\n      inputSchema: {},\n    },\n    async () => {\n      try {\n        const { jobs } = await api.call<{ jobs: JobSummary[] }>(\"GET\", \"/jobs\");\n        if (jobs.length === 0) return text(\"No jobs yet. Declare one with cw.job() and run it once; see get_setup_guide.\");\n        const unhealthy = jobs.filter((j) => j.health !== \"healthy\");\n        const head = `${jobs.length} job${jobs.length === 1 ? \"\" : \"s\"}, ${unhealthy.length} needing attention.`;\n        return text([head, \"\", ...jobs.map(summarizeJob)].join(\"\\n\"));\n      } catch (e) {\n        return failure(e);\n      }\n    },\n  );\n\n  server.registerTool(\n    \"get_job\",\n    {\n      title: \"Get job\",\n      description: \"One job in detail: definition, health, open conditions and its recent runs with errors, output tails and metrics. Use it to work out why a job failed.\",\n      inputSchema: { name: z.string().describe(\"The job name\"), runs: z.number().int().min(1).max(100).optional().describe(\"How many recent runs to include (default 10)\") },\n    },\n    async ({ name, runs }) => {\n      try {\n        const data = await api.call<{ job: JobSummary; runs: Run[] }>(\"GET\", `/jobs/${encodeURIComponent(name)}?runs=${runs ?? 10}`);\n        const def = JSON.stringify(data.job.definition, null, 2);\n        return text([summarizeJob(data.job), \"\", `definition: ${def}`, \"\", `recent runs (${data.runs.length}):`, ...data.runs.map((r) => summarizeRun(r))].join(\"\\n\"));\n      } catch (e) {\n        return failure(e);\n      }\n    },\n  );\n\n  server.registerTool(\n    \"run_check\",\n    {\n      title: \"Run check now\",\n      description: \"Look for missed and stuck runs across every job right now and send any alerts that are due. Returns what it found.\",\n      inputSchema: {},\n    },\n    async () => {\n      try {\n        const result = await api.call<{ checkedAt: number; jobs: JobSummary[]; alerts: { type: string; job: string; title: string }[]; pruned: number }>(\"POST\", \"/check\");\n        const lines = [`Checked ${result.jobs.length} jobs at ${iso(result.checkedAt)}.`];\n        if (result.alerts.length) lines.push(`Alerts sent: ${result.alerts.map((a) => `${a.job} ${a.type}`).join(\", \")}`);\n        else lines.push(\"No new alerts.\");\n        const bad = result.jobs.filter((j) => j.health !== \"healthy\");\n        if (bad.length) lines.push(\"\", ...bad.map(summarizeJob));\n        return text(lines.join(\"\\n\"));\n      } catch (e) {\n        return failure(e);\n      }\n    },\n  );\n\n  server.registerTool(\n    \"silence_job\",\n    {\n      title: \"Silence a job\",\n      description: \"Stop alerts for a job for a while, for example during a migration. Runs keep being recorded.\",\n      inputSchema: { name: z.string(), for: z.string().default(\"1h\").describe('A duration like \"30m\", \"2h\", \"1d\"') },\n    },\n    async ({ name, for: duration }) => {\n      try {\n        const { state } = await api.call<{ state: { silencedUntil: number } }>(\"POST\", `/jobs/${encodeURIComponent(name)}/silence`, { for: duration });\n        return text(`${name} is silenced until ${iso(state.silencedUntil)}.`);\n      } catch (e) {\n        return failure(e);\n      }\n    },\n  );\n\n  server.registerTool(\n    \"unsilence_job\",\n    { title: \"Unsilence a job\", description: \"Resume alerts for a silenced job.\", inputSchema: { name: z.string() } },\n    async ({ name }) => {\n      try {\n        await api.call(\"POST\", `/jobs/${encodeURIComponent(name)}/unsilence`);\n        return text(`${name} alerts are back on.`);\n      } catch (e) {\n        return failure(e);\n      }\n    },\n  );\n\n  server.registerTool(\n    \"forget_job\",\n    {\n      title: \"Forget a job\",\n      description: \"Remove a job and its run history from the store. For jobs that no longer exist in the code. A job still declared in code comes back on its next run.\",\n      inputSchema: { name: z.string() },\n    },\n    async ({ name }) => {\n      try {\n        await api.call(\"DELETE\", `/jobs/${encodeURIComponent(name)}`);\n        return text(`${name} removed.`);\n      } catch (e) {\n        return failure(e);\n      }\n    },\n  );\n\n  server.registerTool(\n    \"get_setup_guide\",\n    {\n      title: \"How to add a job\",\n      description: \"The code to add CronWatch monitoring to a scheduled job in this app: declaring the job, wrapping a route handler or function, mounting the dashboard, and running the missed-run check. Read it before writing any CronWatch code.\",\n      inputSchema: {},\n    },\n    async () => text(SETUP_GUIDE),\n  );\n\n  return server;\n}\n\nexport { SETUP_GUIDE };\n","/** A small HTTP client for the JSON API that @cronwatch/sdk mounts. */\nexport interface ApiClientOptions {\n  /** Where the routes are mounted, e.g. https://app.example.com/cronwatch */\n  baseUrl: string;\n  token: string | null;\n  fetch?: typeof fetch;\n}\n\nexport class ApiError extends Error {\n  constructor(message: string, readonly status: number) {\n    super(message);\n    this.name = \"ApiError\";\n  }\n}\n\nexport class ApiClient {\n  private readonly base: string;\n  private readonly token: string | null;\n  private readonly fetchFn: typeof fetch;\n\n  constructor(options: ApiClientOptions) {\n    this.base = options.baseUrl.replace(/\\/+$/, \"\");\n    this.token = options.token;\n    this.fetchFn = options.fetch ?? fetch;\n  }\n\n  async call<T = unknown>(method: string, path: string, body?: unknown): Promise<T> {\n    const headers: Record<string, string> = { accept: \"application/json\" };\n    if (this.token) headers.authorization = `Bearer ${this.token}`;\n    if (body !== undefined) headers[\"content-type\"] = \"application/json\";\n    const response = await this.fetchFn(`${this.base}/api${path}`, {\n      method,\n      headers,\n      body: body === undefined ? undefined : JSON.stringify(body),\n    });\n    const text = await response.text();\n    let data: unknown = null;\n    try {\n      data = text ? JSON.parse(text) : null;\n    } catch {\n      throw new ApiError(`${method} ${path} answered ${response.status} with a non-JSON body: ${text.slice(0, 200)}`, response.status);\n    }\n    if (!response.ok) {\n      const message = typeof data === \"object\" && data && \"error\" in data ? String((data as { error: unknown }).error) : response.statusText;\n      throw new ApiError(`${method} ${path} failed (${response.status}): ${message}`, response.status);\n    }\n    return data as T;\n  }\n}\n"],"mappings":"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","names":["server"]}

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+
+interface ServerOptions {
+    baseUrl: string;
+    token: string | null;
+    fetch?: typeof fetch;
+}
+declare function createServer(options: ServerOptions): McpServer;
+
+/** A small HTTP client for the JSON API that @cronwatch/sdk mounts. */
+interface ApiClientOptions {
+    /** Where the routes are mounted, e.g. https://app.example.com/cronwatch */
+    baseUrl: string;
+    token: string | null;
+    fetch?: typeof fetch;
+}
+declare class ApiError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+declare class ApiClient {
+    private readonly base;
+    private readonly token;
+    private readonly fetchFn;
+    constructor(options: ApiClientOptions);
+    call<T = unknown>(method: string, path: string, body?: unknown): Promise<T>;
+}
+
+export { ApiClient, ApiError, type ServerOptions, createServer };

package/dist/index.js

@@ -0,0 +1,256 @@
+#!/usr/bin/env node
+
+// src/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+
+// src/client.ts
+var ApiError = class extends Error {
+  constructor(message, status) {
+    super(message);
+    this.status = status;
+    this.name = "ApiError";
+  }
+  status;
+};
+var ApiClient = class {
+  base;
+  token;
+  fetchFn;
+  constructor(options) {
+    this.base = options.baseUrl.replace(/\/+$/, "");
+    this.token = options.token;
+    this.fetchFn = options.fetch ?? fetch;
+  }
+  async call(method, path, body) {
+    const headers = { accept: "application/json" };
+    if (this.token) headers.authorization = `Bearer ${this.token}`;
+    if (body !== void 0) headers["content-type"] = "application/json";
+    const response = await this.fetchFn(`${this.base}/api${path}`, {
+      method,
+      headers,
+      body: body === void 0 ? void 0 : JSON.stringify(body)
+    });
+    const text = await response.text();
+    let data = null;
+    try {
+      data = text ? JSON.parse(text) : null;
+    } catch {
+      throw new ApiError(`${method} ${path} answered ${response.status} with a non-JSON body: ${text.slice(0, 200)}`, response.status);
+    }
+    if (!response.ok) {
+      const message = typeof data === "object" && data && "error" in data ? String(data.error) : response.statusText;
+      throw new ApiError(`${method} ${path} failed (${response.status}): ${message}`, response.status);
+    }
+    return data;
+  }
+};
+
+// src/server.ts
+var VERSION = "0.1.0";
+function iso(at) {
+  return at === null ? "never" : new Date(at).toISOString();
+}
+function ms(v) {
+  if (v === null) return "?";
+  if (v < 1e3) return `${v}ms`;
+  if (v < 6e4) return `${(v / 1e3).toFixed(1)}s`;
+  return `${Math.round(v / 6e4)}m`;
+}
+function summarizeJob(j) {
+  const bits = [
+    `${j.name}: ${j.health}${j.open.length ? ` (open: ${j.open.join(", ")})` : ""}`,
+    `  schedule: ${j.definition.schedule ?? "none"}`,
+    `  last run: ${j.lastRun ? j.lastRun.status === "running" ? `running since ${iso(j.lastRun.startedAt)}` : `${j.lastRun.status} at ${iso(j.lastRun.startedAt)}, ${ms(j.lastRun.durationMs)}` : "never"}`,
+    `  next due: ${iso(j.nextExpectedAt)}`,
+    `  last ${j.stats.runs} runs: ${Math.round(j.stats.okRate * 100)}% ok, p50 ${ms(j.stats.p50Ms)}, p95 ${ms(j.stats.p95Ms)}`
+  ];
+  if (j.consecutiveFailures) bits.push(`  consecutive failures: ${j.consecutiveFailures}`);
+  if (j.silencedUntil && j.silencedUntil > Date.now()) bits.push(`  silenced until ${iso(j.silencedUntil)}`);
+  if (j.definition.description) bits.push(`  ${j.definition.description}`);
+  return bits.join("\n");
+}
+function summarizeRun(r) {
+  const head = `${r.status} at ${iso(r.startedAt)}, ${ms(r.durationMs)}, trigger ${r.trigger}, id ${r.id}`;
+  const parts = [head];
+  if (Object.keys(r.metrics).length) parts.push(`  metrics: ${JSON.stringify(r.metrics)}`);
+  if (r.error) parts.push(`  error: ${r.error.split("\n").slice(0, 6).join("\n    ")}`);
+  if (r.output) {
+    const lines = r.output.trimEnd().split("\n");
+    parts.push(`  output (${lines.length} lines, tail):
+    ${lines.slice(-12).join("\n    ")}`);
+  }
+  return parts.join("\n");
+}
+var SETUP_GUIDE = `# Adding CronWatch to a job
+
+CronWatch is a library, not a service. Install @cronwatch/sdk, declare each job once, wrap the work, and mount the routes.
+
+\`\`\`ts
+// lib/cronwatch.ts
+import { cronwatch } from "@cronwatch/sdk";
+import { sqlite } from "@cronwatch/sdk/sqlite";      // or "@cronwatch/sdk/postgres"
+import { slack } from "@cronwatch/sdk/slack";        // or discord, webhook
+
+export const cw = cronwatch({
+  store: sqlite({ path: "./data/cronwatch.db" }),
+  alerts: [slack({ webhookUrl: process.env.SLACK_WEBHOOK_URL! })],
+});
+
+export const nightlyReport = cw.job("nightly-report", {
+  schedule: "0 2 * * *",   // cron, "@hourly", or "every 15m"
+  timezone: "UTC",         // Vercel and GitHub Actions crons run in UTC
+  grace: "15m",            // how late a start may be before it is "missed"
+  timeout: "30m",          // a run still going after this is "stuck"
+  expect: "Report written", // the output must contain this, or the run failed
+  budget: { cost: 2 },     // a run reporting cost above 2 is "over budget"
+});
+\`\`\`
+
+\`\`\`ts
+// app/api/cron/nightly-report/route.ts  (Vercel cron hits this; Authorization: Bearer CRON_SECRET is checked)
+import { nightlyReport } from "@/lib/cronwatch";
+export const GET = nightlyReport.handler(async (job) => {
+  const result = await buildReport();
+  job.log("Report written:", result.path);
+  job.metric("cost", result.usdCost);
+});
+\`\`\`
+
+\`\`\`ts
+// app/cronwatch/[[...path]]/route.ts  (dashboard + JSON API; set CRONWATCH_TOKEN)
+import { cw } from "@/lib/cronwatch";
+export const { GET, POST, DELETE } = cw.routes();
+\`\`\`
+
+Missed runs are found by \`cw.check()\`. Either call \`cw.start()\` once in a long-running server (instrumentation.ts in Next.js), or point a cron at \`GET /cronwatch/api/check\` every few minutes with the bearer token.
+
+For a plain function outside HTTP: \`await nightlyReport.run(async (job) => { ... })\`. The function's exception is recorded as a failure and rethrown.
+
+Docs: https://cronwatch.dev/docs`;
+function createServer(options) {
+  const api = new ApiClient({ baseUrl: options.baseUrl, token: options.token, fetch: options.fetch });
+  const server = new McpServer({ name: "cronwatch", version: VERSION });
+  const text = (t) => ({ content: [{ type: "text", text: t }] });
+  const failure = (e) => ({
+    content: [{ type: "text", text: e instanceof ApiError ? e.message : `Error: ${e.message}` }],
+    isError: true
+  });
+  server.registerTool(
+    "list_jobs",
+    {
+      title: "List jobs",
+      description: "Every scheduled job CronWatch knows about in this app, with its health (healthy, late, failing, stuck, silenced, never_ran), schedule, last run and next due time. Start here.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        const { jobs } = await api.call("GET", "/jobs");
+        if (jobs.length === 0) return text("No jobs yet. Declare one with cw.job() and run it once; see get_setup_guide.");
+        const unhealthy = jobs.filter((j) => j.health !== "healthy");
+        const head = `${jobs.length} job${jobs.length === 1 ? "" : "s"}, ${unhealthy.length} needing attention.`;
+        return text([head, "", ...jobs.map(summarizeJob)].join("\n"));
+      } catch (e) {
+        return failure(e);
+      }
+    }
+  );
+  server.registerTool(
+    "get_job",
+    {
+      title: "Get job",
+      description: "One job in detail: definition, health, open conditions and its recent runs with errors, output tails and metrics. Use it to work out why a job failed.",
+      inputSchema: { name: z.string().describe("The job name"), runs: z.number().int().min(1).max(100).optional().describe("How many recent runs to include (default 10)") }
+    },
+    async ({ name, runs }) => {
+      try {
+        const data = await api.call("GET", `/jobs/${encodeURIComponent(name)}?runs=${runs ?? 10}`);
+        const def = JSON.stringify(data.job.definition, null, 2);
+        return text([summarizeJob(data.job), "", `definition: ${def}`, "", `recent runs (${data.runs.length}):`, ...data.runs.map((r) => summarizeRun(r))].join("\n"));
+      } catch (e) {
+        return failure(e);
+      }
+    }
+  );
+  server.registerTool(
+    "run_check",
+    {
+      title: "Run check now",
+      description: "Look for missed and stuck runs across every job right now and send any alerts that are due. Returns what it found.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        const result = await api.call("POST", "/check");
+        const lines = [`Checked ${result.jobs.length} jobs at ${iso(result.checkedAt)}.`];
+        if (result.alerts.length) lines.push(`Alerts sent: ${result.alerts.map((a) => `${a.job} ${a.type}`).join(", ")}`);
+        else lines.push("No new alerts.");
+        const bad = result.jobs.filter((j) => j.health !== "healthy");
+        if (bad.length) lines.push("", ...bad.map(summarizeJob));
+        return text(lines.join("\n"));
+      } catch (e) {
+        return failure(e);
+      }
+    }
+  );
+  server.registerTool(
+    "silence_job",
+    {
+      title: "Silence a job",
+      description: "Stop alerts for a job for a while, for example during a migration. Runs keep being recorded.",
+      inputSchema: { name: z.string(), for: z.string().default("1h").describe('A duration like "30m", "2h", "1d"') }
+    },
+    async ({ name, for: duration }) => {
+      try {
+        const { state } = await api.call("POST", `/jobs/${encodeURIComponent(name)}/silence`, { for: duration });
+        return text(`${name} is silenced until ${iso(state.silencedUntil)}.`);
+      } catch (e) {
+        return failure(e);
+      }
+    }
+  );
+  server.registerTool(
+    "unsilence_job",
+    { title: "Unsilence a job", description: "Resume alerts for a silenced job.", inputSchema: { name: z.string() } },
+    async ({ name }) => {
+      try {
+        await api.call("POST", `/jobs/${encodeURIComponent(name)}/unsilence`);
+        return text(`${name} alerts are back on.`);
+      } catch (e) {
+        return failure(e);
+      }
+    }
+  );
+  server.registerTool(
+    "forget_job",
+    {
+      title: "Forget a job",
+      description: "Remove a job and its run history from the store. For jobs that no longer exist in the code. A job still declared in code comes back on its next run.",
+      inputSchema: { name: z.string() }
+    },
+    async ({ name }) => {
+      try {
+        await api.call("DELETE", `/jobs/${encodeURIComponent(name)}`);
+        return text(`${name} removed.`);
+      } catch (e) {
+        return failure(e);
+      }
+    }
+  );
+  server.registerTool(
+    "get_setup_guide",
+    {
+      title: "How to add a job",
+      description: "The code to add CronWatch monitoring to a scheduled job in this app: declaring the job, wrapping a route handler or function, mounting the dashboard, and running the missed-run check. Read it before writing any CronWatch code.",
+      inputSchema: {}
+    },
+    async () => text(SETUP_GUIDE)
+  );
+  return server;
+}
+export {
+  ApiClient,
+  ApiError,
+  createServer
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts","../src/client.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport { ApiClient, ApiError } from \"./client.js\";\n\nconst VERSION = \"0.1.0\";\n\nexport interface ServerOptions {\n  baseUrl: string;\n  token: string | null;\n  fetch?: typeof fetch;\n}\n\ninterface Run {\n  id: string;\n  status: string;\n  startedAt: number;\n  finishedAt: number | null;\n  durationMs: number | null;\n  error: string | null;\n  output: string | null;\n  metrics: Record<string, number>;\n  trigger: string;\n}\n\ninterface JobSummary {\n  name: string;\n  definition: Record<string, unknown> & { schedule?: string; description?: string };\n  health: string;\n  open: string[];\n  lastRun: Run | null;\n  nextExpectedAt: number | null;\n  consecutiveFailures: number;\n  silencedUntil: number | null;\n  stats: { runs: number; okRate: number; p50Ms: number | null; p95Ms: number | null };\n}\n\nfunction iso(at: number | null): string {\n  return at === null ? \"never\" : new Date(at).toISOString();\n}\n\nfunction ms(v: number | null): string {\n  if (v === null) return \"?\";\n  if (v < 1000) return `${v}ms`;\n  if (v < 60_000) return `${(v / 1000).toFixed(1)}s`;\n  return `${Math.round(v / 60_000)}m`;\n}\n\nfunction summarizeJob(j: JobSummary): string {\n  const bits = [\n    `${j.name}: ${j.health}${j.open.length ? ` (open: ${j.open.join(\", \")})` : \"\"}`,\n    `  schedule: ${j.definition.schedule ?? \"none\"}`,\n    `  last run: ${j.lastRun ? (j.lastRun.status === \"running\" ? `running since ${iso(j.lastRun.startedAt)}` : `${j.lastRun.status} at ${iso(j.lastRun.startedAt)}, ${ms(j.lastRun.durationMs)}`) : \"never\"}`,\n    `  next due: ${iso(j.nextExpectedAt)}`,\n    `  last ${j.stats.runs} runs: ${Math.round(j.stats.okRate * 100)}% ok, p50 ${ms(j.stats.p50Ms)}, p95 ${ms(j.stats.p95Ms)}`,\n  ];\n  if (j.consecutiveFailures) bits.push(`  consecutive failures: ${j.consecutiveFailures}`);\n  if (j.silencedUntil && j.silencedUntil > Date.now()) bits.push(`  silenced until ${iso(j.silencedUntil)}`);\n  if (j.definition.description) bits.push(`  ${j.definition.description}`);\n  return bits.join(\"\\n\");\n}\n\nfunction summarizeRun(r: Run): string {\n  const head = `${r.status} at ${iso(r.startedAt)}, ${ms(r.durationMs)}, trigger ${r.trigger}, id ${r.id}`;\n  const parts = [head];\n  if (Object.keys(r.metrics).length) parts.push(`  metrics: ${JSON.stringify(r.metrics)}`);\n  if (r.error) parts.push(`  error: ${r.error.split(\"\\n\").slice(0, 6).join(\"\\n    \")}`);\n  if (r.output) {\n    const lines = r.output.trimEnd().split(\"\\n\");\n    parts.push(`  output (${lines.length} lines, tail):\\n    ${lines.slice(-12).join(\"\\n    \")}`);\n  }\n  return parts.join(\"\\n\");\n}\n\nconst SETUP_GUIDE = `# Adding CronWatch to a job\n\nCronWatch is a library, not a service. Install @cronwatch/sdk, declare each job once, wrap the work, and mount the routes.\n\n\\`\\`\\`ts\n// lib/cronwatch.ts\nimport { cronwatch } from \"@cronwatch/sdk\";\nimport { sqlite } from \"@cronwatch/sdk/sqlite\";      // or \"@cronwatch/sdk/postgres\"\nimport { slack } from \"@cronwatch/sdk/slack\";        // or discord, webhook\n\nexport const cw = cronwatch({\n  store: sqlite({ path: \"./data/cronwatch.db\" }),\n  alerts: [slack({ webhookUrl: process.env.SLACK_WEBHOOK_URL! })],\n});\n\nexport const nightlyReport = cw.job(\"nightly-report\", {\n  schedule: \"0 2 * * *\",   // cron, \"@hourly\", or \"every 15m\"\n  timezone: \"UTC\",         // Vercel and GitHub Actions crons run in UTC\n  grace: \"15m\",            // how late a start may be before it is \"missed\"\n  timeout: \"30m\",          // a run still going after this is \"stuck\"\n  expect: \"Report written\", // the output must contain this, or the run failed\n  budget: { cost: 2 },     // a run reporting cost above 2 is \"over budget\"\n});\n\\`\\`\\`\n\n\\`\\`\\`ts\n// app/api/cron/nightly-report/route.ts  (Vercel cron hits this; Authorization: Bearer CRON_SECRET is checked)\nimport { nightlyReport } from \"@/lib/cronwatch\";\nexport const GET = nightlyReport.handler(async (job) => {\n  const result = await buildReport();\n  job.log(\"Report written:\", result.path);\n  job.metric(\"cost\", result.usdCost);\n});\n\\`\\`\\`\n\n\\`\\`\\`ts\n// app/cronwatch/[[...path]]/route.ts  (dashboard + JSON API; set CRONWATCH_TOKEN)\nimport { cw } from \"@/lib/cronwatch\";\nexport const { GET, POST, DELETE } = cw.routes();\n\\`\\`\\`\n\nMissed runs are found by \\`cw.check()\\`. Either call \\`cw.start()\\` once in a long-running server (instrumentation.ts in Next.js), or point a cron at \\`GET /cronwatch/api/check\\` every few minutes with the bearer token.\n\nFor a plain function outside HTTP: \\`await nightlyReport.run(async (job) => { ... })\\`. The function's exception is recorded as a failure and rethrown.\n\nDocs: https://cronwatch.dev/docs`;\n\nexport function createServer(options: ServerOptions): McpServer {\n  const api = new ApiClient({ baseUrl: options.baseUrl, token: options.token, fetch: options.fetch });\n  const server = new McpServer({ name: \"cronwatch\", version: VERSION });\n\n  const text = (t: string) => ({ content: [{ type: \"text\" as const, text: t }] });\n  const failure = (e: unknown) => ({\n    content: [{ type: \"text\" as const, text: e instanceof ApiError ? e.message : `Error: ${(e as Error).message}` }],\n    isError: true,\n  });\n\n  server.registerTool(\n    \"list_jobs\",\n    {\n      title: \"List jobs\",\n      description: \"Every scheduled job CronWatch knows about in this app, with its health (healthy, late, failing, stuck, silenced, never_ran), schedule, last run and next due time. Start here.\",\n      inputSchema: {},\n    },\n    async () => {\n      try {\n        const { jobs } = await api.call<{ jobs: JobSummary[] }>(\"GET\", \"/jobs\");\n        if (jobs.length === 0) return text(\"No jobs yet. Declare one with cw.job() and run it once; see get_setup_guide.\");\n        const unhealthy = jobs.filter((j) => j.health !== \"healthy\");\n        const head = `${jobs.length} job${jobs.length === 1 ? \"\" : \"s\"}, ${unhealthy.length} needing attention.`;\n        return text([head, \"\", ...jobs.map(summarizeJob)].join(\"\\n\"));\n      } catch (e) {\n        return failure(e);\n      }\n    },\n  );\n\n  server.registerTool(\n    \"get_job\",\n    {\n      title: \"Get job\",\n      description: \"One job in detail: definition, health, open conditions and its recent runs with errors, output tails and metrics. Use it to work out why a job failed.\",\n      inputSchema: { name: z.string().describe(\"The job name\"), runs: z.number().int().min(1).max(100).optional().describe(\"How many recent runs to include (default 10)\") },\n    },\n    async ({ name, runs }) => {\n      try {\n        const data = await api.call<{ job: JobSummary; runs: Run[] }>(\"GET\", `/jobs/${encodeURIComponent(name)}?runs=${runs ?? 10}`);\n        const def = JSON.stringify(data.job.definition, null, 2);\n        return text([summarizeJob(data.job), \"\", `definition: ${def}`, \"\", `recent runs (${data.runs.length}):`, ...data.runs.map((r) => summarizeRun(r))].join(\"\\n\"));\n      } catch (e) {\n        return failure(e);\n      }\n    },\n  );\n\n  server.registerTool(\n    \"run_check\",\n    {\n      title: \"Run check now\",\n      description: \"Look for missed and stuck runs across every job right now and send any alerts that are due. Returns what it found.\",\n      inputSchema: {},\n    },\n    async () => {\n      try {\n        const result = await api.call<{ checkedAt: number; jobs: JobSummary[]; alerts: { type: string; job: string; title: string }[]; pruned: number }>(\"POST\", \"/check\");\n        const lines = [`Checked ${result.jobs.length} jobs at ${iso(result.checkedAt)}.`];\n        if (result.alerts.length) lines.push(`Alerts sent: ${result.alerts.map((a) => `${a.job} ${a.type}`).join(\", \")}`);\n        else lines.push(\"No new alerts.\");\n        const bad = result.jobs.filter((j) => j.health !== \"healthy\");\n        if (bad.length) lines.push(\"\", ...bad.map(summarizeJob));\n        return text(lines.join(\"\\n\"));\n      } catch (e) {\n        return failure(e);\n      }\n    },\n  );\n\n  server.registerTool(\n    \"silence_job\",\n    {\n      title: \"Silence a job\",\n      description: \"Stop alerts for a job for a while, for example during a migration. Runs keep being recorded.\",\n      inputSchema: { name: z.string(), for: z.string().default(\"1h\").describe('A duration like \"30m\", \"2h\", \"1d\"') },\n    },\n    async ({ name, for: duration }) => {\n      try {\n        const { state } = await api.call<{ state: { silencedUntil: number } }>(\"POST\", `/jobs/${encodeURIComponent(name)}/silence`, { for: duration });\n        return text(`${name} is silenced until ${iso(state.silencedUntil)}.`);\n      } catch (e) {\n        return failure(e);\n      }\n    },\n  );\n\n  server.registerTool(\n    \"unsilence_job\",\n    { title: \"Unsilence a job\", description: \"Resume alerts for a silenced job.\", inputSchema: { name: z.string() } },\n    async ({ name }) => {\n      try {\n        await api.call(\"POST\", `/jobs/${encodeURIComponent(name)}/unsilence`);\n        return text(`${name} alerts are back on.`);\n      } catch (e) {\n        return failure(e);\n      }\n    },\n  );\n\n  server.registerTool(\n    \"forget_job\",\n    {\n      title: \"Forget a job\",\n      description: \"Remove a job and its run history from the store. For jobs that no longer exist in the code. A job still declared in code comes back on its next run.\",\n      inputSchema: { name: z.string() },\n    },\n    async ({ name }) => {\n      try {\n        await api.call(\"DELETE\", `/jobs/${encodeURIComponent(name)}`);\n        return text(`${name} removed.`);\n      } catch (e) {\n        return failure(e);\n      }\n    },\n  );\n\n  server.registerTool(\n    \"get_setup_guide\",\n    {\n      title: \"How to add a job\",\n      description: \"The code to add CronWatch monitoring to a scheduled job in this app: declaring the job, wrapping a route handler or function, mounting the dashboard, and running the missed-run check. Read it before writing any CronWatch code.\",\n      inputSchema: {},\n    },\n    async () => text(SETUP_GUIDE),\n  );\n\n  return server;\n}\n\nexport { SETUP_GUIDE };\n","/** A small HTTP client for the JSON API that @cronwatch/sdk mounts. */\nexport interface ApiClientOptions {\n  /** Where the routes are mounted, e.g. https://app.example.com/cronwatch */\n  baseUrl: string;\n  token: string | null;\n  fetch?: typeof fetch;\n}\n\nexport class ApiError extends Error {\n  constructor(message: string, readonly status: number) {\n    super(message);\n    this.name = \"ApiError\";\n  }\n}\n\nexport class ApiClient {\n  private readonly base: string;\n  private readonly token: string | null;\n  private readonly fetchFn: typeof fetch;\n\n  constructor(options: ApiClientOptions) {\n    this.base = options.baseUrl.replace(/\\/+$/, \"\");\n    this.token = options.token;\n    this.fetchFn = options.fetch ?? fetch;\n  }\n\n  async call<T = unknown>(method: string, path: string, body?: unknown): Promise<T> {\n    const headers: Record<string, string> = { accept: \"application/json\" };\n    if (this.token) headers.authorization = `Bearer ${this.token}`;\n    if (body !== undefined) headers[\"content-type\"] = \"application/json\";\n    const response = await this.fetchFn(`${this.base}/api${path}`, {\n      method,\n      headers,\n      body: body === undefined ? undefined : JSON.stringify(body),\n    });\n    const text = await response.text();\n    let data: unknown = null;\n    try {\n      data = text ? JSON.parse(text) : null;\n    } catch {\n      throw new ApiError(`${method} ${path} answered ${response.status} with a non-JSON body: ${text.slice(0, 200)}`, response.status);\n    }\n    if (!response.ok) {\n      const message = typeof data === \"object\" && data && \"error\" in data ? String((data as { error: unknown }).error) : response.statusText;\n      throw new ApiError(`${method} ${path} failed (${response.status}): ${message}`, response.status);\n    }\n    return data as T;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@cronwatch/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for CronWatch. Lets Claude Code, Cursor and other agents list jobs, read failures, run a check and silence alerts in an app that uses @cronwatch/sdk.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/phillips-jon/cronwatch.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://cronwatch.dev/docs/mcp",
+  "keywords": ["mcp", "model context protocol", "cron", "monitoring", "agents", "claude"],
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "cronwatch-mcp": "./dist/cli.js"
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "node --import tsx --test test/*.test.ts",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.23.0",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}