# langfuse-mcp

> A Model Context Protocol (MCP) server for Langfuse, enabling AI agents to query Langfuse trace data for enhanced debugging and observability

- **URL**: https://www.freshcrate.ai/projects/langfuse-mcp
- **Author**: avivsinai
- **Category**: MCP Servers
- **Latest version**: `v0.9.1` (2026-05-06)
- **License**: MIT
- **Source**: https://github.com/avivsinai/langfuse-mcp
- **Language**: Python
- **GitHub**: 80 stars, 21 forks
- **Registry**: github
- **Tags**: `agent-skills`, `ai-agents`, `claude-code`, `codex`, `developer-tools`, `genai`, `langfuse`, `llm`, `python`

## Description

A Model Context Protocol (MCP) server for Langfuse, enabling AI agents to query Langfuse trace data for enhanced debugging and observability

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.9.1` | 2026-05-06 | High | ## [0.9.1] - 2026-05-06 ### Changed - Re-enabled Python 3.14 support now that the supported Langfuse SDK range includes v4, which uses Pydantic v2; CI now covers Python 3.10 through 3.14. |
| `v0.9.0` | 2026-04-29 | High | ## [0.9.0] - 2026-04-29 ### Changed - Allow `langfuse>=4.0.0,<5.0.0` alongside the existing `>=3.11.2,<4.0.0` range so projects can pin langfuse-mcp without blocking the v4.x SDK upgrade (closes #40). - Added a small capability-based shim (`langfuse_mcp/_compat.py`) so MCP tool calls auto-select the right SDK surface across SDK versions:   - Score list/get routing now follows the `api.scores` (v4) ↔ `api.score_v_2` (v3) rename, and the v4 method rename `get` → `get_many`. Score creation tools ar |
| `v0.7.0` | 2026-04-26 | High | ## [0.7.0] - 2026-04-26 ### Added - Added `--default-output-mode` and `LANGFUSE_MCP_DEFAULT_OUTPUT_MODE` so MCP tool schemas can default to `compact`, `full_json_string`, or `full_json_file` when clients omit `output_mode`.  ### Fixed - Consolidated PyPI, Docker, and skill publishing into the release workflow so they no longer depend on tag-push events that `GITHUB_TOKEN` cannot trigger. - Pinned all GitHub Actions to commit SHAs across every workflow for supply-chain safety. - Added missing `pe |
| `v0.6.5` | 2026-04-02 | Medium | ## [0.6.5] - 2026-04-02 ### Changed - Switched releases to the shared PR-based `scripts/release.sh` flow, with `CHANGELOG.md` supplying the GitHub release notes and CI creating the version tag only after the merged release commit verifies.  ### Fixed - Pinned release verification and build to Python 3.12 so release automation no longer drifts onto unsupported Python 3.14 toolchains. - Ignored `dist/.gitignore` during local release artifact verification so release prep now checks the same wheel a |
| `v0.6.4` | 2026-04-01 | Medium | **Full Changelog**: https://github.com/avivsinai/langfuse-mcp/compare/v0.6.3...v0.6.4 |
| `v0.6.3` | 2026-04-01 | Medium | **Full Changelog**: https://github.com/avivsinai/langfuse-mcp/compare/v0.6.2...v0.6.3 |
| `v0.6.2` | 2026-04-01 | Medium | **Full Changelog**: https://github.com/avivsinai/langfuse-mcp/compare/v0.6.1...v0.6.2 |
| `v0.5.3` | 2026-03-29 | Medium | ## What's Changed * chore: OSS polish - templates, SECURITY.md, keywords, type checking by @avivsinai in https://github.com/avivsinai/langfuse-mcp/pull/15   **Full Changelog**: https://github.com/avivsinai/langfuse-mcp/compare/v0.5.2...v0.5.3 |
| `v0.5.2` | 2026-02-08 | Low | ### Fixed  - **Fix `get_session_details` 500 error** (#13) — ClickHouse rejected epoch-zero (1970-01-01) as a `DateTime64(3)` filter parameter. Now omits the time filter for session/trace ID lookups.   - Same fix applied to `get_exception_details` (latent bug, same pattern)   - Thanks to @guys-arpeely for reporting!  - **Fix operator precedence bug in exception tracking** — `obs_id` was always `None` for SDK objects (non-dict) in `_efficient_fetch_observations`, silently dropping observations fr |
| `v0.5.1` | 2026-01-27 | Low | ### Fixed  - Fixed `claude mcp add` command syntax in README (#12)   - Environment variable flags (`-e`) must come before other options like `--scope` due to a CLI parser bug in Claude Code   - Thanks to @BhanutejaTR for reporting!  ### Technical Details  When other options precede `-e`/`--env` in Claude Code's CLI, the parser incorrectly consumes the server name as an env var value. The fix moves `-e` flags to the beginning of the command. |

## Citation

- HTML: https://www.freshcrate.ai/projects/langfuse-mcp
- Markdown: https://www.freshcrate.ai/projects/langfuse-mcp.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/langfuse-mcp/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._