Opik MCP Server: Setup for Claude, Cursor and Other Apps

• Shows one project, trace, prompt, dataset or experiment in full

  Fetches one record you name, such as a trace with its spans, a prompt with its versions, a dataset or an experiment. Long inner fields may be cut, and the answer says when they are.

  Try: “Show me trace 7f2e3c8a with all its spans.”

  Network · read

• Lists records of one kind, with name filters and paging

  Lists projects, traces, spans, threads, experiments and other records, with filters and paging. It helps find the ones worth reading in full.

  Try: “Which traces in project 'demo' failed today?”

  Network · list

• Logs traces, scores and comments, saves prompts, and manages datasets and experiments

  Changes your Opik workspace. Operations include logging traces and spans, attaching scores and comments, saving prompt versions, creating datasets and experiments, opening or closing threads, resolving Diagnostics issues and managing annotation queues.

  Try: “Score trace 7f2e3c8a 0.9 on helpfulness with the reason 'great recovery'.”

  Write · write

• Reads one of the Opik how-to skills bundled with the server

  Gives the assistant a bundled Opik skill, a short guide for tasks such as adding Opik tracing to code.

  Try: “Load the Opik skill for instrumenting my code.”

  Read · read_skill

• Used by the assistant behind the scenes

  Shows the exact fields a write needs before it is sent

  Looks up the shape of a write operation or the filters a list accepts, so the assistant builds a valid request. It makes no call to Opik.

  Try: “What fields does a score need?”

  Read · schema

Watch out for

• It can change your Opik data

  One tool can log traces, add scores, save prompt versions and close or resolve Diagnostics issues. The docs tell the assistant to ask you before resolving or closing an issue. github.com

• An open-source Opik has no login

  The README says the open-source backend does not authenticate requests. Keep the server on its default local address and use stdio. github.com

• Wrong workspace can go unnoticed

  On a self-hosted Comet, leaving the workspace unset reads from your default workspace without an error. Set it to the name in your Opik URL. github.com

• Telemetry is on by default

  The README lists settings to turn off the analytics and error reporting. github.com

Security advisories