# langfuse-mcp

Source: https://glimind.com/server/npm%2Flangfuse-mcp
Registry id: `npm/langfuse-mcp`
Status: unknown

## Install

```json
{
  "mcpServers": {
    "langfuse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "langfuse-mcp"
      ]
    }
  }
}
```

Claude Code:

```sh
claude mcp add langfuse-mcp -- npx -y langfuse-mcp
```

## Tools (27)

- `getComment`: Fetch a single comment by id.
- `getDailyMetrics`: Daily aggregated usage / cost / count metrics.
- `getDataset`: Fetch a dataset by name.
- `getDatasetItem`: Fetch a single dataset item by id.
- `getDatasetRun`: Fetch a specific dataset run by name.
- `getHealth`: Ping the Langfuse public health endpoint — useful for credential validation.
- `getMedia`: Fetch metadata for a media attachment (image, audio, file).
- `getMetrics`: Run a custom metrics query (counts, latency, cost, token usage). Pass a JSON query string.
- `getModel`: Fetch a model definition by id.
- `getObservation`: Fetch a single observation by id.
- `getPrompt`: Fetch a prompt by name, optionally pinned to a specific version or label.
- `getScore`: Fetch a single score by id.
- `getScoreConfig`: Fetch a score configuration by id.
- `getSession`: Fetch a session by id, including its traces.
- `getTrace`: Fetch a single trace by id including the full observation tree.
- `listComments`: List comments attached to traces, observations, sessions, or prompts.
- `listDatasetItems`: List items in a dataset (inputs, expected outputs, metadata).
- `listDatasetRuns`: List evaluation runs for a dataset.
- `listDatasets`: List datasets configured in Langfuse.
- `listModels`: List models known to Langfuse (for cost / token attribution).
- `listObservations`: List spans, generations, and events with filters.
- `listProjects`: List projects accessible to the current API key.
- `listPrompts`: List prompt definitions, optionally filtered by name, label, or tag.
- `listScoreConfigs`: List score configurations (definitions, ranges, categories).
- `listScores`: List scores with filters.
- `listSessions`: List sessions within a time range.
- `listTraces`: List traces with filters. Returns summary metadata.

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
