Agent skill

Langfuse

by avivsinai in avivsinai/langfuse-mcp

Investigate AI traces, observations, exceptions, latency, sessions, prompts, datasets, annotation queues, and scores through Langfuse MCP.

MITAuto-check passedAI & LLM Engineering

Install Langfuse

skills CLI
$ npx skills add avivsinai/langfuse-mcp --skill langfuse -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install avivsinai/langfuse-mcp langfuse --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/avivsinai/langfuse-mcp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/langfuse .claude/skills/langfuse && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
langfuse
GitHub stars
113
Used in
1 other repo
Token cost
~580 tokens
SKILL.md length
242 words
Files
4 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Investigate AI traces, observations, exceptions, latency, sessions, prompts, datasets, annotation queues, and scores through Langfuse MCP.

  • The request names Langfuse
  • SKILL.md covers Route the task and Evidence and mutation boundaries
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Asks to diagnose recorded AI behavior

What it does

Langfuse is an agent skill from avivsinai/langfuse-mcp. 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.

Its SKILL.md is about 580 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/setup.md`, `references/tool-reference.md` and `references/workflows.md`).

It sits in AI & LLM Engineering, covering LLM observability. It works with Langfuse and Model Context Protocol. The repository describes itself as: A Model Context Protocol (MCP) server for Langfuse, enabling AI agents to query Langfuse trace data for enhanced debugging and observability. The licence is MIT.

When your agent uses it

  • The request names Langfuse
  • Asks to diagnose recorded AI behavior

Example prompts

  • “/langfuse”

What it can do on your machine

Read from SKILL.md and the folder at commit 3d16560. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Langfuse loads about 580 tokens when it runs, and up to ~10k if it reads all its reference files. Until then it costs about 56 tokens; SKILL.md has 242 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~580
With references · SKILL.md plus every file in references/, read only if the agent opens them
~10k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from avivsinai/langfuse-mcp at commit 3d16560, republished under its MIT licence (© avivsinai). 242 words, ~580 tokens.

Download SKILL.mdSave it as .claude/skills/langfuse/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
langfuse
description
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.
version
0.13.0
metadata.short-description
Langfuse observability via MCP
metadata.compatibility
claude-code, codex-cli

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:

    bash
    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.

© avivsinai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/langfuse of avivsinai/langfuse-mcp.

  • SKILL.md
  • references/setup.md
  • references/tool-reference.md
  • references/workflows.md

Open the folder on GitHubat commit 3d16560

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in avivsinai/langfuse-mcp, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Langfuse next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Langfuse compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Langfuse this skillavivsinai/langfuse-mcp1131 repos~580Automated safety check: PassMIT
Agents Operationfazer-ai/agents118—~1.3kAutomated safety check: PassApache-2.0
Agents Onboardingfazer-ai/agents118—~4.4kAutomated safety check: PassApache-2.0
Langfuse Integration Pagelangfuse/langfuse-docs246—~3.7kAutomated safety check: PassMIT
Langfuselangfuse/skills301—~2.1kAutomated safety check: NotesMIT
Agent Prompt Engineeringagentailor/fullstack-langgraph-nextjs-agent132—~3.6kAutomated safety check: PassMIT

Similar skills

  • Agents Operation

    fazer-ai/agents

    Modo operação do fazer.ai agents: debugar conversas em produção e corrigir comportamentos inesperados do agente.

    118 GitHub stars~1.3k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Agents Onboarding

    fazer-ai/agents

    Conduz a jornada de onboarding 'do zero ao agente de atendimento' do fazer.ai agents num VPS, escolhendo o orquestrador de deploy (Tier A Coolify, B Portainer, C compose genérico para VM crua ou…

    118 GitHub stars~4.4k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Langfuse Integration Page

    langfuse/langfuse-docs

    Create a new Langfuse integration page in the langfuse-docs repo.

    246 GitHub stars~3.7k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Langfuse

    langfuse/skills

    Interact with Langfuse and access its documentation: tracing, monitoring, creating datasets, running experiments, and evaluating AI applications.

    301 GitHub stars~2.1k tokensUpdated 9 days ago
    AI & LLM EngineeringAuto-check: notes
  • Agent Prompt Engineering

    agentailor/fullstack-langgraph-nextjs-agent

    Comprehensive guide for designing, refining, and auditing system prompts for autonomous AI agents based on Anthropic's production practices.

    132 GitHub stars~3.6k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed
  • Queries Langfuse traces, prompts, datasets and sessions, and analyzes local LLM gateway logs for requests, context growth, token use and cache hits.

    229 GitHub stars~4.3k tokensUpdated today
    AI & LLM EngineeringAuto-check: notes

Questions about Langfuse

What does Langfuse do?

Investigate AI traces, observations, exceptions, latency, sessions, prompts, datasets, annotation queues, and scores through Langfuse MCP. Langfuse is an agent skill from avivsinai/langfuse-mcp. Investigate AI traces, observations, exceptions, latency, sessions, prompts, datasets, annotation queues, and scores through Langfuse MCP.

When should I use Langfuse?

Langfuse fits situations like: the request names Langfuse; asks to diagnose recorded AI behavior.

How do I install Langfuse in Claude Code?

Run `npx skills add avivsinai/langfuse-mcp --skill langfuse -a claude-code`. Or copy the skill folder (skills/langfuse in avivsinai/langfuse-mcp) into .claude/skills/langfuse in your project. Claude Code loads it when a task matches its description.

How do I install Langfuse in Codex?

Run `npx skills add avivsinai/langfuse-mcp --skill langfuse -a codex`. Or copy the skill folder (skills/langfuse in avivsinai/langfuse-mcp) into .agents/skills/langfuse in your project. Codex loads it when a task matches its description.

Can I use Langfuse in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add avivsinai/langfuse-mcp --skill langfuse -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/langfuse, .gemini/skills/langfuse, .github/skills/langfuse and .opencode/skills/langfuse in your project.

What does Langfuse need to run?

SKILL.md names no scripts, command-line tools or credentials: Langfuse is instructions for the agent only.

Does Langfuse access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Langfuse safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Langfuse use?

Langfuse is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Langfuse use?

About 580 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 9.9k tokens, read only when the agent opens those files.

What are the alternatives to Langfuse?

Skills that share tags, products or a category with Langfuse: Agents Operation (fazer-ai/agents, 118 stars), Agents Onboarding (fazer-ai/agents, 118 stars), Langfuse Integration Page (langfuse/langfuse-docs, 246 stars) and Langfuse (langfuse/skills, 301 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Langfuse?

avivsinai (a GitHub user) maintains it in avivsinai/langfuse-mcp, which has 113 GitHub stars. The repository was last updated on October 11, 2026.

Source: avivsinai/langfuse-mcp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.