@offlocal/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 the author
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,73 @@
+# @offlocal/mcp
+
+The MCP (Model Context Protocol) server for [Offlocal](https://offlocal.ai) —
+lets your AI coding agent (Claude Code, Cursor, Codex, Windsurf, etc.) deploy
+apps directly from a coding session.
+
+## Install
+
+Sign up at [offlocal.ai](https://offlocal.ai) to get an agent key, then add
+this MCP server to your agent's config.
+
+### Claude Code
+
+```bash
+claude mcp add offlocal \
+  --env OFFLOCAL_AGENT_KEY=off_live_xxx \
+  -- npx -y @offlocal/mcp
+```
+
+### Cursor (`~/.cursor/mcp.json`)
+
+```json
+{
+  "mcpServers": {
+    "offlocal": {
+      "command": "npx",
+      "args": ["-y", "@offlocal/mcp"],
+      "env": { "OFFLOCAL_AGENT_KEY": "off_live_xxx" }
+    }
+  }
+}
+```
+
+### Codex (`~/.codex/config.toml`)
+
+```toml
+[mcp_servers.offlocal]
+command = "npx"
+args = ["-y", "@offlocal/mcp"]
+env = { OFFLOCAL_AGENT_KEY = "off_live_xxx" }
+```
+
+### Windsurf (`~/.codeium/windsurf/mcp_config.json`)
+
+Same shape as Cursor.
+
+### Easier: let your agent install itself
+
+Paste this into a fresh agent chat:
+
+> Install Offlocal as an MCP server for me. Use `npx -y @offlocal/mcp` with env
+> `OFFLOCAL_AGENT_KEY = off_live_xxx`. Use whatever config file or built-in
+> command your agent uses. Tell me to restart when done.
+
+## Tools exposed
+
+| Tool | What it does |
+| --- | --- |
+| `offlocal_ping` | Verify the agent is connected. Returns your email if so. |
+| `offlocal_deploy` | Detect runtime, zip the source, upload, kick off the build + deploy pipeline. Returns a `deploymentId`. |
+| `offlocal_status` | Poll a deployment. Returns the current phase, ETA, and the live URL on success. |
+| `offlocal_logs` | Read the most recent container logs from CloudWatch. |
+
+## Env
+
+| Variable | Required | Notes |
+| --- | --- | --- |
+| `OFFLOCAL_AGENT_KEY` | yes | From the Offlocal dashboard at offlocal.ai |
+| `OFFLOCAL_API_URL` | no | Defaults to `https://api.offlocal.ai`. |
+
+## License
+
+MIT

package/dist/client.js

@@ -0,0 +1,84 @@
+const API_URL = process.env.OFFLOCAL_API_URL?.replace(/\/+$/, "") ?? "http://localhost:4000";
+const AGENT_KEY = process.env.OFFLOCAL_AGENT_KEY ?? "";
+function authHeaders() {
+    return AGENT_KEY ? { Authorization: `Bearer ${AGENT_KEY}` } : {};
+}
+export async function pingApi() {
+    if (!AGENT_KEY) {
+        return { ok: false, reason: "OFFLOCAL_AGENT_KEY env var is empty" };
+    }
+    const url = `${API_URL}/api/agent/ping`;
+    try {
+        const res = await fetch(url, {
+            method: "POST",
+            headers: { "content-type": "application/json", ...authHeaders() },
+            body: "{}",
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            return {
+                ok: false,
+                reason: `${res.status} ${res.statusText} from ${url}${body ? ` — ${body.slice(0, 200)}` : ""}`,
+            };
+        }
+        const data = (await res.json());
+        return { ok: true, user: data.user };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            ok: false,
+            reason: `fetch ${url} failed — ${message}`,
+        };
+    }
+}
+export async function createDeployment(input) {
+    const res = await fetch(`${API_URL}/api/deployments`, {
+        method: "POST",
+        headers: { "content-type": "application/json", ...authHeaders() },
+        body: JSON.stringify(input),
+    });
+    if (!res.ok)
+        throw new Error(await failureText(res, "create_deployment"));
+    return (await res.json());
+}
+export async function uploadBundle(url, bundle) {
+    const res = await fetch(url, {
+        method: "PUT",
+        headers: { "content-type": "application/zip" },
+        body: bundle,
+    });
+    if (!res.ok)
+        throw new Error(await failureText(res, "upload_bundle"));
+}
+export async function markUploadComplete(deploymentId) {
+    const res = await fetch(`${API_URL}/api/deployments/${encodeURIComponent(deploymentId)}/upload-complete`, { method: "POST", headers: { ...authHeaders() } });
+    if (!res.ok)
+        throw new Error(await failureText(res, "upload_complete"));
+    const json = (await res.json());
+    return json.deployment;
+}
+export async function getDeployment(deploymentId) {
+    const res = await fetch(`${API_URL}/api/deployments/${encodeURIComponent(deploymentId)}`, { headers: { ...authHeaders() } });
+    if (!res.ok)
+        throw new Error(await failureText(res, "get_deployment"));
+    const json = (await res.json());
+    return json.deployment;
+}
+export async function getDeploymentLogs(deploymentId, options) {
+    const params = new URLSearchParams();
+    if (options?.limit)
+        params.set("limit", String(options.limit));
+    const qs = params.toString();
+    const url = `${API_URL}/api/deployments/${encodeURIComponent(deploymentId)}/logs${qs ? `?${qs}` : ""}`;
+    const res = await fetch(url, { headers: { ...authHeaders() } });
+    if (!res.ok)
+        throw new Error(await failureText(res, "get_logs"));
+    const json = (await res.json());
+    return json.logs;
+}
+async function failureText(res, kind) {
+    const body = await res.text().catch(() => "");
+    return `${kind} failed: ${res.status} ${res.statusText}${body ? ` — ${body.slice(0, 400)}` : ""}`;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/detect.js

@@ -0,0 +1,108 @@
+import { readFile, stat } from "node:fs/promises";
+import { basename, join } from "node:path";
+const DEFAULTS = {
+    runtime: "node-20",
+    framework: "node",
+    buildCommand: "echo no-build",
+    startCommand: "npm start",
+    port: 3000,
+};
+export async function detect(sourceDir) {
+    const pkgPath = join(sourceDir, "package.json");
+    let pkg = null;
+    if (await fileExists(pkgPath)) {
+        try {
+            const raw = await readFile(pkgPath, "utf8");
+            pkg = JSON.parse(raw);
+        }
+        catch {
+            pkg = null;
+        }
+    }
+    const appName = pkg?.name ?? slugifyDirName(sourceDir) ?? "app";
+    const deps = {
+        ...(pkg?.dependencies ?? {}),
+        ...(pkg?.devDependencies ?? {}),
+    };
+    const scripts = pkg?.scripts ?? {};
+    const framework = pickFramework(deps);
+    const port = portFor(framework);
+    const buildCommand = scripts.build ? "npm run build" : DEFAULTS.buildCommand;
+    const startCommand = scripts.start
+        ? "npm start"
+        : pickFallbackStart(framework);
+    return {
+        appName,
+        runtime: DEFAULTS.runtime,
+        framework,
+        buildCommand,
+        startCommand,
+        port,
+    };
+}
+function pickFramework(deps) {
+    if ("next" in deps)
+        return "nextjs";
+    if ("nuxt" in deps)
+        return "nuxt";
+    if ("@remix-run/serve" in deps || "@remix-run/node" in deps)
+        return "remix";
+    if ("astro" in deps)
+        return "astro";
+    if ("fastify" in deps)
+        return "fastify";
+    if ("hono" in deps)
+        return "hono";
+    if ("express" in deps)
+        return "express";
+    if ("koa" in deps)
+        return "koa";
+    if ("vite" in deps)
+        return "vite";
+    return "node";
+}
+function portFor(framework) {
+    switch (framework) {
+        case "nextjs":
+            return 3000;
+        case "nuxt":
+            return 3000;
+        case "remix":
+            return 3000;
+        case "astro":
+            return 4321;
+        case "vite":
+            return 4173;
+        case "fastify":
+            return 3000;
+        case "hono":
+            return 3000;
+        case "express":
+            return 3000;
+        case "koa":
+            return 3000;
+        default:
+            return 3000;
+    }
+}
+function pickFallbackStart(framework) {
+    if (framework === "nextjs")
+        return "npx next start";
+    if (framework === "nuxt")
+        return "node .output/server/index.mjs";
+    return "node index.js";
+}
+function slugifyDirName(dir) {
+    const name = basename(dir).toLowerCase().replace(/[^a-z0-9-]+/g, "-");
+    return name || null;
+}
+async function fileExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { pingApi } from "./client.js";
+import { DeployInputShape, deployHandler } from "./tools/deploy.js";
+import { StatusInputShape, statusHandler } from "./tools/status.js";
+import { LogsInputShape, logsHandler } from "./tools/logs.js";
+import { PingInputShape, pingHandler } from "./tools/ping.js";
+const DeploySchema = z.object(DeployInputShape);
+const StatusSchema = z.object(StatusInputShape);
+const LogsSchema = z.object(LogsInputShape);
+const PingSchema = z.object(PingInputShape);
+async function main() {
+    const server = new McpServer({
+        name: "offlocal",
+        version: "0.1.0",
+    });
+    server.tool("offlocal_ping", "Verify the Offlocal connection. Returns the signed-in email if connected, or an error message if not. This tool does NOT deploy anything, upload anything, or call AWS — it is the right tool to call when the user asks to 'check my Offlocal connection' or similar.", PingInputShape, async (args) => pingHandler(PingSchema.parse(args)));
+    server.tool("offlocal_deploy", "Deploy an app from a local directory to Offlocal. Returns a deploymentId you can poll with offlocal_status. Detects runtime/framework/port automatically; you can override appName and port. Only call this when the user explicitly asks to deploy.", DeployInputShape, async (args) => deployHandler(DeploySchema.parse(args)));
+    server.tool("offlocal_status", "Get the current status of a deployment. Poll this every few seconds after offlocal_deploy until status is 'live' or 'failed'.", StatusInputShape, async (args) => statusHandler(StatusSchema.parse(args)));
+    server.tool("offlocal_logs", "Read recent container logs for a deployment. Useful for debugging a failed deploy or watching live output.", LogsInputShape, async (args) => logsHandler(LogsSchema.parse(args)));
+    // Fire-and-forget ping so the dashboard knows the agent is connected.
+    // Don't block startup if it fails — agent will still work.
+    pingApi().catch(() => { });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("offlocal-mcp fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9D,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAChD,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAChD,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;AAC5C,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;AAE5C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CACT,eAAe,EACf,wQAAwQ,EACxQ,cAAc,EACd,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CACpD,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,sPAAsP,EACtP,gBAAgB,EAChB,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CACxD,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,+HAA+H,EAC/H,gBAAgB,EAChB,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CACxD,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,eAAe,EACf,4GAA4G,EAC5G,cAAc,EACd,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CACpD,CAAC;IAEF,sEAAsE;IACtE,2DAA2D;IAC3D,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAE1B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/deploy.js

@@ -0,0 +1,79 @@
+import { z } from "zod";
+import { createDeployment, markUploadComplete, uploadBundle, } from "../client.js";
+import { detect } from "../detect.js";
+import { bundleDirectory } from "../zip.js";
+export const DeployInputShape = {
+    sourceDir: z
+        .string()
+        .min(1)
+        .describe("Absolute path to the project directory to deploy. Use the project root (where package.json lives)."),
+    appName: z
+        .string()
+        .min(1)
+        .max(63)
+        .optional()
+        .describe("Optional. Defaults to package.json `name` or the folder name. Becomes the subdomain: {appName}.offlocal.ai"),
+    port: z
+        .number()
+        .int()
+        .min(1)
+        .max(65535)
+        .optional()
+        .describe("Optional. The port the container listens on. Auto-detected from framework."),
+};
+export async function deployHandler(input) {
+    const detected = await detect(input.sourceDir);
+    const appName = input.appName ?? detected.appName;
+    const port = input.port ?? detected.port;
+    const bundle = await bundleDirectory(input.sourceDir);
+    const created = await createDeployment({
+        appName,
+        runtime: detected.runtime,
+        framework: detected.framework,
+        buildCommand: detected.buildCommand,
+        startCommand: detected.startCommand,
+        port,
+    });
+    await uploadBundle(created.upload.url, bundle.buffer);
+    await markUploadComplete(created.deploymentId);
+    const summary = {
+        deploymentId: created.deploymentId,
+        appName,
+        framework: detected.framework,
+        port,
+        bundle: {
+            fileCount: bundle.fileCount,
+            bytes: bundle.byteSize,
+        },
+        status: "uploaded",
+        expectedUrl: `https://${appName}.offlocal.ai`,
+        pollAfterSeconds: 45,
+        expectedTotalSeconds: 180,
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Deployment created and source uploaded.\n\n` +
+                    `  deploymentId: ${summary.deploymentId}\n` +
+                    `  appName:      ${summary.appName}\n` +
+                    `  framework:    ${summary.framework}\n` +
+                    `  port:         ${summary.port}\n` +
+                    `  bundle:       ${summary.bundle.fileCount} files, ${summary.bundle.bytes} bytes\n` +
+                    `  expectedUrl:  ${summary.expectedUrl}\n\n` +
+                    `WAIT — this is a normal, slow operation.\n` +
+                    `Typical end-to-end time: 2-4 minutes (CodeBuild cold start + ECS rollout).\n` +
+                    `Do NOT poll offlocal_status faster than once every 30 seconds. ` +
+                    `Repeated polling does not speed anything up; the only thing that helps is time.\n\n` +
+                    `Recommended sequence:\n` +
+                    `  1. Sleep 45 seconds.\n` +
+                    `  2. Call offlocal_status({ deploymentId: "${summary.deploymentId}" }).\n` +
+                    `  3. The response will include "pollAfterSeconds" — sleep that long, then call status again.\n` +
+                    `  4. Continue until status is 'live' or 'failed'.\n\n` +
+                    `Tell the user the deploy is in progress and you'll report back when it's live.`,
+            },
+        ],
+        structuredContent: summary,
+    };
+}
+//# sourceMappingURL=deploy.js.map

package/dist/tools/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../src/tools/deploy.ts"],"names":[],"mappings":"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"}

package/dist/tools/logs.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { getDeploymentLogs } from "../client.js";
+export const LogsInputShape = {
+    deploymentId: z
+        .string()
+        .min(1)
+        .describe("The deploymentId whose container logs you want to read."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(500)
+        .optional()
+        .describe("Maximum number of log lines to return (default 100, max 500)."),
+};
+export async function logsHandler(input) {
+    const logs = await getDeploymentLogs(input.deploymentId, {
+        limit: input.limit,
+    });
+    if (logs.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "No logs available yet. The container may not be running, or no log stream exists for this project. " +
+                        "Wait until offlocal_status reports 'live', then try again.",
+                },
+            ],
+            structuredContent: { logs: [] },
+        };
+    }
+    const text = logs.map((l) => `${l.at}  ${l.message}`).join("\n");
+    return {
+        content: [{ type: "text", text }],
+        structuredContent: { logs },
+    };
+}
+//# sourceMappingURL=logs.js.map

package/dist/tools/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../src/tools/logs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,yDAAyD,CAAC;IACtE,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;CACpE,CAAC;AAIX,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAgB;IAChD,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,YAAY,EAAE;QACvD,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EACF,qGAAqG;wBACrG,4DAA4D;iBAC/D;aACF;YACD,iBAAiB,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;SAChC,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEjE,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;QAC1C,iBAAiB,EAAE,EAAE,IAAI,EAAE;KAC5B,CAAC;AACJ,CAAC"}

package/dist/tools/ping.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { pingApi } from "../client.js";
+export const PingInputShape = {};
+export async function pingHandler(_input) {
+    const result = await pingApi();
+    if (!result.ok) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Not connected to Offlocal.\n\n" +
+                        `Reason: ${result.reason}\n\n` +
+                        "Common fixes:\n" +
+                        "  - If you're calling from WSL, make sure OFFLOCAL_API_URL points at the Windows host (http://host.docker.internal:4000) — not localhost.\n" +
+                        "  - Make sure `pnpm dev:api` is running on the Windows side.\n" +
+                        "  - Double-check OFFLOCAL_AGENT_KEY matches a key created in the dashboard.",
+                },
+            ],
+            structuredContent: { connected: false, reason: result.reason },
+        };
+    }
+    const email = result.user?.email ?? "(unknown)";
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Connected to Offlocal as ${email}.`,
+            },
+        ],
+        structuredContent: { connected: true, email },
+    };
+}
+// Silence unused-import warnings if z isn't used after init.
+void z;
+//# sourceMappingURL=ping.js.map

package/dist/tools/ping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.js","sourceRoot":"","sources":["../../src/tools/ping.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAW,CAAC;AAI1C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAiB;IACjD,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC;IAE/B,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EACF,gCAAgC;wBAChC,WAAW,MAAM,CAAC,MAAM,MAAM;wBAC9B,iBAAiB;wBACjB,6IAA6I;wBAC7I,gEAAgE;wBAChE,6EAA6E;iBAChF;aACF;YACD,iBAAiB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;SAC/D,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,IAAI,WAAW,CAAC;IAChD,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,4BAA4B,KAAK,GAAG;aAC3C;SACF;QACD,iBAAiB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE;KAC9C,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,KAAK,CAAC,CAAC"}

package/dist/tools/status.js

@@ -0,0 +1,116 @@
+import { z } from "zod";
+import { getDeployment } from "../client.js";
+export const StatusInputShape = {
+    deploymentId: z
+        .string()
+        .min(1)
+        .describe("The deploymentId returned by offlocal_deploy."),
+};
+export async function statusHandler(input) {
+    const dep = await getDeployment(input.deploymentId);
+    const phase = phaseFor(dep.status);
+    const isTerminal = dep.status === "live" || dep.status === "failed";
+    const pollAfterSeconds = isTerminal ? 0 : pollIntervalFor(dep.status);
+    const etaSeconds = isTerminal ? 0 : etaFor(dep.status);
+    const summary = {
+        deploymentId: dep.id,
+        status: dep.status,
+        phase,
+        isTerminal,
+        pollAfterSeconds,
+        etaSeconds,
+        liveUrl: dep.liveUrl,
+        errorType: dep.errorType,
+        errorMessage: dep.errorMessage,
+        updatedAt: dep.updatedAt,
+    };
+    const lines = [`Status: ${dep.status} (${phase})`];
+    if (dep.status === "live" && dep.liveUrl) {
+        lines.push("");
+        lines.push(`Live at ${dep.liveUrl}`);
+    }
+    else if (dep.status === "failed") {
+        lines.push("");
+        lines.push(`Failed: ${dep.errorType ?? "unknown"}`);
+        if (dep.errorMessage) {
+            lines.push("");
+            lines.push(dep.errorMessage.slice(0, 2000));
+        }
+    }
+    else {
+        lines.push("");
+        lines.push(`Still in progress. Typical end-to-end deploy: 2-4 minutes from upload.`);
+        lines.push(`Do NOT call this tool again for at least ${pollAfterSeconds} seconds — there's no faster way to make the deploy go.`);
+        lines.push(`If you must wait, just sleep ${pollAfterSeconds} seconds and call this tool exactly once. Repeated polling will not speed anything up.`);
+    }
+    return {
+        content: [{ type: "text", text: lines.join("\n") }],
+        structuredContent: summary,
+    };
+}
+function phaseFor(status) {
+    switch (status) {
+        case "created":
+        case "upload_pending":
+            return "waiting for source upload";
+        case "uploaded":
+        case "validating":
+            return "validating source";
+        case "queued":
+            return "queued for build";
+        case "building":
+        case "image_built":
+            return "building image (CodeBuild)";
+        case "deploying":
+            return "starting container (ECS rollout)";
+        case "live":
+            return "live";
+        case "failed":
+            return "failed";
+        case "deleted":
+            return "deleted";
+        default:
+            return "unknown";
+    }
+}
+/**
+ * How long the agent should wait before calling this tool again.
+ * Tuned to typical AWS step latencies so we don't hammer the API.
+ */
+function pollIntervalFor(status) {
+    switch (status) {
+        case "upload_pending":
+            return 5;
+        case "uploaded":
+        case "validating":
+            return 10;
+        case "queued":
+        case "building":
+        case "image_built":
+            return 30;
+        case "deploying":
+            return 30;
+        default:
+            return 15;
+    }
+}
+/** Rough remaining-time estimate in seconds. */
+function etaFor(status) {
+    switch (status) {
+        case "upload_pending":
+            return 30;
+        case "uploaded":
+        case "validating":
+            return 15;
+        case "queued":
+            return 90;
+        case "building":
+        case "image_built":
+            return 75;
+        case "deploying":
+            return 90;
+        default:
+            return 0;
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/tools/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"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"}

package/dist/zip.js

@@ -0,0 +1,76 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join, relative, sep } from "node:path";
+import AdmZip from "adm-zip";
+const IGNORED_DIRS = new Set([
+    "node_modules",
+    ".git",
+    ".next",
+    ".nuxt",
+    ".output",
+    ".astro",
+    ".svelte-kit",
+    "dist",
+    "build",
+    "out",
+    "coverage",
+    ".turbo",
+    ".cache",
+    ".vercel",
+    ".netlify",
+    ".idea",
+    ".vscode",
+]);
+const IGNORED_FILE_RE = /^(\.env(\..+)?|.*\.log|\.DS_Store|Thumbs\.db|.*\.tsbuildinfo)$/;
+const MAX_FILE_BYTES = 50 * 1024 * 1024;
+const MAX_BUNDLE_BYTES = 250 * 1024 * 1024;
+export async function bundleDirectory(sourceDir) {
+    const zip = new AdmZip();
+    let fileCount = 0;
+    let totalBytes = 0;
+    await walk(sourceDir, async (absolute) => {
+        const rel = relative(sourceDir, absolute);
+        if (!rel)
+            return;
+        const st = await stat(absolute);
+        if (!st.isFile())
+            return;
+        if (st.size > MAX_FILE_BYTES) {
+            throw new Error(`file too large to bundle: ${rel} (${st.size} bytes, max ${MAX_FILE_BYTES})`);
+        }
+        const content = await readFile(absolute);
+        const zipPath = rel.split(sep).join("/");
+        zip.addFile(zipPath, content);
+        fileCount++;
+        totalBytes += st.size;
+        if (totalBytes > MAX_BUNDLE_BYTES) {
+            throw new Error(`bundle exceeds ${MAX_BUNDLE_BYTES} bytes. Trim node_modules-like outputs or add a .offlocalignore.`);
+        }
+    });
+    if (fileCount === 0) {
+        throw new Error(`no files to bundle under ${sourceDir}`);
+    }
+    return { buffer: zip.toBuffer(), fileCount, byteSize: totalBytes };
+}
+async function walk(root, onFile) {
+    const stack = [root];
+    while (stack.length) {
+        const current = stack.pop();
+        if (!current)
+            break;
+        const entries = await readdir(current, { withFileTypes: true });
+        for (const entry of entries) {
+            const absolute = join(current, entry.name);
+            if (entry.isDirectory()) {
+                if (IGNORED_DIRS.has(entry.name))
+                    continue;
+                stack.push(absolute);
+            }
+            else if (entry.isFile()) {
+                if (IGNORED_FILE_RE.test(entry.name))
+                    continue;
+                await onFile(absolute);
+            }
+        }
+    }
+}
+//# sourceMappingURL=zip.js.map

package/dist/zip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.js","sourceRoot":"","sources":["../src/zip.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@offlocal/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Offlocal — lets your AI coding agent deploy apps via offlocal_deploy, offlocal_status, offlocal_logs, offlocal_ping.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "offlocal",
+    "deploy",
+    "claude-code",
+    "cursor",
+    "codex",
+    "windsurf",
+    "ai-agent"
+  ],
+  "homepage": "https://offlocal.ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/offlocal/offlocal.git",
+    "directory": "apps/mcp"
+  },
+  "license": "MIT",
+  "author": "the author",
+  "type": "module",
+  "bin": {
+    "offlocal-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.17.0",
+    "adm-zip": "0.5.16",
+    "zod": "3.25.76"
+  },
+  "devDependencies": {
+    "@types/adm-zip": "0.5.5",
+    "@types/node": "20.14.10",
+    "tsx": "4.19.1",
+    "typescript": "5.5.3"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc -p tsconfig.json && node -e \"try{require('fs').chmodSync('dist/index.js', 0o755)}catch(e){}\"",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit"
+  }
+}