opik-mcp 2.0.0 → 2.0.1

package/build/prompts/core-prompts.js

@@ -31,7 +31,7 @@ export function loadCorePrompts(server) {
             .string()
             .default('Find low-quality items and produce cleanup actions.')
             .describe('Dataset maintenance objective.'),
-    }, async ({ datasetName, objective }) => ({
+    }, async ({ datasetName, objective, }) => ({
         messages: [
             {
                 role: 'user',

package/build/resources/opik-resources.js

@@ -1,5 +1,5 @@
 import { callSdk, getOpikApi, getRequestOptions } from '../utils/opik-sdk.js';
-import { registerResource, registerResourceTemplate } from '../tools/registration.js';
+import { registerResource, registerResourceTemplate, } from '../tools/registration.js';
 const DEFAULT_PAGE = 1;
 const DEFAULT_SIZE = 10;
 const MAX_SIZE = 100;
@@ -69,7 +69,12 @@ export function loadOpikResources(server, config) {
                 return toReadError(uri.toString(), response.error || 'Failed to fetch projects');
             }
             return {
-                contents: [{ uri: uri.toString(), text: JSON.stringify(response.data, null, 2) }],
+                contents: [
+                    {
+                        uri: uri.toString(),
+                        text: JSON.stringify(response.data, null, 2),
+                    },
+                ],
             };
         });
     }
@@ -83,7 +88,12 @@ export function loadOpikResources(server, config) {
                 return toReadError(uri.toString(), response.error || 'Failed to fetch prompts');
             }
             return {
-                contents: [{ uri: uri.toString(), text: JSON.stringify(response.data, null, 2) }],
+                contents: [
+                    {
+                        uri: uri.toString(),
+                        text: JSON.stringify(response.data, null, 2),
+                    },
+                ],
             };
         });
         registerResourceTemplate(server, 'prompt-latest', 'opik://prompt/{name}', 'Latest prompt version by prompt name.', async (uri, variables) => {
@@ -97,7 +107,12 @@ export function loadOpikResources(server, config) {
                 return toReadError(uri.toString(), response.error || 'Failed to fetch prompt');
             }
             return {
-                contents: [{ uri: uri.toString(), text: JSON.stringify(response.data, null, 2) }],
+                contents: [
+                    {
+                        uri: uri.toString(),
+                        text: JSON.stringify(response.data, null, 2),
+                    },
+                ],
             };
         });
         registerResourceTemplate(server, 'prompt-commit', 'opik://prompt/{name}/{commit}', 'Specific prompt version by prompt name and commit.', async (uri, variables) => {
@@ -112,7 +127,12 @@ export function loadOpikResources(server, config) {
                 return toReadError(uri.toString(), response.error || 'Failed to fetch prompt version');
             }
             return {
-                contents: [{ uri: uri.toString(), text: JSON.stringify(response.data, null, 2) }],
+                contents: [
+                    {
+                        uri: uri.toString(),
+                        text: JSON.stringify(response.data, null, 2),
+                    },
+                ],
             };
         });
     }
@@ -126,7 +146,12 @@ export function loadOpikResources(server, config) {
                 return toReadError(uri.toString(), response.error || 'Failed to fetch datasets');
             }
             return {
-                contents: [{ uri: uri.toString(), text: JSON.stringify(response.data, null, 2) }],
+                contents: [
+                    {
+                        uri: uri.toString(),
+                        text: JSON.stringify(response.data, null, 2),
+                    },
+                ],
             };
         });
         registerResourceTemplate(server, 'dataset-by-id', 'opik://dataset/{datasetId}', 'Dataset details by dataset ID.', async (uri, variables) => {
@@ -140,7 +165,12 @@ export function loadOpikResources(server, config) {
                 return toReadError(uri.toString(), response.error || 'Failed to fetch dataset');
             }
             return {
-                contents: [{ uri: uri.toString(), text: JSON.stringify(response.data, null, 2) }],
+                contents: [
+                    {
+                        uri: uri.toString(),
+                        text: JSON.stringify(response.data, null, 2),
+                    },
+                ],
             };
         });
         registerResourceTemplate(server, 'dataset-items-page', 'opik://dataset/{datasetId}/items/{page}/{size}', 'Paginated dataset items by dataset ID, page, and size.', async (uri, variables) => {
@@ -156,7 +186,12 @@ export function loadOpikResources(server, config) {
                 return toReadError(uri.toString(), response.error || 'Failed to fetch dataset items');
             }
             return {
-                contents: [{ uri: uri.toString(), text: JSON.stringify(response.data, null, 2) }],
+                contents: [
+                    {
+                        uri: uri.toString(),
+                        text: JSON.stringify(response.data, null, 2),
+                    },
+                ],
             };
         });
     }
@@ -172,7 +207,12 @@ export function loadOpikResources(server, config) {
                 return toReadError(uri.toString(), response.error || 'Failed to fetch trace');
             }
             return {
-                contents: [{ uri: uri.toString(), text: JSON.stringify(response.data, null, 2) }],
+                contents: [
+                    {
+                        uri: uri.toString(),
+                        text: JSON.stringify(response.data, null, 2),
+                    },
+                ],
             };
         });
         registerResourceTemplate(server, 'traces-by-project-page', 'opik://traces/{projectId}/{page}/{size}', 'Paginated traces by project ID, page, and size.', async (uri, variables) => {
@@ -188,7 +228,12 @@ export function loadOpikResources(server, config) {
                 return toReadError(uri.toString(), response.error || 'Failed to fetch traces');
             }
             return {
-                contents: [{ uri: uri.toString(), text: JSON.stringify(response.data, null, 2) }],
+                contents: [
+                    {
+                        uri: uri.toString(),
+                        text: JSON.stringify(response.data, null, 2),
+                    },
+                ],
             };
         });
     }

package/build/test-client.js

@@ -239,7 +239,7 @@ async function runApiTests() {
                 console.log(`${index + 1}. Workspace: ${project.workspaceName}, Project: ${project.projectName} (${project.projectId}), Traces: ${project.traceCount}`);
             });
             // Look for the 'Therapist Chat' project first
-            let testProject = discovery.projectsWithTraces.find(p => p.projectName === 'Therapist Chat');
+            let testProject = discovery.projectsWithTraces.find((p) => p.projectName === 'Therapist Chat');
             // If not found, use the first project with traces
             if (!testProject) {
                 testProject = discovery.projectsWithTraces[0];
@@ -275,7 +275,8 @@ async function runApiTests() {
                 console.log(`Found ${tracesResponse.data.total} traces`);
                 console.log(JSON.stringify(tracesResponse.data, null, 2));
                 // If there are traces, get details for the first one
-                if (tracesResponse.data.content && tracesResponse.data.content.length > 0) {
+                if (tracesResponse.data.content &&
+                    tracesResponse.data.content.length > 0) {
                     const traceId = tracesResponse.data.content[0].id;
                     console.log(`\nGetting details for trace: ${traceId}`);
                     const traceDetail = await api.getTrace(traceId);
@@ -299,7 +300,8 @@ async function runApiTests() {
                 console.log(`Found ${projectsResponse.data.total} projects`);
                 console.log(JSON.stringify(projectsResponse.data, null, 2));
                 // If there are projects, get details for the first one
-                if (projectsResponse.data.content && projectsResponse.data.content.length > 0) {
+                if (projectsResponse.data.content &&
+                    projectsResponse.data.content.length > 0) {
                     firstProjectId = projectsResponse.data.content[0].id;
                     console.log(`\nGetting details for project: ${firstProjectId}`);
                     const projectDetail = await api.getProject(firstProjectId);
@@ -360,7 +362,8 @@ async function runApiTests() {
                     console.log(`Found ${therapistChatTraces.data.total} traces`);
                     console.log(JSON.stringify(therapistChatTraces.data, null, 2));
                     // Get details for first trace if available
-                    if (therapistChatTraces.data.content && therapistChatTraces.data.content.length > 0) {
+                    if (therapistChatTraces.data.content &&
+                        therapistChatTraces.data.content.length > 0) {
                         const traceId = therapistChatTraces.data.content[0].id;
                         console.log(`\nGetting details for trace: ${traceId}`);
                         const traceDetail = await api.getTrace(traceId);
@@ -427,7 +430,7 @@ if (isMainModule) {
         console.log('\n✅ API tests completed');
     });
 }
-main().catch(error => {
+main().catch((error) => {
     console.error('Fatal error:', error);
     process.exit(1);
 });

package/build/tools/capabilities.js

@@ -23,10 +23,10 @@ function formatTopicHelp(topic) {
         `Available: ${section.available ? 'Yes' : 'No'}`,
         '',
         '## Features',
-        ...section.features.map(feature => `- ${feature}`),
+        ...section.features.map((feature) => `- ${feature}`),
         '',
         '## Limitations',
-        ...section.limitations.map(limitation => `- ${limitation}`),
+        ...section.limitations.map((limitation) => `- ${limitation}`),
     ].join('\n');
 }
 export const loadCapabilitiesTools = (server, config) => {

package/build/tools/dataset.js

@@ -14,7 +14,12 @@ export const loadDatasetTools = (server) => {
         const response = await callSdk(() => api.datasets.findDatasets({ page, size, name }, getRequestOptions(workspaceName)));
         if (!response.data) {
             return {
-                content: [{ type: 'text', text: response.error || 'Failed to fetch datasets' }],
+                content: [
+                    {
+                        type: 'text',
+                        text: response.error || 'Failed to fetch datasets',
+                    },
+                ],
             };
         }
         return {
@@ -39,16 +44,23 @@ export const loadDatasetTools = (server) => {
         const response = await callSdk(() => api.datasets.getDatasetById(datasetId, getRequestOptions(workspaceName)));
         if (!response.data) {
             return {
-                content: [{ type: 'text', text: response.error || 'Failed to fetch dataset' }],
+                content: [
+                    { type: 'text', text: response.error || 'Failed to fetch dataset' },
+                ],
             };
         }
         return {
-            content: [{ type: 'text', text: JSON.stringify(response.data, null, 2) }],
+            content: [
+                { type: 'text', text: JSON.stringify(response.data, null, 2) },
+            ],
         };
     });
     registerTool(server, 'create-dataset', 'Create a dataset for evaluations and experiments.', {
         name: z.string().min(1).describe('Dataset name.'),
-        description: z.string().optional().describe('Optional dataset description.'),
+        description: z
+            .string()
+            .optional()
+            .describe('Optional dataset description.'),
         workspaceName: workspaceNameSchema,
     }, async (args) => {
         const { name, description, workspaceName } = args;
@@ -59,7 +71,12 @@ export const loadDatasetTools = (server) => {
         }, getRequestOptions(workspaceName)));
         if (response.error) {
             return {
-                content: [{ type: 'text', text: response.error || 'Failed to create dataset' }],
+                content: [
+                    {
+                        type: 'text',
+                        text: response.error || 'Failed to create dataset',
+                    },
+                ],
             };
         }
         return {
@@ -80,11 +97,18 @@ export const loadDatasetTools = (server) => {
         const response = await callSdk(() => api.datasets.deleteDataset(datasetId, getRequestOptions(workspaceName)));
         if (response.error) {
             return {
-                content: [{ type: 'text', text: response.error || 'Failed to delete dataset' }],
+                content: [
+                    {
+                        type: 'text',
+                        text: response.error || 'Failed to delete dataset',
+                    },
+                ],
             };
         }
         return {
-            content: [{ type: 'text', text: `Successfully deleted dataset ${datasetId}` }],
+            content: [
+                { type: 'text', text: `Successfully deleted dataset ${datasetId}` },
+            ],
         };
     });
     registerTool(server, 'list-dataset-items', 'List items in a dataset.', {
@@ -98,7 +122,12 @@ export const loadDatasetTools = (server) => {
         const response = await callSdk(() => api.datasets.getDatasetItems(datasetId, { page, size }, getRequestOptions(workspaceName)));
         if (!response.data) {
             return {
-                content: [{ type: 'text', text: response.error || 'Failed to fetch dataset items' }],
+                content: [
+                    {
+                        type: 'text',
+                        text: response.error || 'Failed to fetch dataset items',
+                    },
+                ],
             };
         }
         return {
@@ -117,8 +146,14 @@ export const loadDatasetTools = (server) => {
     registerTool(server, 'create-dataset-item', 'Create one dataset item with input, expected output, and metadata.', {
         datasetId: z.string().min(1).describe('Dataset ID.'),
         input: z.record(z.any()).describe('Input payload.'),
-        expectedOutput: z.record(z.any()).optional().describe('Optional expected output payload.'),
-        metadata: z.record(z.any()).optional().describe('Optional metadata payload.'),
+        expectedOutput: z
+            .record(z.any())
+            .optional()
+            .describe('Optional expected output payload.'),
+        metadata: z
+            .record(z.any())
+            .optional()
+            .describe('Optional metadata payload.'),
         workspaceName: workspaceNameSchema,
     }, async (args) => {
         const { datasetId, input, expectedOutput, metadata, workspaceName } = args;
@@ -138,7 +173,12 @@ export const loadDatasetTools = (server) => {
         }, getRequestOptions(workspaceName)));
         if (response.error) {
             return {
-                content: [{ type: 'text', text: response.error || 'Failed to create dataset item' }],
+                content: [
+                    {
+                        type: 'text',
+                        text: response.error || 'Failed to create dataset item',
+                    },
+                ],
             };
         }
         return {
@@ -161,11 +201,18 @@ export const loadDatasetTools = (server) => {
         }, getRequestOptions(workspaceName)));
         if (response.error) {
             return {
-                content: [{ type: 'text', text: response.error || 'Failed to delete dataset item' }],
+                content: [
+                    {
+                        type: 'text',
+                        text: response.error || 'Failed to delete dataset item',
+                    },
+                ],
             };
         }
         return {
-            content: [{ type: 'text', text: `Successfully deleted dataset item ${itemId}` }],
+            content: [
+                { type: 'text', text: `Successfully deleted dataset item ${itemId}` },
+            ],
         };
     });
     return server;

package/build/tools/metrics.js

@@ -17,7 +17,7 @@ export const loadMetricTools = (server) => {
         endDate: isoDateSchema,
         workspaceName: workspaceNameSchema,
     }, async (args) => {
-        const { metricName, projectId, projectName, startDate, endDate, workspaceName } = args;
+        const { metricName, projectId, projectName, startDate, endDate, workspaceName, } = args;
         const resolved = await resolveProjectIdentifier(projectId, projectName, workspaceName);
         if (resolved.error || (!resolved.projectId && !resolved.projectName)) {
             return {
@@ -49,7 +49,9 @@ export const loadMetricTools = (server) => {
         }, getRequestOptions(workspaceName)));
         if (!response.data) {
             return {
-                content: [{ type: 'text', text: response.error || 'Failed to fetch metrics' }],
+                content: [
+                    { type: 'text', text: response.error || 'Failed to fetch metrics' },
+                ],
             };
         }
         const metricWarning = metricName && !metricType

package/build/tools/project.js

@@ -15,7 +15,12 @@ export const loadProjectTools = (server, options = {}) => {
             const response = await callSdk(() => api.projects.findProjects({ page, size }, getRequestOptions(workspaceName)));
             if (!response.data) {
                 return {
-                    content: [{ type: 'text', text: response.error || 'Failed to fetch projects' }],
+                    content: [
+                        {
+                            type: 'text',
+                            text: response.error || 'Failed to fetch projects',
+                        },
+                    ],
                 };
             }
             return {
@@ -43,7 +48,10 @@ export const loadProjectTools = (server, options = {}) => {
     if (includeMutations) {
         registerTool(server, 'create-project', 'Create a new project for traces, prompts, and evaluation runs.', {
             name: z.string().min(1).describe('Project name.'),
-            description: z.string().optional().describe('Optional project description.'),
+            description: z
+                .string()
+                .optional()
+                .describe('Optional project description.'),
             workspaceName: workspaceNameSchema,
         }, async (args) => {
             const { name, description, workspaceName } = args;

package/build/tools/prompt.js

@@ -13,7 +13,9 @@ export const loadPromptTools = (server) => {
         const response = await callSdk(() => api.prompts.getPrompts({ page, size, name }));
         if (!response.data) {
             return {
-                content: [{ type: 'text', text: response.error || 'Failed to fetch prompts' }],
+                content: [
+                    { type: 'text', text: response.error || 'Failed to fetch prompts' },
+                ],
             };
         }
         return {
@@ -31,8 +33,14 @@ export const loadPromptTools = (server) => {
     });
     registerTool(server, 'create-prompt', 'Create a prompt definition.', {
         name: z.string().min(1).describe('Prompt name.'),
-        description: z.string().optional().describe('Optional prompt description.'),
-        tags: z.array(z.string().min(1)).optional().describe('Optional prompt tags.'),
+        description: z
+            .string()
+            .optional()
+            .describe('Optional prompt description.'),
+        tags: z
+            .array(z.string().min(1))
+            .optional()
+            .describe('Optional prompt tags.'),
     }, async (args) => {
         const { name, description, tags } = args;
         const api = getOpikApi();
@@ -58,7 +66,9 @@ export const loadPromptTools = (server) => {
         const response = await callSdk(() => api.prompts.getPromptById(promptId));
         if (!response.data) {
             return {
-                content: [{ type: 'text', text: response.error || 'Failed to fetch prompt' }],
+                content: [
+                    { type: 'text', text: response.error || 'Failed to fetch prompt' },
+                ],
             };
         }
         return {
@@ -72,7 +82,10 @@ export const loadPromptTools = (server) => {
     });
     registerTool(server, 'get-prompt-version', 'Get a specific prompt version by name and optional commit.', {
         name: z.string().min(1).describe('Prompt name.'),
-        commit: z.string().optional().describe('Optional commit/version identifier.'),
+        commit: z
+            .string()
+            .optional()
+            .describe('Optional commit/version identifier.'),
     }, async (args) => {
         const { name, commit } = args;
         const api = getOpikApi();
@@ -82,7 +95,12 @@ export const loadPromptTools = (server) => {
         }));
         if (!response.data) {
             return {
-                content: [{ type: 'text', text: response.error || 'Failed to fetch prompt version' }],
+                content: [
+                    {
+                        type: 'text',
+                        text: response.error || 'Failed to fetch prompt version',
+                    },
+                ],
             };
         }
         return {
@@ -102,7 +120,9 @@ export const loadPromptTools = (server) => {
         const response = await callSdk(() => api.prompts.deletePrompt(promptId));
         if (response.error) {
             return {
-                content: [{ type: 'text', text: response.error || 'Failed to delete prompt' }],
+                content: [
+                    { type: 'text', text: response.error || 'Failed to delete prompt' },
+                ],
             };
         }
         return {
@@ -121,25 +141,41 @@ export const loadPromptTools = (server) => {
             .string()
             .optional()
             .describe('Optional summary of changes in this version.'),
-        change_description: z.string().optional().describe('Deprecated alias for changeDescription.'),
-        metadata: z.record(z.any()).optional().describe('Additional metadata for the prompt version'),
-        type: z.enum(['mustache', 'jinja2']).optional().describe('Template format.'),
+        change_description: z
+            .string()
+            .optional()
+            .describe('Deprecated alias for changeDescription.'),
+        metadata: z
+            .record(z.any())
+            .optional()
+            .describe('Additional metadata for the prompt version'),
+        type: z
+            .enum(['mustache', 'jinja2'])
+            .optional()
+            .describe('Template format.'),
     }, async (args) => {
-        const { name, template, change_description, changeDescription, metadata, type } = args;
+        const { name, template, change_description, changeDescription, metadata, type, } = args;
         const resolvedChangeDescription = changeDescription ?? change_description;
         const api = getOpikApi();
         const response = await callSdk(() => api.prompts.createPromptVersion({
             name,
             version: {
                 template,
-                ...(resolvedChangeDescription && { changeDescription: resolvedChangeDescription }),
+                ...(resolvedChangeDescription && {
+                    changeDescription: resolvedChangeDescription,
+                }),
                 ...(metadata && { metadata }),
                 ...(type && { type }),
             },
         }));
         if (!response.data) {
             return {
-                content: [{ type: 'text', text: response.error || 'Failed to create prompt version' }],
+                content: [
+                    {
+                        type: 'text',
+                        text: response.error || 'Failed to create prompt version',
+                    },
+                ],
             };
         }
         return {

package/build/tools/registration.js

@@ -11,7 +11,7 @@ const MISSING_API_KEY_MESSAGE = [
 function inferAnnotations(name) {
     const readPrefixes = ['get-', 'list-', 'search-', 'read-'];
     const mutatePrefixes = ['create-', 'delete-', 'update-', 'add-', 'save-'];
-    if (readPrefixes.some(prefix => name.startsWith(prefix))) {
+    if (readPrefixes.some((prefix) => name.startsWith(prefix))) {
         return {
             readOnlyHint: true,
             destructiveHint: false,
@@ -19,7 +19,7 @@ function inferAnnotations(name) {
             openWorldHint: false,
         };
     }
-    if (mutatePrefixes.some(prefix => name.startsWith(prefix))) {
+    if (mutatePrefixes.some((prefix) => name.startsWith(prefix))) {
         return {
             readOnlyHint: false,
             destructiveHint: name.startsWith('delete-'),
@@ -33,7 +33,7 @@ function withRequestContext(handler, requiresApiKey = true) {
     return (...args) => {
         const extra = [...args]
             .reverse()
-            .find(arg => arg && typeof arg === 'object' && 'authInfo' in arg);
+            .find((arg) => arg && typeof arg === 'object' && 'authInfo' in arg);
         const authInfo = extra?.authInfo;
         const context = {
             apiKey: authInfo?.token,
@@ -64,7 +64,9 @@ export function registerTool(server, name, description, inputSchema, handler, op
             ...(options.title && { title: options.title }),
             description,
             inputSchema,
-            ...(Object.keys(mergedAnnotations).length > 0 && { annotations: mergedAnnotations }),
+            ...(Object.keys(mergedAnnotations).length > 0 && {
+                annotations: mergedAnnotations,
+            }),
             ...(options.outputSchema && { outputSchema: options.outputSchema }),
             ...(options._meta && { _meta: options._meta }),
         }, wrappedHandler);
@@ -84,7 +86,9 @@ export function registerResource(server, name, uri, description, readCallback) {
 }
 export function registerResourceTemplate(server, name, uriTemplate, description, readCallback, listCallback) {
     const wrappedReadCallback = withRequestContext(readCallback);
-    const wrappedListCallback = listCallback ? withRequestContext(listCallback) : undefined;
+    const wrappedListCallback = listCallback
+        ? withRequestContext(listCallback)
+        : undefined;
     const template = new ResourceTemplate(uriTemplate, {
         list: wrappedListCallback,
     });

package/build/tools/schema.js

@@ -1,6 +1,17 @@
 import { z } from 'zod';
-export const pageSchema = z.number().int().min(1).default(1).describe('1-based page number.');
-export const sizeSchema = (defaultSize, max = 100) => z.number().int().min(1).max(max).default(defaultSize).describe(`Page size (1-${max}).`);
+export const pageSchema = z
+    .number()
+    .int()
+    .min(1)
+    .default(1)
+    .describe('1-based page number.');
+export const sizeSchema = (defaultSize, max = 100) => z
+    .number()
+    .int()
+    .min(1)
+    .max(max)
+    .default(defaultSize)
+    .describe(`Page size (1-${max}).`);
 export const workspaceNameSchema = z
     .string()
     .min(1)