Skip to content
MCP server

Opik

Read Opik traces, score them and save prompts from your coding assistant

Install
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally or Remotely
Version
3.0.9
Listing updated
3 days ago

About Opik

Opik is an open-source MCP server for ai models and llm tooling. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://www.comet.com/opik/api/v1/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "opik-mcp": {
      "url": "https://www.comet.com/opik/api/v1/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • OPIK_API_KEYOpik API key, for Opik Cloud and self-hosted Comet. Leave unset for open-source Opik.
  • OPIK_WORKSPACEWorkspace name: the segment after comet.com/opik/ in your Opik URL. Leave unset for open-source Opik.
  • OPIK_URLOpik REST API base, for open-source Opik.
  • COMET_URL_OVERRIDEBase URL of a self-hosted Comet platform; Opik's API is <url>/opik/api.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Open-source server; Opik Cloud and self-hosted Comet plans not described here

Prices change. Check comet.com before you buy.

Opik 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 to Opik

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools