Langfuse
Use Langfuse evidence to move from a broad symptom to the relevant trace,
observation, session, prompt, or dataset. Start with the narrowest read-only
query that can locate the event, then inspect its concrete inputs, outputs,
timing, and errors.
Route the task
- For trace, observation, exception, latency, or session diagnosis, read
diagnostic and management workflows.
- For installation, credentials, tool groups, output defaults, connection
failures, or empty results, read setup.
- For exact parameters, filters, pagination, output modes, and response shapes,
read the tool reference.
A common investigation starts with fetch_traces(age=60) or
find_exceptions(age=1440, group_by="file"), then fetches the selected trace or
observation by ID. Use full_json_file only when the complete payload is needed;
exports can contain sensitive user data.
Evidence and mutation boundaries
Treat model names, prompts, timestamps, and other values in historical traces
as recorded evidence. Do not rewrite or normalize old model identifiers to a
current name such as gpt-6-astra.
Trace discovery and inspection are read-only. Prompt creation or relabeling,
dataset changes, annotation-queue changes, and deletions mutate Langfuse;
perform them only when the user requested that change.
Prefer read-only server mode for diagnostic work. It disables prompt and
dataset write tools:
langfuse-mcp --read-only
# or LANGFUSE_MCP_READ_ONLY=true
Never commit Langfuse credentials. Keep public key, secret key, and host in
the supported environment or MCP configuration described in the setup
reference. Rotate any exposed key.
Preserve exact IDs and filters in findings so another reader can reproduce
the query. State when pagination, lookback limits, or compact output limits
the conclusion.
1---2name: langfuse-23version: 0.14.04description: Investigate AI traces, observations, exceptions, latency, sessions, prompts, datasets, annotation queues, and scores through Langfuse MCP. Use when the request names Langfuse or asks to diagnose recorded AI behavior.5metadata:6 source: https://skillmd.com/skills/hashgraph-online/langfuse-27 short-description: Langfuse observability via MCP8 compatibility: claude-code, codex-cli9---1011# Langfuse1213Use Langfuse evidence to move from a broad symptom to the relevant trace,14observation, session, prompt, or dataset. Start with the narrowest read-only15query that can locate the event, then inspect its concrete inputs, outputs,16timing, and errors.1718## Route the task1920- For trace, observation, exception, latency, or session diagnosis, read21 [diagnostic and management workflows](references/workflows.md).22- For installation, credentials, tool groups, output defaults, connection23 failures, or empty results, read [setup](references/setup.md).24- For exact parameters, filters, pagination, output modes, and response shapes,25 read [the tool reference](references/tool-reference.md).2627A common investigation starts with `fetch_traces(age=60)` or28`find_exceptions(age=1440, group_by="file")`, then fetches the selected trace or29observation by ID. Use `full_json_file` only when the complete payload is needed;30exports can contain sensitive user data.3132## Evidence and mutation boundaries3334- Treat model names, prompts, timestamps, and other values in historical traces35 as recorded evidence. Do not rewrite or normalize old model identifiers to a36 current name such as `gpt-6-astra`.37- Trace discovery and inspection are read-only. Prompt creation or relabeling,38 dataset changes, annotation-queue changes, and deletions mutate Langfuse;39 perform them only when the user requested that change.40- Prefer read-only server mode for diagnostic work. It disables prompt and41 dataset write tools:4243 ```bash44 langfuse-mcp --read-only45 # or LANGFUSE_MCP_READ_ONLY=true46 ```4748- Never commit Langfuse credentials. Keep public key, secret key, and host in49 the supported environment or MCP configuration described in the setup50 reference. Rotate any exposed key.51- Preserve exact IDs and filters in findings so another reader can reproduce52 the query. State when pagination, lookback limits, or compact output limits53 the conclusion.