capix-mcp 2.1.0

package/dist/resources.js

@@ -0,0 +1,101 @@
+/**
+ * Capix MCP Server — resources (capix:// URIs).
+ *
+ * Resources are read-only views the MCP client can list and read by URI. They
+ * mirror the discovery + website sub-ports: account, balance, projects,
+ * catalogs, deployments, receipts, attestations, websites, and memory/skills
+ * intelligence surfaces.
+ *
+ * `registerResources(server, client)` wires each `capix://…` URI to a
+ * `readResource` callback that delegates to the canonical Capix API client.
+ */
+export const CAPIX_RESOURCES = [
+    {
+        uri: "capix://account",
+        name: "Account",
+        description: "Authenticated account inspection snapshot (wallet, spending limit, active deploys).",
+        mimeType: "application/json",
+    },
+    {
+        uri: "capix://balance",
+        name: "Balance",
+        description: "Customer cash balance (available / held / total) per asset.",
+        mimeType: "application/json",
+    },
+    {
+        uri: "capix://projects",
+        name: "Projects",
+        description: "Projects visible to the authenticated account.",
+        mimeType: "application/json",
+    },
+    {
+        uri: "capix://models",
+        name: "Models",
+        description: "Live model endpoint catalog (model id, context length, price per 1k tokens).",
+        mimeType: "application/json",
+    },
+    {
+        uri: "capix://deployments",
+        name: "Deployments",
+        description: "Deployments for the account/project with phase + allocation state.",
+        mimeType: "application/json",
+    },
+    {
+        uri: "capix://receipts",
+        name: "Receipts",
+        description: "Settled work receipts (cost records).",
+        mimeType: "application/json",
+    },
+    {
+        uri: "capix://memory",
+        name: "Memory",
+        description: "Recent Capix intelligence memory nodes for the active project.",
+        mimeType: "application/json",
+    },
+    {
+        uri: "capix://skills",
+        name: "Skills",
+        description: "Registered Capix skills available to the project.",
+        mimeType: "application/json",
+    },
+];
+const RESOURCE_READERS = {
+    account: (c) => c.get("/api/v1/account"),
+    balance: (c) => c.get("/api/v1/account/balance"),
+    projects: (c) => c.get("/api/v1/projects", { limit: 50 }),
+    models: (c) => c.get("/api/v1/catalog/models"),
+    deployments: (c) => c.get("/api/v1/deployments", { limit: 50 }),
+    receipts: (c) => c.get("/api/v1/receipts", { limit: 50 }),
+    memory: (c) => c.get("/api/v1/account/memory"),
+    skills: (c) => c.get("/api/v1/account/skills"),
+};
+/**
+ * Register all capix:// resources with the given McpServer. Each resource's
+ * read callback delegates to the canonical Capix API client and returns the
+ * raw JSON object as a text content block.
+ */
+export function registerResources(server, client) {
+    for (const res of CAPIX_RESOURCES) {
+        const key = res.uri.replace(/^capix:\/\//, "");
+        const reader = RESOURCE_READERS[key];
+        if (!reader)
+            continue;
+        server.registerResource(res.name, res.uri, {
+            description: res.description,
+            mimeType: res.mimeType,
+        }, async () => {
+            const data = await reader(client);
+            const text = typeof data === "string" ? data : JSON.stringify(data, null, 2);
+            return {
+                contents: [
+                    {
+                        uri: res.uri,
+                        mimeType: res.mimeType,
+                        text,
+                    },
+                ],
+            };
+        });
+    }
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Capix MCP Server — the McpServer assembly + transport wiring.
+ *
+ * `createCapixMcpServer(client)` builds an {@link McpServer} with all 59
+ * tools, the capix:// resources, and the guided prompts registered. Each tool
+ * registration wires:
+ *   - inputSchema  → the tool's Zod raw shape (validated by the SDK)
+ *   - outputSchema → the tool's Zod raw output shape
+ *   - annotations   → readOnlyHint / destructiveHint / idempotentHint derived
+ *                    from the billable/requiresApproval/scope flags
+ *
+ * The dispatch callback enforces the Capix control-plane invariants:
+ *   1. billable / requiresApproval tools refuse to run without an
+ *      approvalToken (surfaced as a structured MCP error with capixCode
+ *      `approval_required`). The agent must re-request with a bound token.
+ *   2. read-only tools (billable=false, requiresApproval=false) auto-run.
+ *   3. every billable tool's cost is the canonical quote the agent obtained
+ *      upstream (no in-line price guess); the approval token binds that quote.
+ *
+ * Transports:
+ *   - stdio        : StdioServerTransport, for local agent integration
+ *   - streamable HTTP : StreamableHTTPServerTransport, for remote / hosted use
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CapixClient } from "./client.js";
+import type { ToolDef, ToolScope } from "./types.js";
+/**
+ * Build a fully-wired McpServer. All 59 tools, resources, and prompts are
+ * registered before returning; the caller just attaches a transport.
+ */
+export declare function createCapixMcpServer(client: CapixClient, opts?: {
+    version?: string;
+}): McpServer;
+export interface CapixServerOptions {
+    version?: string;
+    /** HTTP port for the streamable HTTP transport (0 = don't start HTTP). */
+    httpPort?: number;
+    /** Bearer service token guarding the HTTP transport (required if httpPort>0). */
+    httpServiceToken?: string;
+}
+/** Start the MCP server on stdio (the default for local agent integration). */
+export declare function startStdioServer(client: CapixClient, opts?: CapixServerOptions): Promise<void>;
+/**
+ * Start the MCP server on a streamable HTTP transport.
+ *
+ * The server exposes the MCP JSON-RPC endpoint at `/mcp` (POST for requests,
+ * GET for SSE streams). A `/healthz` endpoint reports wired tool count. The
+ * transport is stateful (session id per connection) by default.
+ */
+export declare function startHttpServer(client: CapixClient, opts: CapixServerOptions & {
+    httpPort: number;
+    httpServiceToken: string;
+}): Promise<void>;
+export declare function getToolSummary(): Array<{
+    name: string;
+    scope: ToolScope;
+    billable: boolean;
+    requiresApproval: boolean;
+}>;
+export declare function lookupTool(name: string): ToolDef | undefined;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAsBrD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,SAAS,CAmFX;AA8DD,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,+EAA+E;AAC/E,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,kBAAkB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,GACxE,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAMD,wBAAgB,cAAc,IAAI,KAAK,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC,CAOD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE5D"}

package/dist/server.js

@@ -0,0 +1,223 @@
+/**
+ * Capix MCP Server — the McpServer assembly + transport wiring.
+ *
+ * `createCapixMcpServer(client)` builds an {@link McpServer} with all 59
+ * tools, the capix:// resources, and the guided prompts registered. Each tool
+ * registration wires:
+ *   - inputSchema  → the tool's Zod raw shape (validated by the SDK)
+ *   - outputSchema → the tool's Zod raw output shape
+ *   - annotations   → readOnlyHint / destructiveHint / idempotentHint derived
+ *                    from the billable/requiresApproval/scope flags
+ *
+ * The dispatch callback enforces the Capix control-plane invariants:
+ *   1. billable / requiresApproval tools refuse to run without an
+ *      approvalToken (surfaced as a structured MCP error with capixCode
+ *      `approval_required`). The agent must re-request with a bound token.
+ *   2. read-only tools (billable=false, requiresApproval=false) auto-run.
+ *   3. every billable tool's cost is the canonical quote the agent obtained
+ *      upstream (no in-line price guess); the approval token binds that quote.
+ *
+ * Transports:
+ *   - stdio        : StdioServerTransport, for local agent integration
+ *   - streamable HTTP : StreamableHTTPServerTransport, for remote / hosted use
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { randomUUID } from "node:crypto";
+import http from "node:http";
+import { TOOLS, TOOL_MAP, TOOL_COUNT } from "./tools.js";
+import { registerResources } from "./resources.js";
+import { registerPrompts } from "./prompts.js";
+import { CapixApiError } from "./types.js";
+/** MCP tool annotations derived from a tool's billing/approval/scope flags. */
+function annotationsFor(tool) {
+    const isDestructive = (tool.scope === "lifecycle" && (tool.name === "capix_delete" || tool.name === "capix_cancel")) ||
+        tool.name === "capix_destroy_task_resources" ||
+        tool.name === "capix_website_destroy" ||
+        tool.name === "capix_website_domain_remove";
+    return {
+        readOnlyHint: !tool.billable && !tool.requiresApproval,
+        destructiveHint: isDestructive,
+        idempotentHint: !tool.billable || tool.scope === "discovery",
+        openWorldHint: true,
+    };
+}
+/**
+ * Build a fully-wired McpServer. All 59 tools, resources, and prompts are
+ * registered before returning; the caller just attaches a transport.
+ */
+export function createCapixMcpServer(client, opts) {
+    const server = new McpServer({
+        name: "capix-mcp",
+        version: opts?.version ?? "2.0.0",
+    });
+    // ── Tools ───────────────────────────────────────────────────────────────
+    for (const tool of TOOLS) {
+        server.registerTool(tool.name, {
+            title: tool.name.replace(/^capix_/, "").replace(/_/g, " "),
+            description: appendApprovalNote(tool),
+            inputSchema: tool.inputShape,
+            // Conditionally include outputSchema only when defined so the SDK's
+            // generic inference picks the ZodRawShape overload (not the empty-
+            // overload fallback) for both input and output.
+            ...(tool.outputShape ? { outputSchema: tool.outputShape } : {}),
+            annotations: annotationsFor(tool),
+            _meta: {
+                scope: tool.scope,
+                billable: tool.billable,
+                requiresApproval: tool.requiresApproval,
+            },
+        }, async (args, extra) => {
+            const actor = extra.authInfo?.name ?? "unknown";
+            const approvalToken = args.approvalToken ??
+                extra.params?.approvalToken;
+            // ── Approval gate ──────────────────────────────────────────────────
+            if ((tool.billable || tool.requiresApproval) && !approvalToken) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: "text",
+                            text: `approval_required: ${tool.name} ${tool.billable
+                                ? "moves funds or mutates provider state"
+                                : "mutates state"} and requires a bound approvalToken (§5). Re-request the tool call with an approvalToken obtained after the user reviewed the canonical cost.`,
+                        },
+                    ],
+                };
+            }
+            try {
+                const data = await tool.handler(args, {
+                    client,
+                    ctx: {
+                        actor,
+                        traceId: randomUUID(),
+                        approvalToken,
+                    },
+                });
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(data, (_k, v) => (typeof v === "bigint" ? v.toString() : v), 2),
+                        },
+                    ],
+                    structuredContent: data,
+                };
+            }
+            catch (err) {
+                return errorResult(err, tool.name);
+            }
+        });
+    }
+    // ── Resources + prompts ────────────────────────────────────────────────
+    registerResources(server, client);
+    registerPrompts(server);
+    return server;
+}
+/** Surface the billable/approval requirement alongside the description. */
+function appendApprovalNote(tool) {
+    if (!tool.billable && !tool.requiresApproval) {
+        return `${tool.description} [read-only — auto-runs after auth]`;
+    }
+    const tags = [];
+    if (tool.billable)
+        tags.push("billable");
+    if (tool.requiresApproval)
+        tags.push("requires approvalToken");
+    return `${tool.description} [${tags.join(", ")}]`;
+}
+/** Convert a thrown error into a structured MCP error result. */
+function errorResult(err, toolName) {
+    if (err instanceof CapixApiError) {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        ok: false,
+                        error: {
+                            capixCode: err.capixCode,
+                            message: err.message,
+                            status: err.status,
+                            problem: err.problem,
+                        },
+                        tool: toolName,
+                    }),
+                },
+            ],
+        };
+    }
+    const e = err;
+    return {
+        isError: true,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    ok: false,
+                    error: {
+                        capixCode: e.capixCode ?? "tool_internal_error",
+                        message: e.message ?? `${toolName} threw unexpectedly`,
+                        status: e.status,
+                    },
+                    tool: toolName,
+                }),
+            },
+        ],
+    };
+}
+/** Start the MCP server on stdio (the default for local agent integration). */
+export async function startStdioServer(client, opts) {
+    const server = createCapixMcpServer(client, opts);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+/**
+ * Start the MCP server on a streamable HTTP transport.
+ *
+ * The server exposes the MCP JSON-RPC endpoint at `/mcp` (POST for requests,
+ * GET for SSE streams). A `/healthz` endpoint reports wired tool count. The
+ * transport is stateful (session id per connection) by default.
+ */
+export async function startHttpServer(client, opts) {
+    const server = createCapixMcpServer(client, opts);
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: () => randomUUID(),
+    });
+    const httpServer = http.createServer(async (req, res) => {
+        const url = new URL(req.url ?? "/", `http://localhost:${opts.httpPort}`);
+        // Health/readiness for orchestrators.
+        if (req.method === "GET" && url.pathname === "/healthz") {
+            res.writeHead(200, { "content-type": "application/json" });
+            res.end(JSON.stringify({
+                ok: true,
+                service: "capix-mcp",
+                version: opts.version ?? "2.0.0",
+                tools: TOOL_COUNT,
+                authenticated: client.isAuthenticated(),
+            }));
+            return;
+        }
+        // All other paths flow through the MCP streamable HTTP transport.
+        await transport.handleRequest(req, res);
+    });
+    await server.connect(transport);
+    httpServer.listen(opts.httpPort);
+}
+// ===========================================================================
+// Introspection helpers (used by the `doctor` CLI command)
+// ===========================================================================
+export function getToolSummary() {
+    return TOOLS.map((t) => ({
+        name: t.name,
+        scope: t.scope,
+        billable: t.billable,
+        requiresApproval: t.requiresApproval,
+    }));
+}
+export function lookupTool(name) {
+    return TOOL_MAP.get(name);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Capix MCP Server — all 59 tool definitions.
+ *
+ * Each tool is declared with:
+ *   - inputShape  : a Zod raw shape (validated by the McpServer before dispatch)
+ *   - outputShape : a Zod raw shape describing the structured result envelope
+ *   - billable / requiresApproval : control-plane flags enforced by the server
+ *
+ * Handlers are deliberately thin: they translate Zod-validated arguments into
+ * canonical `/api/v1/*` client calls and return the upstream JSON object as
+ * structured content. The CapixApiError (problem+json) thrown by the client is
+ * caught by the server wrapper and surfaced as an MCP error result.
+ *
+ * Tools are grouped by scope (mirrors services/capix-mcp/tools/*.ts):
+ *   discovery (9) · planning (6) · lifecycle (7) · networking (8) ·
+ *   testing (6) · verification (6) · website (17)
+ */
+import type { ToolDef } from "./types.js";
+declare const discoveryTools: ToolDef[];
+declare const planningTools: ToolDef[];
+declare const lifecycleTools: ToolDef[];
+declare const networkingTools: ToolDef[];
+declare const testingTools: ToolDef[];
+declare const verificationTools: ToolDef[];
+declare const websiteTools: ToolDef[];
+export declare const TOOLS: ToolDef[];
+export declare const TOOL_NAMES: string[];
+export declare const TOOL_COUNT: number;
+/** Map of tool name → definition, used by the server for O(1) lookup. */
+export declare const TOOL_MAP: Map<string, ToolDef>;
+export { discoveryTools, planningTools, lifecycleTools, networkingTools, testingTools, verificationTools, websiteTools };
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAEV,OAAO,EAGR,MAAM,YAAY,CAAC;AAyIpB,QAAA,MAAM,cAAc,EAAE,OAAO,EAmK5B,CAAC;AAqCF,QAAA,MAAM,aAAa,EAAE,OAAO,EA8F3B,CAAC;AAMF,QAAA,MAAM,cAAc,EAAE,OAAO,EA0I5B,CAAC;AAMF,QAAA,MAAM,eAAe,EAAE,OAAO,EA8H7B,CAAC;AAMF,QAAA,MAAM,YAAY,EAAE,OAAO,EA4I1B,CAAC;AAMF,QAAA,MAAM,iBAAiB,EAAE,OAAO,EAmI/B,CAAC;AAaF,QAAA,MAAM,YAAY,EAAE,OAAO,EAmU1B,CAAC;AAMF,eAAO,MAAM,KAAK,EAAE,OAAO,EAQ1B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAAM,EAA6B,CAAC;AAE7D,eAAO,MAAM,UAAU,QAAe,CAAC;AAEvC,yEAAyE;AACzE,eAAO,MAAM,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAA0C,CAAC;AAErF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC"}