@revoxai/sdk-mcp 0.1.0

package/options.d.ts

@@ -0,0 +1,20 @@
+export type CLIOptions = McpOptions & {
+    debug: boolean;
+    logFormat: 'json' | 'pretty';
+    transport: 'stdio' | 'http';
+    port: number | undefined;
+    socket: string | undefined;
+};
+export type McpOptions = {
+    includeCodeTool?: boolean | undefined;
+    includeDocsTools?: boolean | undefined;
+    stainlessApiKey?: string | undefined;
+    codeAllowHttpGets?: boolean | undefined;
+    codeAllowedMethods?: string[] | undefined;
+    codeBlockedMethods?: string[] | undefined;
+    codeExecutionMode: McpCodeExecutionMode;
+};
+export type McpCodeExecutionMode = 'stainless-sandbox' | 'local';
+export declare function parseCLIOptions(): CLIOptions;
+export declare function parseQueryOptions(defaultOptions: McpOptions, query: unknown): McpOptions;
+//# sourceMappingURL=options.d.ts.map

package/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["src/options.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC1C,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC1C,iBAAiB,EAAE,oBAAoB,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,GAAG,OAAO,CAAC;AAEjE,wBAAgB,eAAe,IAAI,UAAU,CAgG5C;AAiBD,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,UAAU,CAmBxF"}

package/options.js

@@ -0,0 +1,122 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCLIOptions = parseCLIOptions;
+exports.parseQueryOptions = parseQueryOptions;
+const qs_1 = __importDefault(require("qs"));
+const yargs_1 = __importDefault(require("yargs"));
+const helpers_1 = require("yargs/helpers");
+const zod_1 = __importDefault(require("zod"));
+const util_1 = require("./util.js");
+function parseCLIOptions() {
+    const opts = (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
+        .option('code-allow-http-gets', {
+        type: 'boolean',
+        description: 'Allow all code tool methods that map to HTTP GET operations. If all code-allow-* flags are unset, then everything is allowed.',
+    })
+        .option('code-allowed-methods', {
+        type: 'string',
+        array: true,
+        description: 'Methods to explicitly allow for code tool. Evaluated as regular expressions against method fully qualified names. If all code-allow-* flags are unset, then everything is allowed.',
+    })
+        .option('code-blocked-methods', {
+        type: 'string',
+        array: true,
+        description: 'Methods to explicitly block for code tool. Evaluated as regular expressions against method fully qualified names. If all code-allow-* flags are unset, then everything is allowed.',
+    })
+        .option('code-execution-mode', {
+        type: 'string',
+        choices: ['stainless-sandbox', 'local'],
+        default: 'stainless-sandbox',
+        description: "Where to run code execution in code tool; 'stainless-sandbox' will execute code in Stainless-hosted sandboxes whereas 'local' will execute code locally on the MCP server machine.",
+    })
+        .option('debug', { type: 'boolean', description: 'Enable debug logging' })
+        .option('log-format', {
+        type: 'string',
+        choices: ['json', 'pretty'],
+        description: 'Format for log output; defaults to json unless tty is detected',
+    })
+        .option('no-tools', {
+        type: 'string',
+        array: true,
+        choices: ['code', 'docs'],
+        description: 'Tools to explicitly disable',
+    })
+        .option('port', {
+        type: 'number',
+        default: 3000,
+        description: 'Port to serve on if using http transport',
+    })
+        .option('socket', { type: 'string', description: 'Unix socket to serve on if using http transport' })
+        .option('stainless-api-key', {
+        type: 'string',
+        default: (0, util_1.readEnv)('STAINLESS_API_KEY'),
+        description: 'API key for Stainless. Used to authenticate requests to Stainless-hosted tools endpoints.',
+    })
+        .option('tools', {
+        type: 'string',
+        array: true,
+        choices: ['code', 'docs'],
+        description: 'Tools to explicitly enable',
+    })
+        .option('transport', {
+        type: 'string',
+        choices: ['stdio', 'http'],
+        default: 'stdio',
+        description: 'What transport to use; stdio for local servers or http for remote servers',
+    })
+        .env('MCP_SERVER')
+        .version(true)
+        .help();
+    const argv = opts.parseSync();
+    const shouldIncludeToolType = (toolType) => argv.noTools?.includes(toolType) ? false
+        : argv.tools?.includes(toolType) ? true
+            : undefined;
+    const includeCodeTool = shouldIncludeToolType('code');
+    const includeDocsTools = shouldIncludeToolType('docs');
+    const transport = argv.transport;
+    const logFormat = argv.logFormat ? argv.logFormat
+        : process.stderr.isTTY ? 'pretty'
+            : 'json';
+    return {
+        ...(includeCodeTool !== undefined && { includeCodeTool }),
+        ...(includeDocsTools !== undefined && { includeDocsTools }),
+        debug: !!argv.debug,
+        stainlessApiKey: argv.stainlessApiKey,
+        codeAllowHttpGets: argv.codeAllowHttpGets,
+        codeAllowedMethods: argv.codeAllowedMethods,
+        codeBlockedMethods: argv.codeBlockedMethods,
+        codeExecutionMode: argv.codeExecutionMode,
+        transport,
+        logFormat,
+        port: argv.port,
+        socket: argv.socket,
+    };
+}
+const coerceArray = (zodType) => zod_1.default.preprocess((val) => Array.isArray(val) ? val
+    : val ? [val]
+        : val, zod_1.default.array(zodType).optional());
+const QueryOptions = zod_1.default.object({
+    tools: coerceArray(zod_1.default.enum(['code', 'docs'])).describe('Specify which MCP tools to use'),
+    no_tools: coerceArray(zod_1.default.enum(['code', 'docs'])).describe('Specify which MCP tools to not use.'),
+    tool: coerceArray(zod_1.default.string()).describe('Include tools matching the specified names'),
+});
+function parseQueryOptions(defaultOptions, query) {
+    const queryObject = typeof query === 'string' ? qs_1.default.parse(query) : query;
+    const queryOptions = QueryOptions.parse(queryObject);
+    let codeTool = queryOptions.no_tools && queryOptions.no_tools?.includes('code') ? false
+        : queryOptions.tools?.includes('code') ? true
+            : defaultOptions.includeCodeTool;
+    let docsTools = queryOptions.no_tools && queryOptions.no_tools?.includes('docs') ? false
+        : queryOptions.tools?.includes('docs') ? true
+            : defaultOptions.includeDocsTools;
+    return {
+        ...(codeTool !== undefined && { includeCodeTool: codeTool }),
+        ...(docsTools !== undefined && { includeDocsTools: docsTools }),
+        codeExecutionMode: defaultOptions.codeExecutionMode,
+    };
+}
+//# sourceMappingURL=options.js.map

package/options.js.map

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

package/options.mjs

@@ -0,0 +1,115 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import qs from 'qs';
+import yargs from 'yargs';
+import { hideBin } from 'yargs/helpers';
+import z from 'zod';
+import { readEnv } from "./util.mjs";
+export function parseCLIOptions() {
+    const opts = yargs(hideBin(process.argv))
+        .option('code-allow-http-gets', {
+        type: 'boolean',
+        description: 'Allow all code tool methods that map to HTTP GET operations. If all code-allow-* flags are unset, then everything is allowed.',
+    })
+        .option('code-allowed-methods', {
+        type: 'string',
+        array: true,
+        description: 'Methods to explicitly allow for code tool. Evaluated as regular expressions against method fully qualified names. If all code-allow-* flags are unset, then everything is allowed.',
+    })
+        .option('code-blocked-methods', {
+        type: 'string',
+        array: true,
+        description: 'Methods to explicitly block for code tool. Evaluated as regular expressions against method fully qualified names. If all code-allow-* flags are unset, then everything is allowed.',
+    })
+        .option('code-execution-mode', {
+        type: 'string',
+        choices: ['stainless-sandbox', 'local'],
+        default: 'stainless-sandbox',
+        description: "Where to run code execution in code tool; 'stainless-sandbox' will execute code in Stainless-hosted sandboxes whereas 'local' will execute code locally on the MCP server machine.",
+    })
+        .option('debug', { type: 'boolean', description: 'Enable debug logging' })
+        .option('log-format', {
+        type: 'string',
+        choices: ['json', 'pretty'],
+        description: 'Format for log output; defaults to json unless tty is detected',
+    })
+        .option('no-tools', {
+        type: 'string',
+        array: true,
+        choices: ['code', 'docs'],
+        description: 'Tools to explicitly disable',
+    })
+        .option('port', {
+        type: 'number',
+        default: 3000,
+        description: 'Port to serve on if using http transport',
+    })
+        .option('socket', { type: 'string', description: 'Unix socket to serve on if using http transport' })
+        .option('stainless-api-key', {
+        type: 'string',
+        default: readEnv('STAINLESS_API_KEY'),
+        description: 'API key for Stainless. Used to authenticate requests to Stainless-hosted tools endpoints.',
+    })
+        .option('tools', {
+        type: 'string',
+        array: true,
+        choices: ['code', 'docs'],
+        description: 'Tools to explicitly enable',
+    })
+        .option('transport', {
+        type: 'string',
+        choices: ['stdio', 'http'],
+        default: 'stdio',
+        description: 'What transport to use; stdio for local servers or http for remote servers',
+    })
+        .env('MCP_SERVER')
+        .version(true)
+        .help();
+    const argv = opts.parseSync();
+    const shouldIncludeToolType = (toolType) => argv.noTools?.includes(toolType) ? false
+        : argv.tools?.includes(toolType) ? true
+            : undefined;
+    const includeCodeTool = shouldIncludeToolType('code');
+    const includeDocsTools = shouldIncludeToolType('docs');
+    const transport = argv.transport;
+    const logFormat = argv.logFormat ? argv.logFormat
+        : process.stderr.isTTY ? 'pretty'
+            : 'json';
+    return {
+        ...(includeCodeTool !== undefined && { includeCodeTool }),
+        ...(includeDocsTools !== undefined && { includeDocsTools }),
+        debug: !!argv.debug,
+        stainlessApiKey: argv.stainlessApiKey,
+        codeAllowHttpGets: argv.codeAllowHttpGets,
+        codeAllowedMethods: argv.codeAllowedMethods,
+        codeBlockedMethods: argv.codeBlockedMethods,
+        codeExecutionMode: argv.codeExecutionMode,
+        transport,
+        logFormat,
+        port: argv.port,
+        socket: argv.socket,
+    };
+}
+const coerceArray = (zodType) => z.preprocess((val) => Array.isArray(val) ? val
+    : val ? [val]
+        : val, z.array(zodType).optional());
+const QueryOptions = z.object({
+    tools: coerceArray(z.enum(['code', 'docs'])).describe('Specify which MCP tools to use'),
+    no_tools: coerceArray(z.enum(['code', 'docs'])).describe('Specify which MCP tools to not use.'),
+    tool: coerceArray(z.string()).describe('Include tools matching the specified names'),
+});
+export function parseQueryOptions(defaultOptions, query) {
+    const queryObject = typeof query === 'string' ? qs.parse(query) : query;
+    const queryOptions = QueryOptions.parse(queryObject);
+    let codeTool = queryOptions.no_tools && queryOptions.no_tools?.includes('code') ? false
+        : queryOptions.tools?.includes('code') ? true
+            : defaultOptions.includeCodeTool;
+    let docsTools = queryOptions.no_tools && queryOptions.no_tools?.includes('docs') ? false
+        : queryOptions.tools?.includes('docs') ? true
+            : defaultOptions.includeDocsTools;
+    return {
+        ...(codeTool !== undefined && { includeCodeTool: codeTool }),
+        ...(docsTools !== undefined && { includeDocsTools: docsTools }),
+        codeExecutionMode: defaultOptions.codeExecutionMode,
+    };
+}
+//# sourceMappingURL=options.mjs.map

package/options.mjs.map

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

package/package.json

@@ -0,0 +1,224 @@
+{
+  "name": "@revoxai/sdk-mcp",
+  "version": "0.1.0",
+  "description": "The official MCP Server for the Revox API",
+  "author": "Revox <>",
+  "types": "./index.d.ts",
+  "main": "./index.js",
+  "type": "commonjs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/revoxai/revox-typescript-prod.git",
+    "directory": "packages/mcp-server"
+  },
+  "homepage": "https://github.com/revoxai/revox-typescript-prod/tree/main/packages/mcp-server#readme",
+  "license": "Apache-2.0",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@revoxai/sdk": "^0.1.0",
+    "ajv": "^8.18.0",
+    "@cloudflare/cabidela": "^0.2.4",
+    "@hono/node-server": "^1.19.10",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "hono": "^4.12.4",
+    "@valtown/deno-http-worker": "^0.0.21",
+    "cookie-parser": "^1.4.6",
+    "cors": "^2.8.5",
+    "express": "^5.1.0",
+    "fuse.js": "^7.1.0",
+    "jq-web": "https://github.com/stainless-api/jq-web/releases/download/v0.8.8/jq-web.tar.gz",
+    "pino": "^10.3.1",
+    "pino-http": "^11.0.0",
+    "pino-pretty": "^13.1.3",
+    "qs": "^6.14.1",
+    "typescript": "5.8.3",
+    "yargs": "^17.7.2",
+    "zod": "^3.25.20",
+    "zod-to-json-schema": "^3.24.5",
+    "zod-validation-error": "^4.0.1"
+  },
+  "bin": {
+    "mcp-server": "./index.js"
+  },
+  "imports": {
+    "@revoxai/sdk-mcp": ".",
+    "@revoxai/sdk-mcp/*": "./src/*"
+  },
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./index.d.ts",
+        "default": "./index.js"
+      },
+      "types": "./index.d.mts",
+      "default": "./index.mjs"
+    },
+    "./auth": {
+      "import": "./auth.mjs",
+      "require": "./auth.js"
+    },
+    "./auth.js": {
+      "default": "./auth.js"
+    },
+    "./auth.mjs": {
+      "default": "./auth.mjs"
+    },
+    "./code-tool-paths": {
+      "require": "./code-tool-paths.cjs"
+    },
+    "./code-tool-paths.cjs": {
+      "default": "./code-tool-paths.cjs"
+    },
+    "./code-tool-types": {
+      "import": "./code-tool-types.mjs",
+      "require": "./code-tool-types.js"
+    },
+    "./code-tool-types.js": {
+      "default": "./code-tool-types.js"
+    },
+    "./code-tool-types.mjs": {
+      "default": "./code-tool-types.mjs"
+    },
+    "./code-tool-worker": {
+      "import": "./code-tool-worker.mjs",
+      "require": "./code-tool-worker.js"
+    },
+    "./code-tool-worker.js": {
+      "default": "./code-tool-worker.js"
+    },
+    "./code-tool-worker.mjs": {
+      "default": "./code-tool-worker.mjs"
+    },
+    "./code-tool": {
+      "import": "./code-tool.mjs",
+      "require": "./code-tool.js"
+    },
+    "./code-tool.js": {
+      "default": "./code-tool.js"
+    },
+    "./code-tool.mjs": {
+      "default": "./code-tool.mjs"
+    },
+    "./docs-search-tool": {
+      "import": "./docs-search-tool.mjs",
+      "require": "./docs-search-tool.js"
+    },
+    "./docs-search-tool.js": {
+      "default": "./docs-search-tool.js"
+    },
+    "./docs-search-tool.mjs": {
+      "default": "./docs-search-tool.mjs"
+    },
+    "./http": {
+      "import": "./http.mjs",
+      "require": "./http.js"
+    },
+    "./http.js": {
+      "default": "./http.js"
+    },
+    "./http.mjs": {
+      "default": "./http.mjs"
+    },
+    "./index": {
+      "import": "./index.mjs",
+      "require": "./index.js"
+    },
+    "./index.js": {
+      "default": "./index.js"
+    },
+    "./index.mjs": {
+      "default": "./index.mjs"
+    },
+    "./instructions": {
+      "import": "./instructions.mjs",
+      "require": "./instructions.js"
+    },
+    "./instructions.js": {
+      "default": "./instructions.js"
+    },
+    "./instructions.mjs": {
+      "default": "./instructions.mjs"
+    },
+    "./logger": {
+      "import": "./logger.mjs",
+      "require": "./logger.js"
+    },
+    "./logger.js": {
+      "default": "./logger.js"
+    },
+    "./logger.mjs": {
+      "default": "./logger.mjs"
+    },
+    "./methods": {
+      "import": "./methods.mjs",
+      "require": "./methods.js"
+    },
+    "./methods.js": {
+      "default": "./methods.js"
+    },
+    "./methods.mjs": {
+      "default": "./methods.mjs"
+    },
+    "./options": {
+      "import": "./options.mjs",
+      "require": "./options.js"
+    },
+    "./options.js": {
+      "default": "./options.js"
+    },
+    "./options.mjs": {
+      "default": "./options.mjs"
+    },
+    "./server": {
+      "import": "./server.mjs",
+      "require": "./server.js"
+    },
+    "./server.js": {
+      "default": "./server.js"
+    },
+    "./server.mjs": {
+      "default": "./server.mjs"
+    },
+    "./stdio": {
+      "import": "./stdio.mjs",
+      "require": "./stdio.js"
+    },
+    "./stdio.js": {
+      "default": "./stdio.js"
+    },
+    "./stdio.mjs": {
+      "default": "./stdio.mjs"
+    },
+    "./types": {
+      "import": "./types.mjs",
+      "require": "./types.js"
+    },
+    "./types.js": {
+      "default": "./types.js"
+    },
+    "./types.mjs": {
+      "default": "./types.mjs"
+    },
+    "./util": {
+      "import": "./util.mjs",
+      "require": "./util.js"
+    },
+    "./util.js": {
+      "default": "./util.js"
+    },
+    "./util.mjs": {
+      "default": "./util.mjs"
+    }
+  },
+  "scripts": {
+    "test": "jest",
+    "build": "bash ./build",
+    "format": "prettier --write --cache --cache-strategy metadata . !dist",
+    "tsn": "ts-node -r tsconfig-paths/register",
+    "lint": "eslint .",
+    "fix": "eslint --fix ."
+  }
+}

package/server.d.mts

@@ -0,0 +1,29 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { ClientOptions } from '@revoxai/sdk';
+import { McpOptions } from "./options.mjs";
+import { HandlerFunction, McpRequestContext, ToolCallResult, McpTool } from "./types.mjs";
+export declare const newMcpServer: (stainlessApiKey: string | undefined) => Promise<McpServer>;
+/**
+ * Initializes the provided MCP Server with the given tools and handlers.
+ * If not provided, the default client, tools and handlers will be used.
+ */
+export declare function initMcpServer(params: {
+    server: Server | McpServer;
+    clientOptions?: ClientOptions;
+    mcpOptions?: McpOptions;
+    stainlessApiKey?: string | undefined;
+}): Promise<void>;
+/**
+ * Selects the tools to include in the MCP Server based on the provided options.
+ */
+export declare function selectTools(options?: McpOptions): McpTool[];
+/**
+ * Runs the provided handler with the given client and arguments.
+ */
+export declare function executeHandler({ handler, reqContext, args, }: {
+    handler: HandlerFunction;
+    reqContext: McpRequestContext;
+    args: Record<string, unknown> | undefined;
+}): Promise<ToolCallResult>;
+//# sourceMappingURL=server.d.mts.map

package/server.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.mts","sourceRoot":"","sources":["src/server.ts"],"names":[],"mappings":"OAEO,EAAE,MAAM,EAAE,MAAM,2CAA2C;OAC3D,EAAE,SAAS,EAAE,MAAM,yCAAyC;OAM5D,EAAE,aAAa,EAAE,MAAM,cAAc;OAKrC,EAAE,UAAU,EAAE;OAEd,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,OAAO,EAAE;AAEtE,eAAO,MAAM,YAAY,GAAU,iBAAiB,MAAM,GAAG,SAAS,uBAUnE,CAAC;AAEJ;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,iBAiHA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,EAAE,CAe3D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,EACnC,OAAO,EACP,UAAU,EACV,IAAI,GACL,EAAE;IACD,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC3C,GAAG,OAAO,CAAC,cAAc,CAAC,CAE1B"}

package/server.d.ts

@@ -0,0 +1,29 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { ClientOptions } from '@revoxai/sdk';
+import { McpOptions } from "./options.js";
+import { HandlerFunction, McpRequestContext, ToolCallResult, McpTool } from "./types.js";
+export declare const newMcpServer: (stainlessApiKey: string | undefined) => Promise<McpServer>;
+/**
+ * Initializes the provided MCP Server with the given tools and handlers.
+ * If not provided, the default client, tools and handlers will be used.
+ */
+export declare function initMcpServer(params: {
+    server: Server | McpServer;
+    clientOptions?: ClientOptions;
+    mcpOptions?: McpOptions;
+    stainlessApiKey?: string | undefined;
+}): Promise<void>;
+/**
+ * Selects the tools to include in the MCP Server based on the provided options.
+ */
+export declare function selectTools(options?: McpOptions): McpTool[];
+/**
+ * Runs the provided handler with the given client and arguments.
+ */
+export declare function executeHandler({ handler, reqContext, args, }: {
+    handler: HandlerFunction;
+    reqContext: McpRequestContext;
+    args: Record<string, unknown> | undefined;
+}): Promise<ToolCallResult>;
+//# sourceMappingURL=server.d.ts.map

package/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["src/server.ts"],"names":[],"mappings":"OAEO,EAAE,MAAM,EAAE,MAAM,2CAA2C;OAC3D,EAAE,SAAS,EAAE,MAAM,yCAAyC;OAM5D,EAAE,aAAa,EAAE,MAAM,cAAc;OAKrC,EAAE,UAAU,EAAE;OAEd,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,OAAO,EAAE;AAEtE,eAAO,MAAM,YAAY,GAAU,iBAAiB,MAAM,GAAG,SAAS,uBAUnE,CAAC;AAEJ;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,iBAiHA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,EAAE,CAe3D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,EACnC,OAAO,EACP,UAAU,EACV,IAAI,GACL,EAAE;IACD,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC3C,GAAG,OAAO,CAAC,cAAc,CAAC,CAE1B"}