# Fanout

Fanout ingests OpenTelemetry traces, logs, and metrics, then exposes investigation tools, dashboards, and alerts to an MCP client.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: labstack
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/labstack/fanout
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/fanout

## What it does

Fanout accepts OTLP over gRPC and HTTP and keeps traces, logs, and metrics together. Telemetry is stored in Parquet, DuckDB handles analytical queries, and SQLite keeps transactional product state. The same binary includes the investigation agent, MCP server, browser client, dashboards, and alerts.

An MCP client connects to Fanout through an externally reachable HTTPS origin and its `/mcp` endpoint. OAuth handles client registration and scope approval. The client must support MCP `2026-07-28` over stateless Streamable HTTP. Chat needs either `ANTHROPIC_API_KEY` with the Anthropic provider or `OPENAI_API_KEY` with the OpenAI provider.

Fanout runs as a single node with no clustering, replication, or object tier. A deployment that outgrows one machine’s disk or CPU has outgrown Fanout. The project is pre-release and changes without migration paths, so that constraint matters before deployment.

## Requirements
- Remote server: `https://{fanout_host}/mcp`

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http fanout https://{fanout_host}/mcp
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add fanout --url https://{fanout_host}/mcp
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "fanout": {
            "url": "https://{fanout_host}/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "fanout": {
            "type": "http",
            "url": "https://{fanout_host}/mcp"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http fanout https://{fanout_host}/mcp
```

## When to use it
- investigate service errors through traces
- keep logs, metrics, and traces in one store
- ask an agent questions about telemetry
- build dashboards for service signals
- trigger alerts for latency and error rate

## Example prompts
- Investigate the rise in errors and latency for this service using Fanout traces and metrics.
- Show logs and related traces for requests reaching the `checkout` service.
- Create a dashboard for this service with throughput, latency, and error rate.

## Similar
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Oh My Posh Validator](https://affpapa.org/en/nevibecode/mcp/oh-my-posh-validator.md) — MCP server · ★ 23654
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18779
- [Coder](https://affpapa.org/en/nevibecode/mcp/coder.md) — MCP server · ★ 17191
- [mcp](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — MCP server · ★ 12110

## Other versions with the same name
- [fanout · houtini-ai](https://affpapa.org/en/nevibecode/mcp/houtini-ai-fanout.md) — ★ 13

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md