@prompteryx/mcp-server 1.0.1

package/dist/tools/browser-tools.js

@@ -0,0 +1,270 @@
+/**
+ * Browser Automation Tools
+ *
+ * 20+ MCP tools that wrap Playwright browser actions.
+ * Each tool maps to node types in lib/node-executor.ts.
+ */
+import { z } from 'zod';
+import { enforceUsageLimits, recordUsage, formatUsageRemaining } from '../auth/usage-enforcer.js';
+import { executeBrowserAction } from '../execution/cloud-executor.js';
+import { formatError } from '../utils/output-formatter.js';
+function withUsageCheck(ctx, category, fn) {
+    return async () => {
+        const check = enforceUsageLimits(ctx.getAuth(), category, ctx.executionMode);
+        if (!check.allowed) {
+            return formatError(check.reason, undefined, { usageRemaining: formatUsageRemaining(ctx.getAuth()) });
+        }
+        return fn();
+    };
+}
+async function ensurePage(ctx) {
+    if (ctx.executionMode === 'cloud') {
+        const session = await ctx.sessionManager.getOrCreateCloudPage(ctx.cloudConfig());
+        return session.page;
+    }
+    const session = await ctx.sessionManager.getOrCreateLocalPage({
+        electronUrl: 'http://localhost:61337',
+        chromeProfile: process.env.PROMPTERYX_CHROME_PROFILE,
+    });
+    return session.page;
+}
+export function registerBrowserTools(server, ctx) {
+    // browser_navigate
+    server.tool('browser_navigate', 'Navigate to a URL. Returns page title and final URL after any redirects.', { url: z.string().describe('The URL to navigate to'), waitUntil: z.enum(['load', 'domcontentloaded', 'networkidle']).optional().describe('When to consider navigation complete') }, async (params) => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        const result = await executeBrowserAction(page, 'navigate', params);
+        // Include debug URL on first navigation
+        if (ctx.sessionManager.activeSession?.debugUrl) {
+            const debugUrl = ctx.sessionManager.activeSession.debugUrl;
+            if (result.content[0]?.type === 'text' && result.content[0].text) {
+                const data = JSON.parse(result.content[0].text);
+                data.debugUrl = debugUrl;
+                result.content[0].text = JSON.stringify(data, null, 2);
+            }
+        }
+        return result;
+    });
+    // browser_click
+    server.tool('browser_click', 'Click an element on the page using a CSS selector.', {
+        selector: z.string().describe('CSS selector of the element to click'),
+        button: z.enum(['left', 'right', 'middle']).optional().describe('Mouse button'),
+        clickCount: z.number().optional().describe('Number of clicks (2 for double-click)'),
+    }, async (params) => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        return executeBrowserAction(page, 'click', params);
+    });
+    // browser_fill
+    server.tool('browser_fill', 'Clear and fill an input field with text. Clears existing content first.', {
+        selector: z.string().describe('CSS selector of the input field'),
+        value: z.string().describe('Text to fill into the field'),
+    }, async (params) => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        return executeBrowserAction(page, 'fill', params);
+    });
+    // browser_type
+    server.tool('browser_type', 'Type text character by character (simulates real typing). Unlike fill, does not clear existing content.', {
+        selector: z.string().describe('CSS selector of the element'),
+        text: z.string().describe('Text to type'),
+        delay: z.number().optional().describe('Delay between keystrokes in ms (default: 50)'),
+    }, async (params) => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        return executeBrowserAction(page, 'type', params);
+    });
+    // browser_press_key
+    server.tool('browser_press_key', 'Press a keyboard key (Enter, Tab, Escape, ArrowDown, etc.).', {
+        key: z.string().describe('Key to press (e.g. "Enter", "Tab", "Escape", "ArrowDown", "Control+a")'),
+        selector: z.string().optional().describe('Optional: focus this element first'),
+    }, async (params) => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        return executeBrowserAction(page, 'press_key', params);
+    });
+    // browser_select
+    server.tool('browser_select', 'Select an option from a dropdown/select element.', {
+        selector: z.string().describe('CSS selector of the select element'),
+        value: z.union([z.string(), z.array(z.string())]).describe('Value(s) to select'),
+    }, async (params) => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        return executeBrowserAction(page, 'select', params);
+    });
+    // browser_check
+    server.tool('browser_check', 'Check or uncheck a checkbox.', {
+        selector: z.string().describe('CSS selector of the checkbox'),
+        uncheck: z.boolean().optional().describe('Set to true to uncheck instead of check'),
+    }, async (params) => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        return executeBrowserAction(page, 'check', params);
+    });
+    // browser_hover
+    server.tool('browser_hover', 'Hover over an element to reveal tooltips, menus, or other hover effects.', { selector: z.string().describe('CSS selector of the element to hover over') }, async (params) => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        return executeBrowserAction(page, 'hover', params);
+    });
+    // browser_scroll
+    server.tool('browser_scroll', 'Scroll the page or scroll to a specific element.', {
+        selector: z.string().optional().describe('CSS selector to scroll into view'),
+        deltaX: z.number().optional().describe('Horizontal scroll pixels (for mouse wheel)'),
+        deltaY: z.number().optional().describe('Vertical scroll pixels (default: 300, negative scrolls up)'),
+    }, async (params) => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        return executeBrowserAction(page, 'scroll', params);
+    });
+    // browser_extract_text
+    server.tool('browser_extract_text', 'Extract the visible text content of an element.', { selector: z.string().describe('CSS selector of the element') }, async (params) => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        return executeBrowserAction(page, 'extract_text', params);
+    });
+    // browser_extract_attribute
+    server.tool('browser_extract_attribute', 'Get an HTML attribute value from an element (e.g. href, src, value, data-*).', {
+        selector: z.string().describe('CSS selector of the element'),
+        attribute: z.string().describe('Attribute name (e.g. "href", "src", "value", "data-id")'),
+    }, async (params) => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        return executeBrowserAction(page, 'extract_attribute', params);
+    });
+    // browser_screenshot
+    server.tool('browser_screenshot', 'Take a screenshot of the current page or a specific element. Returns the image directly.', {
+        selector: z.string().optional().describe('CSS selector to screenshot (default: full page viewport)'),
+        fullPage: z.boolean().optional().describe('Capture the full scrollable page'),
+    }, async (params) => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        return executeBrowserAction(page, 'screenshot', params);
+    });
+    // browser_evaluate
+    server.tool('browser_evaluate', 'Execute JavaScript code in the browser page context. Returns the result.', { script: z.string().describe('JavaScript code to execute in the page') }, async (params) => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        return executeBrowserAction(page, 'evaluate', params);
+    });
+    // browser_wait
+    server.tool('browser_wait', 'Wait for a selector to appear, a timeout, or navigation to complete.', {
+        selector: z.string().optional().describe('CSS selector to wait for'),
+        state: z.enum(['visible', 'hidden', 'attached', 'detached']).optional().describe('Desired state of the selector (default: visible)'),
+        milliseconds: z.number().optional().describe('Fixed wait time in milliseconds'),
+        navigation: z.boolean().optional().describe('Wait for page navigation/load'),
+        loadState: z.enum(['load', 'domcontentloaded', 'networkidle']).optional().describe('Load state to wait for'),
+    }, async (params) => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        return executeBrowserAction(page, 'wait', params);
+    });
+    // browser_get_page_info
+    server.tool('browser_get_page_info', 'Get current page URL and title.', {}, async () => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        return executeBrowserAction(page, 'get_page_info', {});
+    });
+    // browser_drag_drop
+    server.tool('browser_drag_drop', 'Drag an element and drop it onto another element.', {
+        source: z.string().describe('CSS selector of the element to drag'),
+        target: z.string().describe('CSS selector of the drop target'),
+    }, async (params) => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        return executeBrowserAction(page, 'drag_drop', params);
+    });
+    // browser_set_files
+    server.tool('browser_set_files', 'Upload file(s) to a file input element.', {
+        selector: z.string().describe('CSS selector of the file input'),
+        files: z.array(z.string()).describe('Array of file paths to upload'),
+    }, async (params) => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        return executeBrowserAction(page, 'set_files', params);
+    });
+    // browser_get_cookies
+    server.tool('browser_get_cookies', 'Get all cookies for the current page.', {}, async () => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        return executeBrowserAction(page, 'get_cookies', {});
+    });
+    // browser_set_cookies
+    server.tool('browser_set_cookies', 'Set cookies on the browser context.', {
+        cookies: z.array(z.object({
+            name: z.string(),
+            value: z.string(),
+            domain: z.string().optional(),
+            path: z.string().optional(),
+            httpOnly: z.boolean().optional(),
+            secure: z.boolean().optional(),
+        })).describe('Array of cookie objects to set'),
+    }, async (params) => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        return executeBrowserAction(page, 'set_cookies', params);
+    });
+    // browser_pdf
+    server.tool('browser_pdf', 'Generate a PDF of the current page.', {
+        format: z.enum(['A4', 'Letter', 'Legal', 'Tabloid']).optional().describe('Page format (default: A4)'),
+        printBackground: z.boolean().optional().describe('Include background graphics (default: true)'),
+    }, async (params) => {
+        const check = enforceUsageLimits(ctx.getAuth(), 'browser', ctx.executionMode);
+        if (!check.allowed)
+            return formatError(check.reason);
+        const page = await ensurePage(ctx);
+        return executeBrowserAction(page, 'pdf', params);
+    });
+    // browser_close
+    server.tool('browser_close', 'Close the browser session and release resources. Reports cloud minutes used.', {}, async () => {
+        const { minutesUsed } = await ctx.sessionManager.close();
+        if (minutesUsed > 0 && ctx.executionMode === 'cloud') {
+            await recordUsage(ctx.apiKey, ctx.apiUrl, { cloudBrowserMinutes: minutesUsed });
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, sessionClosed: true, cloudMinutesUsed: minutesUsed }),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=browser-tools.js.map

package/dist/tools/browser-tools.js.map

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

package/dist/tools/data-tools.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Data Transformation Tools
+ *
+ * Lightweight data manipulation tools that run locally
+ * with zero cost and zero API calls.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerDataTools(server: McpServer): void;
+//# sourceMappingURL=data-tools.d.ts.map

package/dist/tools/data-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-tools.d.ts","sourceRoot":"","sources":["../../src/tools/data-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,QAmIlD"}

package/dist/tools/data-tools.js

@@ -0,0 +1,110 @@
+/**
+ * Data Transformation Tools
+ *
+ * Lightweight data manipulation tools that run locally
+ * with zero cost and zero API calls.
+ */
+import { z } from 'zod';
+import { formatSuccess, formatError } from '../utils/output-formatter.js';
+export function registerDataTools(server) {
+    server.tool('transform_json', 'Parse, query, or transform JSON data. Supports JSONPath-like access.', {
+        data: z.any().describe('JSON data to transform'),
+        path: z.string().optional().describe('Dot-notation path to extract (e.g. "results.0.name")'),
+        operation: z.enum(['parse', 'stringify', 'keys', 'values', 'flatten', 'pick']).optional().describe('Transformation to apply'),
+        fields: z.array(z.string()).optional().describe('Fields to pick (for "pick" operation)'),
+    }, async ({ data, path, operation, fields }) => {
+        try {
+            let parsed = typeof data === 'string' ? JSON.parse(data) : data;
+            if (path) {
+                const parts = path.split('.');
+                for (const p of parts) {
+                    if (parsed == null)
+                        break;
+                    parsed = parsed[p];
+                }
+            }
+            switch (operation) {
+                case 'stringify':
+                    return formatSuccess({ result: JSON.stringify(parsed, null, 2) });
+                case 'keys':
+                    return formatSuccess({ result: Object.keys(parsed ?? {}) });
+                case 'values':
+                    return formatSuccess({ result: Object.values(parsed ?? {}) });
+                case 'flatten':
+                    if (Array.isArray(parsed)) {
+                        return formatSuccess({ result: parsed.flat(Infinity) });
+                    }
+                    return formatSuccess({ result: parsed });
+                case 'pick':
+                    if (fields && typeof parsed === 'object') {
+                        const picked = {};
+                        for (const f of fields)
+                            picked[f] = parsed[f];
+                        return formatSuccess({ result: picked });
+                    }
+                    return formatSuccess({ result: parsed });
+                default:
+                    return formatSuccess({ result: parsed });
+            }
+        }
+        catch (err) {
+            return formatError(`JSON transform failed: ${err.message}`);
+        }
+    });
+    server.tool('generate_uuid', 'Generate a random UUID v4.', {}, async () => {
+        const uuid = crypto.randomUUID();
+        return formatSuccess({ uuid });
+    });
+    server.tool('base64_encode', 'Encode text to Base64.', { text: z.string().describe('Text to encode') }, async ({ text }) => {
+        return formatSuccess({ result: Buffer.from(text).toString('base64') });
+    });
+    server.tool('base64_decode', 'Decode Base64 to text.', { data: z.string().describe('Base64 string to decode') }, async ({ data }) => {
+        try {
+            return formatSuccess({ result: Buffer.from(data, 'base64').toString('utf-8') });
+        }
+        catch (err) {
+            return formatError(`Decode failed: ${err.message}`);
+        }
+    });
+    server.tool('format_date', 'Format a date string or timestamp.', {
+        date: z.union([z.string(), z.number()]).optional().describe('Date string, timestamp, or omit for now'),
+        format: z.string().optional().describe('Output format (default: ISO 8601)'),
+        timezone: z.string().optional().describe('IANA timezone (e.g. "America/New_York")'),
+    }, async ({ date, timezone }) => {
+        try {
+            const d = date ? new Date(date) : new Date();
+            if (isNaN(d.getTime()))
+                return formatError('Invalid date');
+            const options = {
+                year: 'numeric', month: '2-digit', day: '2-digit',
+                hour: '2-digit', minute: '2-digit', second: '2-digit',
+                ...(timezone ? { timeZone: timezone } : {}),
+            };
+            return formatSuccess({
+                iso: d.toISOString(),
+                formatted: d.toLocaleString('en-GB', options),
+                timestamp: d.getTime(),
+            });
+        }
+        catch (err) {
+            return formatError(`Date formatting failed: ${err.message}`);
+        }
+    });
+    server.tool('math_operation', 'Perform a math operation.', {
+        expression: z.string().describe('Math expression to evaluate (e.g. "2 + 3 * 4")'),
+    }, async ({ expression }) => {
+        try {
+            // Simple safe eval using Function constructor (no access to globals)
+            const sanitized = expression.replace(/[^0-9+\-*/.()%\s]/g, '');
+            if (sanitized !== expression) {
+                return formatError('Expression contains invalid characters. Only numbers and +, -, *, /, %, (, ) are allowed.');
+            }
+            const result = new Function(`return (${sanitized})`)();
+            return formatSuccess({ expression, result });
+        }
+        catch (err) {
+            return formatError(`Math error: ${err.message}`);
+        }
+    });
+}
+//# sourceMappingURL=data-tools.js.map

package/dist/tools/data-tools.js.map

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

package/dist/tools/integration-tools.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Integration Tools (Dynamic Registry)
+ *
+ * Auto-generates MCP tools from NODE_CONFIGS integration entries.
+ * When new integration nodes are added to the platform, they
+ * automatically appear as MCP tools—no MCP code changes needed.
+ *
+ * Only registers tools for services where the user has valid credentials.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AuthContext } from '../auth/api-key-auth.js';
+interface IntegrationToolsContext {
+    getAuth: () => AuthContext;
+    apiKey: string;
+    apiUrl: string;
+}
+/**
+ * Registers integration tools dynamically.
+ *
+ * This is called once during server setup. It registers tools based on:
+ * 1. Available integration configs from the platform
+ * 2. User's connected OAuth credentials
+ *
+ * For the MCP protocol, tools are registered statically at connection
+ * init, so we scope to all service types the user has credentials for.
+ */
+export declare function registerIntegrationTools(server: McpServer, ctx: IntegrationToolsContext): Promise<number>;
+export {};
+//# sourceMappingURL=integration-tools.d.ts.map

package/dist/tools/integration-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-tools.d.ts","sourceRoot":"","sources":["../../src/tools/integration-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,yBAAyB,CAAC;AAW9E,UAAU,uBAAuB;IAC/B,OAAO,EAAE,MAAM,WAAW,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAiDD;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,MAAM,CAAC,CA8DjB"}