stormgtm-mcp 0.1.0 → 0.1.1

package/README.md

@@ -37,7 +37,9 @@ Then call `whoami`. It returns the account email and credit balance.
 
 ## Authentication
 
-The server reads `STORMGTM_API_KEY` first, then `~/.stormgtm/config.json` (the same file `stormgtm login` writes). `STORMGTM_API_URL` overrides the API URL (default `https://stormgtm.com`).
+The server reads `STORMGTM_API_KEY` first, then `~/.stormgtm/config.json` (the same file `stormgtm login` writes), on every tool call. `STORMGTM_API_URL` overrides the API URL (default `https://stormgtm.com`).
+
+The server starts without a key. Until you sign in, every tool returns a short message saying how to; after `stormgtm login` the next call works without restarting the server.
 
 ```bash
 npm i -g stormgtm

package/dist/index.js

@@ -2,11 +2,11 @@
 
 // src/index.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { clientFromEnv } from "stormgtm";
+import { clientFromEnv, resolveApiKey } from "stormgtm";
 
 // src/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StormGTMError, summarize } from "stormgtm";
+import { describeError, MissingApiKeyError, StormGTMError, summarize } from "stormgtm";
 import { z } from "zod";
 
 // src/version.ts
@@ -59,11 +59,26 @@ var policyShape = z.object({
 function ok(summary, data) {
   return { content: [{ type: "text", text: summary }], structuredContent: data };
 }
-function fail(error) {
-  const message = error instanceof StormGTMError ? `${error.code}: ${error.message}` : error instanceof Error ? error.message : String(error);
-  return { content: [{ type: "text", text: message }], isError: true };
+var NO_KEY_MESSAGE = "StormGTM is not signed in. Run `npx stormgtm login` (or `stormgtm login` if installed globally), or set STORMGTM_API_KEY in this MCP server's environment, then call the tool again.";
+function failureMessage(error, apiUrl) {
+  if (error instanceof MissingApiKeyError) return NO_KEY_MESSAGE;
+  if (error instanceof StormGTMError) {
+    const detail = error.status === 401 || error.status === 402 || error.status === 429 ? describeError(error, apiUrl).message : error.message;
+    return `StormGTM request failed (${error.code}): ${detail}`;
+  }
+  return describeError(error, apiUrl).message;
 }
-function createServer(client) {
+function createServer(source) {
+  const api = typeof source === "function" ? source : () => source;
+  const fail = (error) => {
+    let apiUrl;
+    try {
+      apiUrl = api().baseUrl;
+    } catch {
+      apiUrl = void 0;
+    }
+    return { content: [{ type: "text", text: failureMessage(error, apiUrl) }], isError: true };
+  };
   const server2 = new McpServer({ name: "stormgtm", version: MCP_VERSION }, { instructions: INSTRUCTIONS });
   server2.registerTool(
     "check_lead",
@@ -79,7 +94,7 @@ function createServer(client) {
     },
     async ({ email, context, tier, policy }) => {
       try {
-        const result = await client.check({ email, context, tier, policy });
+        const result = await api().check({ email, context, tier, policy });
         return ok(summarize(result), result);
       } catch (error) {
         return fail(error);
@@ -99,7 +114,7 @@ function createServer(client) {
     },
     async ({ leads, tier, policy }) => {
       try {
-        const created = await client.createBatch({ leads, tier, policy });
+        const created = await api().createBatch({ leads, tier, policy });
         return ok(`Batch ${created.id} queued with ${created.total} leads (up to ${created.maxCredits} credits). Call batch_status with this id.`, created);
       } catch (error) {
         return fail(error);
@@ -119,7 +134,7 @@ function createServer(client) {
     },
     async ({ id, offset, limit }) => {
       try {
-        const status = await client.batch(id, { offset, limit: limit ?? 200 });
+        const status = await api().batch(id, { offset, limit: limit ?? 200 });
         const counts = {};
         for (const row of status.results) {
           const key = row.result?.verdict ?? row.status;
@@ -146,7 +161,7 @@ function createServer(client) {
     },
     async ({ email, kind, detail }) => {
       try {
-        const result = await client.reportOutcome({ email, kind, detail });
+        const result = await api().reportOutcome({ email, kind, detail });
         return ok(result.recorded ? `Recorded ${kind} for ${email}.` : `Not recorded: ${result.rejected.map((r) => r.reason).join(", ")}`, result);
       } catch (error) {
         return fail(error);
@@ -162,6 +177,7 @@ function createServer(client) {
     },
     async () => {
       try {
+        const client = api();
         const me = await client.me();
         return ok(`${me.email}: ${me.credits} credits (${client.baseUrl})`, { id: me.id, email: me.email, credits: me.credits, apiUrl: client.baseUrl });
       } catch (error) {
@@ -178,7 +194,7 @@ function createServer(client) {
     },
     async () => {
       try {
-        const me = await client.me();
+        const me = await api().me();
         return ok(`${me.credits} credits. fast=${me.pricing.fast}, deep=${me.pricing.deep}, unknown=free. 30d: ${me.usage30d.total} checks.`, me);
       } catch (error) {
         return fail(error);
@@ -206,7 +222,7 @@ function createServer(client) {
     },
     async ({ messages }) => {
       try {
-        const result = await client.send(messages);
+        const result = await api().send(messages);
         const lines = [`${result.accepted.length} queued, ${result.rejected.length} rejected.`];
         for (const entry of result.accepted) lines.push(`queued ${entry.id} \u2192 ${entry.to}${entry.duplicate ? " (already queued)" : ""}`);
         for (const entry of result.rejected) lines.push(`rejected #${entry.index}: ${entry.code} \u2014 ${entry.message}`);
@@ -225,7 +241,7 @@ function createServer(client) {
     },
     async () => {
       try {
-        const domains = await client.domains();
+        const domains = await api().domains();
         const lines = domains.length ? domains.map((domain) => `${domain.name} (${domain.id}): ${domain.status}, ${domain.warmup.paused ? "paused" : `${domain.warmup.dailyCap}/day`}`) : ["No sending domains yet. Add one in the StormGTM dashboard."];
         return ok(lines.join("\n"), { domains });
       } catch (error) {
@@ -242,7 +258,7 @@ function createServer(client) {
     },
     async ({ id }) => {
       try {
-        const health = await client.domainHealth(id);
+        const health = await api().domainHealth(id);
         const pct = (value) => `${(value * 100).toFixed(1)}%`;
         const state = health.warmup.paused ? `paused (${health.warmup.pausedReason ?? "manual"})` : `${health.warmup.remainingToday}/${health.warmup.dailyCap} left today`;
         return ok(`${health.name}: ${state}. 7d: ${health.last7Days.sent} sent, ${pct(health.last7Days.bounceRate)} bounced, ${pct(health.last7Days.complaintRate)} complaints.`, health);
@@ -260,7 +276,7 @@ function createServer(client) {
     },
     async ({ id }) => {
       try {
-        const email = await client.email(id);
+        const email = await api().email(id);
         return ok(`${email.id} \u2192 ${email.to}: ${email.status}, delivery ${email.delivery}${email.error ? ` (${email.error})` : ""}`, email);
       } catch (error) {
         return fail(error);
@@ -281,7 +297,7 @@ function createServer(client) {
     },
     async ({ name, from, replyTo, steps }) => {
       try {
-        const sequence = await client.createSequence({ name, from, replyTo, steps });
+        const sequence = await api().createSequence({ name, from, replyTo, steps });
         const variables = sequence.variables.length ? ` Leads need: ${sequence.variables.join(", ")}.` : "";
         return ok(`Created sequence ${sequence.id} "${sequence.name}" with ${sequence.steps.length} steps.${variables} Enroll leads with enroll_leads.`, sequence);
       } catch (error) {
@@ -301,7 +317,7 @@ function createServer(client) {
     },
     async ({ sequenceId, leads }) => {
       try {
-        const result = await client.enroll(sequenceId, leads);
+        const result = await api().enroll(sequenceId, leads);
         const fresh = result.accepted.filter((entry) => !entry.duplicate).length;
         const lines = [`${fresh} enrolled, ${result.accepted.length - fresh} already enrolled, ${result.rejected.length} rejected. Up to ${result.maxCredits} credits.`];
         for (const entry of result.rejected.slice(0, 50)) lines.push(`rejected #${entry.index}: ${entry.code} \u2014 ${entry.message}`);
@@ -321,11 +337,11 @@ function createServer(client) {
     async ({ id }) => {
       try {
         if (!id) {
-          const sequences = await client.sequences();
+          const sequences = await api().sequences();
           const lines2 = sequences.length ? sequences.map((entry) => `${entry.id} "${entry.name}"${entry.archivedAt ? " (archived)" : ""}: ${entry.steps} steps, ${entry.counts.active} active, ${entry.counts.completed} completed, ${entry.counts.stopped} stopped`) : ["No sequences yet. Create one with create_sequence."];
           return ok(lines2.join("\n"), { sequences });
         }
-        const [sequence, enrollments] = await Promise.all([client.sequence(id), client.enrollments(id, 100)]);
+        const [sequence, enrollments] = await Promise.all([api().sequence(id), api().enrollments(id, 100)]);
         const lines = [`${sequence.id} "${sequence.name}" from ${sequence.from}: ${sequence.steps.length} steps`];
         for (const entry of enrollments.slice(0, 50)) lines.push(`${entry.email}: ${entry.status}${entry.stopReason ? ` (${entry.stopReason})` : entry.nextStep !== null ? `, step ${entry.nextStep + 1} next` : ""}`);
         return ok(lines.join("\n"), { sequence, enrollments });
@@ -343,7 +359,7 @@ function createServer(client) {
     },
     async ({ sequenceId, enrollmentId }) => {
       try {
-        const result = await client.stopEnrollment(sequenceId, enrollmentId);
+        const result = await api().stopEnrollment(sequenceId, enrollmentId);
         return ok(`Stopped ${result.id}.`, result);
       } catch (error) {
         return fail(error);
@@ -354,5 +370,7 @@ function createServer(client) {
 }
 
 // src/index.ts
-var server = createServer(clientFromEnv());
+if (!resolveApiKey()) process.stderr.write(`stormgtm-mcp: ${NO_KEY_MESSAGE}
+`);
+var server = createServer(() => clientFromEnv());
 await server.connect(new StdioServerTransport());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stormgtm-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "StormGTM MCP server — qualify leads with Barometer and send through your own domains, over stdio",
   "license": "MIT",
   "type": "module",
@@ -13,7 +13,7 @@
     "lead-qualification"
   ],
   "bin": {
-    "stormgtm-mcp": "./dist/index.js"
+    "stormgtm-mcp": "dist/index.js"
   },
   "homepage": "https://github.com/marginsystems/stormgtm-mcp",
   "repository": {
@@ -39,7 +39,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.31.0",
-    "stormgtm": "0.1.0",
+    "stormgtm": "0.1.1",
     "zod": "^4.6.5"
   },
   "devDependencies": {