Opik

comet-ml/opik-mcp

Opik Mcp provides an MCP server that integrates Opik, a prompt engineering and LLM observability platform, with MCP-compatible clients through both local stdio and remote streamable-http transports. The server exposes tools for prompt lifecycle management, workspace and project exploration, trace analysis, metrics and dataset operations, and MCP resources for metadata-aware workflows. It solves the problem of enabling AI assistants and development tools to programmatically interact with Opik's LLM evaluation and monitoring capabilities without requiring direct API integration.

GitHub stars: 226
tools: 10
auth: Secret needed
transport: STDIO, HTTP
env vars: 4
last updated: Nov 6, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://www.comet.com/opik/api/v1/mcp --name opik-mcp

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http opik-mcp https://www.comet.com/opik/api/v1/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 10 tools

Verified live against the running server on Jun 11, 2026.

get-server-infoReturn server configuration and enabled Opik capabilities. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-15

Return server configuration and enabled Opik capabilities. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-15

No parameters. Call it with no arguments.

get-opik-helpReturn Opik capability documentation, optionally filtered by topic. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-151 params

Return Opik capability documentation, optionally filtered by topic. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-15

Parameters* required

topicstring

Optional capability topic to describeone of prompts · projects · traces · metrics · general

get-opik-examplesReturn Opik usage examples for a requested task. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-151 params

Return Opik usage examples for a requested task. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-15

Parameters* required

taskstring

Optional task name, e.g. "create prompt", "log trace", "evaluate response"

get-opik-metrics-infoReturn Opik metric definitions and usage guidance. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-151 params

Return Opik metric definitions and usage guidance. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-15

Parameters* required

metricstring

Optional metric name (e.g. hallucination, answerrelevance, moderation)

get-opik-tracing-infoReturn tracing guidance for traces, spans, feedback, search, and visualization. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-151 params

Return tracing guidance for traces, spans, feedback, search, and visualization. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-15

Parameters* required

topicstring

Optional tracing topicone of traces · spans · feedback · search · visualization

list-projectsList projects in the active workspace to find IDs for traces and metrics operations. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-153 params

List projects in the active workspace to find IDs for traces and metrics operations. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-15

Parameters* required

pageinteger

1-based page number.default: 1

sizeinteger

Page size (1-100).default: 10

workspaceNamestring

Workspace override for local/stdio mode. Ignored when remote token-to-workspace mapping is enforced.

list-tracesList traces for a project for quick inspection and navigation. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-155 params

List traces for a project for quick inspection and navigation. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-15

Parameters* required

pageinteger

1-based page number.default: 1

projectIdstring

Optional project ID. If omitted, the first available project is used.

projectNamestring

Optional project name (alternative to projectId).

sizeinteger

Page size (1-100).default: 10

workspaceNamestring

Workspace override for local/stdio mode. Ignored when remote token-to-workspace mapping is enforced.

get-trace-by-idGet full details for a trace, including metadata and serialized input/output. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-152 params

Get full details for a trace, including metadata and serialized input/output. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-15

Parameters* required

traceId*string

Trace ID.

workspaceNamestring

Workspace override for local/stdio mode. Ignored when remote token-to-workspace mapping is enforced.

get-trace-statsGet aggregated trace statistics (count, tokens, cost, and duration) over time. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-155 params

Get aggregated trace statistics (count, tokens, cost, and duration) over time. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-15

Parameters* required

endDatevalue

projectIdstring

Optional project ID. If omitted, the first available project is used.

projectNamestring

Optional project name (alternative to projectId).

startDatestring

Date in YYYY-MM-DD format.

workspaceNamestring

Workspace override for local/stdio mode. Ignored when remote token-to-workspace mapping is enforced.

get-trace-threadsList trace threads (conversation/session groupings) or fetch one thread by ID. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-156 params

List trace threads (conversation/session groupings) or fetch one thread by ID. ⚠️ DEPRECATED — migrate to `uvx opik-mcp@latest` by 2026-11-15

Parameters* required

pageinteger

1-based page number.default: 1

projectIdstring

Optional project ID filter.

projectNamestring

Optional project name filter.

sizeinteger

Page size (1-100).default: 10

threadIdstring

Optional thread ID. When set, returns that thread instead of paginated listing.

workspaceNamestring

Workspace override for local/stdio mode. Ignored when remote token-to-workspace mapping is enforced.

Configuration

OPIK_API_KEYsecret

Opik API key, for Opik Cloud and self-hosted Comet. Leave unset for open-source Opik.

OPIK_WORKSPACE

Workspace name: the segment after comet.com/opik/ in your Opik URL. Leave unset for open-source Opik.

OPIK_URL

Opik REST API base, for open-source Opik.

COMET_URL_OVERRIDE

Base URL of a self-hosted Comet platform; Opik's API is <url>/opik/api.

Readme

Opik MCP Server

The official Model Context Protocol (MCP) server for Opik, the open-source LLM observability and evaluation platform, built by Comet. Plug your AI host (Claude Code, Cursor, VS Code Copilot, Codex, opencode, or any MCP client) directly into your Opik workspace: read traces, log scores, and save prompt versions, all from the chat.

Built for LLM engineers who already run Opik and want to drive it from the same AI assistant they code with.

You:    "Which traces in project 'demo' failed today?"
Claude: → list(entity_type="trace", project_name="demo") → "Three traces failed…"

You:    "Score trace 7f2e… 0.9 on helpfulness with reason 'great recovery'."
Claude: → write(score.create) → done

Quick start

View the full README on GitHub

Details

Repository: github.com/comet-ml/opik-mcp
Website: www.comet.com/docs/opik/mcp-server
Package: opik-mcp
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active
Resources: 2
Prompts: 2
Tools verified: Jun 11, 2026