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
uvx opik-mcp
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 examplehttp://localhost:5173/apion this machine orhttps://<host>/apion a server.COMET_URL_OVERRIDE: set tohttps://<host>for a self-hosted Comet platform whose Opik UI is athttps://<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_WORKSPACEmakes reads come from your account's default workspace, with no error to say so. COMET_URL_OVERRIDEwould 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@latestasks 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.
Similar tools
Memory
A knowledge graph that persists facts across sessions, so an agent can recall context after the conversation ends.
DBHub
Token-efficient MCP server for PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, ClickHouse, SQLite
PostgreSQL
Read only SQL access with schema introspection, so an agent can answer questions about your data without guessing column names.
Supabase MCP Server
Connects AI assistants directly to Supabase projects to manage database tables, query data, run migrations, and control edge functions.