An MCP server that exposes the Langfuse REST API as tools, so Claude (or any MCP client) can query your traces, observations, sessions, scores, prompts, datasets, and metrics during a conversation.
Langfuse Mcp is an MCP project maintained in the hugoles/langfuse-mcp repository. The maintainer describes its purpose as “An MCP server that exposes the Langfuse REST API as tools, so Claude (or any MCP client) can query your traces, observations, sessions, scores, prompts…”. Read the project documentation for the complete scope.
The documented npm package is langfuse-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.
The example declares LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEY, LANGFUSE_BASE_URL. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| listTraces | List traces with filters. Returns summary metadata. |
| getTrace | Fetch a single trace by id including the full observation tree. |
| listObservations | List spans, generations, and events with filters. |
| getObservation | Fetch a single observation by id. |
| listSessions | List sessions within a time range. |
| getSession | Fetch a session by id, including its traces. |
| listScores | List scores with filters. |
| getScore | Fetch a single score by id. |
| listScoreConfigs | List score configurations (definitions, ranges, categories). |
| getScoreConfig | Fetch a score configuration by id. |
| listPrompts | List prompt definitions, optionally filtered by name, label, or tag. |
| getPrompt | Fetch a prompt by name, optionally pinned to a specific version or label. |
| listDatasets | List datasets configured in Langfuse. |
| getDataset | Fetch a dataset by name. |
| listDatasetItems | List items in a dataset (inputs, expected outputs, metadata). |
| getDatasetItem | Fetch a single dataset item by id. |
| listDatasetRuns | List evaluation runs for a dataset. |
| getDatasetRun | Fetch a specific dataset run by name. |
| getMetrics | Run a custom metrics query (counts, latency, cost, token usage). Pass a JSON query string. |
| getDailyMetrics | Daily aggregated usage / cost / count metrics. |
| listModels | List models known to Langfuse (for cost / token attribution). |
| getModel | Fetch a model definition by id. |
| listProjects | List projects accessible to the current API key. |
| listComments | List comments attached to traces, observations, sessions, or prompts. |
| getComment | Fetch a single comment by id. |
| getMedia | Fetch metadata for a media attachment (image, audio, file). |
| getHealth | Ping the Langfuse public health endpoint — useful for credential validation. |
{
"mcpServers": {
"langfuse": {
"command": "npx",
"args": [
"-y",
"langfuse-mcp"
],
"env": {
"LANGFUSE_PUBLIC_KEY": "YOUR_LANGFUSE_PUBLIC_KEY",
"LANGFUSE_SECRET_KEY": "YOUR_LANGFUSE_SECRET_KEY",
"LANGFUSE_BASE_URL": "https://cloud.langfuse.com"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| LANGFUSE_PUBLIC_KEY | Declared in the maintainer’s client configuration. | Yes |
| LANGFUSE_SECRET_KEY | Declared in the maintainer’s client configuration. | Yes |
| LANGFUSE_BASE_URL | Declared in the maintainer’s client configuration. | Yes |
Give your coding agent the full DevTools toolbox: traces, network, console, heap snapshots and Lighthouse.
Workers, KV, R2 and D1 by conversation — Cloudflare's official remote servers for building and observability.
Scout your MongoDB databases with AI - safety features, live monitoring, and data quality
LastSaaS is a complete, production-ready SaaS foundation built entirely through conversation with [Claude Code](https://claude.ai/claude-code). It
An MCP (Model Context Protocol) server that connects your AI Assistant or Agent to your Linode cloud infrastructure allowing you to manage your cloud resources through natural conversation. Built…
A focused Model Context Protocol (MCP) server that provides comprehensive NBA player statistics from basketball-reference.com. This server