# Flowlines

Track how people use your MCP servers, which sessions fail and which intents changed after a release. Flowlines connects to your workspace and records telemetry from instrumented MCP servers.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: flowlines-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/flowlines-ai/plugins
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/flowlines

## What it does

Flowlines is an observability platform for MCP servers. The MCP server connects your client (Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI or others) to a Flowlines workspace at `https://api.flowlines.ai/mcp`. From there you see how tools are called, what results return, and where sessions break.

Four built-in skills handle different jobs: weekly reviews of what changed, before-and-after release comparisons, investigation of a failing session from a signal or complaint, and user cohort building by rule. The `flowlines-doctor` skill diagnoses connection issues and incomplete telemetry from MCP servers, LangSmith, Langfuse, and OTLP apps.

Start by running `onboarding` — it returns an instrumentation plan. Your API key is created once on the Flowlines setup page and shown only there; never paste it into chat. An instrumented MCP server ships tool arguments, client-visible results, and user metadata. You choose what to record on the initialization page.

## Requirements
- Remote server: `https://api.flowlines.ai/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http flowlines https://api.flowlines.ai/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add flowlines --url https://api.flowlines.ai/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "flowlines": {
            "url": "https://api.flowlines.ai/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "flowlines": {
            "type": "http",
            "url": "https://api.flowlines.ai/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http flowlines https://api.flowlines.ai/mcp
```

## When to use it
- see which MCP server tools fail and where sessions break
- compare MCP server outcomes and costs before and after release
- trace a failing session from a signal down to the broken turn
- segment users by rule and measure the cohort against baseline

## Example prompts
- Get an instrumentation plan: `/flowlines:onboarding`
- See what changed this week: `/flowlines:flowlines-weekly-review`
- Investigate why a session failed: `/flowlines:flowlines-investigate-session`

## Similar
- [cargo-observability](https://affpapa.org/en/nevibecode/skills/cargo-observability.md) — skill · 7900 installs
- [dashboard](https://affpapa.org/en/nevibecode/skills/dashboard.md) — skill · ★ 937 repo stars
- [logfire](https://affpapa.org/en/nevibecode/plugins/logfire.md) — plugin · ★ 156 repo stars
- [dash0](https://affpapa.org/en/nevibecode/plugins/dash0.md) — plugin · ★ 6 repo stars
- [monitoring-observability](https://affpapa.org/en/nevibecode/skills/akillness-monitoring-observability.md) — skill · 371 installs
- [datadog](https://affpapa.org/en/nevibecode/plugins/datadog-datadog.md) — plugin · ★ 8052 repo stars

---
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
