@energyatit/mcp-server 0.1.0 → 0.2.0

package/dist/index.js

@@ -8,17 +8,85 @@ const BASE_URL = (process.env.ENERGYATIT_BASE_URL ??
     "https://energyatit.com").replace(/\/$/, "");
 const API_KEY = process.env.ENERGYATIT_API_KEY ?? "";
 const TOKEN = process.env.ENERGYATIT_TOKEN ?? "";
+// ─── Demo Mode ──────────────────────────────────────────────────────────────
+const demoMode = !API_KEY && !TOKEN;
+let sessionApiKey = "";
 function authHeaders() {
     const h = { "Content-Type": "application/json" };
     if (TOKEN)
         h["Authorization"] = `Bearer ${TOKEN}`;
     else if (API_KEY)
         h["X-API-Key"] = API_KEY;
+    else if (sessionApiKey)
+        h["X-API-Key"] = sessionApiKey;
     return h;
 }
+// Demo path mapping: read-only tools use public /demo/* routes when in demo mode
+const DEMO_PATH_MAP = {
+    "/api/sites": "/api/v1/demo/sites",
+    "/api/assets": "/api/v1/demo/assets",
+    "/api/grid-connections": "/api/v1/demo/grid-connections",
+    "/api/meter-readings": "/api/v1/demo/meter-readings",
+    "/api/settlements": "/api/v1/demo/settlements",
+    "/api/v1/dr/events": "/api/v1/demo/dr/events",
+    "/api/v1/integrations/status": "/api/v1/demo/integrations/status",
+    "/api/v1/carbon": "/api/v1/demo/carbon",
+};
+function resolveDemoPath(path) {
+    if (!demoMode)
+        return path;
+    // Check exact match first
+    const basePath = path.split("?")[0];
+    const qs = path.includes("?") ? path.slice(path.indexOf("?")) : "";
+    if (DEMO_PATH_MAP[basePath])
+        return DEMO_PATH_MAP[basePath] + qs;
+    // Check prefix matches (e.g. /api/sites/123)
+    for (const [from, to] of Object.entries(DEMO_PATH_MAP)) {
+        if (basePath.startsWith(from + "/")) {
+            return to + basePath.slice(from.length) + qs;
+        }
+    }
+    return path;
+}
 // ─── HTTP helpers ──────────────────────────────────────────────────────────
+async function autoProvisionSandbox() {
+    try {
+        const res = await fetch(`${BASE_URL}/api/v1/sandbox/provision`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+        });
+        const json = await res.json();
+        if (json.success && json.data) {
+            const data = json.data;
+            if (data.apiKey && typeof data.apiKey === "string") {
+                sessionApiKey = data.apiKey;
+                console.error(`[demo] Auto-provisioned sandbox (key: ${sessionApiKey.slice(0, 20)}...)`);
+                return true;
+            }
+        }
+        console.error("[demo] Sandbox provision returned unexpected response:", json);
+        return false;
+    }
+    catch (err) {
+        console.error("[demo] Failed to auto-provision sandbox:", err);
+        return false;
+    }
+}
 async function apiGet(path) {
-    const res = await fetch(`${BASE_URL}${path}`, { headers: authHeaders() });
+    const resolvedPath = resolveDemoPath(path);
+    const res = await fetch(`${BASE_URL}${resolvedPath}`, { headers: authHeaders() });
+    // Auto-provision on 401 in demo mode
+    if (res.status === 401 && demoMode && !sessionApiKey) {
+        const provisioned = await autoProvisionSandbox();
+        if (provisioned) {
+            // Retry with the new key
+            const retry = await fetch(`${BASE_URL}${resolvedPath}`, { headers: authHeaders() });
+            const retryJson = await retry.json();
+            if (retryJson.success === false)
+                throw new Error(String(retryJson.error ?? `API error ${retry.status}`));
+            return retryJson.data ?? retryJson;
+        }
+    }
     const json = await res.json();
     if (json.success === false)
         throw new Error(String(json.error ?? `API error ${res.status}`));
@@ -30,6 +98,21 @@ async function apiPost(path, body) {
         headers: authHeaders(),
         body: body ? JSON.stringify(body) : undefined,
     });
+    // Auto-provision on 401 in demo mode
+    if (res.status === 401 && demoMode && !sessionApiKey) {
+        const provisioned = await autoProvisionSandbox();
+        if (provisioned) {
+            const retry = await fetch(`${BASE_URL}${path}`, {
+                method: "POST",
+                headers: authHeaders(),
+                body: body ? JSON.stringify(body) : undefined,
+            });
+            const retryJson = await retry.json();
+            if (retryJson.success === false)
+                throw new Error(String(retryJson.error ?? `API error ${retry.status}`));
+            return retryJson.data ?? retryJson;
+        }
+    }
     const json = await res.json();
     if (json.success === false)
         throw new Error(String(json.error ?? `API error ${res.status}`));
@@ -55,7 +138,7 @@ function errorResult(err) {
 // ─── MCP Server ────────────────────────────────────────────────────────────
 const server = new McpServer({
     name: "energyatit",
-    version: "0.1.0",
+    version: "0.2.0",
 });
 // ── Sites ────────────────────────────────────────────────────────────────
 server.tool("list_sites", "List all energy sites in your tenant", {}, async () => {
@@ -473,17 +556,17 @@ server.resource("platform-overview", "energyatit://overview", async () => ({
                 "  - Integrations: Modbus, OpenADR 2.0b, OCPP 2.0, IEC 61850",
                 "",
                 `Connected to: ${BASE_URL}`,
-                `Auth: ${TOKEN ? "JWT token" : API_KEY ? "API key" : "none (set ENERGYATIT_API_KEY)"}`,
+                `Auth: ${TOKEN ? "JWT token" : API_KEY ? "API key" : demoMode ? "demo mode (public endpoints + auto-provision)" : "none"}`,
             ].join("\n"),
         }],
 }));
 // ─── Start ─────────────────────────────────────────────────────────────────
 async function main() {
-    if (!API_KEY && !TOKEN) {
-        console.error("Warning: No ENERGYATIT_API_KEY or ENERGYATIT_TOKEN set. Requests will be unauthenticated.");
-        console.error("Set ENERGYATIT_API_KEY=eat_live_xxx or ENERGYATIT_TOKEN=jwt_xxx in your environment.");
+    if (demoMode) {
+        console.error("Running in demo mode — read-only tools use public endpoints, write tools auto-provision sandbox");
+        console.error("Set ENERGYATIT_API_KEY or ENERGYATIT_TOKEN for full access.");
     }
-    console.error(`EnergyAtIt MCP server v0.1.0 — connecting to ${BASE_URL}`);
+    console.error(`EnergyAtIt MCP server v0.2.0 — connecting to ${BASE_URL}`);
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error("EnergyAtIt MCP server running on stdio");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@energyatit/mcp-server",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for EnergyAtIt — connect Claude, GPT, or any MCP client to energy grid data",
   "type": "module",
   "bin": {