BACK TO MCP SERVERS
dataany

Opik

Read and score Opik traces, experiments, datasets and prompts from your AI assistant.

At a glance

Not tested yet
GitHub stars
226
Weekly downloads
1,316
Last commit
2026-11-18
Licence
Apache-2.0
Transport
stdio
Auth
api-key
Install
uvx opik-mcp
Stats checked 2026-11-19

What it does

Opik MCP server is the official Model Context Protocol server for Opik, an open-source LLM observability and evaluation platform built by Comet. It connects an AI host such as Claude Code, Cursor, VS Code Copilot, Codex or opencode to an Opik workspace so the assistant can read traces, log scores and save prompt versions from the chat. It is built for LLM engineers who already run Opik and want to drive it from the same AI assistant they code with.

Key features

  • Reads traces from Opik projects and reports them in the chat.
  • Logs scores on traces, with a value and a reason.
  • Saves prompt versions.
  • Works with Claude Code, Cursor, VS Code Copilot, Codex, opencode or any MCP client.
  • Supports Opik Cloud through a hosted server with browser sign-in and no API key.
  • Supports self-hosted Comet and open-source Opik through a local server over stdio.
  • A one-command installer registers the server, installs the Opik skill pack and checks the connection.

Quick start

Install uv once; it fetches the package and Python 3.13 if needed on first use.

curl -LsSf https://astral.sh/uv/install.sh | sh
brew install uv

Run the installer for your client. Without a terminal, name the client:

uvx opik@latest mcp configure --ai-client claude-code --skills

--ai-client also takes codex, cursor, vscode and opencode. Before adding the server to a client, check the settings with the same env and --check:

OPIK_URL=http://localhost:5173/api uvx opik-mcp@latest --check

Clients load MCP servers when a session starts, so start a new session afterwards.

Add this to .mcp.json in your project root (Claude Code) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "opik-mcp": {
      "command": "uvx",
      "args": [
        "opik-mcp"
      ],
      "env": {
        "OPIK_API_KEY": "YOUR_OPIK_API_KEY",
        "OPIK_WORKSPACE": "YOUR_OPIK_WORKSPACE",
        "OPIK_URL": "YOUR_OPIK_URL",
        "COMET_URL_OVERRIDE": "YOUR_COMET_URL_OVERRIDE"
      }
    }
  }
}

Replace each YOUR_ value with your own, and delete the variables you do not use.

Environment variables

  • OPIK_API_KEY: needed only where the deployment adds authentication, such as a self-hosted Comet platform.
  • OPIK_WORKSPACE: set to the segment after /opik/ in your Opik URL on a self-hosted Comet, which has named workspaces. Open-source Opik has one workspace, default, and needs none.
  • OPIK_URL: points the server at an open-source Opik, for example http://localhost:5173/api on this machine or https://<host>/api on a server.
  • COMET_URL_OVERRIDE: set to https://<host> for a self-hosted Comet platform whose Opik UI is at https://<host>/opik.

Example prompts

  • Which traces in project 'demo' failed today?
  • Score trace 7f2e 0.9 on helpfulness with reason 'great recovery'.
  • List my Opik projects.

What to watch out for

  • The server refuses a placeholder workspace such as <your-workspace> or ${input:OPIK_WORKSPACE}; a placeholder URL is sent as-is and fails to connect.
  • On a self-hosted Comet, leaving out OPIK_WORKSPACE makes reads come from your account's default workspace, with no error to say so.
  • COMET_URL_OVERRIDE would point the server at /opik/api, which open source does not serve.
  • A client can't confirm the settings before a new session: Claude Code shows Connected even with a wrong key, and Codex starts nothing until then.
  • Codex waits mcp_optional_startup_grace_ms (1 s by default) for servers before it builds the first tool list, so a slower start can leave the tools out of the first turn.
  • uvx opik-mcp@latest asks PyPI on every start, which adds about a second and a half.

Not tested by tools4agents yet. Read the source repository before you install it.

GitHub SourceGitHub Stars
Last verified 2026-11-18

Similar tools