Opik MCP Server

by comet-mlio.github.comet-ml/opik-mcpv3.0.5

MCP server to talk to your Opik cloud or open-source instance to query and analyze LLM traces, metrics and observability.

220Pythonstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active1d ago

Install Opik MCP server

claude mcp add opik -e OPIK_API_KEY='<opik-api-key>' -- uvx opik-mcp

{
  "mcpServers": {
    "opik": {
      "command": "uvx",
      "args": [
        "opik-mcp"
      ],
      "env": {
        "OPIK_API_KEY": "<opik-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "opik": {
      "command": "uvx",
      "args": [
        "opik-mcp"
      ],
      "env": {
        "OPIK_API_KEY": "<opik-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "opik": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "opik-mcp"
      ],
      "env": {
        "OPIK_API_KEY": "<opik-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "opik": {
      "command": "uvx",
      "args": [
        "opik-mcp"
      ],
      "env": {
        "OPIK_API_KEY": "<opik-api-key>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
OPIK_API_KEY	—	yes	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 <url>/opik/api.

Remote endpoints

streamable-httphttps://www.comet.com/opik/api/v1/mcp

Freshness

Active — last maintenance signal 1d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 1d ago · GitHub
Latest release
2026-10-08 · 1d ago · GitHub · 3.0.5
Package published
no data · npm/PyPI
Registry entry updated
2026-10-08 · 1d ago · official registry · v3.0.5

FAQ

›How do I install the Opik MCP server in Claude Code?

Run: claude mcp add opik -e OPIK_API_KEY='<opik-api-key>' -- uvx opik-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Opik require an API key?

Yes. It expects OPIK_API_KEY, of which 1 is a secret.

›Can I use Opik as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Opik in the official MCP registry?

Yes, as io.github.comet-ml/opik-mcp.