# Opik (MCP server)

> Opik is an MCP server that adds cloud and DevOps tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Read and score Opik traces, experiments, datasets and prompts from your AI assistant. It has 219 GitHub stars, is released under the Apache-2.0 license and runs locally with uvx opik-mcp.

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.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/comet-ml/opik-mcp |
| GitHub stars | 219 |
| License | Apache-2.0 |
| Language | Python |
| Transport | stdio, streamable-http |
| Packages | pypi: opik-mcp |
| Remote URL | https://www.comet.com/opik/api/v1/mcp |
| Needs API key | yes |
| Official | yes |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code, Claude.ai, ChatGPT |
| Category | Cloud & DevOps |
| Latest release | 3.0.0 (Oct 5, 2026) |
| Last commit | Oct 6, 2026 |
| MCP registry name | io.github.comet-ml/opik-mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "opik": {
      "command": "uvx",
      "args": [
        "opik-mcp"
      ],
      "env": {
        "OPIK_API_KEY": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env OPIK_API_KEY=your-value --transport stdio opik -- uvx opik-mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "opik": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "opik-mcp"
      ],
      "env": {
        "OPIK_API_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "opik_api_key",
      "description": "OPIK_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "opik": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "opik-mcp"
      ],
      "env": {
        "OPIK_API_KEY": "${input:opik_api_key}"
      }
    }
  }
}
```

### Claude Code (remote)

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

The same server is also hosted as a remote MCP endpoint, so nothing runs on your machine.

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `OPIK_API_KEY` (secret): 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 /opik/api.

## Tools

- `read_skill`: Read one of the Opik agent skills bundled with this server
- `read`: One tool for any "show me X" question. Takes an entitytype plus an id
- `list`: Browse or search a collection with pagination. Project-scoped types (trace,
- `write`: Universal write dispatcher. Pass operation + data and the dispatcher
- `trace.create`: Log a single trace (or a batch). Parent for spans / scores / comments.
- `trace.update`: Finalize or amend an existing trace.
- `span.create`: Log a span on an existing trace (or a batch).
- `score.create`: Attach a numeric feedback score to a trace, span, or thread.
- `comment.create`: Attach a free-text comment to a trace, span, or thread.
- `prompt_version.save`: Save a new prompt version (creates the prompt by name if missing).
- `dataset.create`: Create a dataset — type: "testsuite" makes it an evaluation test suite.
- `dataset_item.upsert`: Upsert items into a dataset (always the envelope shape).
- `experiment.create`: Create an experiment scoped to a dataset.
- `experiment_item.create`: Attach trace + dataset_item rows to an experiment.
- `thread.close`: Close a thread (mark it inactive). Pass threadid and the project.
- `thread.open`: Reopen a closed thread. Pass threadid and the project.
- `agent_insights_job.enable`: Turn Diagnostics on for a project (daily scans, safe to repeat).
- `agent_insights_job.trigger`: Run a Diagnostics scan now, over the last 24 hours.
- `agent_insights_issue.resolve`: Mark a Diagnostics issue dealt with (ask the user first).
- `agent_insights_issue.close`: Mark a Diagnostics issue not worth acting on (ask the user first).
- `agent_insights_issue.reopen`: Put a resolved or closed Diagnostics issue back on the open list.
- `schema`: Inspect the exact JSON shape and required fields of any write operation before

## Similar MCP servers

- [Worldmonitor](https://appsgit.com/mcp-servers/worldmonitor): Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface. (87,920 stars, AGPL-3.0)
- [Netdata](https://appsgit.com/mcp-servers/netdata): Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection. (80,817 stars, GPL-3.0, needs API key)
- [openstatus](https://appsgit.com/mcp-servers/openstatus): Manage monitors, status pages, incidents and maintenances in your openstatus workspace. (9,171 stars, AGPL-3.0, official)
- [MCP Server Cloudflare](https://appsgit.com/mcp-servers/mcp-server-cloudflare): Model Context Protocol (MCP) is a new, standardized protocol for managing context between large language models (LLMs) and external systems. (4,360 stars, Apache-2.0, official, needs API key)
- [Dagu](https://appsgit.com/mcp-servers/dagu): Self-hostable workflow orchestrator for teams whose main work isn't orchestration. (4,289 stars, GPL-3.0)
- [Azure MCP Server](https://appsgit.com/mcp-servers/azure-mcp-server): All Azure MCP tools to create a seamless connection between AI agents and Azure services. (3,738 stars, MIT, official)

---

Canonical page: https://appsgit.com/mcp-servers/opik
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.