staygreen 0.1.0 → 0.1.2

package/CLI.md

@@ -17,8 +17,8 @@ Requires Node 22 or later:
 npx -y staygreen mcp
 ```
 
-The package is prepared for publication; until the owner publishes it, build this
-source and use `node /absolute/path/to/dist/cli.js mcp` in place of `npx`.
+To run a checkout of this source instead, build it (below) and use
+`node /absolute/path/to/dist/cli.js mcp` in place of `npx`.
 
 Create a workspace API token at [Agents and API](https://staygreen.io/app/agents)
 and provide it as `STAYGREEN_API_TOKEN` in the server process's environment.

package/README.md

@@ -31,6 +31,16 @@ claude mcp add --transport http staygreen https://staygreen.io/mcp \
   --header "Authorization: Bearer $STAYGREEN_API_TOKEN"
 ```
 
+### Local server (npm)
+
+The [`staygreen`](https://www.npmjs.com/package/staygreen) package runs the same tools as a local stdio server and calls the REST API with a workspace API token. Node 22 or later.
+
+```sh
+claude mcp add staygreen -e STAYGREEN_API_TOKEN=… -- npx -y staygreen mcp
+```
+
+Without a token only `scan_app` works. Configuration for Claude Desktop, Cursor and VS Code, and the package's `scan` and `provision` commands, are in [CLI.md](CLI.md).
+
 ### Tools
 
 | Tool | What it does |

package/dist/cli.js

@@ -8,9 +8,10 @@ var __export = (target, all) => {
 // src/cli.ts
 import { parseArgs } from "node:util";
 import { randomUUID } from "node:crypto";
+import { realpathSync } from "node:fs";
 import { writeFile, mkdir } from "node:fs/promises";
 import { dirname, resolve } from "node:path";
-import { pathToFileURL } from "node:url";
+import { fileURLToPath } from "node:url";
 
 // node_modules/zod/v4/classic/external.js
 var external_exports = {};
@@ -20134,7 +20135,7 @@ var contract_generated_default = {
     {
       name: "list_monitors",
       title: "List monitors",
-      description: "List monitors in your workspace, optionally filtered by app, type or state. Returns monitor and app ids, current state and last_check with its precision: an exact outcome, the start of its latest five-minute check window, or no data. Never credentials or heartbeat URLs. Call again with cursor set to next_cursor until null.",
+      description: "List monitors in your workspace with their app ids, current state and last check, ordered by id. The app, type and status filters combine, each narrowing the same list; with none you get every monitor, automatic SSL checks included. last_check_precision says whether last_check is an exact outcome, the start of its latest five-minute check window, or no data. Never returns credentials or heartbeat URLs. Use get_status instead for each app's overall state and open incidents, get_uptime for history. Call again with cursor set to next_cursor until null.",
       inputSchema: {
         $schema: "https://json-schema.org/draft/2020-12/schema",
         type: "object",
@@ -20273,7 +20274,7 @@ var contract_generated_default = {
     {
       name: "get_status",
       title: "Get status",
-      description: "Read the current status of one app or every app, including private monitors, page components and open incidents with their latest published note. Use its app and incident ids in the other tools. No draft notes are returned.",
+      description: "Read the current status of one app or every app: its overall state, monitors (private ones included), status page components and open incidents with their latest published note. Omit app or pass * for the whole workspace; an app id outside your workspace returns not_found. Start here: its app, monitor and incident ids feed the other tools. Use get_uptime or get_incidents for history. No draft notes are returned.",
       inputSchema: {
         $schema: "https://json-schema.org/draft/2020-12/schema",
         type: "object",
@@ -20512,7 +20513,7 @@ var contract_generated_default = {
     {
       name: "get_uptime",
       title: "Get uptime",
-      description: "Read measured uptime, downtime minutes, incident counts and daily history for one or every monitor. Unmeasured time is no data, not 100% uptime. History is capped by your workspace's plan. Follow next_cursor to read every monitor.",
+      description: "Read measured uptime, downtime minutes, incident counts and daily history. With monitor omitted or *, every monitor is returned a page at a time (follow next_cursor); a monitor id returns that monitor alone, so pass no cursor with it. window is capped at 30d unless your plan includes a year of history, and the result's window says which one applied. Unmeasured time is no data, not 100% uptime. Use get_response_times instead for latency, and get_incidents for what failed and why.",
       inputSchema: {
         $schema: "https://json-schema.org/draft/2020-12/schema",
         type: "object",
@@ -20966,7 +20967,7 @@ var contract_generated_default = {
     {
       name: "get_ssl_and_domain_expiry",
       title: "Get ssl and domain expiry",
-      description: "Read certificate and domain expiry dates and days remaining for monitored hosts. Missing measurements are null, never a guessed expiry. Follow next_cursor to read every host.",
+      description: "Read certificate and domain expiry dates, with days remaining, for the hosts your SSL monitors check. Omit app for every SSL monitor in the workspace, or pass an app id for that app's hosts only. A null date means Staygreen has no date to show for that host; it never guesses one. Use this for renewal deadlines; use get_status instead for whether a site is up now. Follow next_cursor to read every host.",
       inputSchema: {
         $schema: "https://json-schema.org/draft/2020-12/schema",
         type: "object",
@@ -21066,7 +21067,7 @@ var contract_generated_default = {
     {
       name: "provision_app",
       title: "Provision app",
-      description: "Set up an app's website check, automatic SSL/domain check, status page and supplied cron heartbeats in one transaction. A normalized app URL is idempotent; an existing app is returned without changing it. Optional service checks need valid read-only credentials. Reports skipped options explicitly; a plan_limit error creates nothing and lists what was not created. New heartbeat credentials are returned only to the creating request and its retries. Supply a request_id UUID for safe retries. Needs write access.",
+      description: "Set up a new app in one transaction: its website check, an automatic SSL/domain check when url is https on port 443 with a hostname that has no SSL monitor yet, a status page, and one heartbeat per crons_from entry. Optional checks come in pairs, supabase_url with supabase_key and stripe_key with stripe_endpoints: half a pair is reported in skipped, and a full pair that fails verification refuses the whole call. mcp_url and status_domain are reported in skipped when supplied. A new app's explicit name must be free; without one, the hostname is made unique. Every option is validated and checked first; then, if url matches an existing app, that app comes back with its monitors as they were (add checks with create_monitor), plus a status page if it had none. A plan_limit error creates nothing and lists what was not created. Heartbeat URLs are returned only to this request and its retries with the same request_id. Needs write access.",
       inputSchema: {
         $schema: "https://json-schema.org/draft/2020-12/schema",
         type: "object",
@@ -21286,7 +21287,7 @@ var contract_generated_default = {
     {
       name: "create_monitor",
       title: "Create monitor",
-      description: "Create one monitor in an app returned by provision_app or list_monitors. Uses the same type validation, public-address checks and plan quotas as the dashboard. Returns a first test result; heartbeat URLs are available only in the dashboard or when provision_app creates cron heartbeats. Supply request_id for safe retries. Needs write access.",
+      description: "Create one monitor in an existing app; for a new app use provision_app instead. type decides what target is and which config keys apply: http takes a URL with method, expect, keyword, slowMs, assertions and headers; tcp a hostname or public IP with port, tls and slowMs; ssl a hostname and no config; dns a record name with record and expected; heartbeat ignores target and takes schedule, tz, graceMin, maxRunMin and assertions, so give it a name; supabase a project URL with key and databaseRead; stripe https://api.stripe.com with key, endpoints, critical, failureThreshold, windowMin and pendingMin. A key belonging to another type is refused. Validation, public-address checks and plan quotas match the dashboard, and Stripe and Supabase checks must verify before saving. Returns a first test result but never a heartbeat's URL, which the dashboard shows. Supply request_id for safe retries. Needs write access.",
       inputSchema: {
         $schema: "https://json-schema.org/draft/2020-12/schema",
         type: "object",
@@ -21316,14 +21317,14 @@ var contract_generated_default = {
             description: "Monitor type. MCP server monitors are not available yet."
           },
           name: {
-            description: "Monitor name; defaults to a name derived from the target.",
+            description: `Monitor name. Without one, Staygreen picks a default (a heartbeat's is "Scheduled job"), which this tool does not return; list_monitors shows it.`,
             type: "string",
             maxLength: 80
           },
           target: {
             type: "string",
             maxLength: 2048,
-            description: "HTTP or Supabase URL, SSL/TCP hostname, DNS record name, or job name for a heartbeat. HTTP(S) URL hostnames may be at most 80 characters. Stripe uses https://api.stripe.com."
+            description: "HTTP or Supabase URL, SSL hostname, TCP hostname or public IP, or DNS record name. HTTP(S) URL hostnames may be at most 80 characters. Stripe uses https://api.stripe.com; a heartbeat ignores it."
           },
           config: {
             default: {},
@@ -22142,7 +22143,15 @@ async function main(args = process.argv.slice(2), env = process.env) {
   await writeFile(output2, JSON.stringify(result, null, 2) + "\n", { mode: 384 });
   console.log("Monitoring provisioned. Private setup and heartbeat URLs saved to the output file.");
 }
-if (process.argv[1] && import.meta.url === pathToFileURL(resolve(process.argv[1])).href)
+var real = (path) => {
+  try {
+    return realpathSync(path);
+  } catch {
+    return null;
+  }
+};
+var invoked = process.argv[1] ? real(resolve(process.argv[1])) : null;
+if (invoked && invoked === real(fileURLToPath(import.meta.url)))
   main().catch(() => {
     console.error("Staygreen command failed. Check --help, inputs, credentials and plan limits. Retry provisioning with the same output file and unchanged inputs.");
     process.exitCode = 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "staygreen",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "mcpName": "io.github.phuryn/staygreen",
   "description": "Staygreen MCP server and CLI: scan apps and manage monitoring through the Staygreen API.",
   "type": "module",