@runpod/mcp-server 1.4.0 → 2.0.0

package/dist/tools.d.cts

@@ -1,5 +1,30 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 
+interface RequestInitLike {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+}
+type FetchLike = (url: string, init: RequestInitLike) => Promise<HttpResponseLike>;
+interface HttpResponseLike {
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+    headers: {
+        get(name: string): string | null;
+    };
+}
+interface HttpClient {
+    (url: string, method?: string, body?: Record<string, unknown>): Promise<unknown>;
+}
+declare function createHttpClient(deps: {
+    apiKey: string;
+    fetch: FetchLike;
+    tracking: () => Record<string, string>;
+    errorPrefix: string;
+}): HttpClient;
+
 /**
  * Context passed to every tool handler. Contains the API key used to
  * authenticate against the Runpod REST and Serverless APIs, the transport the
@@ -12,10 +37,33 @@ interface ToolContext {
     clientUserAgent?: string;
     serverVersion?: string;
 }
+type HttpFetch = Parameters<typeof createHttpClient>[0]['fetch'];
+interface ToolDeps {
+    fetch?: HttpFetch;
+    v2Available?: boolean;
+    streamSse?: StreamSse;
+}
+interface StreamSseResult {
+    raw: string;
+    truncated: boolean;
+}
+type StreamSse = (url: string, opts: {
+    maxWaitMs: number;
+    maxBytes: number;
+}) => Promise<StreamSseResult>;
+
 /**
- * Register all Runpod tools on the given MCP server instance. The provided
- * context supplies the API key that authenticated request helpers will use.
+ * Register all Runpod tools on the given MCP server instance.
+ *
+ * The tool surface is split by resource under `src/tools/<resource>.ts`; this
+ * function builds the shared runtime (caller-tracking, authenticated REST/
+ * Serverless/GraphQL clients, the v1/v2 backend resolver) once and threads it
+ * into each per-resource registrar.
+ *
+ * @param ctx  supplies the API key the request helpers authenticate with.
+ * @param deps optional test seam (inject a fake fetch / the resolved v2-probe
+ *             verdict). Production passes nothing.
  */
-declare function registerTools(server: McpServer, ctx: ToolContext): void;
+declare function registerTools(server: McpServer, ctx: ToolContext, deps?: ToolDeps): void;
 
 export { type ToolContext, registerTools };

package/dist/tools.d.ts

@@ -1,5 +1,30 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 
+interface RequestInitLike {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+}
+type FetchLike = (url: string, init: RequestInitLike) => Promise<HttpResponseLike>;
+interface HttpResponseLike {
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+    headers: {
+        get(name: string): string | null;
+    };
+}
+interface HttpClient {
+    (url: string, method?: string, body?: Record<string, unknown>): Promise<unknown>;
+}
+declare function createHttpClient(deps: {
+    apiKey: string;
+    fetch: FetchLike;
+    tracking: () => Record<string, string>;
+    errorPrefix: string;
+}): HttpClient;
+
 /**
  * Context passed to every tool handler. Contains the API key used to
  * authenticate against the Runpod REST and Serverless APIs, the transport the
@@ -12,10 +37,33 @@ interface ToolContext {
     clientUserAgent?: string;
     serverVersion?: string;
 }
+type HttpFetch = Parameters<typeof createHttpClient>[0]['fetch'];
+interface ToolDeps {
+    fetch?: HttpFetch;
+    v2Available?: boolean;
+    streamSse?: StreamSse;
+}
+interface StreamSseResult {
+    raw: string;
+    truncated: boolean;
+}
+type StreamSse = (url: string, opts: {
+    maxWaitMs: number;
+    maxBytes: number;
+}) => Promise<StreamSseResult>;
+
 /**
- * Register all Runpod tools on the given MCP server instance. The provided
- * context supplies the API key that authenticated request helpers will use.
+ * Register all Runpod tools on the given MCP server instance.
+ *
+ * The tool surface is split by resource under `src/tools/<resource>.ts`; this
+ * function builds the shared runtime (caller-tracking, authenticated REST/
+ * Serverless/GraphQL clients, the v1/v2 backend resolver) once and threads it
+ * into each per-resource registrar.
+ *
+ * @param ctx  supplies the API key the request helpers authenticate with.
+ * @param deps optional test seam (inject a fake fetch / the resolved v2-probe
+ *             verdict). Production passes nothing.
  */
-declare function registerTools(server: McpServer, ctx: ToolContext): void;
+declare function registerTools(server: McpServer, ctx: ToolContext, deps?: ToolDeps): void;
 
 export { type ToolContext, registerTools };

package/dist/tools.mjs

@@ -1,6 +1,6 @@
 import {
   registerTools
-} from "./chunk-D4AEYJ2O.mjs";
+} from "./chunk-ZP3TCVXG.mjs";
 export {
   registerTools
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runpod/mcp-server",
-  "version": "1.4.0",
+  "version": "2.0.0",
   "description": "MCP server for interacting with Runpod API",
   "license": "Apache-2.0",
   "type": "module",
@@ -88,6 +88,7 @@
     "oauth-e2e": "tsx scripts/oauth-e2e.ts",
     "changeset": "changeset",
     "changeset:version": "changeset version",
-    "changeset:publish": "changeset publish"
+    "changeset:publish": "changeset publish",
+    "smoke:crud": "tsx scripts/smoke-crud.ts"
   }
 }