langfuse-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LANGFUSE_BASE_URL | Yes | Base URL of the Langfuse instance, e.g. https://cloud.langfuse.com (EU) or https://us.cloud.langfuse.com (US) or self-hosted URL. | |
| LANGFUSE_ENV_FILE | No | Optional path to a .env file to load instead of ./.env. | |
| LANGFUSE_PUBLIC_KEY | Yes | Project public key (pk-lf-…). | |
| LANGFUSE_SECRET_KEY | Yes | Project secret key (sk-lf-…). |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| listTracesA | List Langfuse traces with filters. Returns summary metadata (use getTrace for the full observation tree). |
| getTraceB | Fetch a single trace by id including all nested observations. |
| listObservationsC | List observations (spans, generations, events) with filters. |
| getObservationA | Fetch a single observation by id. |
| listSessionsC | List sessions within a time range. |
| getSessionA | Fetch a session by id, including its traces. |
| listScoresC | List scores with filters. |
| getScoreC | Fetch a single score by id. |
| listScoreConfigsB | List score configurations (definitions for score names, ranges, and categories). |
| getScoreConfigC | Fetch a single score configuration by id. |
| listPromptsB | List prompt definitions tracked in Langfuse. |
| getPromptA | Fetch a prompt by name. Optionally pin to a specific version or label (e.g. 'production'). |
| listDatasetsB | List datasets configured in Langfuse. |
| getDatasetC | Fetch metadata for a dataset by its name. |
| listDatasetItemsC | List items in a dataset (inputs / expected outputs / metadata). |
| getDatasetItemC | Fetch a single dataset item by id. |
| listDatasetRunsC | List runs (evaluation rounds) for a dataset. |
| getDatasetRunB | Fetch a specific dataset run by name. |
| getMetricsC | Run a metrics query (counts, latency, cost, token usage). Pass a JSON query string per the Langfuse metrics API. |
| getDailyMetricsC | Fetch daily aggregated usage / cost / count metrics for traces and observations. |
| listModelsB | List models known to Langfuse (for cost / token attribution). |
| getModelB | Fetch a single model definition by id. |
| listProjectsA | List projects accessible to the current API key (typically a single project). |
| listCommentsC | List comments attached to traces, observations, sessions, or prompts. |
| getCommentA | Fetch a single comment by id. |
| getMediaC | Fetch metadata for a media attachment (image, audio, file) by id. |
| getHealthA | Pings the Langfuse public health endpoint. Useful to validate credentials and connectivity. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/hugoles/langfuse-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server