@mozilla-ai/mcpd 0.0.1 → 0.0.3

package/README.md

@@ -9,14 +9,15 @@ This SDK provides high-level and dynamic access to those tools, making it easy t
 ## Features
 
 - Discover and list available `mcpd` hosted MCP servers
-- Retrieve tool definitions and schemas for one or all servers
+- Retrieve tool, prompt, and resource definitions from individual servers
 - Dynamically invoke any tool using a clean, attribute-based syntax
-- Unified AI framework integration - works directly with LangChain JS and Vercel AI SDK
+- Unified AI framework integration - works directly with LangChain JS and Vercel AI SDK via `getAgentTools()`
 - Generate self-contained, framework-compatible tool functions without conversion layers
 - Multiple output formats (`'array'`, `'object'`, `'map'`) for different framework needs
 - Full TypeScript support with comprehensive type definitions and overloads
 - Minimal dependencies (`lru-cache` for caching, `zod` for schema validation)
 - Works in both Node.js and browser environments
+- Clean API wrapper over mcpd HTTP endpoints - no opinionated aggregation logic
 
 ## Installation
 
@@ -47,7 +48,7 @@ console.log(servers);
 // Example: ['time', 'fetch', 'git']
 
 // List tool definitions for a specific server
-const tools = await client.servers.time.listTools();
+const tools = await client.servers.time.getTools();
 console.log(tools);
 
 // Dynamically call a tool via the .tools namespace
@@ -79,7 +80,7 @@ const client = new McpdClient({
 const servers: string[] = await client.listServers();
 
 // Get tools with proper typing
-const tools: Tool[] = await client.servers.time.listTools();
+const tools: Tool[] = await client.servers.time.getTools();
 
 // Dynamic tool invocation with error handling via .tools namespace
 try {
@@ -122,38 +123,13 @@ const servers = await client.listServers();
 // Returns: ['time', 'fetch', 'git']
 ```
 
-#### `client.getToolSchemas(options?)`
-
-Returns tool schemas from all (or specific) servers with names transformed to `serverName__toolName` format.
-
-**IMPORTANT**: Tool names are automatically transformed to prevent naming clashes and identify server origin. Original tool name `get_current_time` on server `time` becomes `time__get_current_time`.
-
-This is useful for:
-
-- MCP servers aggregating and re-exposing tools from multiple upstream servers
-- Tool inspection and discovery across all servers
-- Custom tooling that needs raw MCP tool schemas with unique names
-
-```typescript
-// Get all tools from all servers
-const allTools = await client.getToolSchemas();
-// Returns: [
-//   { name: "time__get_current_time", description: "...", inputSchema: {...} },
-//   { name: "fetch__fetch_url", description: "...", inputSchema: {...} },
-//   { name: "git__commit", description: "...", inputSchema: {...} }
-// ]
-
-// Get tools from specific servers only
-const someTools = await client.getToolSchemas({ servers: ["time", "fetch"] });
-```
-
-#### `client.servers.<server>.listTools()`
+#### `client.servers.<server>.getTools()`
 
 Returns tool schemas for a specific server.
 
 ```typescript
 // Get tools for a specific server
-const timeTools = await client.servers.time.listTools();
+const timeTools = await client.servers.time.getTools();
 // Returns: [{ name: 'get_current_time', description: '...', inputSchema: {...} }]
 ```
 
@@ -172,13 +148,13 @@ const result = await client.servers.weather.tools.get_forecast({
 const time = await client.servers.time.tools.get_current_time();
 ```
 
-#### `client.servers.<server>.listTools()`
+#### `client.servers.<server>.getTools()`
 
-List all tools available on a specific server.
+Get all tools available on a specific server.
 
 ```typescript
 // List tools for a server using property access
-const tools = await client.servers.time.listTools();
+const tools = await client.servers.time.getTools();
 for (const tool of tools) {
   console.log(`${tool.name}: ${tool.description}`);
 }
@@ -186,7 +162,7 @@ for (const tool of tools) {
 // Useful in loops with dynamic server names
 const servers = await client.listServers();
 for (const serverName of servers) {
-  const tools = await client.servers[serverName].listTools();
+  const tools = await client.servers[serverName].getTools();
   console.log(`${serverName}: ${tools.length} tools`);
 }
 ```
@@ -228,6 +204,130 @@ if (await client.servers[serverName].hasTool("get_current_time")) {
 }
 ```
 
+#### `client.servers.<server>.getPrompts()`
+
+Returns prompt schemas for a specific server.
+
+```typescript
+// Get prompts for a specific server
+const githubPrompts = await client.servers.github.getPrompts();
+// Returns: [{ name: 'create_pr', description: '...', arguments: [...] }]
+```
+
+#### `client.servers.<server>.prompts.<prompt>(args)`
+
+Dynamically generate any prompt using natural syntax via the `.prompts` namespace. Prompt names must match exactly as returned by the MCP server.
+
+```typescript
+// Generate a prompt with parameters using property access (recommended)
+const result = await client.servers.github.prompts.create_pr({
+  title: "Fix bug",
+  description: "Fixed authentication issue",
+});
+
+// Generate without parameters (if prompt has no required args)
+const result = await client.servers.templates.prompts.default_template();
+```
+
+#### `client.servers.<server>.generatePrompt(promptName, args?)`
+
+Generate a prompt by name with the given arguments. This is useful for programmatic prompt generation when the prompt name is in a variable.
+
+```typescript
+// Generate with dynamic prompt name
+const promptName = "create_pr";
+const result = await client.servers.github.generatePrompt(promptName, {
+  title: "Fix bug",
+  description: "Fixed authentication issue",
+});
+
+// Using with dynamic server name too
+const serverName = "github";
+const result2 = await client.servers[serverName].generatePrompt(promptName, {
+  title: "Fix bug",
+});
+```
+
+#### `client.servers.<server>.hasPrompt(promptName)`
+
+Check if a specific prompt exists on a server. Prompt names must match exactly as returned by the MCP server.
+
+```typescript
+// Check if prompt exists before generating it
+if (await client.servers.github.hasPrompt("create_pr")) {
+  const result = await client.servers.github.generatePrompt("create_pr", {
+    title: "Fix bug",
+  });
+}
+
+// Using with dynamic server names
+const serverName = "github";
+if (await client.servers[serverName].hasPrompt("create_pr")) {
+  const result = await client.servers[serverName].prompts.create_pr({
+    title: "Fix bug",
+  });
+}
+```
+
+#### `client.servers.<server>.getResources()`
+
+Returns resource schemas for a specific server.
+
+```typescript
+// Get resources for a specific server
+const githubResources = await client.servers.github.getResources();
+// Returns: [{ name: 'readme', uri: 'file:///repo/README.md', ... }]
+```
+
+#### `client.servers.<server>.getResourceTemplates()`
+
+Returns resource template schemas for a specific server.
+
+```typescript
+// Get resource templates for a specific server
+const githubTemplates = await client.servers.github.getResourceTemplates();
+// Returns: [{ name: 'file', uriTemplate: 'file:///{path}', ... }]
+```
+
+#### `client.servers.<server>.readResource(uri)`
+
+Read resource content by URI from a specific server.
+
+```typescript
+// Read resource content by URI
+const contents = await client.servers.github.readResource(
+  "file:///repo/README.md",
+);
+for (const content of contents) {
+  if (content.text) {
+    console.log(content.text);
+  } else if (content.blob) {
+    console.log("Binary content (base64):", content.blob);
+  }
+}
+```
+
+#### `client.servers.<server>.hasResource(uri)`
+
+Check if a specific resource exists on a server. Resource URIs must match exactly as returned by the MCP server.
+
+```typescript
+// Check if resource exists before reading it
+if (await client.servers.github.hasResource("file:///repo/README.md")) {
+  const contents = await client.servers.github.readResource(
+    "file:///repo/README.md",
+  );
+}
+
+// Using with dynamic server names
+const serverName = "github";
+if (await client.servers[serverName].hasResource("file:///repo/README.md")) {
+  const contents = await client.servers[serverName].readResource(
+    "file:///repo/README.md",
+  );
+}
+```
+
 #### `client.getServerHealth(serverName?: string)`
 
 Get health information for one or all servers.
@@ -402,6 +502,9 @@ npm run test:coverage
 ### Linting and Formatting
 
 ```bash
+# Run all checks (format, lint, typecheck, test, build)
+npm run check
+
 # Run linter
 npm run lint
 

package/dist/apiPaths.d.ts

@@ -5,6 +5,11 @@ export declare const API_PATHS: {
     readonly SERVERS: "/api/v1/servers";
     readonly SERVER_TOOLS: (serverName: string) => string;
     readonly TOOL_CALL: (serverName: string, toolName: string) => string;
+    readonly SERVER_PROMPTS: (serverName: string, cursor?: string) => string;
+    readonly PROMPT_GET_GENERATED: (serverName: string, promptName: string) => string;
+    readonly SERVER_RESOURCES: (serverName: string, cursor?: string) => string;
+    readonly SERVER_RESOURCE_TEMPLATES: (serverName: string, cursor?: string) => string;
+    readonly RESOURCE_CONTENT: (serverName: string, uri: string) => string;
     readonly HEALTH_ALL: "/api/v1/health/servers";
     readonly HEALTH_SERVER: (serverName: string) => string;
 };

package/dist/apiPaths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apiPaths.d.ts","sourceRoot":"","sources":["../src/apiPaths.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,eAAO,MAAM,SAAS;;wCAKO,MAAM;qCAET,MAAM,YAAY,MAAM;;yCAKpB,MAAM;CAE1B,CAAC"}
+{"version":3,"file":"apiPaths.d.ts","sourceRoot":"","sources":["../src/apiPaths.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,eAAO,MAAM,SAAS;;wCAKO,MAAM;qCAET,MAAM,YAAY,MAAM;0CAInB,MAAM,WAAW,MAAM;gDAIjB,MAAM,cAAc,MAAM;4CAI9B,MAAM,WAAW,MAAM;qDAId,MAAM,WAAW,MAAM;4CAIhC,MAAM,OAAO,MAAM;;yCAKtB,MAAM;CAE1B,CAAC"}

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { McpdClientOptions, ServerHealth, Tool } from './types';
+import { McpdClientOptions, ServerHealth } from './types';
 import { ServersNamespace } from './dynamicCaller';
 import { AgentFunction } from './functionBuilder';
 /**
@@ -57,51 +57,6 @@ export declare class McpdClient {
      * ```
      */
     listServers(): Promise<string[]>;
-    /**
-     * Get tool schemas from all (or specific) MCP servers with transformed names.
-     *
-     * IMPORTANT: Tool names are transformed to `serverName__toolName` format to:
-     * 1. Prevent naming clashes when aggregating tools from multiple servers
-     * 2. Identify which server each tool belongs to
-     *
-     * This method automatically filters out unhealthy servers by checking their health
-     * status before fetching tools. Unhealthy servers are silently skipped to ensure
-     * the method returns quickly without waiting for timeouts on failed servers.
-     *
-     * Tool fetches from multiple servers are executed concurrently for optimal performance.
-     *
-     * This is useful for:
-     * - MCP servers that aggregate and re-expose tools from multiple upstream servers
-     * - Tool inspection and discovery across all servers
-     * - Custom tooling that needs raw MCP tool schemas
-     *
-     * @param options - Optional configuration
-     * @param options.servers - Array of server names to include. If not specified, includes all servers.
-     * @returns Array of tool schemas with transformed names (serverName__toolName). Only includes tools from healthy servers.
-     * @throws {ConnectionError} If unable to connect to the mcpd daemon
-     * @throws {TimeoutError} If requests to the daemon time out
-     * @throws {AuthenticationError} If API key authentication fails
-     * @throws {McpdError} If health check or initial server listing fails
-     *
-     * @example
-     * ```typescript
-     * // Get all tools from all servers
-     * const allTools = await client.getToolSchemas();
-     * // Returns: [
-     * //   { name: "time__get_current_time", description: "...", ... },
-     * //   { name: "fetch__fetch_url", description: "...", ... }
-     * // ]
-     *
-     * // Get tools from specific servers only
-     * const someTools = await client.getToolSchemas({ servers: ['time', 'fetch'] });
-     *
-     * // Original tool name "get_current_time" becomes "time__get_current_time"
-     * // This prevents clashes if multiple servers have tools with the same name
-     * ```
-     */
-    getToolSchemas(options?: {
-        servers?: string[];
-    }): Promise<Tool[]>;
     /**
      * Get health information for one or all servers.
      *

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,OAAO,EAEL,iBAAiB,EACjB,YAAY,EACZ,IAAI,EAKL,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,UAAU;;IAYrB;;OAEG;IACH,SAAgB,OAAO,EAAE,gBAAgB,CAAC;IAE1C;;;;OAIG;gBACS,OAAO,EAAE,iBAAiB;IAgJtC;;;;;;;;;;;OAWG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAItC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IA2EvE;;;;;;;;;;;;;;;;;;OAkBG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxD,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAoDhE;;;;;;;;;;;;OAYG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiG3D;;;OAGG;IACH,oBAAoB,IAAI,IAAI;IAI5B;;;OAGG;IACH,sBAAsB,IAAI,IAAI;IAI9B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA2C9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4CG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE;QAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IACtB,aAAa,CAAC,OAAO,EAAE;QAC3B,MAAM,EAAE,QAAQ,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACpC,aAAa,CAAC,OAAO,EAAE;QAC3B,MAAM,EAAE,KAAK,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAwBxC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,OAAO,EAEL,iBAAiB,EACjB,YAAY,EAeb,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AASxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,UAAU;;IAYrB;;OAEG;IACH,SAAgB,OAAO,EAAE,gBAAgB,CAAC;IAE1C;;;;OAIG;gBACS,OAAO,EAAE,iBAAiB;IAkJtC;;;;;;;;;;;OAWG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAmNtC;;;;;;;;;;;;;;;;;;OAkBG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxD,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAoDhE;;;;;;;;;;;;OAYG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqH3D;;;OAGG;IACH,oBAAoB,IAAI,IAAI;IAI5B;;;OAGG;IACH,sBAAsB,IAAI,IAAI;IAI9B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA6B9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4CG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE;QAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IACtB,aAAa,CAAC,OAAO,EAAE;QAC3B,MAAM,EAAE,QAAQ,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACpC,aAAa,CAAC,OAAO,EAAE;QAC3B,MAAM,EAAE,KAAK,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAwBxC"}

package/dist/dynamicCaller.d.ts

@@ -1,4 +1,4 @@
-import { Tool, PerformCallFn, GetToolsFn } from './types';
+import { Tool, Prompt, Resource, ResourceTemplate, ResourceContent, GeneratePromptResponseBody, PerformCallFn, GetToolsFn, GetPromptsFn, GeneratePromptFn, GetResourcesFn, GetResourceTemplatesFn, ReadResourceFn } from './types';
 /**
  * Namespace for accessing MCP servers via proxy.
  *
@@ -24,10 +24,24 @@ export declare class ServersNamespace {
     /**
      * Initialize the ServersNamespace with injected functions.
      *
-     * @param performCall - Function to execute tool calls
-     * @param getTools - Function to get tool schemas
+     * @param options - Configuration object
+     * @param options.performCall - Function to execute tool calls
+     * @param options.getTools - Function to get tool schemas
+     * @param options.generatePrompt - Function to generate prompts
+     * @param options.getPrompts - Function to get prompt schemas
+     * @param options.getResources - Function to get resources
+     * @param options.getResourceTemplates - Function to get resource templates
+     * @param options.readResource - Function to read resource content
      */
-    constructor(performCall: PerformCallFn, getTools: GetToolsFn);
+    constructor({ performCall, getTools, generatePrompt, getPrompts, getResources, getResourceTemplates, readResource, }: {
+        performCall: PerformCallFn;
+        getTools: GetToolsFn;
+        generatePrompt: GeneratePromptFn;
+        getPrompts: GetPromptsFn;
+        getResources: GetResourcesFn;
+        getResourceTemplates: GetResourceTemplatesFn;
+        readResource: ReadResourceFn;
+    });
 }
 /**
  * Represents a specific MCP server, providing access to its tools and operations.
@@ -41,7 +55,7 @@ export declare class ServersNamespace {
  * const timeServer = client.servers.time; // Returns Server(...)
  *
  * // List available tools
- * const tools = await timeServer.listTools();
+ * const tools = await timeServer.getTools();
  *
  * // Call tools through the .tools namespace:
  * await timeServer.tools.get_current_time({ timezone: "UTC" })
@@ -50,16 +64,22 @@ export declare class ServersNamespace {
 export declare class Server {
     #private;
     readonly tools: ToolsNamespace;
+    readonly prompts: PromptsNamespace;
     /**
      * Initialize a Server for a specific server.
      *
      * @param performCall - Function to execute tool calls
      * @param getTools - Function to get tool schemas
+     * @param generatePrompt - Function to generate prompts
+     * @param getPrompts - Function to get prompt schemas
+     * @param getResources - Function to get resources
+     * @param getResourceTemplates - Function to get resource templates
+     * @param readResource - Function to read resource content
      * @param serverName - The name of the MCP server
      */
-    constructor(performCall: PerformCallFn, getTools: GetToolsFn, serverName: string);
+    constructor(performCall: PerformCallFn, getTools: GetToolsFn, generatePrompt: GeneratePromptFn, getPrompts: GetPromptsFn, getResources: GetResourcesFn, getResourceTemplates: GetResourceTemplatesFn, readResource: ReadResourceFn, serverName: string);
     /**
-     * List all tools available on this server.
+     * Get all tools available on this server.
      *
      * @returns Array of tool schemas
      * @throws {ServerNotFoundError} If the server doesn't exist
@@ -67,20 +87,25 @@ export declare class Server {
      *
      * @example
      * ```typescript
-     * const tools = await client.servers.time.listTools();
+     * const tools = await client.servers.time.getTools();
      * for (const tool of tools) {
      *   console.log(`${tool.name}: ${tool.description}`);
      * }
      * ```
      */
-    listTools(): Promise<Tool[]>;
+    getTools(): Promise<Tool[]>;
     /**
      * Check if a tool exists on this server.
      *
      * The tool name must match exactly as returned by the server.
      *
+     * This method is designed as a safe boolean predicate - it catches all errors
+     * (ServerNotFoundError, ServerUnhealthyError, ConnectionError, etc.) and returns
+     * false rather than throwing. This makes it safe to use in conditional checks
+     * without requiring error handling.
+     *
      * @param toolName - The exact name of the tool to check
-     * @returns True if the tool exists, false otherwise
+     * @returns True if the tool exists, false otherwise (including on errors)
      *
      * @example
      * ```typescript
@@ -113,6 +138,152 @@ export declare class Server {
      * ```
      */
     callTool(toolName: string, args?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Get all prompts available on this server.
+     *
+     * Note: This method is marked `async` for consistency with other server methods,
+     * even though it doesn't directly await. This maintains a uniform async interface
+     * and allows for future enhancements without breaking the API contract.
+     *
+     * @returns Array of prompt schemas
+     * @throws {ServerNotFoundError} If the server doesn't exist
+     * @throws {ServerUnhealthyError} If the server is unhealthy
+     *
+     * @example
+     * ```typescript
+     * const prompts = await client.servers.github.getPrompts();
+     * for (const prompt of prompts) {
+     *   console.log(`${prompt.name}: ${prompt.description}`);
+     * }
+     * ```
+     */
+    getPrompts(): Promise<Prompt[]>;
+    /**
+     * Check if a prompt exists on this server.
+     *
+     * The prompt name must match exactly as returned by the server.
+     *
+     * This method is designed as a safe boolean predicate - it catches all errors
+     * (ServerNotFoundError, ServerUnhealthyError, ConnectionError, etc.) and returns
+     * false rather than throwing. This makes it safe to use in conditional checks
+     * without requiring error handling.
+     *
+     * @param promptName - The exact name of the prompt to check
+     * @returns True if the prompt exists, false otherwise (including on errors)
+     *
+     * @example
+     * ```typescript
+     * if (await client.servers.github.hasPrompt('create_pr')) {
+     *   const result = await client.servers.github.generatePrompt('create_pr', { title: 'Fix bug' });
+     * }
+     * ```
+     */
+    hasPrompt(promptName: string): Promise<boolean>;
+    /**
+     * Generate a prompt by name with the given arguments.
+     *
+     * This method is useful for programmatic prompt generation when the prompt name
+     * is in a variable. The prompt name must match exactly as returned by the server.
+     *
+     * @param promptName - The exact name of the prompt to generate
+     * @param args - The arguments to pass to the prompt template
+     * @returns The generated prompt response
+     * @throws {ToolNotFoundError} If the prompt doesn't exist on the server
+     *
+     * @example
+     * ```typescript
+     * // Call with explicit method (useful for dynamic prompt names):
+     * const promptName = 'create_pr';
+     * await client.servers.github.generatePrompt(promptName, { title: 'Fix bug' });
+     *
+     * // Or with dynamic server name:
+     * const serverName = 'github';
+     * await client.servers[serverName].generatePrompt(promptName, { title: 'Fix bug' });
+     * ```
+     */
+    generatePrompt(promptName: string, args?: Record<string, string>): Promise<GeneratePromptResponseBody>;
+    /**
+     * Get all resources available on this server.
+     *
+     * Note: This method is marked `async` for consistency with other server methods,
+     * even though it doesn't directly await. This maintains a uniform async interface
+     * and allows for future enhancements without breaking the API contract.
+     *
+     * @returns Array of resource schemas with original names
+     * @throws {ServerNotFoundError} If the server doesn't exist
+     * @throws {ServerUnhealthyError} If the server is unhealthy
+     *
+     * @example
+     * ```typescript
+     * const resources = await client.servers.github.getResources();
+     * for (const resource of resources) {
+     *   console.log(`${resource.name}: ${resource.uri}`);
+     * }
+     * ```
+     */
+    getResources(): Promise<Resource[]>;
+    /**
+     * Get all resource templates available on this server.
+     *
+     * Note: This method is marked `async` for consistency with other server methods,
+     * even though it doesn't directly await. This maintains a uniform async interface
+     * and allows for future enhancements without breaking the API contract.
+     *
+     * @returns Array of resource template schemas with original names
+     * @throws {ServerNotFoundError} If the server doesn't exist
+     * @throws {ServerUnhealthyError} If the server is unhealthy
+     *
+     * @example
+     * ```typescript
+     * const templates = await client.servers.github.getResourceTemplates();
+     * for (const template of templates) {
+     *   console.log(`${template.name}: ${template.uriTemplate}`);
+     * }
+     * ```
+     */
+    getResourceTemplates(): Promise<ResourceTemplate[]>;
+    /**
+     * Check if a resource exists on this server.
+     *
+     * The resource URI must match exactly as returned by the server.
+     *
+     * This method is designed as a safe boolean predicate - it catches all errors
+     * (ServerNotFoundError, ServerUnhealthyError, ConnectionError, etc.) and returns
+     * false rather than throwing. This makes it safe to use in conditional checks
+     * without requiring error handling.
+     *
+     * @param uri - The exact URI of the resource to check
+     * @returns True if the resource exists, false otherwise (including on errors)
+     *
+     * @example
+     * ```typescript
+     * if (await client.servers.github.hasResource('file:///repo/README.md')) {
+     *   const content = await client.servers.github.readResource('file:///repo/README.md');
+     * }
+     * ```
+     */
+    hasResource(uri: string): Promise<boolean>;
+    /**
+     * Read resource content by URI from this server.
+     *
+     * @param uri - The resource URI
+     * @returns Array of resource contents (text or blob)
+     * @throws {ServerNotFoundError} If the server doesn't exist
+     * @throws {ServerUnhealthyError} If the server is unhealthy
+     *
+     * @example
+     * ```typescript
+     * const contents = await client.servers.github.readResource('file:///repo/README.md');
+     * for (const content of contents) {
+     *   if (content.text) {
+     *     console.log(content.text);
+     *   } else if (content.blob) {
+     *     console.log('Binary content:', content.blob.substring(0, 50) + '...');
+     *   }
+     * }
+     * ```
+     */
+    readResource(uri: string): Promise<ResourceContent[]>;
 }
 /**
  * Namespace for accessing tools on a specific MCP server via proxy.
@@ -143,4 +314,36 @@ export declare class ToolsNamespace {
      */
     constructor(performCall: PerformCallFn, getTools: GetToolsFn, serverName: string);
 }
+/**
+ * Namespace for accessing prompts on a specific MCP server via proxy.
+ *
+ * This class provides the `.prompts` namespace for a server, allowing you to generate
+ * prompts as if they were methods. All prompt names must match exactly as returned
+ * by the MCP server.
+ *
+ * NOTE: Use `client.servers.foo.generatePrompt()` and `client.servers.foo.hasPrompt()`
+ * instead of putting them in the `.prompts` namespace to avoid collisions with
+ * actual prompts named "generatePrompt" or "hasPrompt".
+ *
+ * @example
+ * ```typescript
+ * // Generate prompts via .prompts namespace with static names
+ * const result = await client.servers.github.prompts.create_pr({
+ *   title: "Fix bug",
+ *   description: "Fixed auth issue"
+ * });
+ * ```
+ */
+export declare class PromptsNamespace {
+    #private;
+    [promptName: string]: (args?: Record<string, string>) => Promise<GeneratePromptResponseBody>;
+    /**
+     * Initialize a PromptsNamespace for a specific server.
+     *
+     * @param generatePrompt - Function to generate prompts
+     * @param getPrompts - Function to get prompt schemas
+     * @param serverName - The name of the MCP server
+     */
+    constructor(generatePrompt: GeneratePromptFn, getPrompts: GetPromptsFn, serverName: string);
+}
 //# sourceMappingURL=dynamicCaller.d.ts.map

package/dist/dynamicCaller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamicCaller.d.ts","sourceRoot":"","sources":["../src/dynamicCaller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAgB;;IAC3B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAK7B;;;;;OAKG;gBACS,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU;CAc7D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,MAAM;;IACjB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAM/B;;;;;;OAMG;gBAED,WAAW,EAAE,aAAa,EAC1B,QAAQ,EAAE,UAAU,EACpB,UAAU,EAAE,MAAM;IAcpB;;;;;;;;;;;;;;OAcG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAIlC;;;;;;;;;;;;;;OAcG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASjD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,OAAO,CAAC;CAiBpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAc;;IACzB,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAMzE;;;;;;OAMG;gBAED,WAAW,EAAE,aAAa,EAC1B,QAAQ,EAAE,UAAU,EACpB,UAAU,EAAE,MAAM;CAoCrB"}
+{"version":3,"file":"dynamicCaller.d.ts","sourceRoot":"","sources":["../src/dynamicCaller.ts"],"names":[],"mappings":"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"}