Langfuse MCP Server

Local MCP server and skill for Langfuse. Debug traces, sessions, and exceptions from Claude Code, Codex, Cursor, or any MCP client.

Local serverstdio

What is the Langfuse MCP Server?

Langfuse MCP (Model Context Protocol) is an MCP project maintained in the avivsinai/langfuse-mcp repository. The maintainer describes its purpose as “Local MCP server and skill for Langfuse. Debug traces, sessions, and exceptions from Claude Code, Codex, Cursor, or any MCP client”. Read the project documentation for the complete scope.

Installation

The documented pypi package is langfuse-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEY, LANGFUSE_HOST, LANGFUSE_MCP_DEFAULT_OUTPUT_MODE. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
CategoryTools
Tracesfetch_traces, fetch_trace
Observationsfetch_observations, fetch_observation
Routingfind_route_decisions, get_route_decision, summarize_route_decisions, find_low_confidence_route_decisions
Sessionsfetch_sessions, get_session_details, get_user_sessions
Exceptionsfind_exceptions, find_exceptions_in_file, get_exception_details, get_error_count
Promptslist_prompts, get_prompt, get_prompt_unresolved, create_text_prompt, create_chat_prompt, update_prompt_labels
Datasetslist_datasets, get_dataset, list_dataset_items, get_dataset_item, create_dataset, create_dataset_item, delete_dataset_item, list_dataset_runs, get_dataset_run,
Scoreslist_scores_v2, get_score_v2
Metricsquery_metrics, get_metrics_schema
Schemaget_data_schema

How to install the Langfuse MCP Server

{
  "mcpServers": {
    "langfuse": {
      "command": "uvx",
      "args": [
        "langfuse-mcp"
      ],
      "env": {
        "LANGFUSE_PUBLIC_KEY": "YOUR_LANGFUSE_PUBLIC_KEY",
        "LANGFUSE_SECRET_KEY": "YOUR_LANGFUSE_SECRET_KEY",
        "LANGFUSE_HOST": "https://cloud.langfuse.com",
        "LANGFUSE_MCP_DEFAULT_OUTPUT_MODE": "full_json_file"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
LANGFUSE_PUBLIC_KEYDeclared in the maintainer’s client configuration.Check documentation
LANGFUSE_SECRET_KEYDeclared in the maintainer’s client configuration.Check documentation
LANGFUSE_HOSTDeclared in the maintainer’s client configuration.Check documentation
LANGFUSE_MCP_DEFAULT_OUTPUT_MODEDeclared in the maintainer’s client configuration.Check documentation