MCP.so
Sign In

Langfuse MCP (MCP)

@avivsinai

Basic information

Category

Other

License

MIT

Transports

stdio

Author

avivsinai

About Langfuse MCP

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

Langfuse MCP config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "langfuse-mcp": {
      "command": "npx",
      "args": [
        "skills",
        "add",
        "avivsinai/langfuse-mcp",
        "-g",
        "-y"
      ]
    }
  }
}

Langfuse MCP tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Langfuse MCP?

Langfuse MCP is an agent-facing Model Context Protocol server and skill for Langfuse observability. It lets AI agents query traces, inspect generations, debug exceptions, analyze sessions, manage prompts, browse datasets, and understand what agents did in production.

How to use Langfuse MCP?

Install via uvx langfuse-mcp with Python 3.10+ and the uv runtime. Set environment variables LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEY, and LANGFUSE_HOST (defaults to Langfuse Cloud). Add the server to an MCP client (Claude Code, Codex, Cursor) using the provided configuration commands or JSON files. Start the MCP client, then invoke tools directly or use the included agent skill for ready‑made debugging playbooks.

Key features of Langfuse MCP

  • 48 tools covering traces, observations, sessions, exceptions, prompts, datasets, annotation queues, scores, metrics, and schema.
  • Selective tool loading via --tools flag to reduce token overhead.
  • Read‑only mode (--read-only) disables all write operations.
  • Default output mode (--default-output-mode) for compact, full JSON string, or file output.
  • Support for HTTP transport with per‑project credentials via Authorization header.
  • Included agent skill with playbooks for trace debugging, exception triage, latency analysis, prompt management, and dataset work.

Use cases of Langfuse MCP

  • Debug failing agent runs by querying Langfuse traces and observations.
  • Find exceptions, slow generations, high‑latency spans, and affected users.
  • Inspect sessions and user journeys without leaving the agent workflow.
  • Manage prompt versions, labels, datasets, annotation queues, and scores.
  • Answer questions like “what failed?”, “why was this slow?”, or “which prompt version ran?”

Frequently asked questions

1

How does Langfuse MCP differ from the native Langfuse MCP?

Langfuse MCP is a local, debugging‑first server with compact trace inspection, exception triage, session analysis, and route‑decision tools. It does not mirror every native MCP tool; the native MCP is a hosted endpoint with a broader API surface.

2

What are the runtime requirements?

Python 3.10–3.14 and the `uv` package runner (for `uvx`). The server is verified on CI for those Python versions.

3

Can I load only specific tools?

Yes. Use `langfuse-mcp --tools traces,prompts` to load only the tool groups you need. Available groups include traces, observations, routing, sessions, exceptions, prompts, datasets, annotation_queues, scores, metrics, and schema.

4

Is there a read‑only mode?

Yes. Start with `langfuse-mcp --read-only` or set `LANGFUSE_MCP_READ_ONLY=true` to disable all write operations (e.g., creating prompts, datasets, annotation queue items).

5

How do I use Langfuse MCP with multiple Langfuse projects?

Run the server in HTTP transport mode with `--transport streamable-http`. Each MCP client passes its project credentials as a `Basic` `Authorization` header (base64(public_key:secret_key)). An absent header falls back to the server’s startup environment credentials.

Comments

More Other MCP servers