Comet Opik MCP Server

Query and analyze your Opik logs, traces, prompts and all other telemtry data from your LLMs in natural language.

Remote serverstreamable-httpPython

What is the Comet Opik MCP Server?

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.

What Comet Opik does

Built for LLM engineers who already run Opik and want to drive it from the same AI assistant they code with.

Practical notes

  • Written in Python.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
readOne 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
listBrowse a collection with optional name filter and pagination. Project-scoped types (trace, test_suite_item, prompt_version) require their parent UUID.
ask_ollieFor 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
writeUniversal write dispatcher. Pass operation + data and the dispatcher validates the payload, applies the right REST verb, and returns the backend response.
schemaInspect 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_experimentRun 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

How to install the Comet Opik MCP Server

claude mcp add opik --env OPIK_API_KEY=your-value --env OPIK_WORKSPACE=your-value --env COMET_URL_OVERRIDE=your-value --env OPIK_MCP_ANALYTICS_SOURCE=your-value --env OPIK_URL=your-value --env COMET_WORKSPACE_ID=your-value --env OPIK_MCP_HOST=your-value --env OPIK_MCP_AS_URL=your-value -- npx -y opik-mcp

Configuration

VariableDescriptionRequired
OPIK_API_KEYCredential the server authenticates with.Yes
OPIK_WORKSPACEConfiguration value read at startup.Optional
COMET_URL_OVERRIDEEndpoint or connection string the server talks to.Yes
OPIK_MCP_ANALYTICS_SOURCEConfiguration value read at startup.Optional
OPIK_URLEndpoint or connection string the server talks to.Yes
COMET_WORKSPACE_IDConfiguration value read at startup.Optional
OPIK_MCP_HOSTEndpoint or connection string the server talks to.Optional
OPIK_MCP_AS_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • “Use Comet Opik to Cursor.”
  • “Use Comet Opik to read.”
  • “Use Comet Opik to list.”

Frequently asked questions

Query and analyze your Opik logs, traces, prompts and all other telemtry data from your LLMs in natural language. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.