Loggerhead
Let a coding agent read the logs, metrics and traces of the app running on your Mac
- 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.mcpbAdd 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"
]
}
}
}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"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools