Query and analyze your Opik logs, traces, prompts and all other telemtry data from your LLMs in natural language.
Comet opik mcp server lets Claude, Cursor and other MCP clients work with Comet Opik directly. Query and analyze your Opik logs, traces, prompts and all other telemtry data from your LLMs in natural language.
Built for LLM engineers who already run Opik and want to drive it from the same AI assistant they code with.
Once connected, the assistant can call these 8 tools directly:
Cursor — Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json (project), or open Cmd+Shift+J → Features → Model Context Protocol:read — One tool for any "show me X" question. Takes an entity_type plus an id (UUID or, for nameable types, a name) or a full opik:// URI. Composite reads (tracelist — Browse a collection with optional name filter and pagination. Project-scoped types (trace, test_suite_item, prompt_version) require their parent UUIDask_ollie — For investigative questions, cross-entity synthesis, or anything that needs Opik domain expertise. Ollie has direct read access to your workspace and canwrite — Universal write dispatcher. Pass operation + data and the dispatcher validates the payload, applies the right REST verb, and returns the backend responseschema — Inspect the exact JSON shape and required fields of any write operation before you call it — useful when you're not sure what data should look like. Returnsrun_experiment — Run an evaluation experiment end-to-end via Ollie. Takes a single experiment_config dict that mirrors Opik's experiment shape (prompt, test suite, scorers)Telemetry — Anonymous usage events (event type + timing only — no query content). A SHA-256 digest of your API key is included so support can find your account; the rawThe server is distributed via npm as opik-mcp, so most clients can run it without a manual build step. Add it to your MCP client's configuration and restart the client to pick it up — the copy-paste configs for Claude Desktop, Claude Code and Cursor are on this page.
Before the server will start you need to supply 8 environment variables: OPIK_API_KEY, OPIK_WORKSPACE, COMET_URL_OVERRIDE, OPIK_MCP_ANALYTICS_SOURCE, OPIK_URL, COMET_WORKSPACE_ID, OPIK_MCP_HOST, OPIK_MCP_AS_URL. Keep credentials in your client's env block or a secrets manager rather than committing them.
Developer-tool servers are usually the first ones people connect, because they turn "help me with this code" into an assistant that can actually read the repo and act on it. Comet Opik sits in that group, and the shape of its toolset — Cursor, read, list among others — tells you what it is really for. Worth comparing against the other developer tools servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.
| Tool | What it does |
|---|---|
| Cursor | Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json (project), or open **Cmd+Shift+J → Features → Model Context Protocol**: |
| read | One tool for any "show me X" question. Takes an entity_type plus an id (UUID or, for nameable types, a name) or a full opik:// URI. Composite reads (trace, prompt) inline their children so a single call returns the full |
| list | Browse a collection with optional name filter and pagination. Project-scoped types (trace, test_suite_item, prompt_version) require their parent UUID. |
| ask_ollie | For investigative questions, cross-entity synthesis, or anything that needs Opik domain expertise. Ollie has direct read access to your workspace and can execute writes (scores, comments, test-suite items, prompt version |
| write | Universal write dispatcher. Pass operation + data and the dispatcher validates the payload, applies the right REST verb, and returns the backend response. |
| schema | Inspect the exact JSON shape and required fields of any write operation before you call it — useful when you're not sure what data should look like. Returns the schema, OAuth scope, and one validated example. Pure lookup |
| run_experiment | Run an evaluation experiment end-to-end via Ollie. Takes a single experiment_config dict that mirrors Opik's experiment shape (prompt, test suite, scorers); Ollie executes the run and writes results back as an Opik exper |
| Telemetry | Anonymous usage events (event type + timing only — no query content). A SHA-256 digest of your API key is included so support can find your account; the raw key never leaves the process. **Opt out:** OPIK_MCP_ANALYTICS_E |
Or edit `~/.claude.json` directly:
```json
{
"mcpServers": {
"opik-mcp": {
"type": "stdio",
"command": "uvx",
"args": ["opik-mcp"],
"env": {
"OPIK_API_KEY": "<your-key>",
"OPIK_WORKSPACE": "<your-workspace>"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| OPIK_API_KEY | Credential the server authenticates with. | Yes |
| OPIK_WORKSPACE | Configuration value read at startup. | Optional |
| COMET_URL_OVERRIDE | Endpoint or connection string the server talks to. | Yes |
| OPIK_MCP_ANALYTICS_SOURCE | Configuration value read at startup. | Optional |
| OPIK_URL | Endpoint or connection string the server talks to. | Yes |
| COMET_WORKSPACE_ID | Configuration value read at startup. | Optional |
| OPIK_MCP_HOST | Endpoint or connection string the server talks to. | Optional |
| OPIK_MCP_AS_URL | Endpoint or connection string the server talks to. | Yes |
Read-only SQL access to Postgres — let your assistant inspect schemas and answer questions from real data.
Manage your whole Supabase project in conversation — database, auth, storage, Edge Functions and branches.
Query, modify and analyse local SQLite databases in conversation — the fastest way to chat with a data file.
Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.
Official MongoDB server covering data, schemas and Atlas management — from find queries to spinning up clusters.
Serverless Postgres with database branching — point your assistant at Neon and let it work on disposable copies.