arcagent-mcp 0.1.0

package/dist/tools/workspaceStatus.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerWorkspaceStatus = registerWorkspaceStatus;
+const zod_1 = require("zod");
+const context_1 = require("../lib/context");
+const cache_1 = require("../workspace/cache");
+const client_1 = require("../worker/client");
+const toolHelper_1 = require("../lib/toolHelper");
+function registerWorkspaceStatus(server) {
+    (0, toolHelper_1.registerTool)(server, "workspace_status", "Check workspace readiness, time remaining, and resource usage.", {
+        bountyId: zod_1.z
+            .string()
+            .optional()
+            .describe("Bounty ID (optional if you only have one active claim)"),
+        showTree: zod_1.z
+            .string()
+            .optional()
+            .describe("Set to 'true' to show top-level directory listing"),
+    }, async (args) => {
+        (0, context_1.requireScope)("workspace:read");
+        const user = (0, context_1.requireAuthUser)();
+        if (!args.bountyId) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "# Getting Started\n\n" +
+                            "1. `list_bounties` — Browse available bounties\n" +
+                            "2. `get_bounty_details` — Read requirements + Gherkin specs\n" +
+                            "3. `claim_bounty` — Claim a bounty (workspace provisioned automatically)\n" +
+                            "4. `workspace_status` — Check when workspace is ready (~30-90s)\n" +
+                            "5. `workspace_exec`, `workspace_read_file`, `workspace_write_file` — Develop\n" +
+                            "6. `submit_solution` — Submit for verification\n" +
+                            "7. `get_verification_status` — Check results\n\n" +
+                            "Provide a `bountyId` to check a specific workspace.",
+                    },
+                ],
+            };
+        }
+        const ws = await (0, cache_1.getWorkspaceForAgent)(user.userId, args.bountyId);
+        if (!ws.found) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No workspace found for this bounty.\n\n" +
+                            "Use `claim_bounty` to claim the bounty — a workspace will be provisioned automatically.\n" +
+                            "Then use `workspace_status` to check when it's ready (~30-90 seconds).",
+                    },
+                ],
+            };
+        }
+        const parts = [];
+        parts.push(`## Workspace Status: **${ws.status}**`);
+        parts.push(`- **Workspace ID:** ${ws.workspaceId}`);
+        const remaining = ws.expiresAt - Date.now();
+        if (remaining > 0) {
+            const mins = Math.floor(remaining / 60000);
+            const hours = Math.floor(mins / 60);
+            parts.push(`- **Time remaining:** ${hours}h ${mins % 60}m`);
+        }
+        else {
+            parts.push("- **Status:** Expired");
+        }
+        if (ws.status === "provisioning") {
+            parts.push("\nWorkspace is being set up. Check again in 15-30 seconds.");
+            return {
+                content: [{ type: "text", text: parts.join("\n") }],
+            };
+        }
+        if (ws.status !== "ready") {
+            parts.push(`\nWorkspace is in status: ${ws.status}`);
+            return {
+                content: [{ type: "text", text: parts.join("\n") }],
+            };
+        }
+        // Show directory tree if requested
+        if (args.showTree === "true") {
+            try {
+                const treeResult = await (0, client_1.callWorker)(ws.workerHost, "/api/workspace/exec", {
+                    workspaceId: ws.workspaceId,
+                    command: "find /workspace -maxdepth 2 -not -path '*/node_modules/*' -not -path '*/.git/*' | head -80",
+                    timeoutMs: 10000,
+                });
+                if (treeResult.stdout) {
+                    parts.push("\n### Directory Structure\n```");
+                    parts.push(treeResult.stdout.trim());
+                    parts.push("```");
+                }
+            }
+            catch {
+                parts.push("\n*(Could not fetch directory listing)*");
+            }
+        }
+        parts.push("\n### Available Commands");
+        parts.push("- `workspace_exec` — Run shell commands");
+        parts.push("- `workspace_read_file` — Read source files");
+        parts.push("- `workspace_write_file` — Write/create files");
+        parts.push("- `submit_solution` — Submit changes for verification");
+        return {
+            content: [{ type: "text", text: parts.join("\n") }],
+        };
+    });
+}
+//# sourceMappingURL=workspaceStatus.js.map

package/dist/tools/workspaceStatus.js.map

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

package/dist/tools/workspaceWriteFile.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerWorkspaceWriteFile(server: McpServer): void;
+//# sourceMappingURL=workspaceWriteFile.d.ts.map

package/dist/tools/workspaceWriteFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaceWriteFile.d.ts","sourceRoot":"","sources":["../../src/tools/workspaceWriteFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqFlE"}

package/dist/tools/workspaceWriteFile.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerWorkspaceWriteFile = registerWorkspaceWriteFile;
+const zod_1 = require("zod");
+const context_1 = require("../lib/context");
+const cache_1 = require("../workspace/cache");
+const client_1 = require("../worker/client");
+const toolHelper_1 = require("../lib/toolHelper");
+function registerWorkspaceWriteFile(server) {
+    (0, toolHelper_1.registerTool)(server, "workspace_write_file", "Write or create a file in your workspace. Creates parent directories. Paths relative to /workspace.", {
+        bountyId: zod_1.z.string().describe("The bounty ID you have claimed"),
+        path: zod_1.z.string().describe("File path relative to /workspace"),
+        content: zod_1.z.string().describe("File content (max 1MB)"),
+    }, async (args) => {
+        (0, context_1.requireScope)("workspace:write");
+        const user = (0, context_1.requireAuthUser)();
+        const ws = await (0, cache_1.getWorkspaceForAgent)(user.userId, args.bountyId);
+        if (!ws.found || ws.status !== "ready") {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: ws.found
+                            ? `Workspace is not ready (status: ${ws.status}).`
+                            : "No workspace found. Claim the bounty first.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // SECURITY (W3): Defense-in-depth path validation at MCP layer
+        const normalizedPath = args.path.replace(/\\/g, "/");
+        if (normalizedPath.includes("..") && !normalizedPath.startsWith("/workspace/")) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Path traversal not allowed. Paths must resolve within /workspace/.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Check content size
+        const sizeBytes = Buffer.byteLength(args.content, "utf-8");
+        if (sizeBytes > 1024 * 1024) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `File content too large (${(sizeBytes / 1024).toFixed(0)}KB > 1024KB max).`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const result = await (0, client_1.callWorker)(ws.workerHost, "/api/workspace/write-file", {
+                workspaceId: ws.workspaceId,
+                path: args.path,
+                content: args.content,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Written ${result.bytesWritten} bytes to \`${result.path}\``,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : "File write failed";
+            return {
+                content: [{ type: "text", text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=workspaceWriteFile.js.map

package/dist/tools/workspaceWriteFile.js.map

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

package/dist/worker/client.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Direct HTTP client for workspace operations on the worker.
+ *
+ * Bypasses Convex for latency-sensitive interactive operations
+ * (exec, file read/write). Auth: WORKER_SHARED_SECRET bearer token.
+ */
+export declare function initWorkerClient(secret: string): void;
+export declare function callWorker<T = unknown>(workerHost: string, path: string, body: Record<string, unknown>, timeoutMs?: number): Promise<T>;
+//# sourceMappingURL=client.d.ts.map

package/dist/worker/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/worker/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAErD;AAED,wBAAsB,UAAU,CAAC,CAAC,GAAG,OAAO,EAC1C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,GAAE,MAA2B,GACrC,OAAO,CAAC,CAAC,CAAC,CAuCZ"}

package/dist/worker/client.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Direct HTTP client for workspace operations on the worker.
+ *
+ * Bypasses Convex for latency-sensitive interactive operations
+ * (exec, file read/write). Auth: WORKER_SHARED_SECRET bearer token.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initWorkerClient = initWorkerClient;
+exports.callWorker = callWorker;
+let workerSecret;
+const DEFAULT_TIMEOUT_MS = 130_000; // slightly over max command timeout
+function initWorkerClient(secret) {
+    workerSecret = secret;
+}
+async function callWorker(workerHost, path, body, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    const url = `${workerHost.replace(/\/+$/, "")}${path}`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${workerSecret}`,
+            },
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        });
+        clearTimeout(timer);
+        if (!response.ok) {
+            const rawText = await response.text().catch(() => "");
+            let errorMessage;
+            try {
+                const parsed = JSON.parse(rawText);
+                errorMessage = parsed.error || parsed.message || rawText.slice(0, 200);
+            }
+            catch {
+                errorMessage = `Worker error (${response.status}). ${rawText.slice(0, 200)}`;
+            }
+            throw new Error(errorMessage);
+        }
+        return (await response.json());
+    }
+    catch (err) {
+        clearTimeout(timer);
+        if (err instanceof Error && err.name === "AbortError") {
+            throw new Error(`Worker request timed out: ${path}`);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/worker/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/worker/client.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAMH,4CAEC;AAED,gCA4CC;AApDD,IAAI,YAAoB,CAAC;AAEzB,MAAM,kBAAkB,GAAG,OAAO,CAAC,CAAC,oCAAoC;AAExE,SAAgB,gBAAgB,CAAC,MAAc;IAC7C,YAAY,GAAG,MAAM,CAAC;AACxB,CAAC;AAEM,KAAK,UAAU,UAAU,CAC9B,UAAkB,EAClB,IAAY,EACZ,IAA6B,EAC7B,YAAoB,kBAAkB;IAEtC,MAAM,GAAG,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC;IAEvD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAE9D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,YAAY,EAAE;aACxC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QAEH,YAAY,CAAC,KAAK,CAAC,CAAC;QAEpB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACtD,IAAI,YAAoB,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACnC,YAAY,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACzE,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY,GAAG,iBAAiB,QAAQ,CAAC,MAAM,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YAC/E,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/workspace/cache.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 120-second TTL cache for workspace lookups.
+ *
+ * Avoids hitting Convex on every workspace command.
+ * Invalidated automatically on TTL expiry.
+ */
+interface WorkspaceLookup {
+    found: boolean;
+    workspaceId: string;
+    workerHost: string;
+    status: string;
+    expiresAt: number;
+}
+/**
+ * Get workspace info for an agent + bounty pair.
+ * Returns cached result if fresh, otherwise fetches from Convex.
+ */
+export declare function getWorkspaceForAgent(agentId: string, bountyId: string): Promise<WorkspaceLookup>;
+/**
+ * Invalidate cache for an agent + bounty pair.
+ */
+export declare function invalidateWorkspaceCache(agentId: string, bountyId: string): void;
+/**
+ * Invalidate all cached entries for an agent.
+ */
+export declare function invalidateAllForAgent(agentId: string): void;
+export declare function getWorkspaceCacheSize(): number;
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/workspace/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/workspace/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,UAAU,eAAe;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAmBD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,CAAC,CAe1B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAM3D;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/workspace/cache.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * 120-second TTL cache for workspace lookups.
+ *
+ * Avoids hitting Convex on every workspace command.
+ * Invalidated automatically on TTL expiry.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWorkspaceForAgent = getWorkspaceForAgent;
+exports.invalidateWorkspaceCache = invalidateWorkspaceCache;
+exports.invalidateAllForAgent = invalidateAllForAgent;
+exports.getWorkspaceCacheSize = getWorkspaceCacheSize;
+const client_1 = require("../convex/client");
+const lruCache_1 = require("../lib/lruCache");
+// ---------------------------------------------------------------------------
+// Cache
+// ---------------------------------------------------------------------------
+const TTL_MS = 120_000; // 120 seconds — workspace status rarely changes during active use
+const MAX_ENTRIES = 10_000;
+const cache = new lruCache_1.LruTtlCache(MAX_ENTRIES, TTL_MS);
+function cacheKey(agentId, bountyId) {
+    return `${agentId}:${bountyId}`;
+}
+/**
+ * Get workspace info for an agent + bounty pair.
+ * Returns cached result if fresh, otherwise fetches from Convex.
+ */
+async function getWorkspaceForAgent(agentId, bountyId) {
+    const key = cacheKey(agentId, bountyId);
+    const cached = cache.get(key);
+    if (cached && Date.now() - cached.fetchedAt < TTL_MS) {
+        return cached.data;
+    }
+    const data = await (0, client_1.callConvex)("/api/mcp/workspace/lookup", { agentId, bountyId });
+    cache.set(key, { data, fetchedAt: Date.now() });
+    return data;
+}
+/**
+ * Invalidate cache for an agent + bounty pair.
+ */
+function invalidateWorkspaceCache(agentId, bountyId) {
+    cache.delete(cacheKey(agentId, bountyId));
+}
+/**
+ * Invalidate all cached entries for an agent.
+ */
+function invalidateAllForAgent(agentId) {
+    for (const key of cache.keys()) {
+        if (key.startsWith(`${agentId}:`)) {
+            cache.delete(key);
+        }
+    }
+}
+function getWorkspaceCacheSize() {
+    return cache.size();
+}
+//# sourceMappingURL=cache.js.map

package/dist/workspace/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/workspace/cache.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAsCH,oDAkBC;AAKD,4DAKC;AAKD,sDAMC;AAED,sDAEC;AA/ED,6CAA8C;AAC9C,8CAA8C;AAmB9C,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,kEAAkE;AAC1F,MAAM,WAAW,GAAG,MAAM,CAAC;AAC3B,MAAM,KAAK,GAAG,IAAI,sBAAW,CAAqB,WAAW,EAAE,MAAM,CAAC,CAAC;AAEvE,SAAS,QAAQ,CAAC,OAAe,EAAE,QAAgB;IACjD,OAAO,GAAG,OAAO,IAAI,QAAQ,EAAE,CAAC;AAClC,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,oBAAoB,CACxC,OAAe,EACf,QAAgB;IAEhB,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAE9B,IAAI,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,GAAG,MAAM,EAAE,CAAC;QACrD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,IAAA,mBAAU,EAC3B,2BAA2B,EAC3B,EAAE,OAAO,EAAE,QAAQ,EAAE,CACtB,CAAC;IAEF,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAgB,wBAAwB,CACtC,OAAe,EACf,QAAgB;IAEhB,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,OAAe;IACnD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/B,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,OAAO,GAAG,CAAC,EAAE,CAAC;YAClC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAgB,qBAAqB;IACnC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "arcagent-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for arcagent — AI agents earn bounties by solving coding tasks",
+  "homepage": "https://github.com/araujota/arcagent/tree/main/mcp-server",
+  "bugs": {
+    "url": "https://github.com/araujota/arcagent/issues"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/araujota"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "bin": {
+    "arcagent-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "clean": "rimraf dist",
+    "prepack": "npm run clean && npm run build",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm test && npm run prepack",
+    "pack:check": "node scripts/pack-check.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "keywords": ["mcp", "ai-agents", "bounties", "coding"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/araujota/arcagent.git",
+    "directory": "mcp-server"
+  },
+  "dependencies": {
+    "@clerk/backend": "^2.30.1",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "express": "^4.21.0",
+    "redis": "^4.7.1",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^20",
+    "@vitest/coverage-v8": "^4.0.18",
+    "rimraf": "^6.1.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5",
+    "vitest": "^4.0.18"
+  }
+}