@metalevel/snapix-mcp-server 0.1.1

package/README.md

@@ -0,0 +1,161 @@
+# @metalevel/snapix-mcp-server
+
+MCP server for [SnapiX](https://www.snapix.space) — image optimization, conversion, AI generation, and gallery management via the [Model Context Protocol](https://modelcontextprotocol.io).
+
+## Quick Start — Local (stdio)
+
+Add to your AI client configuration:
+
+### VS Code (Copilot)
+
+Add to `.vscode/mcp.json`:
+
+```json
+{
+  "inputs": [
+    {
+      "id": "SNAPIX_API_KEY",
+      "type": "promptString",
+      "description": "SnapiX API key",
+      "password": true
+    }
+  ],
+  "servers": {
+    "snapix": {
+      "command": "npx",
+      "args": ["-y", "@metalevel/snapix-mcp-server"],
+      "env": {
+        "SNAPIX_API_KEY": "${input:SNAPIX_API_KEY}"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "snapix": {
+      "command": "npx",
+      "args": ["-y", "@metalevel/snapix-mcp-server"],
+      "env": {
+        "SNAPIX_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+## Quick Start — Remote (HTTP)
+
+For clients that support Streamable HTTP transport, point to the hosted endpoint:
+
+```txt
+https://www.snapix.space/api/mcp
+```
+
+Pass your API key via the `Authorization` header:
+
+```ini
+Authorization: Bearer <your-api-key>
+```
+
+The remote endpoint operates in stateless mode — no session persistence between requests.
+
+### VS Code (Copilot)
+
+Add to `.vscode/mcp.json`:
+
+```json
+{
+  "inputs": [
+    {
+      "id": "SNAPIX_API_KEY",
+      "type": "promptString",
+      "description": "SnapiX API key",
+      "password": true
+    }
+  ],
+  "servers": {
+    "snapix": {
+      "type": "http",
+      "url": "https://www.snapix.space/api/mcp",
+      "headers": {
+        "Authorization": "Bearer ${input:SNAPIX_API_KEY}"
+      }
+    }
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+| --- | --- | --- | --- |
+| `SNAPIX_API_KEY` | Yes | — | Your SnapiX API key |
+
+## Available Tools
+
+| Tool | Description | Credits |
+| --- | --- | --- |
+| `snapix_convert_image` | Guidance tool — explains how to convert images using the upload tool | Free |
+| `snapix_upload_image` | Upload an image from URL, optionally convert format and resize | 1+ |
+| `snapix_generate_image` | Generate an image from a text prompt (Gemini AI)* | 40+ |
+| `snapix_list_images` | List images with pagination and filtering | Free |
+| `snapix_get_image` | Get full details for a single image | Free |
+| `snapix_update_image` | Update image metadata or gallery assignments | Free |
+| `snapix_delete_image` | Permanently delete an image | Free |
+| `snapix_create_gallery` | Create a new gallery, optionally with existing images | Free |
+| `snapix_list_galleries` | List all galleries | Free |
+| `snapix_get_gallery` | Get gallery details with all images | Free |
+| `snapix_update_gallery` | Update gallery name or visibility | Free |
+| `snapix_delete_gallery` | Delete a gallery, optionally with all images | Free |
+
+* `snapix_generate_image` the only option that requires a paid subscription, it accepts a text prompt and template image (or image URL) and generates an image using Gemini AI.
+
+## Resources
+
+MCP Resources provide passive context that AI clients can pre-load without making explicit tool calls.
+
+| URI | Description |
+| --- | --- |
+| `snapix://galleries` | All galleries (name, id, visibility, image count) |
+| `snapix://galleries/{galleryId}` | Gallery details with all images and CDN URLs |
+| `snapix://images` | Recent images (first page) with metadata and CDN URLs |
+| `snapix://images/{imageId}` | Full image metadata, variants, dimensions, and CDN URLs |
+
+## Rate Limiting
+
+The MCP server respects the same rate limits as the REST API. When a rate limit is hit (HTTP 429), the server returns an MCP error with a retryable flag, signaling to the AI client that it should wait and retry the request.
+
+## Credits & Quotas
+
+* **Free operations**: listing, getting, updating metadata, and deleting images/galleries
+* **Credit-consuming operations**: uploading images (1+ credits), generating images (40+ credits)
+* Credit costs follow the same rules as the [REST API](https://www.snapix.space/docs/api#app-credits)
+* When credits are exhausted, the server returns a clear error message
+
+## Programmatic Usage
+
+```typescript
+import { createSnapixMcpServer } from "@metalevel/snapix-mcp-server";
+
+const server = createSnapixMcpServer({
+  baseUrl: "https://www.snapix.space",
+  apiKey: process.env.SNAPIX_API_KEY!,
+});
+```
+
+## Documentation
+
+* [Full MCP docs](https://www.snapix.space/docs/mcp)
+* [REST API docs](https://www.snapix.space/docs/api)
+* [Get API key](https://www.snapix.space/user/api-keys)
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,30 @@
+import { type CreateGalleryParams, type GenerateImageParams, type ListImagesParams, type SnapixClientConfig, type UpdateGalleryParams, type UpdateImageParams, type UploadImageParams } from "./types.js";
+export declare class SnapixClient {
+    private baseUrl;
+    private apiKey;
+    constructor(config: SnapixClientConfig);
+    private get headers();
+    private handleResponse;
+    private buildFormData;
+    /**
+     * Image endpoints
+     */
+    uploadImage(params: UploadImageParams): Promise<unknown>;
+    listImages(params?: ListImagesParams): Promise<unknown>;
+    getImage(imageId: string): Promise<unknown>;
+    updateImage(imageId: string, params: UpdateImageParams): Promise<unknown>;
+    deleteImage(imageId: string): Promise<unknown>;
+    /**
+     * Generate endpoint
+     */
+    generateImage(params: GenerateImageParams): Promise<unknown>;
+    /**
+     * Gallery endpoints
+     */
+    createGallery(params: CreateGalleryParams): Promise<unknown>;
+    listGalleries(): Promise<unknown>;
+    getGallery(galleryId: string): Promise<unknown>;
+    updateGallery(galleryId: string, params: UpdateGalleryParams): Promise<unknown>;
+    deleteGallery(galleryId: string, deleteImages?: boolean): Promise<unknown>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AAEpB,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,kBAAkB;IAKtC,OAAO,KAAK,OAAO,GAElB;YAEa,cAAc;IA6B5B,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IAEG,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAoCxD,UAAU,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBvD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS3C,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBzE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAapD;;OAEG;IAEG,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAyBlE;;OAEG;IAEG,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAU5D,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IASjC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS/C,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAU/E,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;CAcjF"}

package/dist/client.js

@@ -0,0 +1,203 @@
+import { API_URI_GALLERIES, API_URI_GENERATE, API_URI_IMAGES } from "./constants.js";
+import { SnapixApiError } from "./errors.js";
+export class SnapixClient {
+    baseUrl;
+    apiKey;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, "");
+        this.apiKey = config.apiKey;
+    }
+    get headers() {
+        return { Authorization: `Bearer ${this.apiKey}` };
+    }
+    async handleResponse(response) {
+        if (!response.ok) {
+            let body;
+            try {
+                body = await response.json();
+            }
+            catch {
+                body = await response.text().catch(() => undefined);
+            }
+            const message = body && typeof body === "object" && "error" in body
+                ? String(body.error)
+                : body && typeof body === "object" && "message" in body
+                    ? String(body.message)
+                    : `HTTP ${response.status}: ${response.statusText}`;
+            throw new SnapixApiError(message, response.status, body);
+        }
+        const contentType = response.headers.get("content-type") ?? "";
+        if (contentType.includes("application/json")) {
+            return response.json();
+        }
+        return response.text();
+    }
+    buildFormData(params) {
+        const formData = new FormData();
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined || value === null) {
+                continue;
+            }
+            if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+                formData.append(key, String(value));
+            }
+            else {
+                formData.append(key, JSON.stringify(value));
+            }
+        }
+        return formData;
+    }
+    /**
+     * Image endpoints
+     */
+    async uploadImage(params) {
+        const formData = this.buildFormData({
+            name: params.name,
+            description: params.description,
+            contentType: params.contentType ?? params.imageContentType,
+            ratio: params.ratio !== undefined ? JSON.stringify(params.ratio) : undefined,
+            resizeOptions: params.resizeOptions !== undefined ? JSON.stringify(params.resizeOptions) : undefined,
+            formatOptions: params.formatOptions !== undefined ? JSON.stringify(params.formatOptions) : undefined,
+            galleries: params.galleries !== undefined ? JSON.stringify(params.galleries) : undefined,
+            bucketKey: params.bucketKey,
+            prefix: params.prefix,
+            storageKeyHandling: params.storageKeyHandling,
+        });
+        if (params.imageBase64) {
+            const mimeType = params.imageContentType ?? params.contentType ?? "application/octet-stream";
+            const buffer = Buffer.from(params.imageBase64, "base64");
+            const blob = new Blob([buffer], { type: mimeType });
+            const ext = mimeType.split("/")[1] ?? "bin";
+            const filename = params.name ? `${params.name}.${ext}` : `upload.${ext}`;
+            formData.append("image", blob, filename);
+        }
+        else if (params.imageUrl) {
+            formData.append("url", params.imageUrl);
+        }
+        const response = await fetch(`${this.baseUrl}/${API_URI_IMAGES}`, {
+            method: "POST",
+            headers: this.headers,
+            body: formData,
+        });
+        return this.handleResponse(response);
+    }
+    async listImages(params) {
+        const searchParams = new URLSearchParams();
+        if (params?.page !== undefined) {
+            searchParams.set("page", String(params.page));
+        }
+        if (params?.limit !== undefined) {
+            searchParams.set("limit", String(params.limit));
+        }
+        if (params?.sort) {
+            searchParams.set("sort", params.sort);
+        }
+        if (params?.bucketKey) {
+            searchParams.set("bucketKey", params.bucketKey);
+        }
+        const query = searchParams.toString();
+        const url = `${this.baseUrl}/${API_URI_IMAGES}${query ? `?${query}` : ""}`;
+        const response = await fetch(url, { method: "GET", headers: this.headers });
+        return this.handleResponse(response);
+    }
+    async getImage(imageId) {
+        const response = await fetch(`${this.baseUrl}/${API_URI_IMAGES}/${imageId}`, {
+            method: "GET",
+            headers: this.headers,
+        });
+        return this.handleResponse(response);
+    }
+    async updateImage(imageId, params) {
+        const formData = this.buildFormData({
+            name: params.name,
+            description: params.description,
+            galleries: params.galleries !== undefined ? JSON.stringify(params.galleries) : undefined,
+            formatOptions: params.formatOptions !== undefined ? JSON.stringify(params.formatOptions) : undefined,
+            resizeOptions: params.resizeOptions !== undefined ? JSON.stringify(params.resizeOptions) : undefined,
+        });
+        const response = await fetch(`${this.baseUrl}/${API_URI_IMAGES}/${imageId}`, {
+            method: "PATCH",
+            headers: this.headers,
+            body: formData,
+        });
+        return this.handleResponse(response);
+    }
+    async deleteImage(imageId) {
+        const response = await fetch(`${this.baseUrl}/${API_URI_IMAGES}/${imageId}`, {
+            method: "DELETE",
+            headers: this.headers,
+        });
+        if (response.status === 204) {
+            return { success: true };
+        }
+        return this.handleResponse(response);
+    }
+    /**
+     * Generate endpoint
+     */
+    async generateImage(params) {
+        const formData = this.buildFormData({
+            url: params.imageUrl,
+            prompt: params.promptText,
+            name: params.name,
+            description: params.description,
+            ratio: params.ratio !== undefined ? JSON.stringify(params.ratio) : undefined,
+            resizeOptions: params.resizeOptions !== undefined ? JSON.stringify(params.resizeOptions) : undefined,
+            formatOptions: params.formatOptions !== undefined ? JSON.stringify(params.formatOptions) : undefined,
+            galleries: params.galleries !== undefined ? JSON.stringify(params.galleries) : undefined,
+            bucketKey: params.bucketKey,
+            aiConfig: params.aiConfig !== undefined ? JSON.stringify(params.aiConfig) : undefined,
+        });
+        const response = await fetch(`${this.baseUrl}/${API_URI_GENERATE}`, {
+            method: "POST",
+            headers: this.headers,
+            body: formData,
+        });
+        return this.handleResponse(response);
+    }
+    /**
+     * Gallery endpoints
+     */
+    async createGallery(params) {
+        const response = await fetch(`${this.baseUrl}/${API_URI_GALLERIES}`, {
+            method: "POST",
+            headers: { ...this.headers, "Content-Type": "application/json" },
+            body: JSON.stringify(params),
+        });
+        return this.handleResponse(response);
+    }
+    async listGalleries() {
+        const response = await fetch(`${this.baseUrl}/${API_URI_GALLERIES}`, {
+            method: "GET",
+            headers: this.headers,
+        });
+        return this.handleResponse(response);
+    }
+    async getGallery(galleryId) {
+        const response = await fetch(`${this.baseUrl}/${API_URI_GALLERIES}/${galleryId}`, {
+            method: "GET",
+            headers: this.headers,
+        });
+        return this.handleResponse(response);
+    }
+    async updateGallery(galleryId, params) {
+        const response = await fetch(`${this.baseUrl}/${API_URI_GALLERIES}/${galleryId}`, {
+            method: "PATCH",
+            headers: { ...this.headers, "Content-Type": "application/json" },
+            body: JSON.stringify(params),
+        });
+        return this.handleResponse(response);
+    }
+    async deleteGallery(galleryId, deleteImages) {
+        const query = deleteImages ? "?deleteImages=true" : "";
+        const response = await fetch(`${this.baseUrl}/${API_URI_GALLERIES}/${galleryId}${query}`, {
+            method: "DELETE",
+            headers: this.headers,
+        });
+        if (response.status === 204) {
+            return { success: true };
+        }
+        return this.handleResponse(response);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,7 @@
+export declare const APP_MCP_BASE_URL: string;
+export declare const APP_MCP_PACKAGE_VERSION: string;
+export declare const APP_MCP_PACKAGE_NAME: string;
+export declare const API_URI_IMAGES = "api/v1/images";
+export declare const API_URI_GENERATE = "api/v1/generate";
+export declare const API_URI_GALLERIES = "api/v1/galleries";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,gBAAgB,QAA+C,CAAC;AAC7E,eAAO,MAAM,uBAAuB,QAAsB,CAAC;AAC3D,eAAO,MAAM,oBAAoB,QAAmB,CAAC;AAErD,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAC9C,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAClD,eAAO,MAAM,iBAAiB,qBAAqB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,11 @@
+import packageJson from "../package.json" with { type: "json" };
+// This is for testing purposes only - this is why it is not in the documentation.
+const PROCESS_MCP_BASE_URL = process.env.MCP_BASE_URL;
+const PACKAGE_MCP_BASE_URL = packageJson.mcpBaseUrl || "https://www.snapix.space";
+export const APP_MCP_BASE_URL = PROCESS_MCP_BASE_URL ?? PACKAGE_MCP_BASE_URL;
+export const APP_MCP_PACKAGE_VERSION = packageJson.version;
+export const APP_MCP_PACKAGE_NAME = packageJson.name;
+export const API_URI_IMAGES = "api/v1/images";
+export const API_URI_GENERATE = "api/v1/generate";
+export const API_URI_GALLERIES = "api/v1/galleries";
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEhE,kFAAkF;AAClF,MAAM,oBAAoB,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;AACtD,MAAM,oBAAoB,GAAI,WAAW,CAAC,UAAqB,IAAI,0BAA0B,CAAC;AAE9F,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,IAAI,oBAAoB,CAAC;AAC7E,MAAM,CAAC,MAAM,uBAAuB,GAAG,WAAW,CAAC,OAAO,CAAC;AAC3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAC,IAAI,CAAC;AAErD,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC;AAC9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AAClD,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,18 @@
+export declare class SnapixApiError extends Error {
+    status: number;
+    responseBody?: unknown | undefined;
+    constructor(message: string, status: number, responseBody?: unknown | undefined);
+    get isRetryable(): boolean;
+    get message(): string;
+}
+export declare function handleToolError(error: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+    _meta?: {
+        retryable: boolean;
+    };
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,KAAK;IAG9B,MAAM,EAAE,MAAM;IACd,YAAY,CAAC,EAAE,OAAO;gBAF7B,OAAO,EAAE,MAAM,EACR,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,OAAO,YAAA;IAM/B,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,OAAO,IAAI,MAAM,CAmBpB;CACF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG;IAC/C,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,CAAC,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;CAChC,CAkBA"}

package/dist/errors.js

@@ -0,0 +1,48 @@
+export class SnapixApiError extends Error {
+    status;
+    responseBody;
+    constructor(message, status, responseBody) {
+        super(message);
+        this.status = status;
+        this.responseBody = responseBody;
+        this.name = "SnapixApiError";
+    }
+    get isRetryable() {
+        return this.status === 429;
+    }
+    get message() {
+        let message;
+        switch (this.status) {
+            case 401:
+                message = "Invalid or missing API key.";
+                break;
+            case 402:
+                message = "Insufficient credits or quota exceeded.";
+                break;
+            case 429:
+                message = "Rate limit exceeded. Please wait before retrying.";
+                break;
+            default:
+                message = super.message || `API error (HTTP ${this.status})`;
+            // We use super.message because our getter overrides the default this.message property
+        }
+        return message;
+    }
+}
+export function handleToolError(error) {
+    if (error instanceof SnapixApiError) {
+        const retryable = error.isRetryable;
+        const message = error.message;
+        return {
+            content: [{ type: "text", text: message }],
+            isError: true,
+            ...(retryable ? { _meta: { retryable: true } } : {}),
+        };
+    }
+    const message = error instanceof Error ? error.message : "An unexpected error occurred.";
+    return {
+        content: [{ type: "text", text: message }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAe,SAAQ,KAAK;IAG9B;IACA;IAHT,YACE,OAAe,EACR,MAAc,EACd,YAAsB;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,WAAM,GAAN,MAAM,CAAQ;QACd,iBAAY,GAAZ,YAAY,CAAU;QAG7B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO;QACT,IAAI,OAAe,CAAC;QAEpB,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;YACpB,KAAK,GAAG;gBACN,OAAO,GAAG,6BAA6B,CAAC;gBACxC,MAAM;YACR,KAAK,GAAG;gBACN,OAAO,GAAG,yCAAyC,CAAC;gBACpD,MAAM;YACR,KAAK,GAAG;gBACN,OAAO,GAAG,mDAAmD,CAAC;gBAC9D,MAAM;YACR;gBACE,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,mBAAmB,IAAI,CAAC,MAAM,GAAG,CAAC;YAC/D,sFAAsF;QACxF,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAK5C,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC;QACpC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAE9B,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YACnD,OAAO,EAAE,IAAI;YACb,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrD,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,+BAA+B,CAAC;IAEzF,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACnD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+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":""}

package/dist/index.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { APP_MCP_BASE_URL } from "./constants.js";
+import { createSnapixMcpServer } from "./server.js";
+const apiKey = process.env.SNAPIX_API_KEY;
+if (!apiKey) {
+    console.error("Error: SNAPIX_API_KEY environment variable is required.");
+    console.error(`Get your API key at ${APP_MCP_BASE_URL}/user/api-keys`);
+    process.exit(1);
+}
+const server = createSnapixMcpServer({ apiKey });
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# 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,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;AAE1C,IAAI,CAAC,MAAM,EAAE,CAAC;IACZ,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;IACzE,OAAO,CAAC,KAAK,CAAC,uBAAuB,gBAAgB,gBAAgB,CAAC,CAAC;IACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;AACjD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/resources/galleries.d.ts

@@ -0,0 +1,4 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type SnapixClient } from "../client.js";
+export declare function registerGalleryResources(server: McpServer, client: SnapixClient): void;
+//# sourceMappingURL=galleries.d.ts.map

package/dist/resources/galleries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"galleries.d.ts","sourceRoot":"","sources":["../../src/resources/galleries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAE3F,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA8CtF"}

package/dist/resources/galleries.js

@@ -0,0 +1,35 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+export function registerGalleryResources(server, client) {
+    server.resource("gallery-list", "snapix://galleries", {
+        description: "Lists all galleries for the authenticated user (name, id, visibility, image count)",
+        mimeType: "application/json",
+    }, async (uri) => {
+        const data = await client.listGalleries();
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    });
+    server.resource("gallery-detail", new ResourceTemplate("snapix://galleries/{galleryId}", { list: undefined }), {
+        description: "Gallery details with all images, metadata, and CDN URLs",
+        mimeType: "application/json",
+    }, async (uri, variables) => {
+        const galleryId = String(variables.galleryId);
+        const data = await client.getGallery(galleryId);
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=galleries.js.map

package/dist/resources/galleries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"galleries.js","sourceRoot":"","sources":["../../src/resources/galleries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAI3F,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,MAAoB;IAC9E,MAAM,CAAC,QAAQ,CACb,cAAc,EACd,oBAAoB,EACpB;QACE,WAAW,EACT,oFAAoF;QACtF,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QAE1C,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,QAAQ,CACb,gBAAgB,EAChB,IAAI,gBAAgB,CAAC,gCAAgC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAC3E;QACE,WAAW,EAAE,yDAAyD;QACtE,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACvB,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAEhD,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/resources/images.d.ts

@@ -0,0 +1,4 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type SnapixClient } from "../client.js";
+export declare function registerImageResources(server: McpServer, client: SnapixClient): void;
+//# sourceMappingURL=images.d.ts.map

package/dist/resources/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../src/resources/images.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAE3F,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA6CpF"}

package/dist/resources/images.js

@@ -0,0 +1,35 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+export function registerImageResources(server, client) {
+    server.resource("image-list", "snapix://images", {
+        description: "Recent images (first page, default sort) with metadata and CDN URLs",
+        mimeType: "application/json",
+    }, async (uri) => {
+        const data = await client.listImages({ page: 1 });
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    });
+    server.resource("image-detail", new ResourceTemplate("snapix://images/{imageId}", { list: undefined }), {
+        description: "Full image metadata, all variants, dimensions, and CDN URLs",
+        mimeType: "application/json",
+    }, async (uri, variables) => {
+        const imageId = String(variables.imageId);
+        const data = await client.getImage(imageId);
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=images.js.map

package/dist/resources/images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.js","sourceRoot":"","sources":["../../src/resources/images.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAI3F,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,MAAoB;IAC5E,MAAM,CAAC,QAAQ,CACb,YAAY,EACZ,iBAAiB,EACjB;QACE,WAAW,EAAE,qEAAqE;QAClF,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAElD,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,QAAQ,CACb,cAAc,EACd,IAAI,gBAAgB,CAAC,2BAA2B,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EACtE;QACE,WAAW,EAAE,6DAA6D;QAC1E,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACvB,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE5C,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}