Opik

Model Context Protocol (MCP) server for Opik, the open-source LLM observability and evaluation platform, built by Comet. Read traces, log scores, and manage prompts from Claude Code, Cursor, or VS Code.

10K+

13 Tools

Packaged by

Requires Secrets

Add to Docker Desktop

Version 4.43 or later needs to be installed to add the server automatically

Overview Tools (13)Config

Docker Hub⁠Github repository⁠

Use cases

Add feedback scores to a trace for quality evaluation and monitoring. Useful for rating trace quality, relevance, or custom metrics

Create a new project

Create a new prompt

Retrieve a specific version of a prompt

Get a list of prompts with optional filtering

Get detailed information about a specific trace including input, output, metadata, and timing information

Get aggregated statistics for traces including counts, costs, token usage, and performance metrics over time

Get trace threads (conversation groupings) to view related traces that belong to the same conversation or session

Get a list of projects with optional filtering

Get a list of traces from a project. Use this for basic trace retrieval and overview

View all

About

Opik MCP Server

Model Context Protocol (MCP) implementation for Opik enabling seamless IDE integration and unified access to prompts, projects, traces, and metrics. .

What is an MCP Server?⁠

MCP Info

Attribute	Details
Docker Image	mcp/opik⁠
Author	comet-ml⁠
Repository	https://github.com/comet-ml/opik-mcp⁠

Image Building Info

Attribute	Details
Dockerfile	https://github.com/comet-ml/opik-mcp/blob/ea3b4862c5d904fd51cacf61a28abf4791864d1e/Dockerfile⁠
Commit	`ea3b4862c5d904fd51cacf61a28abf4791864d1e`
Docker Image built by	Docker Inc.
Docker Scout Health Score
Verify Signature	`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/opik --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub`
Licence	Apache License 2.0

Available Tools (13)

Tools provided by this Server	Short Description
`add-trace-feedback`	Add feedback scores to a trace for quality evaluation and monitoring.
`create-project`	Create a new project
`create-prompt`	Create a new prompt
`get-prompt-version`	Retrieve a specific version of a prompt
`get-prompts`	Get a list of prompts with optional filtering
`get-trace-by-id`	Get detailed information about a specific trace including input, output, metadata, and timing information
`get-trace-stats`	Get aggregated statistics for traces including counts, costs, token usage, and performance metrics over time
`get-trace-threads`	Get trace threads (conversation groupings) to view related traces that belong to the same conversation or session
`list-projects`	Get a list of projects with optional filtering
`list-traces`	Get a list of traces from a project.
`opik-integration-docs`	Provides detailed documentation on how to integrate Opik with your LLM application
`save-prompt-version`	Save a new version of a prompt
`search-traces`	Advanced search for traces with complex filtering and query capabilities

Tools Details

Tool: `add-trace-feedback`

Add feedback scores to a trace for quality evaluation and monitoring. Useful for rating trace quality, relevance, or custom metrics

Parameters	Type	Description
`scores`	`array`	Array of feedback scores to add. Each score should have a name and value between 0-1
`traceId`	`string`	ID of the trace to add feedback to
`workspaceName`	`string`optional	Workspace name to use instead of the default

Tool: `create-project`

Create a new project

Parameters	Type	Description
`name`	`string`	Name of the project
`description`	`string`optional	Description of the project
`workspaceName`	`string`optional	Workspace name to use instead of the default

Tool: `create-prompt`

Create a new prompt

Parameters	Type	Description
`name`	`string`	Name of the prompt
`description`	`string`optional	Description of the prompt
`tags`	`array`optional	List of tags for the prompt

Tool: `get-prompt-version`

Retrieve a specific version of a prompt

Parameters	Type	Description
`name`	`string`	Name of the prompt
`commit`	`string`optional	Specific commit/version to retrieve

Tool: `get-prompts`

Get a list of prompts with optional filtering

Parameters	Type	Description
`name`	`string`optional	Filter by prompt name
`page`	`number`optional	Page number for pagination
`size`	`number`optional	Number of items per page

Tool: `get-trace-by-id`

Get detailed information about a specific trace including input, output, metadata, and timing information

Parameters	Type	Description
`traceId`	`string`	ID of the trace to fetch (UUID format, e.g. "123e4567-e89b-12d3-a456-426614174000")
`workspaceName`	`string`optional	Workspace name to use instead of the default workspace

Tool: `get-trace-stats`

Get aggregated statistics for traces including counts, costs, token usage, and performance metrics over time

Parameters	Type	Description
`endDate`	`string`optional	End date in ISO format (YYYY-MM-DD). Example: "2024-01-31"
`projectId`	`string`optional	Project ID to filter traces. If not provided, will use the first available project
`projectName`	`string`optional	Project name to filter traces (alternative to projectId)
`startDate`	`string`optional	Start date in ISO format (YYYY-MM-DD). Example: "2024-01-01"
`workspaceName`	`string`optional	Workspace name to use instead of the default workspace

Tool: `get-trace-threads`

Get trace threads (conversation groupings) to view related traces that belong to the same conversation or session

Parameters	Type	Description
`page`	`number`optional	Page number for pagination
`projectId`	`string`optional	Project ID to filter threads
`projectName`	`string`optional	Project name to filter threads
`size`	`number`optional	Number of threads per page
`threadId`	`string`optional	Specific thread ID to retrieve (useful for getting all traces in a conversation)
`workspaceName`	`string`optional	Workspace name to use instead of the default

Tool: `list-projects`

Get a list of projects with optional filtering

Parameters	Type	Description
`page`	`number`optional	Page number for pagination
`size`	`number`optional	Number of items per page
`workspaceName`	`string`optional	Workspace name to use instead of the default

Tool: `list-traces`

Get a list of traces from a project. Use this for basic trace retrieval and overview

Parameters	Type	Description
`page`	`number`optional	Page number for pagination (starts at 1)
`projectId`	`string`optional	Project ID to filter traces. If not provided, will use the first available project
`projectName`	`string`optional	Project name to filter traces (alternative to projectId). Example: "My AI Assistant"
`size`	`number`optional	Number of traces per page (1-100, default 10)
`workspaceName`	`string`optional	Workspace name to use instead of the default workspace

Tool: `opik-integration-docs`

Provides detailed documentation on how to integrate Opik with your LLM application

Tool: `save-prompt-version`

Save a new version of a prompt

Parameters	Type	Description
`name`	`string`	Name of the prompt
`template`	`string`	Template content for the prompt version
`change_description`	`string`optional	Description of changes in this version
`metadata`	`object`optional	Additional metadata for the prompt version
`type`	`string`optional	Template type

Tool: `search-traces`

Advanced search for traces with complex filtering and query capabilities

Parameters	Type	Description
`filters`	`object`optional	Advanced filters as key-value pairs. Examples: {"status": "error"}, {"model": "gpt-4"}, {"duration_ms": {"$gt": 1000}}
`page`	`number`optional	Page number for pagination
`projectId`	`string`optional	Project ID to search within
`projectName`	`string`optional	Project name to search within
`query`	`string`optional	Text query to search in trace names, inputs, outputs, and metadata. Example: "error" or "user_query:hello"
`size`	`number`optional	Number of traces per page (max 100)
`sortBy`	`string`optional	Field to sort by. Options: "created_at", "duration", "name", "status"
`sortOrder`	`string`optional	Sort order: ascending or descending
`workspaceName`	`string`optional	Workspace name to use instead of the default

Use this MCP Server

{
  "mcpServers": {
    "opik": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OPIK_API_BASE_URL",
        "-e",
        "OPIK_WORKSPACE_NAME",
        "-e",
        "OPIK_API_KEY",
        "mcp/opik"
      ],
      "env": {
        "OPIK_API_BASE_URL": "https://www.comet.com/opik/api",
        "OPIK_WORKSPACE_NAME": "default",
        "OPIK_API_KEY": "your_api_key"
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?⁠

Opik

Opik MCP Server

MCP Info

Image Building Info

Available Tools (13)

Tools Details

Tool: `add-trace-feedback`

Tool: `create-project`

Tool: `create-prompt`

Tool: `get-prompt-version`

Tool: `get-prompts`

Tool: `get-trace-by-id`

Tool: `get-trace-stats`

Tool: `get-trace-threads`

Tool: `list-projects`

Tool: `list-traces`

Tool: `opik-integration-docs`

Tool: `save-prompt-version`

Tool: `search-traces`

Use this MCP Server

Related servers

AWS Core

Desktop Commander

Docker Hub

GitHub Official

Opik

Opik MCP Server

MCP Info

Image Building Info

Available Tools (13)

Tools Details

Tool: add-trace-feedback

Tool: create-project

Tool: create-prompt

Tool: get-prompt-version

Tool: get-prompts

Tool: get-trace-by-id

Tool: get-trace-stats

Tool: get-trace-threads

Tool: list-projects

Tool: list-traces

Tool: opik-integration-docs

Tool: save-prompt-version

Tool: search-traces

Use this MCP Server

Related servers

AWS Core

Desktop Commander

Docker Hub

GitHub Official

Tool: `add-trace-feedback`

Tool: `create-project`

Tool: `create-prompt`

Tool: `get-prompt-version`

Tool: `get-prompts`

Tool: `get-trace-by-id`

Tool: `get-trace-stats`

Tool: `get-trace-threads`

Tool: `list-projects`

Tool: `list-traces`

Tool: `opik-integration-docs`

Tool: `save-prompt-version`

Tool: `search-traces`