@velixir/mcp 0.1.2 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # @velixir/mcp
 
-Deploy web apps in **any language** to [velixir](https://velixir.net), the European cloud, straight from your AI agent. One tool, `deploy`: point it at a source directory, and it packs the code, builds it with no Dockerfile, and returns a live URL plus a claim link the human opens to keep the app on a free, card-free account. No velixir account is needed to deploy.
+Deploy web apps in **any language** to [velixir](https://velixir.net), the European cloud, straight from your AI agent. `deploy` points at a source directory, packs the code, builds it with no Dockerfile, and returns a live URL plus a claim link the human opens to keep the app on a free, card-free account. `logs` fetches the build and runtime logs so the agent can debug what it shipped. No velixir account is needed.
 
 ## Why
 
@@ -42,10 +42,21 @@ Point the editor's MCP settings at the same command (`npx -y @velixir/mcp`).
 | `language` | no | node, python, go, ruby, php, java, elixir, rust, dotnet, deno, fsharp. Auto-detected if omitted. |
 | `port` | no | Only if the app hard-codes a port instead of reading the `PORT` env var. |
 
-It returns the live URL, a claim URL (give this to the user), when the claim window closes, and a status URL to poll.
+It returns the live URL, a claim URL (give this to the user), when the claim window closes, a **deployment ID** (pass it to `logs`), and a status URL to poll.
 
 `node_modules`, `.git`, build output, and caches are skipped automatically. Nixpacks reinstalls dependencies and builds from source.
 
+## The `logs` tool
+
+Fetch recent build and runtime logs for an app you deployed, so you can debug without an account: a failed build returns the build error, a running app returns its recent container output.
+
+| Input | Required | Description |
+| --- | --- | --- |
+| `deployment_id` | yes | The deployment ID from the `deploy` response. |
+| `tail` | no | How many recent lines to fetch (default 200, max 1000). |
+
+Works for unclaimed (agent-deployed) apps addressed by deployment ID. Once an app is claimed it moves to the owner's account; use the dashboard or the authenticated API for a claimed app's logs.
+
 ## Config
 
 | Env var | Default | Description |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@velixir/mcp",
-  "version": "0.1.2",
-  "description": "Deploy web apps in any language to Velixir (the European cloud) straight from your AI agent. One tool: point it at a directory, get back a live URL and a claim link.",
+  "version": "0.2.0",
+  "description": "Deploy web apps in any language to Velixir (the European cloud) straight from your AI agent: point deploy at a directory for a live URL and claim link, then read logs to debug what you shipped.",
   "type": "module",
   "bin": {
     "velixir-mcp": "src/index.js"

package/src/index.js

@@ -1,8 +1,11 @@
 #!/usr/bin/env node
-// Velixir MCP server. Exposes one tool, `deploy`, that packs a source directory,
-// posts it to Velixir's account-less deploy endpoint (POST /api/v1/deploy), and
-// returns a live URL plus a single-use claim link the human opens to keep the app
-// on a free, card-free account. No Velixir account is needed to deploy.
+// Velixir MCP server. Exposes two tools:
+//   - `deploy`: pack a source directory and POST it to Velixir's account-less deploy
+//     endpoint (POST /api/v1/deploy), returning a live URL + a single-use claim link
+//     the human opens to keep the app on a free, card-free account.
+//   - `logs`: fetch recent build + runtime logs for a deployment by its ID
+//     (GET /api/v1/deploy/{id}/logs), so the agent can debug what it just shipped.
+// No Velixir account is needed for either.
 //
 // Zero setup: run with `npx -y @velixir/mcp`. Point VELIXIR_API_URL at a different
 // host for staging/self-host (default https://velixir.net).
@@ -43,7 +46,7 @@ async function tarballOf(dir) {
   return Buffer.concat(chunks);
 }
 
-const server = new McpServer({ name: "velixir", version: "0.1.0" });
+const server = new McpServer({ name: "velixir", version: "0.2.0" });
 
 server.tool(
   "deploy",
@@ -108,6 +111,9 @@ server.tool(
         ? `Claim URL: ${data.claim_url}\n(Give this to the user. Opening it keeps the app on a free, card-free Velixir account; unclaimed apps are removed after a short window.)`
         : null,
       data.claim_expires_at ? `Claim before: ${data.claim_expires_at}` : null,
+      data.deployment_id
+        ? `Deployment ID: ${data.deployment_id}\n(Use the "logs" tool with this ID to see build/runtime logs and debug if the app doesn't come up.)`
+        : null,
       data.status_url ? `Deployment status: ${data.status_url}` : null,
     ].filter(Boolean);
 
@@ -115,5 +121,56 @@ server.tool(
   },
 );
 
+server.tool(
+  "logs",
+  "Fetch recent build and runtime logs for an app you deployed to Velixir, by its deployment ID (from the `deploy` tool's response). Use this to debug: if the build failed you get the build error; if it built but isn't responding you get the container's recent output. No Velixir account is needed.",
+  {
+    deployment_id: z
+      .string()
+      .describe("The deployment ID returned by the `deploy` tool."),
+    tail: z
+      .number()
+      .int()
+      .optional()
+      .describe("How many recent log lines to fetch (default 200, max 1000)."),
+  },
+  async ({ deployment_id, tail }) => {
+    const qs = tail != null ? `?tail=${encodeURIComponent(tail)}` : "";
+    const url = `${API_URL}/api/v1/deploy/${encodeURIComponent(deployment_id)}/logs${qs}`;
+
+    let res, body;
+    try {
+      res = await fetch(url);
+      body = await res.text();
+    } catch (err) {
+      return { isError: true, content: [{ type: "text", text: `Could not reach Velixir at ${API_URL}: ${err?.message ?? err}` }] };
+    }
+
+    if (res.status === 404) {
+      return { isError: true, content: [{ type: "text", text: `No logs for deployment ${deployment_id}. It may not exist, may already be claimed (use the dashboard for claimed apps), or its unclaimed window may have passed.` }] };
+    }
+    if (!res.ok) {
+      return { isError: true, content: [{ type: "text", text: `Could not fetch logs (HTTP ${res.status}): ${body}` }] };
+    }
+
+    let data;
+    try { data = JSON.parse(body); } catch { data = {}; }
+
+    const out = [];
+    if (data.status) out.push(`Status: ${data.status}`);
+    if (data.build_error) out.push(`Build error:\n${data.build_error}`);
+
+    const logLines = Array.isArray(data.lines) ? data.lines : [];
+    if (logLines.length) {
+      out.push("Recent logs:");
+      for (const l of logLines) out.push(l.line ?? "");
+    } else if (!data.build_error) {
+      out.push("No log lines yet (the app may still be starting, or has produced no output).");
+    }
+
+    return { content: [{ type: "text", text: out.join("\n") }] };
+  },
+);
+
 const transport = new StdioServerTransport();
 await server.connect(transport);