← Explore all mcp servers

LLM OBSERVABILITY / Helicone

Helicone MCP Server

Connects an assistant to Helicone request logs and sessions, and can send new LLM requests through the Helicone AI Gateway. It runs locally over stdio via the published npm package with a Helicone API key.

“A Model Context Protocol (MCP) server for querying Helicone observability platform data and making LLM requests through the Helicone AI Gateway.”

01 / THE REASONING

Why this made the selection.

  • Publisher-maintained observability surface: query_requests and query_sessions filter logged traffic by model, status, cost, latency and time without leaving the assistant.
  • Ships as a versioned npm package with a documented stdio configuration at the pinned revision.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • helicone-mcp/README.md at 067d9290acb4f1fc9320e902fc67b4b399b50363: tools (use_ai_gateway, query_requests, query_sessions), stdio configuration and required API key.
  • Package manifest: runtime and published entrypoint at the pinned revision.
  • LICENSE: Apache-2.0 terms for the repository source.

Our findings

  • The documented configuration is stdio-only via npx with the API key passed as an environment variable.
  • Corrected 2026-10-13: the README lists three tools, use_ai_gateway, query_requests and query_sessions. use_ai_gateway makes LLM requests through the Helicone AI Gateway, so the earlier statement that the server sends no model requests was wrong.
  • The configExample shows YOUR_HELICONE_API_KEY where the README block prints an example key value. It is otherwise the README block as printed.
  • helicone-mcp/package.json at this commit names @helicone/mcp, matching the install command. HEAD on 2026-10-13 equals the pinned commit.

Not established by this review

  • Server startup, authentication and tool execution were not tested.
  • use_ai_gateway was not called; no model request was sent.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Connect a server deliberately.

Upstream setup instructions ↗

DOCUMENTED COMMAND

npx @helicone/mcp@latest

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

  1. Add the documented stdio configuration to the MCP client with the Helicone API key in the environment.
  2. Confirm the key reaches only the intended Helicone project before querying logs.
  3. The command above is the command and args of the README’s stdio block (npx with @helicone/mcp@latest), not a separate installer. It was not run.

Before you start

  • Node.js with npx available.
  • A Helicone API key with access to the target project.

Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

{
  "mcpServers": {
    "helicone": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@helicone/mcp@latest"
      ],
      "env": {
        "HELICONE_API_KEY": "YOUR_HELICONE_API_KEY"
      }
    }
  }
}

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/Helicone/helicone/blob/067d9290acb4f1fc9320e902fc67b4b399b50363/helicone-mcp/README.md

    Supports: summary, install, compatibility, access, transports, configExample, whySelected, bestFor, limitations, upstreamDescription, Tool list including use_ai_gateway, includeBodies option of query_requests, Filter fields of query_requests and query_sessions

  2. Repository licence ↗Checked

    https://github.com/Helicone/helicone/blob/067d9290acb4f1fc9320e902fc67b4b399b50363/LICENSE

    Supports: license

  3. https://github.com/Helicone/helicone/blob/067d9290acb4f1fc9320e902fc67b4b399b50363/helicone-mcp/package.json

    Supports: Package name @helicone/mcp, Published entrypoint build/index.js

Evidence & Ask