# Opik

> Opik is an open-source MCP server for ai models and llm tooling. Read Opik traces, score them and save prompts from your coding assistant. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Website:** https://www.comet.com/docs/opik/mcp-server
- **Repository:** https://github.com/comet-ml/opik-mcp
- **MCP Registry name:** io.github.comet-ml/opik-mcp
- **Categories:** AI models and LLM tooling, developer tools
- **Listing updated:** 2026-11-14

## About

Opik is Comet's open-source platform for LLM observability and evaluation, and this server connects a coding assistant to it so the assistant can see what the code does at run time. It reads full span trees, errors and feedback scores directly, so you do not paste screenshots into chat. It can query failing, slowest or most expensive traces over a time window and report what they share, then log scores and save prompt versions.

The README shows a pattern of generic tools: a list call with an entity type and project name to find failed traces, and a write call such as score.create to attach a score. A setup command, uvx opik mcp configure, detects Claude Code, Cursor, VS Code Copilot, Codex or opencode, registers the right server, installs an Opik skill pack and checks the result. The skill pack also teaches the assistant to add tracing for your framework, run the app and read the trace back to confirm it arrived.

There are two ways to connect. Opik Cloud uses a hosted Streamable HTTP server with browser OAuth sign-in and no API key. Self-hosted Comet and open-source Opik use a local stdio server configured with environment variables, and an API key only where the deployment needs one.

## Features

- **Trace reading:** Read span trees, errors and feedback scores without pasting screenshots.
- **Scoring:** Attach scores with a reason to a trace from the chat.
- **Prompt versions:** Save new prompt versions to your workspace.
- **Failure analysis:** Query failing, slowest or most expensive traces and find common causes.
- **Guided setup:** One command detects your AI client and installs the Opik skill pack.
- **Cloud or self-hosted:** Hosted OAuth server for Opik Cloud, local stdio server for self-hosted.

## Good for

- Ask which traces in a project failed today
- Score a trace for helpfulness with a written reason
- Find the slowest or costliest runs and what they share
- Add tracing to an app and confirm traces arrive

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.comet.com/opik/api/v1/mcp
```

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

```json
{
  "mcpServers": {
    "opik-mcp": {
      "url": "https://www.comet.com/opik/api/v1/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "opik-mcp": {
      "type": "http",
      "url": "https://www.comet.com/opik/api/v1/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "opik-mcp": {
      "serverUrl": "https://www.comet.com/opik/api/v1/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "opik-mcp": {
      "type": "http",
      "url": "https://www.comet.com/opik/api/v1/mcp"
    }
  }
}
```

## Tools

- `list`: List entities such as traces for a project.
- `write`: Write entities such as a trace score (score.create).

## FAQ

### Do I need an API key on Opik Cloud?

No. The hosted server signs you in through the browser and works in the workspace you pick.

### How do I use it with self-hosted Opik?

Run the local stdio server and set environment variables such as OPIK_URL, plus OPIK_API_KEY only if your deployment needs one.

### Which assistants does the setup command detect?

Claude Code, Cursor, VS Code Copilot, Codex and opencode.

### What does the setup need?

uv; no Opik SDK is required.

### Is Opik free?

Yes. Opik is open source, so you can use and self-host it for free.

### How do I add Opik to Claude Code?

Run this command in your terminal: claude mcp add --transport http opik-mcp https://www.comet.com/opik/api/v1/mcp

### What are the best alternatives to Opik?

The closest alternatives to Opik are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/opik
