@mongodb-js/mcp-tools-assistant 3.0.0-prerelease.1

package/dist/assistantTool.d.ts

@@ -0,0 +1,24 @@
+import { ToolBase } from "@mongodb-js/mcp-core";
+import type { ToolConstructorParams } from "@mongodb-js/mcp-core";
+import type { TelemetryToolMetadata, IToolConfig, ToolCategory, ISession } from "@mongodb-js/mcp-types";
+export declare const DEFAULT_ASSISTANT_BASE_URL = "https://knowledge.mongodb.com/api/v1/";
+export interface IAssistantConfig extends IToolConfig {
+    assistantBaseUrl?: string;
+    serverVersion?: string;
+}
+export interface IAssistantSession extends ISession {
+    config: IAssistantConfig;
+}
+export declare abstract class AssistantToolBase extends ToolBase<IAssistantSession> {
+    static category: ToolCategory;
+    protected baseUrl: URL;
+    protected requiredHeaders: Headers;
+    constructor(params: ToolConstructorParams<IAssistantSession>);
+    protected resolveTelemetryMetadata(): TelemetryToolMetadata;
+    protected callAssistantApi(args: {
+        method: "GET" | "POST";
+        endpoint: string;
+        body?: unknown;
+    }): Promise<Response>;
+}
+//# sourceMappingURL=assistantTool.d.ts.map

package/dist/assistantTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistantTool.d.ts","sourceRoot":"","sources":["../src/assistantTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGxG,eAAO,MAAM,0BAA0B,0CAA0C,CAAC;AAElF,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAkB,SAAQ,QAAQ;IAC/C,MAAM,EAAE,gBAAgB,CAAC;CAC5B;AAED,8BAAsB,iBAAkB,SAAQ,QAAQ,CAAC,iBAAiB,CAAC;IACvE,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAe;IAE5C,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC;IACvB,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC;gBAEvB,MAAM,EAAE,qBAAqB,CAAC,iBAAiB,CAAC;IAW5D,SAAS,CAAC,wBAAwB,IAAI,qBAAqB;cAM3C,gBAAgB,CAAC,IAAI,EAAE;QACnC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,OAAO,CAAC;KAClB,GAAG,OAAO,CAAC,QAAQ,CAAC;CAiBxB"}

package/dist/assistantTool.js

@@ -0,0 +1,37 @@
+import { ToolBase } from "@mongodb-js/mcp-core";
+import { getSharedProxyFetch } from "@mongodb-js/mcp-fetch";
+export const DEFAULT_ASSISTANT_BASE_URL = "https://knowledge.mongodb.com/api/v1/";
+export class AssistantToolBase extends ToolBase {
+    constructor(params) {
+        super(params);
+        this.baseUrl = new URL(params.session.config.assistantBaseUrl ?? DEFAULT_ASSISTANT_BASE_URL);
+        this.requiredHeaders = new Headers({
+            "x-request-origin": "mongodb-mcp-server",
+            "user-agent": params.session.config.serverVersion
+                ? `mongodb-mcp-server/v${params.session.config.serverVersion}`
+                : "mongodb-mcp-server",
+        });
+    }
+    resolveTelemetryMetadata() {
+        // Assistant tool calls are not associated with a specific Atlas project or organization
+        // Therefore, we don't have any values to add to the telemetry metadata
+        return {};
+    }
+    async callAssistantApi(args) {
+        const endpointUrl = new URL(args.endpoint, this.baseUrl);
+        const headers = new Headers(this.requiredHeaders);
+        if (args.method === "POST") {
+            headers.set("Content-Type", "application/json");
+        }
+        // Same shared, memoized fetch as the Atlas API client (proxy support
+        // without reloading the system CA per call).
+        const customFetch = getSharedProxyFetch();
+        return await customFetch(endpointUrl, {
+            method: args.method,
+            headers,
+            body: JSON.stringify(args.body),
+        });
+    }
+}
+AssistantToolBase.category = "assistant";
+//# sourceMappingURL=assistantTool.js.map

package/dist/assistantTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistantTool.js","sourceRoot":"","sources":["../src/assistantTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,CAAC,MAAM,0BAA0B,GAAG,uCAAuC,CAAC;AAWlF,MAAM,OAAgB,iBAAkB,SAAQ,QAA2B;IAMvE,YAAY,MAAgD;QACxD,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,IAAI,0BAA0B,CAAC,CAAC;QAC7F,IAAI,CAAC,eAAe,GAAG,IAAI,OAAO,CAAC;YAC/B,kBAAkB,EAAE,oBAAoB;YACxC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa;gBAC7C,CAAC,CAAC,uBAAuB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE;gBAC9D,CAAC,CAAC,oBAAoB;SAC7B,CAAC,CAAC;IACP,CAAC;IAES,wBAAwB;QAC9B,wFAAwF;QACxF,uEAAuE;QACvE,OAAO,EAAE,CAAC;IACd,CAAC;IAES,KAAK,CAAC,gBAAgB,CAAC,IAIhC;QACG,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAClD,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QACpD,CAAC;QAED,qEAAqE;QACrE,6CAA6C;QAC7C,MAAM,WAAW,GAAG,mBAAmB,EAAE,CAAC;QAE1C,OAAO,MAAM,WAAW,CAAC,WAAW,EAAE;YAClC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC;IACP,CAAC;;AA1CM,0BAAQ,GAAiB,WAAW,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { AssistantToolBase, type IAssistantSession } from "./assistantTool.js";
+export { SearchKnowledgeTool, SearchKnowledgeToolName, ListKnowledgeSourcesTool, ListKnowledgeSourcesToolName, } from "./tools/tools.js";
+import type { IAssistantSession } from "./assistantTool.js";
+import type { ToolClass } from "@mongodb-js/mcp-core";
+export declare const AssistantTools: ToolClass<IAssistantSession>[];
+//# 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":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EACH,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,GAC/B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,eAAO,MAAM,cAAc,EAAE,SAAS,CAAC,iBAAiB,CAAC,EAAoD,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { AssistantToolBase } from "./assistantTool.js";
+export { SearchKnowledgeTool, SearchKnowledgeToolName, ListKnowledgeSourcesTool, ListKnowledgeSourcesToolName, } from "./tools/tools.js";
+import { SearchKnowledgeTool, ListKnowledgeSourcesTool } from "./tools/tools.js";
+export const AssistantTools = [SearchKnowledgeTool, ListKnowledgeSourcesTool];
+//# 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,OAAO,EAAE,iBAAiB,EAA0B,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EACH,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,GAC/B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAGjF,MAAM,CAAC,MAAM,cAAc,GAAmC,CAAC,mBAAmB,EAAE,wBAAwB,CAAC,CAAC"}

package/dist/tools/read/listKnowledgeSources.d.ts

@@ -0,0 +1,29 @@
+import type { CallToolResult } from "@mongodb-js/mcp-types";
+import type { OperationType, ToolCategory } from "@mongodb-js/mcp-types";
+import { AssistantToolBase } from "../../assistantTool.js";
+export type KnowledgeSource = {
+    /** The name of the data source */
+    id: string;
+    /** The type of the data source */
+    type: string;
+    /** A list of available versions for this data source */
+    versions: {
+        /** The version label of the data source */
+        label: string;
+        /** Whether this version is the current/default version */
+        isCurrent: boolean;
+    }[];
+};
+export type ListKnowledgeSourcesResponse = {
+    dataSources: KnowledgeSource[];
+};
+export declare const ListKnowledgeSourcesToolName = "list-knowledge-sources";
+export declare class ListKnowledgeSourcesTool extends AssistantToolBase {
+    static toolName: string;
+    static category: ToolCategory;
+    static operationType: OperationType;
+    description: string;
+    argsShape: {};
+    protected execute(): Promise<CallToolResult>;
+}
+//# sourceMappingURL=listKnowledgeSources.d.ts.map

package/dist/tools/read/listKnowledgeSources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listKnowledgeSources.d.ts","sourceRoot":"","sources":["../../../src/tools/read/listKnowledgeSources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,MAAM,MAAM,eAAe,GAAG;IAC1B,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,QAAQ,EAAE;QACN,2CAA2C;QAC3C,KAAK,EAAE,MAAM,CAAC;QACd,0DAA0D;QAC1D,SAAS,EAAE,OAAO,CAAC;KACtB,EAAE,CAAC;CACP,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACvC,WAAW,EAAE,eAAe,EAAE,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,4BAA4B,2BAA2B,CAAC;AAErE,qBAAa,wBAAyB,SAAQ,iBAAiB;IAC3D,MAAM,CAAC,QAAQ,SAAgC;IAC/C,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAe;IAC5C,MAAM,CAAC,aAAa,EAAE,aAAa,CAAU;IACtC,WAAW,SAAqL;IAChM,SAAS,KAAM;cAEN,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC;CAsCrD"}

package/dist/tools/read/listKnowledgeSources.js

@@ -0,0 +1,47 @@
+import { formatUntrustedData } from "@mongodb-js/mcp-core";
+import { LogId } from "@mongodb-js/mcp-core";
+import { AssistantToolBase } from "../../assistantTool.js";
+import { stringify as yamlStringify } from "yaml";
+export const ListKnowledgeSourcesToolName = "list-knowledge-sources";
+export class ListKnowledgeSourcesTool extends AssistantToolBase {
+    constructor() {
+        super(...arguments);
+        this.description = `List available data sources in the MongoDB Assistant knowledge base. Use this to explore available data sources or to find search filter parameters to use in search-knowledge.`;
+        this.argsShape = {};
+    }
+    async execute() {
+        const response = await this.callAssistantApi({
+            method: "GET",
+            endpoint: "content/sources",
+        });
+        if (!response.ok) {
+            const message = `Failed to list knowledge sources: ${response.statusText}`;
+            this.session.logger.debug({
+                id: LogId.assistantListKnowledgeSourcesError,
+                context: "assistant-list-knowledge-sources",
+                message,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: message,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const { dataSources } = (await response.json());
+        const text = yamlStringify(dataSources.map((ds) => {
+            const currentVersion = ds.versions.find(({ isCurrent }) => isCurrent)?.label;
+            return currentVersion ? { ...ds, currentVersion } : ds;
+        }));
+        return {
+            content: formatUntrustedData(`Found ${dataSources.length} data sources in the MongoDB Assistant knowledge base.`, text),
+        };
+    }
+}
+ListKnowledgeSourcesTool.toolName = ListKnowledgeSourcesToolName;
+ListKnowledgeSourcesTool.category = "assistant";
+ListKnowledgeSourcesTool.operationType = "read";
+//# sourceMappingURL=listKnowledgeSources.js.map

package/dist/tools/read/listKnowledgeSources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listKnowledgeSources.js","sourceRoot":"","sources":["../../../src/tools/read/listKnowledgeSources.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAoBlD,MAAM,CAAC,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AAErE,MAAM,OAAO,wBAAyB,SAAQ,iBAAiB;IAA/D;;QAIW,gBAAW,GAAG,iLAAiL,CAAC;QAChM,cAAS,GAAG,EAAE,CAAC;IAwC1B,CAAC;IAtCa,KAAK,CAAC,OAAO;QACnB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC;YACzC,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,iBAAiB;SAC9B,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,qCAAqC,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC3E,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;gBACtB,EAAE,EAAE,KAAK,CAAC,kCAAkC;gBAC5C,OAAO,EAAE,kCAAkC;gBAC3C,OAAO;aACV,CAAC,CAAC;YACH,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,OAAO;qBAChB;iBACJ;gBACD,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;QACD,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAiC,CAAC;QAEhF,MAAM,IAAI,GAAG,aAAa,CACtB,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YACnB,MAAM,cAAc,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC;YAC7E,OAAO,cAAc,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,CAAC,CAAC,CACL,CAAC;QAEF,OAAO;YACH,OAAO,EAAE,mBAAmB,CACxB,SAAS,WAAW,CAAC,MAAM,wDAAwD,EACnF,IAAI,CACP;SACJ,CAAC;IACN,CAAC;;AA3CM,iCAAQ,GAAG,4BAA4B,AAA/B,CAAgC;AACxC,iCAAQ,GAAiB,WAAW,AAA5B,CAA6B;AACrC,sCAAa,GAAkB,MAAM,AAAxB,CAAyB"}

package/dist/tools/read/searchKnowledge.d.ts

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import type { CallToolResult } from "@mongodb-js/mcp-types";
+import type { ToolArgs } from "@mongodb-js/mcp-core";
+import type { OperationType, ToolCategory } from "@mongodb-js/mcp-types";
+import { AssistantToolBase } from "../../assistantTool.js";
+export declare const SearchKnowledgeToolArgs: {
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    dataSources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        versionLabel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+};
+export type SearchKnowledgeResponse = {
+    /** A list of search results */
+    results: {
+        /** The URL of the search result */
+        url: string;
+        /** The page title of the search result */
+        title: string;
+        /** The text of the page chunk returned from the search */
+        text: string;
+        /** Metadata for the search result */
+        metadata: {
+            /** A list of tags that describe the page */
+            tags: string[];
+            /** Additional metadata */
+            [key: string]: unknown;
+        };
+    }[];
+};
+export declare const SearchKnowledgeToolName = "search-knowledge";
+export declare class SearchKnowledgeTool extends AssistantToolBase {
+    static toolName: string;
+    static category: ToolCategory;
+    static operationType: OperationType;
+    description: string;
+    argsShape: {
+        query: z.ZodString;
+        limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        dataSources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            versionLabel: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    };
+    protected execute(args: ToolArgs<typeof this.argsShape>): Promise<CallToolResult>;
+}
+//# sourceMappingURL=searchKnowledge.d.ts.map

package/dist/tools/read/searchKnowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchKnowledge.d.ts","sourceRoot":"","sources":["../../../src/tools/read/searchKnowledge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,eAAO,MAAM,uBAAuB;;;;;;;CAkBnC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IAClC,+BAA+B;IAC/B,OAAO,EAAE;QACL,mCAAmC;QACnC,GAAG,EAAE,MAAM,CAAC;QACZ,0CAA0C;QAC1C,KAAK,EAAE,MAAM,CAAC;QACd,0DAA0D;QAC1D,IAAI,EAAE,MAAM,CAAC;QACb,qCAAqC;QACrC,QAAQ,EAAE;YACN,4CAA4C;YAC5C,IAAI,EAAE,MAAM,EAAE,CAAC;YACf,0BAA0B;YAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;SAC1B,CAAC;KACL,EAAE,CAAC;CACP,CAAC;AAEF,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D,qBAAa,mBAAoB,SAAQ,iBAAiB;IACtD,MAAM,CAAC,QAAQ,SAA2B;IAC1C,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAe;IAC5C,MAAM,CAAC,aAAa,EAAE,aAAa,CAAU;IACtC,WAAW,SAC2M;IACtN,SAAS;;;;;;;MAEd;cAEc,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;CAkC1F"}

package/dist/tools/read/searchKnowledge.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { formatUntrustedData } from "@mongodb-js/mcp-core";
+import { LogId } from "@mongodb-js/mcp-core";
+import { AssistantToolBase } from "../../assistantTool.js";
+import { stringify as yamlStringify } from "yaml";
+export const SearchKnowledgeToolArgs = {
+    query: z
+        .string()
+        .describe("A natural language query to search for in the MongoDB Assistant knowledge base. This should be a single question or a topic that is relevant to the user's MongoDB use case."),
+    limit: z.number().min(1).max(100).optional().default(5).describe("The maximum number of results to return"),
+    dataSources: z
+        .array(z.object({
+        name: z.string().describe("The name of the data source"),
+        versionLabel: z.string().optional().describe("The version label of the data source"),
+    }))
+        .optional()
+        .describe(`A list of one or more data sources to limit the search to. You can specify a specific version of a data source by providing the version label. If not provided, the latest version of all data sources will be searched. Available data sources and their versions can be listed by calling the list-knowledge-sources tool.`),
+};
+export const SearchKnowledgeToolName = "search-knowledge";
+export class SearchKnowledgeTool extends AssistantToolBase {
+    constructor() {
+        super(...arguments);
+        this.description = "Search for information in the MongoDB Assistant knowledge base. This includes official documentation, curated expert guidance, and other resources provided by MongoDB. Supports filtering by data source and version.";
+        this.argsShape = {
+            ...SearchKnowledgeToolArgs,
+        };
+    }
+    async execute(args) {
+        const response = await this.callAssistantApi({
+            method: "POST",
+            endpoint: "content/search",
+            body: args,
+        });
+        if (!response.ok) {
+            const message = `Failed to search knowledge base: ${response.statusText}`;
+            this.session.logger.debug({
+                id: LogId.assistantSearchKnowledgeError,
+                context: "assistant-search-knowledge",
+                message,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: message,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const { results } = (await response.json());
+        const text = yamlStringify(results);
+        return {
+            content: formatUntrustedData(`Found ${results.length} results in the MongoDB Assistant knowledge base.`, text),
+        };
+    }
+}
+SearchKnowledgeTool.toolName = SearchKnowledgeToolName;
+SearchKnowledgeTool.category = "assistant";
+SearchKnowledgeTool.operationType = "read";
+//# sourceMappingURL=searchKnowledge.js.map

package/dist/tools/read/searchKnowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchKnowledge.js","sourceRoot":"","sources":["../../../src/tools/read/searchKnowledge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAElD,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACnC,KAAK,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,CACL,8KAA8K,CACjL;IACL,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAC3G,WAAW,EAAE,CAAC;SACT,KAAK,CACF,CAAC,CAAC,MAAM,CAAC;QACL,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QACxD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;KACvF,CAAC,CACL;SACA,QAAQ,EAAE;SACV,QAAQ,CACL,8TAA8T,CACjU;CACR,CAAC;AAqBF,MAAM,CAAC,MAAM,uBAAuB,GAAG,kBAAkB,CAAC;AAE1D,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;IAA1D;;QAIW,gBAAW,GACd,wNAAwN,CAAC;QACtN,cAAS,GAAG;YACf,GAAG,uBAAuB;SAC7B,CAAC;IAoCN,CAAC;IAlCa,KAAK,CAAC,OAAO,CAAC,IAAqC;QACzD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC;YACzC,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,gBAAgB;YAC1B,IAAI,EAAE,IAAI;SACb,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,oCAAoC,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC1E,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;gBACtB,EAAE,EAAE,KAAK,CAAC,6BAA6B;gBACvC,OAAO,EAAE,4BAA4B;gBACrC,OAAO;aACV,CAAC,CAAC;YACH,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,OAAO;qBAChB;iBACJ;gBACD,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;QACD,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA4B,CAAC;QAEvE,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QAEpC,OAAO;YACH,OAAO,EAAE,mBAAmB,CACxB,SAAS,OAAO,CAAC,MAAM,mDAAmD,EAC1E,IAAI,CACP;SACJ,CAAC;IACN,CAAC;;AA1CM,4BAAQ,GAAG,uBAAuB,AAA1B,CAA2B;AACnC,4BAAQ,GAAiB,WAAW,AAA5B,CAA6B;AACrC,iCAAa,GAAkB,MAAM,AAAxB,CAAyB"}

package/dist/tools/tools.d.ts

@@ -0,0 +1,3 @@
+export { SearchKnowledgeTool, SearchKnowledgeToolName } from "./read/searchKnowledge.js";
+export { ListKnowledgeSourcesTool, ListKnowledgeSourcesToolName } from "./read/listKnowledgeSources.js";
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/tools/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/tools/tools.js

@@ -0,0 +1,3 @@
+export { SearchKnowledgeTool, SearchKnowledgeToolName } from "./read/searchKnowledge.js";
+export { ListKnowledgeSourcesTool, ListKnowledgeSourcesToolName } from "./read/listKnowledgeSources.js";
+//# sourceMappingURL=tools.js.map

package/dist/tools/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/tools/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@mongodb-js/mcp-tools-assistant",
+  "version": "3.0.0-prerelease.1",
+  "type": "module",
+  "description": "Assistant tools for the MongoDB MCP server",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc --build tsconfig.build.json",
+    "test": "vitest --run",
+    "check": "tsc --build tsconfig.build.json --noEmit"
+  },
+  "dependencies": {
+    "@mongodb-js/mcp-core": "workspace:*",
+    "@mongodb-js/mcp-fetch": "workspace:*",
+    "yaml": "^2.8.1",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@mongodb-js/mcp-types": "workspace:*",
+    "@types/node": "^25.6.0",
+    "typescript": "^5.9.2",
+    "vitest": "^4.1.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}