langsmith-mcp-server 0.1.1

package/dist/common/helpers.js

@@ -0,0 +1,341 @@
+/**
+ * Helper functions for the LangSmith MCP server.
+ */
+import { Client } from "langsmith";
+/**
+ * Create a LangSmith client from environment variables.
+ *
+ * Reads LANGSMITH_API_KEY (required), LANGSMITH_ENDPOINT (optional),
+ * and LANGSMITH_WORKSPACE_ID (optional) from the environment.
+ *
+ * @returns LangSmith Client instance
+ * @throws Error if LANGSMITH_API_KEY is not set
+ */
+export function getLangSmithClient() {
+    const apiKey = process.env.LANGSMITH_API_KEY;
+    if (!apiKey) {
+        throw new Error("API key not found. Set LANGSMITH_API_KEY environment variable.");
+    }
+    return new Client({
+        apiKey,
+        apiUrl: process.env.LANGSMITH_ENDPOINT || undefined,
+        workspaceId: process.env.LANGSMITH_WORKSPACE_ID || undefined,
+    });
+}
+/**
+ * Get API key and endpoint from environment variables.
+ * Used by tools that call LangSmith REST APIs directly (e.g. billing/usage).
+ *
+ * @returns Tuple of [apiKey, endpoint]. Endpoint is normalized (no trailing slash).
+ * @throws Error if LANGSMITH_API_KEY is not set
+ */
+export function getApiKeyAndEndpoint() {
+    const apiKey = process.env.LANGSMITH_API_KEY;
+    if (!apiKey) {
+        throw new Error("API key not found. Set LANGSMITH_API_KEY environment variable.");
+    }
+    const endpoint = (process.env.LANGSMITH_ENDPOINT || "https://api.smith.langchain.com").replace(/\/+$/, "");
+    return [apiKey, endpoint];
+}
+/**
+ * Extract a LangGraph app host name from run stats.
+ *
+ * @param runStats - The run stats object
+ * @returns The LangGraph app host name, or undefined if not found
+ */
+export function getLanggraphAppHostName(runStats) {
+    if (!runStats || !runStats.run_facets)
+        return undefined;
+    const runFacets = runStats.run_facets;
+    if (!Array.isArray(runFacets))
+        return undefined;
+    for (const runFacet of runFacets) {
+        if (typeof runFacet !== "object" || runFacet === null)
+            continue;
+        try {
+            for (const rfk of Object.keys(runFacet)) {
+                const match = rfk.match(/https?:\/\/(?<langgraphHost>[^/]+)/);
+                if (match?.groups?.langgraphHost) {
+                    return match.groups.langgraphHost;
+                }
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return undefined;
+}
+/**
+ * Parse the as_of parameter, converting ISO timestamps to Date objects
+ * while leaving version tags as strings.
+ *
+ * @param asOf - Dataset version tag OR ISO timestamp string
+ * @returns Date object if asOf is a valid ISO timestamp, otherwise the original string
+ */
+export function parseAsOfParameter(asOf) {
+    try {
+        const date = new Date(asOf);
+        if (!isNaN(date.getTime())) {
+            return date;
+        }
+    }
+    catch {
+        // Not a valid date, return as string (version tag)
+    }
+    return asOf;
+}
+/**
+ * Recursively search for a key in a nested dictionary or list.
+ * Returns the first occurrence found during depth-first traversal.
+ *
+ * @param data - The data structure to search in
+ * @param key - The key to search for
+ * @returns The value associated with the key if found, otherwise undefined
+ */
+export function findInDict(data, key) {
+    if (typeof data === "object" && data !== null && !Array.isArray(data)) {
+        const obj = data;
+        if (key in obj) {
+            return obj[key];
+        }
+        for (const value of Object.values(obj)) {
+            const result = findInDict(value, key);
+            if (result !== undefined) {
+                return result;
+            }
+        }
+    }
+    else if (Array.isArray(data)) {
+        for (const item of data) {
+            const result = findInDict(item, key);
+            if (result !== undefined) {
+                return result;
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Recursively convert Date objects to ISO strings in data structures.
+ * Note: In the JS SDK, UUIDs are already strings, unlike the Python SDK
+ * where they are uuid.UUID objects. This function primarily handles Dates.
+ */
+export function convertToSerializable(obj) {
+    if (obj instanceof Date) {
+        return obj.toISOString();
+    }
+    if (typeof obj === "bigint") {
+        return obj.toString();
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(convertToSerializable);
+    }
+    if (typeof obj === "object" && obj !== null) {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            result[key] = convertToSerializable(value);
+        }
+        return result;
+    }
+    return obj;
+}
+/**
+ * Recursively count the total number of characters in a data structure.
+ */
+export function countCharacters(obj) {
+    if (typeof obj === "string") {
+        return obj.length;
+    }
+    if (typeof obj === "object" && obj !== null && !Array.isArray(obj)) {
+        let count = 0;
+        for (const value of Object.values(obj)) {
+            count += countCharacters(value);
+        }
+        return count;
+    }
+    if (Array.isArray(obj)) {
+        let count = 0;
+        for (const item of obj) {
+            count += countCharacters(item);
+        }
+        return count;
+    }
+    // For other types, convert to string and count
+    return String(obj).length;
+}
+/**
+ * Recursively count the total number of fields/keys in a data structure.
+ */
+export function countFields(obj) {
+    if (typeof obj === "object" && obj !== null && !Array.isArray(obj)) {
+        let count = Object.keys(obj).length;
+        for (const value of Object.values(obj)) {
+            count += countFields(value);
+        }
+        return count;
+    }
+    if (Array.isArray(obj)) {
+        let count = 0;
+        for (const item of obj) {
+            count += countFields(item);
+        }
+        return count;
+    }
+    return 0;
+}
+/**
+ * Filter a run dictionary to only include selected fields.
+ * If select is undefined or empty, returns the full dictionary.
+ */
+export function filterFields(runDict, select) {
+    if (!select || select.length === 0) {
+        return runDict;
+    }
+    const filtered = {};
+    for (const field of select) {
+        if (field in runDict) {
+            filtered[field] = runDict[field];
+        }
+    }
+    return filtered;
+}
+/**
+ * Build a simplified trace tree structure showing top-level fields
+ * with metrics for nested content.
+ *
+ * @param runDict - The dictionary to build a tree from
+ * @param depth - How many levels deep to show actual content before summarizing.
+ *               0 = summarize all nested structures (default)
+ */
+export function buildTraceTree(runDict, depth = 0) {
+    const tree = {};
+    for (const [key, value] of Object.entries(runDict)) {
+        if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+            const dictValue = value;
+            const keys = Object.keys(dictValue);
+            if (keys.length === 0) {
+                tree[key] = {};
+            }
+            else if (depth > 0) {
+                tree[key] = buildTraceTree(dictValue, depth - 1);
+            }
+            else {
+                const fieldCount = countFields(dictValue);
+                if (fieldCount === 0) {
+                    tree[key] = {};
+                }
+                else {
+                    tree[key] = {
+                        _type: "dict",
+                        _field_count: fieldCount,
+                        _character_count: countCharacters(dictValue),
+                        _keys: keys.slice(0, 10),
+                    };
+                }
+            }
+        }
+        else if (Array.isArray(value)) {
+            if (value.length === 0) {
+                tree[key] = [];
+            }
+            else if (depth > 0) {
+                const processedItems = [];
+                for (const item of value) {
+                    if (typeof item === "object" &&
+                        item !== null &&
+                        !Array.isArray(item)) {
+                        processedItems.push(buildTraceTree(item, depth - 1));
+                    }
+                    else if (Array.isArray(item)) {
+                        processedItems.push(item.map((subitem) => typeof subitem === "object" &&
+                            subitem !== null &&
+                            !Array.isArray(subitem)
+                            ? buildTraceTree(subitem, depth - 1)
+                            : subitem));
+                    }
+                    else {
+                        processedItems.push(item);
+                    }
+                }
+                tree[key] = processedItems;
+            }
+            else {
+                const preview = [];
+                for (const item of value.slice(0, 2)) {
+                    if (typeof item === "object" &&
+                        item !== null &&
+                        !Array.isArray(item)) {
+                        preview.push({
+                            _type: "dict",
+                            _keys: Object.keys(item).slice(0, 5),
+                        });
+                    }
+                    else if (Array.isArray(item)) {
+                        preview.push({ _type: "list", _length: item.length });
+                    }
+                    else {
+                        const strVal = String(item);
+                        preview.push(strVal.length > 100 ? strVal.slice(0, 100) : strVal);
+                    }
+                }
+                tree[key] = {
+                    _type: "list",
+                    _length: value.length,
+                    _field_count: countFields(value),
+                    _character_count: countCharacters(value),
+                    _preview: preview,
+                };
+            }
+        }
+        else {
+            tree[key] = value;
+        }
+    }
+    return tree;
+}
+/**
+ * Parse a JSON array string into an array of strings.
+ * If the value starts with "[", parse as JSON array.
+ * Otherwise, wrap in a single-element array.
+ */
+export function parseJsonArray(value) {
+    if (!value)
+        return undefined;
+    if (value.startsWith("[")) {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return [value];
+        }
+    }
+    return [value];
+}
+/**
+ * Parse a JSON object string into a Record.
+ * If the value starts with "{", parse as JSON object.
+ * Otherwise, return undefined.
+ */
+export function parseJsonObject(value) {
+    if (!value)
+        return undefined;
+    if (value.startsWith("{")) {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+}
+/**
+ * Parse a boolean string ("true"/"false") to a boolean value.
+ */
+export function parseBoolString(value) {
+    if (value === undefined)
+        return undefined;
+    return value.toLowerCase() === "true";
+}
+//# sourceMappingURL=helpers.js.map

package/dist/common/helpers.js.map

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

package/dist/common/pagination.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Char-based pagination for LangSmith runs.
+ *
+ * Stateless: each request fetches all runs for the trace (up to a safe bound),
+ * builds pages by character budget, and returns the requested page only.
+ * No cursor, no offset, no server-side state. Optimized for LLM callers (simple integers).
+ */
+/** LangSmith API maximum; do not exceed */
+export declare const MAX_RUNS_PER_TRACE = 100;
+/**
+ * Recursively truncate long strings to previewChars; suffix with "... (+N chars)".
+ */
+export declare function truncateStrings(obj: unknown, previewChars: number): unknown;
+/**
+ * Split runs into pages by character budget (JSON length).
+ * If a single run exceeds the budget, it is returned alone on a page.
+ */
+export declare function buildPagesByCharBudget(runsDict: Record<string, unknown>[], maxCharsPerPage: number): Record<string, unknown>[][];
+/**
+ * Return one page of runs (char-based pagination).
+ *
+ * - Applies previewChars truncation to each run if previewChars > 0.
+ * - Builds pages by accumulating JSON length up to maxCharsPerPage.
+ * - pageNumber is 1-based. Out-of-range returns empty runs.
+ * - Ensures the returned page JSON never exceeds maxCharsPerPage.
+ *
+ * @returns Dict with keys: runs, page_number, total_pages, max_chars_per_page, preview_chars.
+ *          May include _truncated, _truncated_message, _truncated_preview if content was cut.
+ */
+export declare function paginateRuns(runsDict: Record<string, unknown>[], pageNumber: number, maxCharsPerPage: number, previewChars?: number): Record<string, unknown>;
+/**
+ * Return one page of messages (char-based pagination), same semantics as paginateRuns.
+ * Uses "result" as the key for the message list.
+ */
+export declare function paginateMessages(messagesDict: Record<string, unknown>[], pageNumber: number, maxCharsPerPage: number, previewChars?: number): Record<string, unknown>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/common/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/common/pagination.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,2CAA2C;AAC3C,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CA0B3E;AAwGD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACnC,eAAe,EAAE,MAAM,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,CAyB7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACnC,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,YAAY,GAAE,MAAU,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BzB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACvC,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,YAAY,GAAE,MAAU,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BzB"}

package/dist/common/pagination.js

@@ -0,0 +1,187 @@
+/**
+ * Char-based pagination for LangSmith runs.
+ *
+ * Stateless: each request fetches all runs for the trace (up to a safe bound),
+ * builds pages by character budget, and returns the requested page only.
+ * No cursor, no offset, no server-side state. Optimized for LLM callers (simple integers).
+ */
+/** LangSmith API maximum; do not exceed */
+export const MAX_RUNS_PER_TRACE = 100;
+/**
+ * Recursively truncate long strings to previewChars; suffix with "... (+N chars)".
+ */
+export function truncateStrings(obj, previewChars) {
+    if (previewChars <= 0) {
+        return obj;
+    }
+    if (typeof obj === "string") {
+        if (obj.length <= previewChars) {
+            return obj;
+        }
+        return (obj.slice(0, previewChars) +
+            "\u2026 (+" +
+            (obj.length - previewChars) +
+            " chars)");
+    }
+    if (typeof obj === "object" && obj !== null && !Array.isArray(obj)) {
+        const result = {};
+        for (const [k, v] of Object.entries(obj)) {
+            result[k] = truncateStrings(v, previewChars);
+        }
+        return result;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => truncateStrings(item, previewChars));
+    }
+    return obj;
+}
+/**
+ * Character count of JSON-serialized run (for budget).
+ */
+function runCharCount(runDict) {
+    return JSON.stringify(runDict, (_key, value) => typeof value === "bigint" ? value.toString() : value).length;
+}
+/**
+ * Character count of the full page JSON. Use indent=0 for compact (budget-friendly).
+ */
+function pageOutputSize(pageDict, indent = 0) {
+    return JSON.stringify(pageDict, (_key, value) => (typeof value === "bigint" ? value.toString() : value), indent || undefined).length;
+}
+/**
+ * If the page JSON exceeds maxCharsPerPage, truncate long strings inside
+ * pageDict[itemsKey] until the serialized output fits.
+ * If still over budget, return a dict with itemsKey=[] and _truncated_preview.
+ */
+function enforcePageCharBudget(pageDict, maxCharsPerPage, options = {}) {
+    const { indent = 0, itemsKey = "runs" } = options;
+    if (pageOutputSize(pageDict, indent) <= maxCharsPerPage) {
+        return pageDict;
+    }
+    const items = pageDict[itemsKey];
+    if (!items || items.length === 0) {
+        return pageDict;
+    }
+    let low = 0;
+    let high = 100_000;
+    let bestPageDict = pageDict;
+    while (low <= high) {
+        const mid = Math.floor((low + high) / 2);
+        const truncatedItems = items.map((it) => truncateStrings(it, mid));
+        const testDict = { ...pageDict, [itemsKey]: truncatedItems };
+        const size = pageOutputSize(testDict, indent);
+        if (size <= maxCharsPerPage) {
+            bestPageDict = testDict;
+            low = mid + 1;
+        }
+        else {
+            high = mid - 1;
+        }
+    }
+    const bestSize = pageOutputSize(bestPageDict, indent);
+    if (bestSize > maxCharsPerPage) {
+        const jsonStr = JSON.stringify(bestPageDict, (_key, value) => (typeof value === "bigint" ? value.toString() : value), indent || undefined);
+        const suffix = "\n\u2026 (output truncated, exceeded max_chars_per_page)";
+        const overhead = 1000;
+        const safePreviewLen = (maxCharsPerPage - suffix.length - overhead) / 2;
+        const previewMax = Math.max(100, safePreviewLen);
+        const truncatedPreview = jsonStr.slice(0, previewMax) + suffix;
+        return {
+            ...Object.fromEntries(Object.entries(pageDict).filter(([k]) => k !== itemsKey)),
+            [itemsKey]: [],
+            page_number: pageDict.page_number,
+            total_pages: pageDict.total_pages,
+            max_chars_per_page: maxCharsPerPage,
+            preview_chars: pageDict.preview_chars ?? 0,
+            _truncated: true,
+            _truncated_message: "Page exceeded character budget; content truncated.",
+            _truncated_preview: truncatedPreview,
+        };
+    }
+    return bestPageDict;
+}
+/**
+ * Split runs into pages by character budget (JSON length).
+ * If a single run exceeds the budget, it is returned alone on a page.
+ */
+export function buildPagesByCharBudget(runsDict, maxCharsPerPage) {
+    if (runsDict.length === 0) {
+        return [];
+    }
+    const pages = [];
+    let currentPage = [];
+    let currentChars = 0;
+    for (const run of runsDict) {
+        const runChars = runCharCount(run);
+        if (currentChars + runChars > maxCharsPerPage && currentPage.length > 0) {
+            pages.push(currentPage);
+            currentPage = [];
+            currentChars = 0;
+        }
+        currentPage.push(run);
+        currentChars += runChars;
+    }
+    if (currentPage.length > 0) {
+        pages.push(currentPage);
+    }
+    return pages;
+}
+/**
+ * Return one page of runs (char-based pagination).
+ *
+ * - Applies previewChars truncation to each run if previewChars > 0.
+ * - Builds pages by accumulating JSON length up to maxCharsPerPage.
+ * - pageNumber is 1-based. Out-of-range returns empty runs.
+ * - Ensures the returned page JSON never exceeds maxCharsPerPage.
+ *
+ * @returns Dict with keys: runs, page_number, total_pages, max_chars_per_page, preview_chars.
+ *          May include _truncated, _truncated_message, _truncated_preview if content was cut.
+ */
+export function paginateRuns(runsDict, pageNumber, maxCharsPerPage, previewChars = 0) {
+    if (previewChars > 0) {
+        runsDict = runsDict.map((r) => truncateStrings(r, previewChars));
+    }
+    const pages = buildPagesByCharBudget(runsDict, maxCharsPerPage);
+    const totalPages = pages.length;
+    let pageRuns;
+    if (pageNumber < 1 || pageNumber > totalPages) {
+        pageRuns = [];
+    }
+    else {
+        pageRuns = pages[pageNumber - 1];
+    }
+    const out = {
+        runs: pageRuns,
+        page_number: pageNumber,
+        total_pages: totalPages,
+        max_chars_per_page: maxCharsPerPage,
+        preview_chars: previewChars,
+    };
+    return enforcePageCharBudget(out, maxCharsPerPage);
+}
+/**
+ * Return one page of messages (char-based pagination), same semantics as paginateRuns.
+ * Uses "result" as the key for the message list.
+ */
+export function paginateMessages(messagesDict, pageNumber, maxCharsPerPage, previewChars = 0) {
+    if (previewChars > 0) {
+        messagesDict = messagesDict.map((m) => truncateStrings(m, previewChars));
+    }
+    const pages = buildPagesByCharBudget(messagesDict, maxCharsPerPage);
+    const totalPages = pages.length;
+    let pageMessages;
+    if (pageNumber < 1 || pageNumber > totalPages) {
+        pageMessages = [];
+    }
+    else {
+        pageMessages = pages[pageNumber - 1];
+    }
+    const out = {
+        result: pageMessages,
+        page_number: pageNumber,
+        total_pages: totalPages,
+        max_chars_per_page: maxCharsPerPage,
+        preview_chars: previewChars,
+    };
+    return enforcePageCharBudget(out, maxCharsPerPage, { itemsKey: "result" });
+}
+//# sourceMappingURL=pagination.js.map

package/dist/common/pagination.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * LangSmith MCP Server - TypeScript implementation.
+ *
+ * Entry point that creates the MCP server and connects it to stdio transport.
+ */
+export {};
+//# 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":";AAEA;;;;GAIG"}

package/dist/index.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * LangSmith MCP Server - TypeScript implementation.
+ *
+ * Entry point that creates the MCP server and connects it to stdio transport.
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { server } from "./server.js";
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("LangSmith MCP server running on stdio");
+}
+main().catch((error) => {
+    console.error("Failed to start LangSmith MCP server:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;AACzD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,16 @@
+/**
+ * MCP server for LangSmith SDK integration.
+ * This server exposes methods to interact with LangSmith's observability platform:
+ * - get_thread_history: Fetch conversation history for a specific thread
+ * - get_prompts: Fetch prompts from LangSmith with optional filtering
+ * - pull_prompt: Pull a specific prompt by its name
+ * - fetch_runs: Fetch runs with flexible filters
+ * - list_projects: List LangSmith projects
+ * - list_datasets: Fetch datasets
+ * - list_examples: Fetch examples from datasets
+ * - list_experiments: List experiment projects
+ * - get_billing_usage: Fetch billing usage data
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const server: McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,eAAO,MAAM,MAAM,WAGlB,CAAC"}

package/dist/server.js

@@ -0,0 +1,20 @@
+/**
+ * MCP server for LangSmith SDK integration.
+ * This server exposes methods to interact with LangSmith's observability platform:
+ * - get_thread_history: Fetch conversation history for a specific thread
+ * - get_prompts: Fetch prompts from LangSmith with optional filtering
+ * - pull_prompt: Pull a specific prompt by its name
+ * - fetch_runs: Fetch runs with flexible filters
+ * - list_projects: List LangSmith projects
+ * - list_datasets: Fetch datasets
+ * - list_examples: Fetch examples from datasets
+ * - list_experiments: List experiment projects
+ * - get_billing_usage: Fetch billing usage data
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerTools } from "./services/register-tools.js";
+// Create MCP server
+export const server = new McpServer({ name: "LangSmith API MCP Server", version: "0.1.0" }, { capabilities: { logging: {} } });
+// Register all tools with the server
+registerTools(server);
+//# sourceMappingURL=server.js.map