Skip to content
appsgit

Opik

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.

github.com/comet-ml/opik-mcp (opens in a new tab)

Install Opik

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.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

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

Cursor

.cursor/mcp.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
{
  "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)

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 Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
OPIK_API_KEYsecretNoOpik API key, for Opik Cloud and self-hosted Comet. Leave unset for open-source Opik.
OPIK_WORKSPACENoWorkspace name: the segment after comet.com/opik/ in your Opik URL. Leave unset for open-source Opik.
OPIK_URLNoOpik REST API base, for open-source Opik.
COMET_URL_OVERRIDENoBase URL of a self-hosted Comet platform; Opik's API is /opik/api.

Tools (22)

Parsed from the Tools section of the README; check the repository for the current list.

  • 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

About Opik

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.

  • mcp-server
  • claude-code
  • llm-observability
  • mcp
  • model-context-protocol
  • opik
  • python
  • generative-ai

FAQ

Opik FAQ

Still curious? Email info@appsgit.com.

What is Opik?

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 source code is at github.com/comet-ml/opik-mcp.

How do I install the Opik MCP server?

Add the command uvx opik-mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Opik free?

The server is open source under the Apache-2.0 license, so running it is free. It needs credentials (OPIK_API_KEY) for the service it connects to, which may require a paid account.

Is Opik actively maintained?

The most recent commit was on Oct 6, 2026. The latest release is 3.0.0, published Oct 5, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.