@spronta/mcp 0.1.0 → 0.1.1

package/dist/api.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Spronta REST API client for the MCP server.
+ * Thin fetch wrapper with Bearer token auth.
+ */
+export declare class SprontaApi {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey: string, baseUrl?: string);
+    request<T = unknown>(method: string, path: string, body?: unknown): Promise<T>;
+    /**
+     * Upload a file to a presigned URL.
+     */
+    uploadToPresigned(uploadUrl: string, fileBuffer: Buffer, contentType: string): Promise<void>;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,MAAsC;IAKrE,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,GACb,OAAO,CAAC,CAAC,CAAC;IAmCb;;OAEG;IACG,iBAAiB,CACrB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;CAWjB"}

package/dist/api.js

@@ -0,0 +1,55 @@
+/**
+ * Spronta REST API client for the MCP server.
+ * Thin fetch wrapper with Bearer token auth.
+ */
+export class SprontaApi {
+    apiKey;
+    baseUrl;
+    constructor(apiKey, baseUrl = "https://app.spronta.com/api") {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl.replace(/\/$/, "");
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+        };
+        if (body !== undefined) {
+            headers["Content-Type"] = "application/json";
+        }
+        const res = await fetch(url, {
+            method,
+            headers,
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        const text = await res.text();
+        let data;
+        try {
+            data = JSON.parse(text);
+        }
+        catch {
+            data = text;
+        }
+        if (!res.ok) {
+            const msg = typeof data === "object" && data !== null && "error" in data
+                ? data.error
+                : `HTTP ${res.status}: ${text.slice(0, 200)}`;
+            throw new Error(msg);
+        }
+        return data;
+    }
+    /**
+     * Upload a file to a presigned URL.
+     */
+    async uploadToPresigned(uploadUrl, fileBuffer, contentType) {
+        const res = await fetch(uploadUrl, {
+            method: "PUT",
+            headers: { "Content-Type": contentType },
+            body: fileBuffer,
+        });
+        if (!res.ok) {
+            throw new Error(`Upload failed: HTTP ${res.status}`);
+        }
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,UAAU;IACb,MAAM,CAAS;IACf,OAAO,CAAS;IAExB,YAAY,MAAc,EAAE,UAAkB,6BAA6B;QACzE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,OAAO,CACX,MAAc,EACd,IAAY,EACZ,IAAc;QAEd,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QACrC,MAAM,OAAO,GAA2B;YACtC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;SACvC,CAAC;QAEF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;QAC/C,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM;YACN,OAAO;YACP,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAC5D,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,GAAG,GACP,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,IAAI;gBAC1D,CAAC,CAAE,IAA0B,CAAC,KAAK;gBACnC,CAAC,CAAC,QAAQ,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;QAED,OAAO,IAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CACrB,SAAiB,EACjB,UAAkB,EAClB,WAAmB;QAEnB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE;YACjC,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE;YACxC,IAAI,EAAE,UAAU;SACjB,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Spronta MCP Server
+ *
+ * Exposes the Spronta Image CDN API as MCP tools for LLM integrations.
+ *
+ * Environment variables:
+ *   SPRONTA_API_KEY    — Required. Your project API key.
+ *   SPRONTA_PROJECT_ID — Optional. Default project ID (can be passed per-tool).
+ *   SPRONTA_API_URL    — Optional. API base URL (default: https://app.spronta.com/api).
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG"}

package/dist/index.js

@@ -0,0 +1,261 @@
+#!/usr/bin/env node
+/**
+ * Spronta MCP Server
+ *
+ * Exposes the Spronta Image CDN API as MCP tools for LLM integrations.
+ *
+ * Environment variables:
+ *   SPRONTA_API_KEY    — Required. Your project API key.
+ *   SPRONTA_PROJECT_ID — Optional. Default project ID (can be passed per-tool).
+ *   SPRONTA_API_URL    — Optional. API base URL (default: https://app.spronta.com/api).
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ListToolsRequestSchema, CallToolRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { SprontaApi } from "./api.js";
+import { TOOLS } from "./tools.js";
+// ── Config ──────────────────────────────────────────────────────
+const API_KEY = process.env.SPRONTA_API_KEY;
+const DEFAULT_PROJECT_ID = process.env.SPRONTA_PROJECT_ID;
+const API_URL = process.env.SPRONTA_API_URL ?? "https://app.spronta.com/api";
+const CDN_URL_DEFAULT = "https://cdn.spronta.com";
+if (!API_KEY) {
+    console.error("Error: SPRONTA_API_KEY environment variable is required.");
+    console.error("Get your API key from https://app.spronta.com");
+    process.exit(1);
+}
+const api = new SprontaApi(API_KEY, API_URL);
+// ── Helpers ─────────────────────────────────────────────────────
+function getProjectId(args) {
+    const id = args.projectId || DEFAULT_PROJECT_ID;
+    if (!id) {
+        throw new Error("projectId is required. Pass it as a parameter or set SPRONTA_PROJECT_ID env var.");
+    }
+    return id;
+}
+function ok(data) {
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(data, null, 2) },
+        ],
+    };
+}
+function detectContentType(filename) {
+    const ext = filename.split(".").pop()?.toLowerCase();
+    const map = {
+        jpg: "image/jpeg",
+        jpeg: "image/jpeg",
+        png: "image/png",
+        gif: "image/gif",
+        webp: "image/webp",
+        avif: "image/avif",
+        svg: "image/svg+xml",
+        tiff: "image/tiff",
+        tif: "image/tiff",
+        bmp: "image/bmp",
+    };
+    return map[ext ?? ""] ?? "image/jpeg";
+}
+// ── Tool handler ────────────────────────────────────────────────
+async function handleTool(name, args) {
+    switch (name) {
+        // ── Projects ─────────────────────────────────────────────
+        case "list_projects":
+            return ok(await api.request("GET", "/images/projects"));
+        case "create_project":
+            return ok(await api.request("POST", "/images/projects", { name: args.name }));
+        case "get_project": {
+            const pid = getProjectId(args);
+            return ok(await api.request("GET", `/images/projects/${pid}`));
+        }
+        case "update_project": {
+            const pid = getProjectId(args);
+            const body = {};
+            if (args.name !== undefined)
+                body.name = args.name;
+            if (args.customDomain !== undefined)
+                body.customDomain = args.customDomain;
+            return ok(await api.request("PATCH", `/images/projects/${pid}`, body));
+        }
+        case "delete_project": {
+            const pid = getProjectId(args);
+            return ok(await api.request("DELETE", `/images/projects/${pid}`));
+        }
+        // ── Upload ───────────────────────────────────────────────
+        case "upload_image": {
+            const pid = getProjectId(args);
+            const filename = args.filename;
+            const contentType = args.contentType || detectContentType(filename);
+            // Fetch the image data
+            let buffer;
+            if (args.imageData) {
+                buffer = Buffer.from(args.imageData, "base64");
+            }
+            else if (args.imageUrl) {
+                const res = await fetch(args.imageUrl);
+                if (!res.ok)
+                    throw new Error(`Failed to fetch image: HTTP ${res.status}`);
+                buffer = Buffer.from(await res.arrayBuffer());
+            }
+            else {
+                throw new Error("Either imageUrl or imageData (base64) is required.");
+            }
+            // Step 1: Initiate upload
+            const initiate = await api.request("POST", `/images/projects/${pid}/upload`, {
+                filename,
+                contentType,
+                fileSize: buffer.length,
+            });
+            // Step 2: Upload to presigned URL
+            await api.uploadToPresigned(initiate.uploadUrl, buffer, contentType);
+            // Step 3: Confirm
+            const confirmed = await api.request("POST", `/images/projects/${pid}/upload/confirm`, { imageId: initiate.imageId });
+            return ok(confirmed);
+        }
+        // ── Images ───────────────────────────────────────────────
+        case "list_images": {
+            const pid = getProjectId(args);
+            const params = new URLSearchParams();
+            if (args.limit)
+                params.set("limit", String(args.limit));
+            if (args.offset)
+                params.set("offset", String(args.offset));
+            const qs = params.toString();
+            return ok(await api.request("GET", `/images/projects/${pid}/images${qs ? `?${qs}` : ""}`));
+        }
+        case "update_image": {
+            const pid = getProjectId(args);
+            const body = {};
+            if (args.altText !== undefined)
+                body.altText = args.altText;
+            if (args.tags !== undefined)
+                body.tags = args.tags;
+            return ok(await api.request("PATCH", `/images/projects/${pid}/images/${args.imageId}`, body));
+        }
+        case "delete_image": {
+            const pid = getProjectId(args);
+            return ok(await api.request("DELETE", `/images/projects/${pid}/images/${args.imageId}`));
+        }
+        // ── Presets ──────────────────────────────────────────────
+        case "list_presets": {
+            const pid = getProjectId(args);
+            return ok(await api.request("GET", `/images/projects/${pid}/presets`));
+        }
+        case "create_preset": {
+            const pid = getProjectId(args);
+            return ok(await api.request("POST", `/images/projects/${pid}/presets`, {
+                name: args.name,
+                transforms: args.transforms,
+            }));
+        }
+        case "update_preset": {
+            const pid = getProjectId(args);
+            const body = {};
+            if (args.name !== undefined)
+                body.name = args.name;
+            if (args.transforms !== undefined)
+                body.transforms = args.transforms;
+            return ok(await api.request("PATCH", `/images/projects/${pid}/presets/${args.presetId}`, body));
+        }
+        case "delete_preset": {
+            const pid = getProjectId(args);
+            return ok(await api.request("DELETE", `/images/projects/${pid}/presets/${args.presetId}`));
+        }
+        // ── Signing ─────────────────────────────────────────────
+        case "get_signing_config": {
+            const pid = getProjectId(args);
+            return ok(await api.request("GET", `/images/projects/${pid}/signing`));
+        }
+        case "update_signing": {
+            const pid = getProjectId(args);
+            const body = {};
+            if (args.enabled !== undefined)
+                body.enabled = args.enabled;
+            if (args.requireSignedUrls !== undefined)
+                body.requireSignedUrls = args.requireSignedUrls;
+            return ok(await api.request("POST", `/images/projects/${pid}/signing`, body));
+        }
+        case "generate_signed_url": {
+            const pid = getProjectId(args);
+            return ok(await api.request("PUT", `/images/projects/${pid}/signing`, {
+                path: args.path,
+                params: args.params,
+                expiresIn: args.expiresIn,
+            }));
+        }
+        // ── Usage ───────────────────────────────────────────────
+        case "get_usage": {
+            const pid = getProjectId(args);
+            const days = args.days ? `?days=${args.days}` : "";
+            return ok(await api.request("GET", `/images/projects/${pid}/usage${days}`));
+        }
+        // ── Utility ─────────────────────────────────────────────
+        case "build_cdn_url": {
+            const pid = getProjectId(args);
+            const cdnBase = args.cdnUrl || CDN_URL_DEFAULT;
+            const imagePath = args.imagePath;
+            const transforms = (args.transforms ?? {});
+            const paramMap = {
+                width: "w",
+                height: "h",
+                fit: "fit",
+                format: "f",
+                quality: "q",
+                qualityMode: "q",
+                dpr: "dpr",
+                gravity: "g",
+                blur: "blur",
+                sharpen: "sharpen",
+                radius: "r",
+                grayscale: "grayscale",
+                brightness: "brightness",
+                contrast: "contrast",
+                saturation: "saturation",
+                sepia: "sepia",
+                bg: "bg",
+                rotate: "rot",
+                flip: "flip",
+            };
+            const params = new URLSearchParams();
+            for (const [key, value] of Object.entries(transforms)) {
+                const param = paramMap[key];
+                if (param && value !== undefined && value !== null) {
+                    params.set(param, String(value));
+                }
+            }
+            const qs = params.toString();
+            const url = `${cdnBase}/${pid}/${imagePath}${qs ? `?${qs}` : ""}`;
+            return ok({ url });
+        }
+        default:
+            throw new Error(`Unknown tool: ${name}`);
+    }
+}
+// ── Server setup ────────────────────────────────────────────────
+const server = new Server({ name: "spronta", version: "0.1.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: TOOLS,
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        return await handleTool(name, (args ?? {}));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// ── Start ───────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Fatal:", error);
+    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":";AAEA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,mEAAmE;AAEnE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;AAC5C,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;AAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,6BAA6B,CAAC;AAC7E,MAAM,eAAe,GAAG,yBAAyB,CAAC;AAElD,IAAI,CAAC,OAAO,EAAE,CAAC;IACb,OAAO,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC1E,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAE7C,mEAAmE;AAEnE,SAAS,YAAY,CAAC,IAA6B;IACjD,MAAM,EAAE,GAAI,IAAI,CAAC,SAAoB,IAAI,kBAAkB,CAAC;IAC5D,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,EAAE,CAAC,IAAa;IACvB,OAAO;QACL,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;SACtD;KACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB;IACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC;IACrD,MAAM,GAAG,GAA2B;QAClC,GAAG,EAAE,YAAY;QACjB,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,WAAW;QAChB,GAAG,EAAE,WAAW;QAChB,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,eAAe;QACpB,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,YAAY;QACjB,GAAG,EAAE,WAAW;KACjB,CAAC;IACF,OAAO,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,YAAY,CAAC;AACxC,CAAC;AAED,mEAAmE;AAEnE,KAAK,UAAU,UAAU,CACvB,IAAY,EACZ,IAA6B;IAE7B,QAAQ,IAAI,EAAE,CAAC;QACb,4DAA4D;QAC5D,KAAK,eAAe;YAClB,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC;QAE1D,KAAK,gBAAgB;YACnB,OAAO,EAAE,CACP,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CACnE,CAAC;QAEJ,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,EAAE,CAAC,CAAC,CAAC;QACjE,CAAC;QAED,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,IAAI,GAA4B,EAAE,CAAC;YACzC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;gBAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACnD,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS;gBAAE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;YAC3E,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;QACzE,CAAC;QAED,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,oBAAoB,GAAG,EAAE,CAAC,CAAC,CAAC;QACpE,CAAC;QAED,4DAA4D;QAC5D,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAkB,CAAC;YACzC,MAAM,WAAW,GACd,IAAI,CAAC,WAAsB,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YAE9D,uBAAuB;YACvB,IAAI,MAAc,CAAC;YACnB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAmB,EAAE,QAAQ,CAAC,CAAC;YAC3D,CAAC;iBAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACzB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAkB,CAAC,CAAC;gBACjD,IAAI,CAAC,GAAG,CAAC,EAAE;oBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC1E,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YAChD,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;YACxE,CAAC;YAED,0BAA0B;YAC1B,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAG/B,MAAM,EAAE,oBAAoB,GAAG,SAAS,EAAE;gBAC3C,QAAQ;gBACR,WAAW;gBACX,QAAQ,EAAE,MAAM,CAAC,MAAM;aACxB,CAAC,CAAC;YAEH,kCAAkC;YAClC,MAAM,GAAG,CAAC,iBAAiB,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;YAErE,kBAAkB;YAClB,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,OAAO,CACjC,MAAM,EACN,oBAAoB,GAAG,iBAAiB,EACxC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAC9B,CAAC;YAEF,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;QACvB,CAAC;QAED,4DAA4D;QAC5D,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YACxD,IAAI,IAAI,CAAC,MAAM;gBAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YAC3D,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC7B,OAAO,EAAE,CACP,MAAM,GAAG,CAAC,OAAO,CACf,KAAK,EACL,oBAAoB,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACtD,CACF,CAAC;QACJ,CAAC;QAED,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,IAAI,GAA4B,EAAE,CAAC;YACzC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;gBAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC5D,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;gBAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACnD,OAAO,EAAE,CACP,MAAM,GAAG,CAAC,OAAO,CACf,OAAO,EACP,oBAAoB,GAAG,WAAW,IAAI,CAAC,OAAO,EAAE,EAChD,IAAI,CACL,CACF,CAAC;QACJ,CAAC;QAED,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,EAAE,CACP,MAAM,GAAG,CAAC,OAAO,CACf,QAAQ,EACR,oBAAoB,GAAG,WAAW,IAAI,CAAC,OAAO,EAAE,CACjD,CACF,CAAC;QACJ,CAAC;QAED,4DAA4D;QAC5D,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,UAAU,CAAC,CAAC,CAAC;QACzE,CAAC;QAED,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,EAAE,CACP,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,UAAU,EAAE;gBAC3D,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC,CACH,CAAC;QACJ,CAAC;QAED,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,IAAI,GAA4B,EAAE,CAAC;YACzC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;gBAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACnD,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;gBAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;YACrE,OAAO,EAAE,CACP,MAAM,GAAG,CAAC,OAAO,CACf,OAAO,EACP,oBAAoB,GAAG,YAAY,IAAI,CAAC,QAAQ,EAAE,EAClD,IAAI,CACL,CACF,CAAC;QACJ,CAAC;QAED,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,EAAE,CACP,MAAM,GAAG,CAAC,OAAO,CACf,QAAQ,EACR,oBAAoB,GAAG,YAAY,IAAI,CAAC,QAAQ,EAAE,CACnD,CACF,CAAC;QACJ,CAAC;QAED,2DAA2D;QAC3D,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,UAAU,CAAC,CAAC,CAAC;QACzE,CAAC;QAED,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,IAAI,GAA4B,EAAE,CAAC;YACzC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;gBAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC5D,IAAI,IAAI,CAAC,iBAAiB,KAAK,SAAS;gBACtC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;YAClD,OAAO,EAAE,CACP,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,UAAU,EAAE,IAAI,CAAC,CACnE,CAAC;QACJ,CAAC;QAED,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,EAAE,CACP,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,UAAU,EAAE;gBAC1D,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B,CAAC,CACH,CAAC;QACJ,CAAC;QAED,2DAA2D;QAC3D,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,OAAO,EAAE,CACP,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,SAAS,IAAI,EAAE,CAAC,CACjE,CAAC;QACJ,CAAC;QAED,2DAA2D;QAC3D,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,OAAO,GAAI,IAAI,CAAC,MAAiB,IAAI,eAAe,CAAC;YAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAmB,CAAC;YAC3C,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAA4B,CAAC;YAEtE,MAAM,QAAQ,GAA2B;gBACvC,KAAK,EAAE,GAAG;gBACV,MAAM,EAAE,GAAG;gBACX,GAAG,EAAE,KAAK;gBACV,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,GAAG;gBACZ,WAAW,EAAE,GAAG;gBAChB,GAAG,EAAE,KAAK;gBACV,OAAO,EAAE,GAAG;gBACZ,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,SAAS;gBAClB,MAAM,EAAE,GAAG;gBACX,SAAS,EAAE,WAAW;gBACtB,UAAU,EAAE,YAAY;gBACxB,QAAQ,EAAE,UAAU;gBACpB,UAAU,EAAE,YAAY;gBACxB,KAAK,EAAE,OAAO;gBACd,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,MAAM;aACb,CAAC;YAEF,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YACrC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBACtD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAC5B,IAAI,KAAK,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACnD,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;YAED,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,GAAG,OAAO,IAAI,GAAG,IAAI,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAElE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QACrB,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,mEAAmE;AAEnE,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,EACrC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;AAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK,EAAE,KAAK;CACb,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IACjD,IAAI,CAAC;QACH,OAAO,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC,CAAC;IACzE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;YAC/D,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,mEAAmE;AAEnE,KAAK,UAAU,IAAI;IACjB,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,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP tool definitions for the Spronta Image CDN API.
+ * Each tool maps to one or more REST API calls.
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const TOOLS: Tool[];
+//# 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;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAiE/D,eAAO,MAAM,KAAK,EAAE,IAAI,EAySvB,CAAC"}

package/dist/tools.js

@@ -0,0 +1,344 @@
+/**
+ * MCP tool definitions for the Spronta Image CDN API.
+ * Each tool maps to one or more REST API calls.
+ */
+const projectIdParam = {
+    projectId: {
+        type: "string",
+        description: "Project ID (UUID). If omitted, uses SPRONTA_PROJECT_ID env var.",
+    },
+};
+const transformsSchema = {
+    type: "object",
+    description: "Image transform parameters",
+    properties: {
+        width: { type: "integer", description: "Width (1–8192)" },
+        height: { type: "integer", description: "Height (1–8192)" },
+        fit: {
+            type: "string",
+            enum: ["cover", "contain", "fill", "scale-down", "crop", "pad"],
+        },
+        format: {
+            type: "string",
+            enum: ["webp", "avif", "jpeg", "png", "jxl", "auto"],
+        },
+        quality: {
+            type: "integer",
+            description: "Quality 1–100, or use qualityMode",
+        },
+        qualityMode: { type: "string", enum: ["high", "medium", "low"] },
+        gravity: {
+            type: "string",
+            enum: [
+                "auto",
+                "face",
+                "center",
+                "top",
+                "bottom",
+                "left",
+                "right",
+                "top-left",
+                "top-right",
+                "bottom-left",
+                "bottom-right",
+            ],
+        },
+        blur: { type: "integer", description: "Gaussian blur (1–250)" },
+        sharpen: {
+            type: "number",
+            description: "Unsharp mask (0–10)",
+        },
+        radius: { type: "integer", description: "Corner radius (1–9999)" },
+        grayscale: { type: "boolean" },
+        brightness: { type: "integer", description: "-100 to 100" },
+        contrast: { type: "number", description: "-100 to 100" },
+        saturation: { type: "integer", description: "-100 to 100" },
+        sepia: { type: "boolean" },
+        bg: {
+            type: "string",
+            description: "Background hex color (6 chars, no #)",
+        },
+        rotate: { type: "integer", enum: [90, 180, 270] },
+        flip: { type: "string", enum: ["h", "v"] },
+    },
+};
+export const TOOLS = [
+    // ── Projects ─────────────────────────────────────────────────
+    {
+        name: "list_projects",
+        description: "List all Spronta image projects for your account.",
+        inputSchema: { type: "object", properties: {}, required: [] },
+    },
+    {
+        name: "create_project",
+        description: "Create a new image project.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Project name (1–100 chars)",
+                },
+            },
+            required: ["name"],
+        },
+    },
+    {
+        name: "get_project",
+        description: "Get project details including usage stats (image count, total storage).",
+        inputSchema: {
+            type: "object",
+            properties: { ...projectIdParam },
+            required: [],
+        },
+    },
+    {
+        name: "update_project",
+        description: "Update a project's name or custom domain.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ...projectIdParam,
+                name: { type: "string", description: "New name (1–100 chars)" },
+                customDomain: {
+                    type: "string",
+                    description: "Custom CDN domain (max 253 chars), or null to remove",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "delete_project",
+        description: "Permanently delete a project and all its images. This cannot be undone.",
+        inputSchema: {
+            type: "object",
+            properties: { ...projectIdParam },
+            required: [],
+        },
+    },
+    // ── Upload ───────────────────────────────────────────────────
+    {
+        name: "upload_image",
+        description: "Upload an image from a URL. Fetches the image, uploads it to Spronta, and returns the CDN URL with blurhash. For base64, pass imageData instead of imageUrl.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ...projectIdParam,
+                imageUrl: {
+                    type: "string",
+                    description: "URL of the image to upload",
+                },
+                imageData: {
+                    type: "string",
+                    description: "Base64-encoded image data (alternative to imageUrl)",
+                },
+                filename: {
+                    type: "string",
+                    description: "Filename for the image (e.g. hero.jpg)",
+                },
+                contentType: {
+                    type: "string",
+                    description: "MIME type (e.g. image/jpeg). Auto-detected if omitted.",
+                },
+            },
+            required: ["filename"],
+        },
+    },
+    // ── Images ───────────────────────────────────────────────────
+    {
+        name: "list_images",
+        description: "List images in a project with pagination.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ...projectIdParam,
+                limit: {
+                    type: "integer",
+                    description: "Max results, 1–100 (default 50)",
+                },
+                offset: {
+                    type: "integer",
+                    description: "Pagination offset (default 0)",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "update_image",
+        description: "Update an image's alt text and/or tags.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ...projectIdParam,
+                imageId: { type: "string", description: "Image ID (UUID)" },
+                altText: {
+                    type: "string",
+                    description: "Alt text (max 1000 chars), or null to remove",
+                },
+                tags: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Tags (max 50, each max 100 chars)",
+                },
+            },
+            required: ["imageId"],
+        },
+    },
+    {
+        name: "delete_image",
+        description: "Permanently delete an image from storage and database. Cannot be undone.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ...projectIdParam,
+                imageId: { type: "string", description: "Image ID (UUID)" },
+            },
+            required: ["imageId"],
+        },
+    },
+    // ── Presets ──────────────────────────────────────────────────
+    {
+        name: "list_presets",
+        description: "List named transform presets. Presets can be used in CDN URLs with ?t=name.",
+        inputSchema: {
+            type: "object",
+            properties: { ...projectIdParam },
+            required: [],
+        },
+    },
+    {
+        name: "create_preset",
+        description: "Create a named transform preset. Use in CDN URLs with ?t=preset-name.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ...projectIdParam,
+                name: {
+                    type: "string",
+                    description: "Preset name (alphanumeric, hyphens, underscores, 1–64 chars)",
+                },
+                transforms: transformsSchema,
+            },
+            required: ["name", "transforms"],
+        },
+    },
+    {
+        name: "update_preset",
+        description: "Update a preset's name or transforms.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ...projectIdParam,
+                presetId: { type: "string", description: "Preset ID (UUID)" },
+                name: { type: "string", description: "New name" },
+                transforms: transformsSchema,
+            },
+            required: ["presetId"],
+        },
+    },
+    {
+        name: "delete_preset",
+        description: "Delete a transform preset.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ...projectIdParam,
+                presetId: { type: "string", description: "Preset ID (UUID)" },
+            },
+            required: ["presetId"],
+        },
+    },
+    // ── Signing ──────────────────────────────────────────────────
+    {
+        name: "get_signing_config",
+        description: "Get the URL signing configuration for a project (enabled, requireSignedUrls, masked secret).",
+        inputSchema: {
+            type: "object",
+            properties: { ...projectIdParam },
+            required: [],
+        },
+    },
+    {
+        name: "update_signing",
+        description: "Enable/disable URL signing. When enabling, a new secret is generated and returned once.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ...projectIdParam,
+                enabled: {
+                    type: "boolean",
+                    description: "true = generate new signing secret, false = disable signing",
+                },
+                requireSignedUrls: {
+                    type: "boolean",
+                    description: "When true, unsigned CDN URLs return 403",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "generate_signed_url",
+        description: "Generate an HMAC-SHA256 signed CDN URL. Requires signing to be enabled.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ...projectIdParam,
+                path: {
+                    type: "string",
+                    description: "Image path (e.g. /my-project/hero.jpg)",
+                },
+                params: {
+                    type: "object",
+                    additionalProperties: { type: "string" },
+                    description: "Transform params as key-value strings (e.g. {w: '800'})",
+                },
+                expiresIn: {
+                    type: "integer",
+                    description: "Expiration in seconds (60–604800)",
+                },
+            },
+            required: ["path"],
+        },
+    },
+    // ── Usage ────────────────────────────────────────────────────
+    {
+        name: "get_usage",
+        description: "Get daily usage metrics (requests, bandwidth, transforms) for a project.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ...projectIdParam,
+                days: {
+                    type: "integer",
+                    description: "Lookback period, 1–90 (default 30)",
+                },
+            },
+            required: [],
+        },
+    },
+    // ── Utility ──────────────────────────────────────────────────
+    {
+        name: "build_cdn_url",
+        description: "Build a Spronta CDN URL with transform parameters. Does not make an API call.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ...projectIdParam,
+                imagePath: {
+                    type: "string",
+                    description: "Image filename or path (e.g. hero.jpg)",
+                },
+                transforms: transformsSchema,
+                cdnUrl: {
+                    type: "string",
+                    description: "CDN base URL (default: https://cdn.spronta.com)",
+                },
+            },
+            required: ["imagePath"],
+        },
+    },
+];
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spronta/mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Spronta Image CDN — MCP server for LLM integrations",
   "type": "module",
   "main": "./dist/index.js",