Skip to content
MCP server

Loggerhead

Let a coding agent read the logs, metrics and traces of the app running on your Mac

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
macOS, CLI
Runs
Locally
Version
1.12.0
Listing updated
2 days ago

About Loggerhead

Loggerhead is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Loggerhead is a native macOS app that receives OpenTelemetry data from software on your own machine and stores it in a local DuckDB file. This MCP bridge connects a coding agent to that store, so when a local endpoint returns errors the agent can search the logs, open the matching trace and see which span timed out before it proposes a fix. The app hosts the endpoint on loopback only, nothing leaves the Mac, and the app must be installed and running or the bridge exits.

Beyond reading telemetry, seven tools change a workspace's lint rules, each with a reason the user sees and can undo in the app, and one marks a lint finding fixed after a code change. The lint findings cover things like noisy logs, unbounded labels, secrets and lost trace context. Telemetry can be pushed in over OTLP from Docker, Kubernetes, another Mac or an app's SDK, or pulled from a Prometheus metrics URL.

It installs as a Claude Desktop extension bundle or a stdio command for Claude Code, Cursor, Codex and Windsurf. The app needs macOS 15 or later and the README says the free tier includes the MCP server.

Install

Run in a terminal

claude mcp add loggerhead -- npx -y https://github.com/rubics-code/loggerhead-mcp/releases/download/v1.12.0/loggerhead-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "loggerhead": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/rubics-code/loggerhead-mcp/releases/download/v1.12.0/loggerhead-mcp.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "loggerhead": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/rubics-code/loggerhead-mcp/releases/download/v1.12.0/loggerhead-mcp.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "loggerhead": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/rubics-code/loggerhead-mcp/releases/download/v1.12.0/loggerhead-mcp.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "loggerhead": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/rubics-code/loggerhead-mcp/releases/download/v1.12.0/loggerhead-mcp.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "loggerhead": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/rubics-code/loggerhead-mcp/releases/download/v1.12.0/loggerhead-mcp.mcpb"
      ]
    }
  }
}

Tools this server provides (17)

Taken from the project documentation; the running server may differ.

query_logs
Search log records by text, severity and time.
query_metrics
Read time-series metrics by name and time range.
query_traces
Find traces by service, operation, duration and time.
get_trace
Read every span of one trace.
list_environments
List every workspace and environment with receiver ports.
get_receiver_info
Report effective OTLP ports and addresses.
query_improvements
List telemetry-lint findings.
list_lint_rules
List lint rules of a workspace with state and thresholds.
query_ai_findings
List findings of the last AI analysis run.
set_lint_rule_enabled
Switch a lint rule on or off, with a reason.
set_lint_threshold
Set a lint rule threshold, with a reason.
reset_lint_threshold
Restore a threshold to default, with a reason.
add_lint_exception
Hide findings of a rule for a service, metric, attribute, operation or message.
remove_lint_exception
Remove a lint rule exception.
ignore_finding
Ignore one lint finding by id.
unignore_finding
Stop ignoring a lint finding.
mark_finding_fixed
Mark a finding fixed after a code change.

What it does

Log search
Query logs by text, severity and time.
Trace inspection
Find traces by service, operation or duration and read every span.
Metric queries
Read time-series metrics by name and range.
Telemetry linting
List findings such as noisy logs, secrets and lost trace context.
Reversible rule changes
Adjust lint rules with a stated reason the user can undo.
Local only
Endpoint binds to 127.0.0.1 and data stays on the Mac.

Good for

  • Ask an agent to explain a local 500 error using real logs
  • Trace a slow request through its spans
  • Check what a service logged just before a failure
  • Clean up noisy telemetry before shipping to production
  • Mark a lint finding fixed after a code change

Pricing

Freemium

Free to start; the free tier includes the MCP server; paid tiers not detailed

Prices change. Check getloggerhead.com before you buy.

Loggerhead FAQ

Does any data leave my Mac?

The README and site say the endpoint is loopback only and nothing leaves the machine.

Does the app need to be running?

Yes. The bridge exits when the Loggerhead app is not running.

Which clients can connect?

Claude Desktop via an extension bundle, plus Claude Code, Cursor, Codex, Windsurf and other stdio clients.

Is it free?

The README says the free tier includes the MCP server; the site says the app is free to start.

Which systems does it run on?

macOS 15 or later, Apple silicon and Intel.

Is Loggerhead free?

Loggerhead has a free plan, with paid plans for more usage or features.

How do I add Loggerhead to Claude Code?

Run this command in your terminal: claude mcp add loggerhead -- npx -y https://github.com/rubics-code/loggerhead-mcp/releases/download/v1.12.0/loggerhead-mcp.mcpb

What are the best alternatives to Loggerhead?

The closest alternatives to Loggerhead are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Loggerhead

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools