@rendshot/mcp 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @rendshot/mcp@0.1.0 build /Users/wuzhiqiang/Documents/WWW/MySelf/rendshot/packages/mcp
+> tsc
+

package/.turbo/turbo-test.log

@@ -0,0 +1,14 @@
+
+> @rendshot/mcp@0.1.0 test /Users/wuzhiqiang/Documents/WWW/MySelf/rendshot/packages/mcp
+> vitest run --passWithNoTests
+
+
+ RUN  v3.2.4 /Users/wuzhiqiang/Documents/WWW/MySelf/rendshot/packages/mcp
+
+ ✓ src/__tests__/tools.test.ts (21 tests) 7ms
+
+ Test Files  1 passed (1)
+      Tests  21 passed (21)
+   Start at  16:13:37
+   Duration  1.29s (transform 152ms, setup 0ms, collect 163ms, tests 7ms, environment 0ms, prepare 526ms)
+

package/dist/__tests__/tools.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tools.test.d.ts.map

package/dist/__tests__/tools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tools.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/tools.test.js

@@ -0,0 +1,221 @@
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import { z } from 'zod';
+import { generateImageSchema, generateImageToolMeta, handleGenerateImage, } from '../tools/generateImage.js';
+import { screenshotUrlSchema, screenshotUrlToolMeta, handleScreenshotUrl, } from '../tools/screenshotUrl.js';
+import { ApiClient } from '../api-client.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeFetchMock(status, body) {
+    return vi.fn().mockResolvedValue({
+        ok: status >= 200 && status < 300,
+        status,
+        json: async () => body,
+    });
+}
+afterEach(() => {
+    vi.unstubAllGlobals();
+    vi.restoreAllMocks();
+});
+// ---------------------------------------------------------------------------
+// Tool meta / definitions
+// ---------------------------------------------------------------------------
+describe('generate_image tool meta', () => {
+    it('has the correct name', () => {
+        expect(generateImageToolMeta.name).toBe('generate_image');
+    });
+    it('has a non-empty description', () => {
+        expect(typeof generateImageToolMeta.description).toBe('string');
+        expect(generateImageToolMeta.description.length).toBeGreaterThan(0);
+    });
+});
+describe('screenshot_url tool meta', () => {
+    it('has the correct name', () => {
+        expect(screenshotUrlToolMeta.name).toBe('screenshot_url');
+    });
+    it('has a non-empty description', () => {
+        expect(typeof screenshotUrlToolMeta.description).toBe('string');
+        expect(screenshotUrlToolMeta.description.length).toBeGreaterThan(0);
+    });
+});
+// ---------------------------------------------------------------------------
+// generate_image schema validation
+// ---------------------------------------------------------------------------
+describe('generateImageSchema validation', () => {
+    const schema = z.object(generateImageSchema);
+    it('accepts valid input with only the required html field', () => {
+        const result = schema.safeParse({ html: '<h1>Hello</h1>' });
+        expect(result.success).toBe(true);
+    });
+    it('accepts all optional fields when provided with correct types', () => {
+        const result = schema.safeParse({
+            html: '<p>test</p>',
+            css: 'body { color: red; }',
+            width: 800,
+            height: 600,
+            format: 'png',
+            quality: 90,
+            deviceScale: 2,
+            timeout: 10000,
+        });
+        expect(result.success).toBe(true);
+    });
+    it('rejects input missing the required html field', () => {
+        const result = schema.safeParse({ width: 800 });
+        expect(result.success).toBe(false);
+    });
+    it('rejects invalid format values', () => {
+        const result = schema.safeParse({ html: '<p>x</p>', format: 'gif' });
+        expect(result.success).toBe(false);
+    });
+    it('rejects invalid deviceScale values', () => {
+        const result = schema.safeParse({ html: '<p>x</p>', deviceScale: 4 });
+        expect(result.success).toBe(false);
+    });
+    it('accepts deviceScale of 1, 2, or 3', () => {
+        for (const scale of [1, 2, 3]) {
+            const result = schema.safeParse({ html: '<p>x</p>', deviceScale: scale });
+            expect(result.success).toBe(true);
+        }
+    });
+});
+// ---------------------------------------------------------------------------
+// screenshot_url schema validation
+// ---------------------------------------------------------------------------
+describe('screenshotUrlSchema validation', () => {
+    const schema = z.object(screenshotUrlSchema);
+    it('accepts valid input with only the required url field', () => {
+        const result = schema.safeParse({ url: 'https://example.com' });
+        expect(result.success).toBe(true);
+    });
+    it('accepts all optional fields when provided with correct types', () => {
+        const result = schema.safeParse({
+            url: 'https://example.com',
+            width: 1280,
+            height: 800,
+            format: 'webp',
+            quality: 85,
+            fullPage: true,
+            deviceScale: 1,
+            timeout: 5000,
+        });
+        expect(result.success).toBe(true);
+    });
+    it('rejects input missing the required url field', () => {
+        const result = schema.safeParse({ width: 1280 });
+        expect(result.success).toBe(false);
+    });
+    it('rejects invalid format values', () => {
+        const result = schema.safeParse({ url: 'https://example.com', format: 'bmp' });
+        expect(result.success).toBe(false);
+    });
+    it('rejects invalid deviceScale values', () => {
+        const result = schema.safeParse({ url: 'https://example.com', deviceScale: 0 });
+        expect(result.success).toBe(false);
+    });
+    it('accepts valid format values: png, jpg, webp', () => {
+        for (const format of ['png', 'jpg', 'webp']) {
+            const result = schema.safeParse({ url: 'https://example.com', format });
+            expect(result.success).toBe(true);
+        }
+    });
+});
+// ---------------------------------------------------------------------------
+// handleGenerateImage — calls ApiClient correctly
+// ---------------------------------------------------------------------------
+describe('handleGenerateImage', () => {
+    it('calls client.generateImage with the provided args', async () => {
+        const mockFetch = makeFetchMock(200, {
+            url: 'https://cdn.example.com/img.png',
+            width: 1080,
+            height: 1080,
+            format: 'png',
+            size: 8192,
+        });
+        vi.stubGlobal('fetch', mockFetch);
+        const client = new ApiClient({ apiUrl: 'https://api.rendshot.com', apiKey: 'rs_test_key' });
+        const args = { html: '<h1>Hello</h1>', width: 1080, height: 1080 };
+        const response = await handleGenerateImage(client, args);
+        // Verify fetch was called to POST /v1/image
+        expect(mockFetch).toHaveBeenCalledOnce();
+        const [url, init] = mockFetch.mock.calls[0];
+        expect(url).toBe('https://api.rendshot.com/v1/image');
+        expect(init.method).toBe('POST');
+        const body = JSON.parse(init.body);
+        expect(body.html).toBe('<h1>Hello</h1>');
+        // Verify the MCP response shape
+        expect(response.content).toHaveLength(1);
+        expect(response.content[0].type).toBe('text');
+        expect(response.content[0].text).toContain('https://cdn.example.com/img.png');
+        expect(response.content[0].text).toContain('Image generated successfully');
+    });
+    it('propagates errors from the API client', async () => {
+        const mockFetch = makeFetchMock(400, { error: { message: 'HTML is required' } });
+        vi.stubGlobal('fetch', mockFetch);
+        const client = new ApiClient({ apiUrl: 'https://api.rendshot.com', apiKey: 'rs_test_key' });
+        await expect(handleGenerateImage(client, { html: '' })).rejects.toThrow('HTML is required');
+    });
+});
+// ---------------------------------------------------------------------------
+// handleScreenshotUrl — calls ApiClient correctly
+// ---------------------------------------------------------------------------
+describe('handleScreenshotUrl', () => {
+    it('calls client.screenshotUrl with the provided args', async () => {
+        const mockFetch = makeFetchMock(200, {
+            url: 'https://cdn.example.com/shot.jpg',
+            width: 1280,
+            height: 800,
+            format: 'jpg',
+            size: 20480,
+        });
+        vi.stubGlobal('fetch', mockFetch);
+        const client = new ApiClient({ apiUrl: 'https://api.rendshot.com', apiKey: 'rs_test_key' });
+        const args = { url: 'https://example.com', fullPage: true, format: 'jpg' };
+        const response = await handleScreenshotUrl(client, args);
+        expect(mockFetch).toHaveBeenCalledOnce();
+        const [url, init] = mockFetch.mock.calls[0];
+        expect(url).toBe('https://api.rendshot.com/v1/screenshot');
+        expect(init.method).toBe('POST');
+        const body = JSON.parse(init.body);
+        expect(body.url).toBe('https://example.com');
+        expect(body.fullPage).toBe(true);
+        expect(response.content).toHaveLength(1);
+        expect(response.content[0].type).toBe('text');
+        expect(response.content[0].text).toContain('https://cdn.example.com/shot.jpg');
+        expect(response.content[0].text).toContain('Screenshot taken');
+    });
+    it('propagates errors from the API client', async () => {
+        const mockFetch = makeFetchMock(422, { error: { message: 'Invalid URL' } });
+        vi.stubGlobal('fetch', mockFetch);
+        const client = new ApiClient({ apiUrl: 'https://api.rendshot.com', apiKey: 'rs_test_key' });
+        await expect(handleScreenshotUrl(client, { url: 'not-a-url' })).rejects.toThrow('Invalid URL');
+    });
+});
+// ---------------------------------------------------------------------------
+// ApiClient (MCP) — HTTP layer
+// ---------------------------------------------------------------------------
+describe('ApiClient (MCP package)', () => {
+    it('sends correct Authorization and Content-Type headers on POST', async () => {
+        const mockFetch = makeFetchMock(200, { url: 'https://cdn.example.com/img.png', width: 1080, height: 1080, format: 'png', size: 0 });
+        vi.stubGlobal('fetch', mockFetch);
+        const client = new ApiClient({ apiUrl: 'https://api.rendshot.com', apiKey: 'rs_mcp_key' });
+        await client.generateImage({ html: '<p>test</p>' });
+        const [, init] = mockFetch.mock.calls[0];
+        const headers = init.headers;
+        expect(headers['Authorization']).toBe('Bearer rs_mcp_key');
+        expect(headers['Content-Type']).toBe('application/json');
+    });
+    it('throws on non-ok response with error message from body', async () => {
+        const mockFetch = makeFetchMock(403, { error: { message: 'Forbidden' } });
+        vi.stubGlobal('fetch', mockFetch);
+        const client = new ApiClient({ apiUrl: 'https://api.rendshot.com', apiKey: 'rs_key' });
+        await expect(client.screenshotUrl({ url: 'https://example.com' })).rejects.toThrow('Forbidden');
+    });
+    it('throws fallback error message when body has no error field', async () => {
+        const mockFetch = makeFetchMock(503, {});
+        vi.stubGlobal('fetch', mockFetch);
+        const client = new ApiClient({ apiUrl: 'https://api.rendshot.com', apiKey: 'rs_key' });
+        await expect(client.screenshotUrl({ url: 'https://example.com' })).rejects.toThrow('API error: 503');
+    });
+});
+//# sourceMappingURL=tools.test.js.map

package/dist/__tests__/tools.test.js.map

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

package/dist/api-client.d.ts

@@ -0,0 +1,31 @@
+export interface ApiClientConfig {
+    apiUrl: string;
+    apiKey: string;
+}
+export declare class ApiClient {
+    private baseUrl;
+    private apiKey;
+    constructor(config: ApiClientConfig);
+    generateImage(params: {
+        html: string;
+        css?: string;
+        width?: number;
+        height?: number;
+        format?: 'png' | 'jpg';
+        quality?: number;
+        deviceScale?: 1 | 2 | 3;
+        timeout?: number;
+    }): Promise<any>;
+    screenshotUrl(params: {
+        url: string;
+        width?: number;
+        height?: number;
+        format?: 'png' | 'jpg';
+        quality?: number;
+        fullPage?: boolean;
+        deviceScale?: 1 | 2 | 3;
+        timeout?: number;
+    }): Promise<any>;
+    private post;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,MAAM,CAAQ;gBAEV,MAAM,EAAE,eAAe;IAK7B,aAAa,CAAC,MAAM,EAAE;QAC1B,IAAI,EAAE,MAAM,CAAA;QACZ,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAA;QACtB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,WAAW,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACvB,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB;IAIK,aAAa,CAAC,MAAM,EAAE;QAC1B,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAA;QACtB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,WAAW,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACvB,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB;YAIa,IAAI;CAiBnB"}

package/dist/api-client.js

@@ -0,0 +1,31 @@
+export class ApiClient {
+    baseUrl;
+    apiKey;
+    constructor(config) {
+        this.baseUrl = config.apiUrl.replace(/\/$/, '');
+        this.apiKey = config.apiKey;
+    }
+    async generateImage(params) {
+        return this.post('/v1/image', params);
+    }
+    async screenshotUrl(params) {
+        return this.post('/v1/screenshot', params);
+    }
+    async post(path, body) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+        const data = await res.json();
+        if (!res.ok) {
+            const err = data;
+            throw new Error(err.error?.message || `API error: ${res.status}`);
+        }
+        return data;
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,SAAS;IACZ,OAAO,CAAQ;IACf,MAAM,CAAQ;IAEtB,YAAY,MAAuB;QACjC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;QAC/C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;IAC7B,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MASnB;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;IACvC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MASnB;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAA;IAC5C,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,IAAa;QAC5C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;YAChD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;gBACxC,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAA;QAEF,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,IAAwC,CAAA;YACpD,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,IAAI,cAAc,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;QACnE,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+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,3 @@
+export {};
+// MCP server entry point is server.ts
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/server.d.ts

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

package/dist/server.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { RendshotClient } from '@rendshot/sdk';
+import { generateImageSchema, generateImageToolMeta, handleGenerateImage, } from './tools/generateImage.js';
+import { screenshotUrlSchema, screenshotUrlToolMeta, handleScreenshotUrl, } from './tools/screenshotUrl.js';
+const apiKey = process.env.RENDSHOT_API_KEY;
+const apiUrl = process.env.RENDSHOT_API_URL || 'https://api.rendshot.ai';
+if (!apiKey) {
+    console.error('RENDSHOT_API_KEY environment variable is required');
+    process.exit(1);
+}
+const client = new RendshotClient({ apiKey, baseUrl: apiUrl });
+const server = new McpServer({
+    name: 'rendshot',
+    version: '0.1.0',
+});
+server.tool(generateImageToolMeta.name, generateImageToolMeta.description, generateImageSchema, async (args) => handleGenerateImage(client, args));
+server.tool(screenshotUrlToolMeta.name, screenshotUrlToolMeta.description, screenshotUrlSchema, async (args) => handleScreenshotUrl(client, args));
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,0BAA0B,CAAA;AAEjC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAA;AAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,yBAAyB,CAAA;AAExE,IAAI,CAAC,MAAM,EAAE,CAAC;IACZ,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAA;IAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;AAE9D,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAA;AAEF,MAAM,CAAC,IAAI,CACT,qBAAqB,CAAC,IAAI,EAC1B,qBAAqB,CAAC,WAAW,EACjC,mBAAmB,EACnB,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAClD,CAAA;AAED,MAAM,CAAC,IAAI,CACT,qBAAqB,CAAC,IAAI,EAC1B,qBAAqB,CAAC,WAAW,EACjC,mBAAmB,EACnB,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAClD,CAAA;AAED,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;AAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA"}

package/dist/tools/generateImage.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import type { RendshotClient } from '@rendshot/sdk';
+export declare const generateImageSchema: {
+    html: z.ZodString;
+    css: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    format: z.ZodOptional<z.ZodEnum<["png", "jpg"]>>;
+    quality: z.ZodOptional<z.ZodNumber>;
+    deviceScale: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+    fonts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+};
+export declare const generateImageToolMeta: {
+    name: string;
+    description: string;
+};
+export declare function handleGenerateImage(client: RendshotClient, args: z.objectOutputType<typeof generateImageSchema, z.ZodTypeAny>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=generateImage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generateImage.d.ts","sourceRoot":"","sources":["../../src/tools/generateImage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,eAAe,CAAA;AAEhE,eAAO,MAAM,mBAAmB;;;;;;;;;;CAU/B,CAAA;AAED,eAAO,MAAM,qBAAqB;;;CAGjC,CAAA;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,CAAC,CAAC,gBAAgB,CAAC,OAAO,mBAAmB,EAAE,CAAC,CAAC,UAAU,CAAC;;;;;GAWnE"}

package/dist/tools/generateImage.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export const generateImageSchema = {
+    html: z.string().describe('HTML content to render'),
+    css: z.string().optional().describe('Optional CSS styles'),
+    width: z.number().optional().describe('Image width in pixels (default 1080)'),
+    height: z.number().optional().describe('Image height in pixels (default 1080)'),
+    format: z.enum(['png', 'jpg']).optional().describe('Output format (default png)'),
+    quality: z.number().optional().describe('Quality 1-100 for jpg (default 90)'),
+    deviceScale: z.union([z.literal(1), z.literal(2), z.literal(3)]).optional().describe('Device scale factor (default 1)'),
+    fonts: z.array(z.string()).optional().describe('Custom fonts to load (e.g. ["Inter", "Roboto"])'),
+    timeout: z.number().optional().describe('Render timeout in ms (default 10000)'),
+};
+export const generateImageToolMeta = {
+    name: 'generate_image',
+    description: 'Render HTML/CSS to an image and return the URL',
+};
+export async function handleGenerateImage(client, args) {
+    const result = await client.renderImage(args);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Image generated successfully!\nURL: ${result.url}\nSize: ${result.width}x${result.height} ${result.format}\nFile size: ${result.size} bytes`,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=generateImage.js.map

package/dist/tools/generateImage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateImage.js","sourceRoot":"","sources":["../../src/tools/generateImage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IACnD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAC1D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IAC7E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAC/E,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACjF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC7E,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACvH,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IACjG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;CAChF,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,gDAAgD;CAC9D,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAsB,EACtB,IAAkE;IAElE,MAAM,MAAM,GAAgB,MAAM,MAAM,CAAC,WAAW,CAAC,IAAW,CAAC,CAAA;IACjE,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,uCAAuC,MAAM,CAAC,GAAG,WAAW,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,gBAAgB,MAAM,CAAC,IAAI,QAAQ;aACpJ;SACF;KACF,CAAA;AACH,CAAC"}

package/dist/tools/screenshotUrl.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import type { RendshotClient } from '@rendshot/sdk';
+export declare const screenshotUrlSchema: {
+    url: z.ZodString;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    format: z.ZodOptional<z.ZodEnum<["png", "jpg"]>>;
+    quality: z.ZodOptional<z.ZodNumber>;
+    fullPage: z.ZodOptional<z.ZodBoolean>;
+    deviceScale: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+};
+export declare const screenshotUrlToolMeta: {
+    name: string;
+    description: string;
+};
+export declare function handleScreenshotUrl(client: RendshotClient, args: z.objectOutputType<typeof screenshotUrlSchema, z.ZodTypeAny>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=screenshotUrl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"screenshotUrl.d.ts","sourceRoot":"","sources":["../../src/tools/screenshotUrl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,eAAe,CAAA;AAEhE,eAAO,MAAM,mBAAmB;;;;;;;;;CAS/B,CAAA;AAED,eAAO,MAAM,qBAAqB;;;CAGjC,CAAA;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,CAAC,CAAC,gBAAgB,CAAC,OAAO,mBAAmB,EAAE,CAAC,CAAC,UAAU,CAAC;;;;;GAWnE"}

package/dist/tools/screenshotUrl.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+export const screenshotUrlSchema = {
+    url: z.string().describe('URL to screenshot'),
+    width: z.number().optional().describe('Viewport width (default 1280)'),
+    height: z.number().optional().describe('Viewport height (default 800)'),
+    format: z.enum(['png', 'jpg']).optional().describe('Output format (default png)'),
+    quality: z.number().optional().describe('Quality 1-100 for jpg (default 90)'),
+    fullPage: z.boolean().optional().describe('Capture full page (default false)'),
+    deviceScale: z.union([z.literal(1), z.literal(2), z.literal(3)]).optional().describe('Device scale factor (default 1)'),
+    timeout: z.number().optional().describe('Timeout in ms (default 10000)'),
+};
+export const screenshotUrlToolMeta = {
+    name: 'screenshot_url',
+    description: 'Take a screenshot of a URL and return the image URL',
+};
+export async function handleScreenshotUrl(client, args) {
+    const result = await client.screenshotUrl(args);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `Screenshot taken!\nURL: ${result.url}\nSize: ${result.width}x${result.height} ${result.format}\nFile size: ${result.size} bytes`,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=screenshotUrl.js.map

package/dist/tools/screenshotUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshotUrl.js","sourceRoot":"","sources":["../../src/tools/screenshotUrl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACtE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACvE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACjF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC7E,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC9E,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACvH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;CACzE,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,qDAAqD;CACnE,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAsB,EACtB,IAAkE;IAElE,MAAM,MAAM,GAAgB,MAAM,MAAM,CAAC,aAAa,CAAC,IAAW,CAAC,CAAA;IACnE,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,2BAA2B,MAAM,CAAC,GAAG,WAAW,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,gBAAgB,MAAM,CAAC,IAAI,QAAQ;aACxI;SACF;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@rendshot/mcp",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "rendshot-mcp": "./dist/server.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1",
+    "zod": "^3",
+    "@rendshot/sdk": "0.1.0"
+  },
+  "devDependencies": {
+    "tsx": "^4",
+    "vitest": "^3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/server.ts",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist"
+  }
+}

package/src/__tests__/tools.test.ts

@@ -0,0 +1,248 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
+import { z } from 'zod'
+import {
+  generateImageSchema,
+  generateImageToolMeta,
+  handleGenerateImage,
+} from '../tools/generateImage.js'
+import {
+  screenshotUrlSchema,
+  screenshotUrlToolMeta,
+  handleScreenshotUrl,
+} from '../tools/screenshotUrl.js'
+import { RendshotClient } from '@rendshot/sdk'
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function makeFetchMock(status: number, body: unknown) {
+  return vi.fn().mockResolvedValue({
+    ok: status >= 200 && status < 300,
+    status,
+    json: async () => body,
+  })
+}
+
+afterEach(() => {
+  vi.unstubAllGlobals()
+  vi.restoreAllMocks()
+})
+
+// ---------------------------------------------------------------------------
+// Tool meta / definitions
+// ---------------------------------------------------------------------------
+
+describe('generate_image tool meta', () => {
+  it('has the correct name', () => {
+    expect(generateImageToolMeta.name).toBe('generate_image')
+  })
+
+  it('has a non-empty description', () => {
+    expect(typeof generateImageToolMeta.description).toBe('string')
+    expect(generateImageToolMeta.description.length).toBeGreaterThan(0)
+  })
+})
+
+describe('screenshot_url tool meta', () => {
+  it('has the correct name', () => {
+    expect(screenshotUrlToolMeta.name).toBe('screenshot_url')
+  })
+
+  it('has a non-empty description', () => {
+    expect(typeof screenshotUrlToolMeta.description).toBe('string')
+    expect(screenshotUrlToolMeta.description.length).toBeGreaterThan(0)
+  })
+})
+
+// ---------------------------------------------------------------------------
+// generate_image schema validation
+// ---------------------------------------------------------------------------
+
+describe('generateImageSchema validation', () => {
+  const schema = z.object(generateImageSchema)
+
+  it('accepts valid input with only the required html field', () => {
+    const result = schema.safeParse({ html: '<h1>Hello</h1>' })
+    expect(result.success).toBe(true)
+  })
+
+  it('accepts all optional fields when provided with correct types', () => {
+    const result = schema.safeParse({
+      html: '<p>test</p>',
+      css: 'body { color: red; }',
+      width: 800,
+      height: 600,
+      format: 'png',
+      quality: 90,
+      deviceScale: 2,
+      timeout: 10000,
+    })
+    expect(result.success).toBe(true)
+  })
+
+  it('rejects input missing the required html field', () => {
+    const result = schema.safeParse({ width: 800 })
+    expect(result.success).toBe(false)
+  })
+
+  it('rejects invalid format values', () => {
+    const result = schema.safeParse({ html: '<p>x</p>', format: 'gif' })
+    expect(result.success).toBe(false)
+  })
+
+  it('rejects invalid deviceScale values', () => {
+    const result = schema.safeParse({ html: '<p>x</p>', deviceScale: 4 })
+    expect(result.success).toBe(false)
+  })
+
+  it('accepts deviceScale of 1, 2, or 3', () => {
+    for (const scale of [1, 2, 3] as const) {
+      const result = schema.safeParse({ html: '<p>x</p>', deviceScale: scale })
+      expect(result.success).toBe(true)
+    }
+  })
+
+  it('accepts fonts array', () => {
+    const result = schema.safeParse({ html: '<p>x</p>', fonts: ['Inter', 'Roboto'] })
+    expect(result.success).toBe(true)
+  })
+})
+
+// ---------------------------------------------------------------------------
+// screenshot_url schema validation
+// ---------------------------------------------------------------------------
+
+describe('screenshotUrlSchema validation', () => {
+  const schema = z.object(screenshotUrlSchema)
+
+  it('accepts valid input with only the required url field', () => {
+    const result = schema.safeParse({ url: 'https://example.com' })
+    expect(result.success).toBe(true)
+  })
+
+  it('accepts all optional fields when provided with correct types', () => {
+    const result = schema.safeParse({
+      url: 'https://example.com',
+      width: 1280,
+      height: 800,
+      format: 'jpg',
+      quality: 85,
+      fullPage: true,
+      deviceScale: 1,
+      timeout: 5000,
+    })
+    expect(result.success).toBe(true)
+  })
+
+  it('rejects input missing the required url field', () => {
+    const result = schema.safeParse({ width: 1280 })
+    expect(result.success).toBe(false)
+  })
+
+  it('rejects invalid format values', () => {
+    const result = schema.safeParse({ url: 'https://example.com', format: 'bmp' })
+    expect(result.success).toBe(false)
+  })
+
+  it('rejects invalid deviceScale values', () => {
+    const result = schema.safeParse({ url: 'https://example.com', deviceScale: 0 })
+    expect(result.success).toBe(false)
+  })
+
+  it('accepts valid format values: png, jpg', () => {
+    for (const format of ['png', 'jpg'] as const) {
+      const result = schema.safeParse({ url: 'https://example.com', format })
+      expect(result.success).toBe(true)
+    }
+  })
+})
+
+// ---------------------------------------------------------------------------
+// handleGenerateImage — calls ApiClient correctly
+// ---------------------------------------------------------------------------
+
+describe('handleGenerateImage', () => {
+  it('calls client.generateImage with the provided args', async () => {
+    const mockFetch = makeFetchMock(200, {
+      url: 'https://cdn.example.com/img.png',
+      width: 1080,
+      height: 1080,
+      format: 'png',
+      size: 8192,
+    })
+    vi.stubGlobal('fetch', mockFetch)
+
+    const client = new RendshotClient({ apiKey: 'rs_test_key', baseUrl: 'https://api.rendshot.com' })
+    const args = { html: '<h1>Hello</h1>', width: 1080, height: 1080 }
+
+    const response = await handleGenerateImage(client, args as any)
+
+    // Verify fetch was called to POST /v1/image
+    expect(mockFetch).toHaveBeenCalledOnce()
+    const [url, init] = mockFetch.mock.calls[0] as [string, RequestInit]
+    expect(url).toBe('https://api.rendshot.com/v1/image')
+    expect((init as any).method).toBe('POST')
+    const body = JSON.parse(init.body as string)
+    expect(body.html).toBe('<h1>Hello</h1>')
+
+    // Verify the MCP response shape
+    expect(response.content).toHaveLength(1)
+    expect(response.content[0].type).toBe('text')
+    expect((response.content[0] as any).text).toContain('https://cdn.example.com/img.png')
+    expect((response.content[0] as any).text).toContain('Image generated successfully')
+  })
+
+  it('propagates errors from the API client', async () => {
+    const mockFetch = makeFetchMock(400, { error: { message: 'HTML is required' } })
+    vi.stubGlobal('fetch', mockFetch)
+
+    const client = new RendshotClient({ apiKey: 'rs_test_key', baseUrl: 'https://api.rendshot.com' })
+    await expect(handleGenerateImage(client, { html: '' } as any)).rejects.toThrow('HTML is required')
+  })
+})
+
+// ---------------------------------------------------------------------------
+// handleScreenshotUrl — calls ApiClient correctly
+// ---------------------------------------------------------------------------
+
+describe('handleScreenshotUrl', () => {
+  it('calls client.screenshotUrl with the provided args', async () => {
+    const mockFetch = makeFetchMock(200, {
+      url: 'https://cdn.example.com/shot.jpg',
+      width: 1280,
+      height: 800,
+      format: 'jpg',
+      size: 20480,
+    })
+    vi.stubGlobal('fetch', mockFetch)
+
+    const client = new RendshotClient({ apiKey: 'rs_test_key', baseUrl: 'https://api.rendshot.com' })
+    const args = { url: 'https://example.com', fullPage: true, format: 'jpg' }
+
+    const response = await handleScreenshotUrl(client, args as any)
+
+    expect(mockFetch).toHaveBeenCalledOnce()
+    const [url, init] = mockFetch.mock.calls[0] as [string, RequestInit]
+    expect(url).toBe('https://api.rendshot.com/v1/screenshot')
+    expect((init as any).method).toBe('POST')
+    const body = JSON.parse(init.body as string)
+    expect(body.url).toBe('https://example.com')
+    expect(body.fullPage).toBe(true)
+
+    expect(response.content).toHaveLength(1)
+    expect(response.content[0].type).toBe('text')
+    expect((response.content[0] as any).text).toContain('https://cdn.example.com/shot.jpg')
+    expect((response.content[0] as any).text).toContain('Screenshot taken')
+  })
+
+  it('propagates errors from the API client', async () => {
+    const mockFetch = makeFetchMock(422, { error: { message: 'Invalid URL' } })
+    vi.stubGlobal('fetch', mockFetch)
+
+    const client = new RendshotClient({ apiKey: 'rs_test_key', baseUrl: 'https://api.rendshot.com' })
+    await expect(
+      handleScreenshotUrl(client, { url: 'not-a-url' } as any)
+    ).rejects.toThrow('Invalid URL')
+  })
+})

package/src/index.ts

@@ -0,0 +1 @@
+// MCP server entry point is server.ts

package/src/server.ts

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
+import { RendshotClient } from '@rendshot/sdk'
+import {
+  generateImageSchema,
+  generateImageToolMeta,
+  handleGenerateImage,
+} from './tools/generateImage.js'
+import {
+  screenshotUrlSchema,
+  screenshotUrlToolMeta,
+  handleScreenshotUrl,
+} from './tools/screenshotUrl.js'
+
+const apiKey = process.env.RENDSHOT_API_KEY
+const apiUrl = process.env.RENDSHOT_API_URL || 'https://api.rendshot.ai'
+
+if (!apiKey) {
+  console.error('RENDSHOT_API_KEY environment variable is required')
+  process.exit(1)
+}
+
+const client = new RendshotClient({ apiKey, baseUrl: apiUrl })
+
+const server = new McpServer({
+  name: 'rendshot',
+  version: '0.1.0',
+})
+
+server.tool(
+  generateImageToolMeta.name,
+  generateImageToolMeta.description,
+  generateImageSchema,
+  async (args) => handleGenerateImage(client, args),
+)
+
+server.tool(
+  screenshotUrlToolMeta.name,
+  screenshotUrlToolMeta.description,
+  screenshotUrlSchema,
+  async (args) => handleScreenshotUrl(client, args),
+)
+
+const transport = new StdioServerTransport()
+await server.connect(transport)

package/src/tools/generateImage.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod'
+import type { RendshotClient, ImageResult } from '@rendshot/sdk'
+
+export const generateImageSchema = {
+  html: z.string().describe('HTML content to render'),
+  css: z.string().optional().describe('Optional CSS styles'),
+  width: z.number().optional().describe('Image width in pixels (default 1080)'),
+  height: z.number().optional().describe('Image height in pixels (default 1080)'),
+  format: z.enum(['png', 'jpg']).optional().describe('Output format (default png)'),
+  quality: z.number().optional().describe('Quality 1-100 for jpg (default 90)'),
+  deviceScale: z.union([z.literal(1), z.literal(2), z.literal(3)]).optional().describe('Device scale factor (default 1)'),
+  fonts: z.array(z.string()).optional().describe('Custom fonts to load (e.g. ["Inter", "Roboto"])'),
+  timeout: z.number().optional().describe('Render timeout in ms (default 10000)'),
+}
+
+export const generateImageToolMeta = {
+  name: 'generate_image',
+  description: 'Render HTML/CSS to an image and return the URL',
+}
+
+export async function handleGenerateImage(
+  client: RendshotClient,
+  args: z.objectOutputType<typeof generateImageSchema, z.ZodTypeAny>,
+) {
+  const result: ImageResult = await client.renderImage(args as any)
+  return {
+    content: [
+      {
+        type: 'text' as const,
+        text: `Image generated successfully!\nURL: ${result.url}\nSize: ${result.width}x${result.height} ${result.format}\nFile size: ${result.size} bytes`,
+      },
+    ],
+  }
+}

package/src/tools/screenshotUrl.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod'
+import type { RendshotClient, ImageResult } from '@rendshot/sdk'
+
+export const screenshotUrlSchema = {
+  url: z.string().describe('URL to screenshot'),
+  width: z.number().optional().describe('Viewport width (default 1280)'),
+  height: z.number().optional().describe('Viewport height (default 800)'),
+  format: z.enum(['png', 'jpg']).optional().describe('Output format (default png)'),
+  quality: z.number().optional().describe('Quality 1-100 for jpg (default 90)'),
+  fullPage: z.boolean().optional().describe('Capture full page (default false)'),
+  deviceScale: z.union([z.literal(1), z.literal(2), z.literal(3)]).optional().describe('Device scale factor (default 1)'),
+  timeout: z.number().optional().describe('Timeout in ms (default 10000)'),
+}
+
+export const screenshotUrlToolMeta = {
+  name: 'screenshot_url',
+  description: 'Take a screenshot of a URL and return the image URL',
+}
+
+export async function handleScreenshotUrl(
+  client: RendshotClient,
+  args: z.objectOutputType<typeof screenshotUrlSchema, z.ZodTypeAny>,
+) {
+  const result: ImageResult = await client.screenshotUrl(args as any)
+  return {
+    content: [
+      {
+        type: 'text' as const,
+        text: `Screenshot taken!\nURL: ${result.url}\nSize: ${result.width}x${result.height} ${result.format}\nFile size: ${result.size} bytes`,
+      },
+    ],
+  }
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["src/__tests__/**"]
+}