@otwa/mcp-server 0.1.0

package/dist/tools/webhooks.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerWebhookTools = registerWebhookTools;
+const zod_1 = require("zod");
+const confirm_1 = require("../guards/confirm");
+const _helpers_1 = require("./_helpers");
+function registerWebhookTools(server, client) {
+    server.registerTool('otwa_list_webhooks', {
+        title: 'List webhook subscriptions',
+        description: 'Returns every webhook the account has registered, with delivery URL and the events each one ' +
+            'subscribes to (e.g. server.created, invoice.paid).',
+        inputSchema: {},
+    }, (0, _helpers_1.safeHandler)(async () => {
+        const res = await client.request('/v1/webhooks');
+        return (0, _helpers_1.jsonResult)(res);
+    }));
+    server.registerTool('otwa_create_webhook', {
+        title: 'Register a new webhook subscription',
+        description: 'Creates a webhook subscription. otwa.cloud will POST signed JSON to the given URL whenever any ' +
+            'of the listed events fire. The signing secret is returned ONCE in this response — save it; the ' +
+            'API will not reveal it again unless explicitly rotated.',
+        inputSchema: {
+            url: zod_1.z
+                .string()
+                .url()
+                .describe('HTTPS endpoint that will receive delivery POSTs. Must accept JSON.'),
+            events: zod_1.z
+                .array(zod_1.z.string().min(1))
+                .min(1)
+                .describe('Event names to subscribe to, e.g. ["server.created", "server.destroyed", "invoice.paid"].'),
+        },
+    }, (0, _helpers_1.safeHandler)(async ({ url, events }) => {
+        const res = await client.request('/v1/webhooks', {
+            method: 'POST',
+            body: { url, events },
+        });
+        return (0, _helpers_1.jsonResult)(res);
+    }));
+    server.registerTool('otwa_delete_webhook', {
+        title: 'Delete a webhook subscription',
+        description: 'Permanently removes a webhook. Any in-flight deliveries finish; nothing further is sent. ' +
+            'Cannot be undone — the consumer just needs to re-create it.',
+        inputSchema: {
+            id: zod_1.z.string().describe('Webhook UUID.'),
+            ...confirm_1.mediumConfirm,
+        },
+    }, (0, _helpers_1.safeHandler)(async ({ id }) => {
+        const res = await client.request(`/v1/webhooks/${encodeURIComponent(id)}`, {
+            method: 'DELETE',
+        });
+        return (0, _helpers_1.jsonResult)(res);
+    }));
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/tools/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../src/tools/webhooks.ts"],"names":[],"mappings":";;AAOA,oDAiEC;AAvED,6BAAwB;AAGxB,+CAAkD;AAClD,yCAAqD;AAErD,SAAgB,oBAAoB,CAAC,MAAiB,EAAE,MAAkB;IACxE,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,4BAA4B;QACnC,WAAW,EACT,8FAA8F;YAC9F,oDAAoD;QACtD,WAAW,EAAE,EAAE;KAChB,EACD,IAAA,sBAAW,EAAC,KAAK,IAAI,EAAE;QACrB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAAmB,cAAc,CAAC,CAAC;QACnE,OAAO,IAAA,qBAAU,EAAC,GAAG,CAAC,CAAC;IACzB,CAAC,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,qCAAqC;QAC5C,WAAW,EACT,iGAAiG;YACjG,iGAAiG;YACjG,yDAAyD;QAC3D,WAAW,EAAE;YACX,GAAG,EAAE,OAAC;iBACH,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,CAAC,oEAAoE,CAAC;YACjF,MAAM,EAAE,OAAC;iBACN,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;iBACxB,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CACP,2FAA2F,CAC5F;SACJ;KACF,EACD,IAAA,sBAAW,EAAC,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;QACpC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAAiB,cAAc,EAAE;YAC/D,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;SACtB,CAAC,CAAC;QACH,OAAO,IAAA,qBAAU,EAAC,GAAG,CAAC,CAAC;IACzB,CAAC,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,+BAA+B;QACtC,WAAW,EACT,2FAA2F;YAC3F,6DAA6D;QAC/D,WAAW,EAAE;YACX,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;YACxC,GAAG,uBAAa;SACjB;KACF,EACD,IAAA,sBAAW,EAAC,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QAC3B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,gBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE;YACzE,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QACH,OAAO,IAAA,qBAAU,EAAC,GAAG,CAAC,CAAC;IACzB,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/util/env.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readEnv = readEnv;
+function readEnv() {
+    const apiKey = process.env.OTWA_API_KEY?.trim() || '';
+    if (!apiKey) {
+        throw new Error('OTWA_API_KEY is not set. Create one at https://otwa.cloud/dashboard/settings/api-keys ' +
+            'and set the OTWA_API_KEY environment variable, then restart this MCP server.');
+    }
+    if (!apiKey.startsWith('otwa_')) {
+        throw new Error('OTWA_API_KEY does not look like an otwa.cloud API key (expected prefix "otwa_"). ' +
+            'Generate a new key at https://otwa.cloud/dashboard/settings/api-keys.');
+    }
+    const apiBase = (process.env.OTWA_API_BASE?.trim() || 'https://api.otwa.cloud').replace(/\/+$/, '');
+    const telemetry = /^(1|true|yes)$/i.test(process.env.OTWA_TELEMETRY?.trim() || '');
+    return { apiKey, apiBase, telemetry };
+}
+//# sourceMappingURL=env.js.map

package/dist/util/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/util/env.ts"],"names":[],"mappings":";;AAMA,0BAiBC;AAjBD,SAAgB,OAAO;IACrB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACtD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,wFAAwF;YACtF,8EAA8E,CACjF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,mFAAmF;YACjF,uEAAuE,CAC1E,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,wBAAwB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACpG,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACnF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACxC,CAAC"}

package/dist/util/version.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.packageInfo = packageInfo;
+const fs_1 = require("fs");
+const path_1 = require("path");
+let cached = null;
+function packageInfo() {
+    if (cached)
+        return cached;
+    try {
+        const raw = (0, fs_1.readFileSync)((0, path_1.join)(__dirname, '..', '..', 'package.json'), 'utf-8');
+        const pkg = JSON.parse(raw);
+        cached = { name: pkg.name || '@otwa/mcp-server', version: pkg.version || '0.0.0' };
+    }
+    catch {
+        cached = { name: '@otwa/mcp-server', version: '0.0.0' };
+    }
+    return cached;
+}
+//# sourceMappingURL=version.js.map

package/dist/util/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/util/version.ts"],"names":[],"mappings":";;AAKA,kCAUC;AAfD,2BAAkC;AAClC,+BAA4B;AAE5B,IAAI,MAAM,GAA6C,IAAI,CAAC;AAE5D,SAAgB,WAAW;IACzB,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,iBAAY,EAAC,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwC,CAAC;QACnE,MAAM,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,kBAAkB,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@otwa/mcp-server",
+  "version": "0.1.0",
+  "description": "Official Model Context Protocol server for otwa.cloud — provision and manage servers from Claude Code, Cursor, Windsurf and other MCP-capable AI tools.",
+  "license": "MIT",
+  "homepage": "https://otwa.cloud/docs/integrations/mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/otwacloud/mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/otwacloud/mcp-server/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "otwa",
+    "otwa.cloud",
+    "vps",
+    "cloud",
+    "claude",
+    "cursor",
+    "ai"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "bin": {
+    "otwa-mcp": "dist/index.js",
+    "otwa-mcp-http": "dist/http/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.21.0",
+    "express": "^4.21.0",
+    "zod": "4.3.6"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "dev:http": "tsx watch src/http/index.ts",
+    "start": "node dist/index.js",
+    "start:http": "node dist/http/index.js",
+    "build": "tsc -p tsconfig.json",
+    "type-check": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist"
+  }
+}