{"$schema":"https://verifymcp.io/schemas/trust-report.json","schemaVersion":1,"license":{"name":"CC BY-NC 4.0","url":"https://creativecommons.org/licenses/by-nc/4.0/"},"generatedAt":"2026-11-21T23:08:36.673Z","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp","markdownUrl":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp.md","server":{"slug":"avivsinai-langfuse-mcp","name":"Langfuse MCP","registryName":"io.github.avivsinai/langfuse-mcp","description":"Langfuse MCP server for accessing and analyzing telemetry data via natural language","registryStatus":"active","deletedAt":null,"statusMessage":null,"liveness":"live","publisher":{"class":"unknown","claimed":false}},"component":{"slug":"langfuse-mcp","type":"pypi","identifier":"langfuse-mcp","withdrawn":false,"url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp","version":"0.14.0","transport":"stdio","scoredAt":"2026-11-21T05:00:23.068Z"},"score":{"total":76,"tier":"medium","status":"scored","weekDelta":0,"history":[{"date":"2026-11-21","total":76},{"date":"2026-11-20","total":75},{"date":"2026-11-19","total":75},{"date":"2026-11-18","total":76},{"date":"2026-11-17","total":76},{"date":"2026-11-16","total":76},{"date":"2026-11-15","total":76},{"date":"2026-11-14","total":76},{"date":"2026-11-13","total":76},{"date":"2026-11-12","total":90},{"date":"2026-11-11","total":75},{"date":"2026-11-10","total":89},{"date":"2026-11-09","total":89},{"date":"2026-11-08","total":88},{"date":"2026-11-07","total":88},{"date":"2026-11-06","total":91},{"date":"2026-11-05","total":76},{"date":"2026-11-04","total":91},{"date":"2026-11-03","total":76},{"date":"2026-11-02","total":91},{"date":"2026-11-01","total":91},{"date":"2026-10-31","total":90},{"date":"2026-10-30","total":76},{"date":"2026-10-29","total":76},{"date":"2026-10-28","total":91},{"date":"2026-10-27","total":91},{"date":"2026-10-26","total":91},{"date":"2026-10-25","total":76},{"date":"2026-10-24","total":75},{"date":"2026-10-23","total":90}]},"categories":[{"name":"Supply Chain Security","score":44,"verdict":"partial","reasons":["Malware scan not yet available for this package.","No known CVEs affecting this package version or its production dependencies.","Declares code that runs automatically (build-time code we could not rule out (a Hatch, PDM or setuptools build hook, a dynamic version we could not read statically, shipped VCS metadata or a stray root module)) and that we could not recognise. It may be perfectly ordinary, but we have not established what it does.","2 of 49 dependencies flagged as unhealthy."],"codes":[{"code":"supplychain.malware_inconclusive","args":{"reason":"vendor_no_verdict"}},{"code":"cve.none","args":{}},{"code":"installscript.unreviewed","args":{"hooks":"build_hook"}},{"code":"dephealth.assessed","args":{"deps":"49","unhealthy":"2"}}]},{"name":"Provenance & Transparency","score":100,"verdict":"pass","reasons":["Source repository is publicly reachable at the declared URL.","Cryptographically verified build provenance (signed, bound to avivsinai/langfuse-mcp).","Clear OSI-approved license (MIT).","Actively maintained (last published 26 days ago).","Publishes a security disclosure policy (SECURITY.md)."],"codes":[{"code":"provenance.repo_verified","args":{}},{"code":"provenance.verified","args":{"repo":"avivsinai/langfuse-mcp"}},{"code":"license.osi","args":{"spdx":"MIT"}},{"code":"maintenance.recent","args":{"age_days":"26"}},{"code":"disclosure.present","args":{}}]},{"name":"Schema Quality & AI Usability","score":66,"verdict":"fail","reasons":["AI-judged instruction clarity (excellent).","Context-footprint check failed: tool/resource definitions use about 8755 tokens (~182/item across 48 items; 48 tools + 0 resources), over budget; trim descriptions and params.","Usage-examples check failed: none of the tools include examples."],"codes":[{"code":"schema.ai_quality","args":{"band":"excellent"}},{"code":"schema.footprint_heavy","args":{"avg":"182","items":"48","tools":"48","tokens":"8755","resources":"0"}},{"code":"schema.examples_absent","args":{}}]},{"name":"Stability & Change Management","score":100,"verdict":"pass","reasons":["No destabilizing schema changes in the last 30 days."],"codes":[{"code":"stability.stable","args":{}}]},{"name":"Tool Coverage","score":100,"verdict":"partial","reasons":["100% of tools have a non-trivial description (not blank, and not just the tool's name).","99% of tool parameters carry a description.","Structured output schemas are declared (100% of tools); any adoption earns full credit."],"codes":[{"code":"toolquality.descriptions","args":{"pct":"100"}},{"code":"toolquality.param_docs","args":{"pct":"99"}},{"code":"toolquality.output_present","args":{"pct":"100"}}]},{"name":"Tool Safety","score":75,"verdict":"fail","reasons":["No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.","0 of 4 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; \"delete_annotation_queue_item\" implies \"delete\" and declares no destructiveHint at all, which the MCP spec reads as destructive by default.","An AI judge read all 48 captured unit(s) of tool text and found none that tries to manipulate the model reading it."],"codes":[{"code":"toolsafety.injection_clean","args":{}},{"code":"toolsafety.destructive_undeclared","args":{"pct":"0","tool":"delete_annotation_queue_item","verb":"delete","declared":"none","annotated":"0","destructive":"4"}},{"code":"toolsafety.manipulation_clean","args":{"units":"48","judged":"48"}}]},{"name":"Capabilities","score":100,"verdict":"pass","reasons":["Implements a current MCP spec version (2026-07-28)."],"codes":[{"code":"protocol.current","args":{"version":"2026-07-28"}}]}],"inconclusive":["Malware scan not yet available for this package."],"malware":[],"components":[{"slug":"langfuse-mcp","type":"pypi","identifier":"langfuse-mcp","withdrawn":false,"score":76,"current":true,"url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp","markdownUrl":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp.md"}],"facts":[{"label":"Registry","value":"pypi"},{"label":"Package","value":"langfuse-mcp"},{"label":"Version","value":"0.14.0"},{"label":"Transport","value":"stdio"}],"install":{"available":true,"bundleSha256":null},"tools":[{"name":"list_annotation_queues","title":null,"description":"List annotation queues with pagination.","inputs":[{"name":"limit","type":"integer","required":false,"description":"Items per page (max 100)"},{"name":"page","type":"integer","required":false,"description":"Page number for pagination (starts at 1)"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":46},{"name":"create_annotation_queue","title":null,"description":"Create an annotation queue.","inputs":[{"name":"description","type":null,"required":false,"description":"Optional queue description"},{"name":"name","type":"string","required":true,"description":"Unique queue name"},{"name":"score_config_ids","type":null,"required":false,"description":"Optional score config IDs attached to this queue"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":47},{"name":"get_annotation_queue","title":null,"description":"Get a single annotation queue by ID.","inputs":[{"name":"queue_id","type":"string","required":true,"description":"Annotation queue ID"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":28},{"name":"list_annotation_queue_items","title":null,"description":"List items in an annotation queue.","inputs":[{"name":"limit","type":"integer","required":false,"description":"Items per page (max 100)"},{"name":"page","type":"integer","required":false,"description":"Page number for pagination (starts at 1)"},{"name":"queue_id","type":"string","required":true,"description":"Annotation queue ID"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":58},{"name":"get_annotation_queue_item","title":null,"description":"Get a specific annotation queue item by queue and item ID.","inputs":[{"name":"item_id","type":"string","required":true,"description":"Annotation queue item ID"},{"name":"queue_id","type":"string","required":true,"description":"Annotation queue ID"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":45},{"name":"create_annotation_queue_item","title":null,"description":"Create an annotation queue item.","inputs":[{"name":"object_id","type":"string","required":true,"description":"Object ID to enqueue"},{"name":"object_type","type":"string","required":true,"description":"Object type, for example TRACE or OBSERVATION"},{"name":"queue_id","type":"string","required":true,"description":"Annotation queue ID"},{"name":"status","type":null,"required":false,"description":"Optional status"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":64},{"name":"update_annotation_queue_item","title":null,"description":"Update the status of an annotation queue item.","inputs":[{"name":"item_id","type":"string","required":true,"description":"Annotation queue item ID"},{"name":"queue_id","type":"string","required":true,"description":"Annotation queue ID"},{"name":"status","type":"string","required":true,"description":"New status value"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":52},{"name":"delete_annotation_queue_item","title":null,"description":"Delete an annotation queue item.","inputs":[{"name":"item_id","type":"string","required":true,"description":"Annotation queue item ID"},{"name":"queue_id","type":"string","required":true,"description":"Annotation queue ID"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":39},{"name":"create_annotation_queue_assignment","title":null,"description":"Assign a user to an annotation queue.","inputs":[{"name":"queue_id","type":"string","required":true,"description":"Annotation queue ID"},{"name":"user_id","type":"string","required":true,"description":"User ID to assign"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":41},{"name":"delete_annotation_queue_assignment","title":null,"description":"Unassign a user from an annotation queue.","inputs":[{"name":"queue_id","type":"string","required":true,"description":"Annotation queue ID"},{"name":"user_id","type":"string","required":true,"description":"User ID to unassign"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":43},{"name":"list_datasets","title":null,"description":"List all datasets in the project with pagination.\n\nReturns metadata about datasets including name, description, item count, and timestamps.\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    page: Page number for pagination (starts at 1)\n    limit: Maximum items per page (max 100)\n\nReturns:\n    A dictionary containing:\n    - data: List of dataset metadata objects\n    - metadata: Pagination info (page, limit, total)","inputs":[{"name":"limit","type":"integer","required":false,"description":"Items per page (max 100)"},{"name":"page","type":"integer","required":false,"description":"Page number for pagination (starts at 1)"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":134},{"name":"get_dataset","title":null,"description":"Get a specific dataset by name.\n\nRetrieves dataset details including metadata and item count.\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    name: The name of the dataset to fetch\n\nReturns:\n    A dictionary containing dataset details:\n    - id: Unique dataset identifier\n    - name: Dataset name\n    - description: Dataset description\n    - metadata: Custom metadata\n    - items: List of dataset items (if included by the API)\n    - runs: List of dataset runs (if included by the API)","inputs":[{"name":"name","type":"string","required":true,"description":"The name of the dataset to fetch"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":134},{"name":"list_dataset_items","title":null,"description":"List items in a dataset with pagination and optional filtering.\n\nReturns dataset items with their input, expected output, and metadata.\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    dataset_name: The name of the dataset to list items from\n    source_trace_id: Optional filter by source trace ID\n    source_observation_id: Optional filter by source observation ID\n    page: Page number for pagination (starts at 1)\n    limit: Maximum items per page (max 100)\n    output_mode: How to format the response data\n\nReturns:\n    A dictionary containing:\n    - data: List of dataset item objects\n    - metadata: Pagination info (page, limit, total, dataset_name)","inputs":[{"name":"dataset_name","type":"string","required":true,"description":"The name of the dataset to list items from"},{"name":"limit","type":"integer","required":false,"description":"Items per page (max 100)"},{"name":"output_mode","type":"string","required":false,"description":"Output format: 'compact' truncates, 'full_json_string' returns full data, 'full_json_file' writes to file"},{"name":"page","type":"integer","required":false,"description":"Page number for pagination (starts at 1)"},{"name":"source_observation_id","type":null,"required":false,"description":"Filter by source observation ID"},{"name":"source_trace_id","type":null,"required":false,"description":"Filter by source trace ID"}],"outputs":[{"name":"result","type":null,"required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":263},{"name":"get_dataset_item","title":null,"description":"Get a specific dataset item by ID.\n\nRetrieves the full dataset item including input, expected output, metadata, and linked traces.\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    item_id: The ID of the dataset item to fetch\n    output_mode: How to format the response data\n\nReturns:\n    A dictionary containing the dataset item details:\n    - id: Unique item identifier\n    - datasetId: Parent dataset ID\n    - input: Input data for the item\n    - expectedOutput: Expected output data\n    - metadata: Custom metadata\n    - sourceTraceId: Linked trace ID (if any)\n    - sourceObservationId: Linked observation ID (if any)\n    - status: Item status (ACTIVE or ARCHIVED)","inputs":[{"name":"item_id","type":"string","required":true,"description":"The ID of the dataset item to fetch"},{"name":"output_mode","type":"string","required":false,"description":"Output format: 'compact' truncates, 'full_json_string' returns full data, 'full_json_file' writes to file"}],"outputs":[{"name":"result","type":null,"required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":217},{"name":"create_dataset","title":null,"description":"Create a new dataset in the project.\n\nDatasets are used to store evaluation test cases with input/expected output pairs.\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    name: Name for the new dataset (must be unique)\n    description: Optional description\n    metadata: Optional custom metadata\n\nReturns:\n    A dictionary containing the created dataset details:\n    - id: Unique dataset identifier\n    - name: Dataset name\n    - description: Dataset description\n    - metadata: Custom metadata\n    - createdAt: Creation timestamp","inputs":[{"name":"description","type":null,"required":false,"description":"Optional description of the dataset"},{"name":"metadata","type":null,"required":false,"description":"Optional custom metadata as key-value pairs"},{"name":"name","type":"string","required":true,"description":"Name for the new dataset (must be unique in project)"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":162},{"name":"create_dataset_item","title":null,"description":"Create a new item in a dataset, or update if item_id already exists.\n\nDataset items store input/expected output pairs for evaluation. If item_id is provided\nand already exists, the item will be updated (upsert behavior).\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    dataset_name: Name of the target dataset\n    input: Input data for the item\n    expected_output: Expected output for evaluation\n    metadata: Optional custom metadata\n    source_trace_id: Optional linked trace ID\n    source_observation_id: Optional linked observation ID\n    item_id: Optional custom ID (enables upsert)\n    status: Item status (ACTIVE or ARCHIVED)\n\nReturns:\n    A dictionary containing the created/updated item details","inputs":[{"name":"dataset_name","type":"string","required":true,"description":"Name of the dataset to add the item to"},{"name":"expected_output","type":null,"required":false,"description":"Expected output data for evaluation (any JSON-serializable value)"},{"name":"input","type":null,"required":false,"description":"Input data for the dataset item (any JSON-serializable value)"},{"name":"item_id","type":null,"required":false,"description":"Optional custom ID for the item (for upsert behavior)"},{"name":"metadata","type":null,"required":false,"description":"Optional custom metadata as key-value pairs"},{"name":"source_observation_id","type":null,"required":false,"description":"Optional observation ID to link this item to"},{"name":"source_trace_id","type":null,"required":false,"description":"Optional trace ID to link this item to"},{"name":"status","type":null,"required":false,"description":"Item status (default: ACTIVE)"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":289},{"name":"delete_dataset_item","title":null,"description":"Delete a dataset item by ID.\n\nThis is a permanent deletion and cannot be undone.\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    item_id: The ID of the dataset item to delete\n\nReturns:\n    A dictionary confirming the deletion","inputs":[{"name":"item_id","type":"string","required":true,"description":"The ID of the dataset item to delete"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":80},{"name":"list_dataset_runs","title":null,"description":"List runs for a dataset by dataset name.","inputs":[{"name":"dataset_name","type":"string","required":true,"description":"The name of the dataset to list runs from"},{"name":"limit","type":"integer","required":false,"description":"Items per page (max 100)"},{"name":"page","type":"integer","required":false,"description":"Page number for pagination (starts at 1)"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":65},{"name":"get_dataset_run","title":null,"description":"Get a dataset run, including any run items returned by the SDK.","inputs":[{"name":"dataset_name","type":"string","required":true,"description":"The name of the dataset that owns the run"},{"name":"output_mode","type":"string","required":false,"description":"Output format: 'compact' truncates, 'full_json_string' returns full data, 'full_json_file' writes to file"},{"name":"run_name","type":"string","required":true,"description":"The dataset run name to fetch"}],"outputs":[{"name":"result","type":null,"required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":88},{"name":"list_dataset_run_items","title":null,"description":"List dataset run items by dataset ID and run name.","inputs":[{"name":"dataset_id","type":"string","required":true,"description":"Dataset ID that owns the run items"},{"name":"limit","type":"integer","required":false,"description":"Items per page (max 100)"},{"name":"output_mode","type":"string","required":false,"description":"Output format: 'compact' truncates, 'full_json_string' returns full data, 'full_json_file' writes to file"},{"name":"page","type":"integer","required":false,"description":"Page number for pagination (starts at 1)"},{"name":"run_name","type":"string","required":true,"description":"Dataset run name to list items from"}],"outputs":[{"name":"result","type":null,"required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":115},{"name":"create_dataset_run_item","title":null,"description":"Create a dataset run item and flush the ingestion write.\n\nIf this legacy API is gone, use the SDK experiment runner or OTel ingestion; neither can link an existing trace through this API.","inputs":[{"name":"dataset_item_id","type":"string","required":true,"description":"Dataset item ID to include in the run"},{"name":"metadata","type":null,"required":false,"description":"Optional run-item metadata"},{"name":"observation_id","type":null,"required":false,"description":"Optional observation ID linked to this run item"},{"name":"run_description","type":null,"required":false,"description":"Optional run description"},{"name":"run_name","type":"string","required":true,"description":"Dataset run name to append this item to"},{"name":"trace_id","type":null,"required":false,"description":"Optional trace ID linked to this run item"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":127},{"name":"delete_dataset_run","title":null,"description":"Delete a run through the legacy route, or explicitly delete its traces after removal.\n\nTrace deletion also removes observations and related scores. Set delete_traces=True to allow this broader replacement.","inputs":[{"name":"dataset_name","type":"string","required":true,"description":"The name of the dataset that owns the run"},{"name":"delete_traces","type":"boolean","required":false,"description":"Allow trace deletion when the legacy run-delete route is unavailable"},{"name":"run_name","type":"string","required":true,"description":"The dataset run name to delete"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":96},{"name":"find_exceptions","title":null,"description":"Get error-level observations grouped by file path, function, type, name, or observation type.\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    age: Number of minutes to look back; capped by the configured maximum\n    group_by: How to group errors - \"file\" groups by recorded code.filepath, \"function\" by code.function,\n              \"type\" by recorded exception.type, \"name\" by observation name, or \"observation_type\" by\n              observation type\n\nReturns:\n    List of error-observation counts grouped by the specified category. A group entry carries a\n    representative observation_id and trace_id. Counts describe error-level observations, NOT\n    individual exception events (which the standard observation listing does not expose).","inputs":[{"name":"age","type":"integer","required":true,"description":"Number of minutes to look back (positive integer, max 7 days/10080 minutes)"},{"name":"group_by","type":"string","required":false,"description":"How to group errors - 'file' groups by recorded code.filepath metadata, 'function' by code.function, 'type' by recorded exception.type, 'name' by observation name, or 'observation_type' by observatio…"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":253},{"name":"find_exceptions_in_file","title":null,"description":"Get detailed error info for a specific file (recorded code.filepath match).\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    filepath: Path to the file as recorded in Langfuse metadata (code.filepath)\n    age: Number of minutes to look back; capped by the configured maximum\n    output_mode: Controls the output format and detail level\n\nReturns:\n    Based on output_mode:\n    - compact: List of summarized error records (top 10 newest after the full scan)\n    - full_json_string: String containing the full JSON response\n    - full_json_file: List of summarized error records with file save info","inputs":[{"name":"age","type":"integer","required":true,"description":"Number of minutes to look back (positive integer, max 7 days/10080 minutes)"},{"name":"filepath","type":"string","required":true,"description":"Path to the file to search for exceptions (full path including extension)"},{"name":"output_mode","type":"string","required":false,"description":"Controls the output format and action. 'compact' (default): Returns a summarized JSON object optimized for direct agent consumption. 'full_json_string': Returns the complete, raw JSON data serialized…"}],"outputs":[{"name":"result","type":null,"required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":258},{"name":"get_exception_details","title":null,"description":"Get detailed error info for a trace/observation.\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    trace_id: The ID of the trace to analyze for errors (unique identifier string)\n    span_id: Optional observation ID to filter by (applies across all observation types)\n    output_mode: Controls the output format and detail level\n\nReturns:\n    Based on output_mode:\n    - compact: List of summarized error records\n    - full_json_string: String containing the full JSON response\n    - full_json_file: List of summarized error records with file save info","inputs":[{"name":"output_mode","type":"string","required":false,"description":"Controls the output format and action. 'compact' (default): Returns a summarized JSON object optimized for direct agent consumption. 'full_json_string': Returns the complete, raw JSON data serialized…"},{"name":"span_id","type":null,"required":false,"description":"Optional span ID to filter by specific span (unique identifier string)"},{"name":"trace_id","type":"string","required":true,"description":"The ID of the trace to analyze for exceptions (unique identifier string)"}],"outputs":[{"name":"result","type":null,"required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":237},{"name":"get_error_count","title":null,"description":"Get number of traces with error-level observations in last N minutes.\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    age: Number of minutes to look back; capped by the configured maximum\n\nReturns:\n    Dictionary with error statistics: trace_count (distinct traces), observation_count\n    (error-level observations), and exception_count (the same error-observation total\n    as find_exceptions, not a count of individual exception events; see metadata.note).","inputs":[{"name":"age","type":"integer","required":true,"description":"Number of minutes to look back (positive integer, max 7 days/10080 minutes)"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":131},{"name":"query_metrics","title":null,"description":"Query aggregated metrics (cost, latency, token usage, counts, score values) from Langfuse.\n\nWraps the Langfuse v2 metrics endpoint. Use this for analytics questions — \"what did\ninference cost in the last 24h grouped by model\", \"p95 latency per prompt\", \"score\ndistribution by name\" — instead of pulling raw observations and aggregating client-side.\nPer-parameter contracts live in the Field descriptions above.\n\nNotes:\n    - The v2 metrics endpoint is Langfuse Cloud-only; self-hosted instances may return 404.\n    - Recently-ingested data can lag (OTEL ingestion delay up to ~10 minutes).\n    - High-cardinality fields (id, traceId, userId, sessionId) must be filters, not dimensions.","inputs":[{"name":"age","type":null,"required":false,"description":"Minutes to look back from now (e.g. 1440 for 24h). Used when from_timestamp is omitted; defaults to 1440 (24h) when no time range is given."},{"name":"dimensions","type":null,"required":false,"description":"Optional fields to group results by, e.g. ['providedModelName']. Do NOT use high-cardinality fields (id, traceId, userId, sessionId) as dimensions — pass them as filters instead."},{"name":"filters","type":null,"required":false,"description":"Optional filter objects: {'column','operator','value','type', plus 'key' for metadata/object types}. Example: [{'column':'userId','operator':'=','value':'u1','type':'string'}]. See get_metrics_schema…"},{"name":"from_timestamp","type":null,"required":false,"description":"ISO-8601 start of the time range. Overrides 'age' when provided."},{"name":"metrics","type":"array","required":true,"description":"One or more metrics to compute. Each item is {'measure': <name>, 'aggregation': <fn>}, e.g. [{'measure': 'totalCost', 'aggregation': 'sum'}, {'measure': 'latency', 'aggregation': 'p95'}]. Aggregation…"},{"name":"order_by","type":null,"required":false,"description":"Optional ordering: list of {'field': <dimension-or-metric>, 'direction': 'asc'|'desc'}."},{"name":"output_mode","type":"string","required":false,"description":"Controls the output format and action. 'compact' (default): Returns a summarized JSON object optimized for direct agent consumption. 'full_json_string': Returns the complete, raw JSON data serialized…"},{"name":"time_granularity","type":null,"required":false,"description":"When set, results are bucketed by this granularity across the time range (time series)."},{"name":"to_timestamp","type":null,"required":false,"description":"ISO-8601 end of the time range. Defaults to now (UTC)."},{"name":"view","type":"string","required":true,"description":"Data view to aggregate over: 'observations' (spans/generations/events — latency, cost, tokens, counts), 'scores-numeric' (numeric/boolean scores), or 'scores-categorical' (categorical scores). Call g…"}],"outputs":[{"name":"result","type":null,"required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":641},{"name":"get_metrics_schema","title":null,"description":"Get the query schema for the metrics API (views, dimensions, measures, aggregations).\n\nCompanion to query_metrics: describes which views exist, the dimensions and measures\navailable on each, the supported aggregations/operators, and the query-object shape.\n``dummy`` is unused and exists only for MCP API compatibility.","inputs":[{"name":"dummy","type":"string","required":false,"description":null}],"outputs":[{"name":"result","type":"string","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":79},{"name":"fetch_observations","title":null,"description":"Get observations filtered by type and other criteria.\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    type: The observation type to filter by (SPAN, GENERATION, EVENT, AGENT, TOOL, CHAIN, RETRIEVER, EVALUATOR, EMBEDDING or GUARDRAIL)\n    age: Minutes ago to start looking (e.g., 1440 for 24 hours)\n    name: Optional name filter (string pattern to match)\n    user_id: Optional user ID filter (exact match)\n    trace_id: Optional trace ID filter (exact match)\n    parent_observation_id: Optional parent observation ID filter (exact match)\n    page: Page number for pagination (starts at 1)\n    limit: Maximum number of observations to return per page\n    output_mode: Controls the output format and detail level\n\nReturns:\n    Based on output_mode:\n    - compact: List of summarized observation objects\n    - full_json_string: String containing the full JSON response\n    - full_json_file: List of summarized observation objects with file save info","inputs":[{"name":"age","type":"integer","required":true,"description":"Minutes ago to start looking (e.g., 1440 for 24 hours)"},{"name":"limit","type":"integer","required":false,"description":"Maximum number of observations to return per page"},{"name":"name","type":null,"required":false,"description":"Optional name filter (string pattern to match)"},{"name":"output_mode","type":"string","required":false,"description":"Controls the output format and action. 'compact' (default): Returns a summarized JSON object optimized for direct agent consumption. 'full_json_string': Returns the complete, raw JSON data serialized…"},{"name":"page","type":"integer","required":false,"description":"Page number for pagination (starts at 1)"},{"name":"parent_observation_id","type":null,"required":false,"description":"Optional parent observation ID filter (exact match)"},{"name":"trace_id","type":null,"required":false,"description":"Optional trace ID filter (exact match)"},{"name":"type","type":null,"required":false,"description":"The observation type to filter by (SPAN, GENERATION, EVENT, AGENT, TOOL, CHAIN, RETRIEVER, EVALUATOR, EMBEDDING or GUARDRAIL)"},{"name":"user_id","type":null,"required":false,"description":"Optional user ID filter (exact match)"}],"outputs":[{"name":"result","type":null,"required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":453},{"name":"fetch_observation","title":null,"description":"Get a single observation by ID.\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    observation_id: The ID of the observation to fetch (unique identifier string)\n    output_mode: Controls the output format and detail level\n\nReturns:\n    Based on output_mode:\n    - compact: Summarized observation object\n    - full_json_string: String containing the full JSON response\n    - full_json_file: Summarized observation object with file save info","inputs":[{"name":"observation_id","type":"string","required":true,"description":"The ID of the observation to fetch (unique identifier string)"},{"name":"output_mode","type":"string","required":false,"description":"Controls the output format and action. 'compact' (default): Returns a summarized JSON object optimized for direct agent consumption. 'full_json_string': Returns the complete, raw JSON data serialized…"}],"outputs":[{"name":"result","type":null,"required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":193},{"name":"get_prompt","title":null,"description":"Fetch a specific prompt by name with resolved dependencies.\n\nRetrieves a prompt from Langfuse with all dependency tags resolved. Uses the SDK's\nbuilt-in caching for optimal performance.\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    name: The name of the prompt to fetch\n    label: Optional label to fetch (e.g., 'production'). Cannot be used with version.\n    version: Optional specific version number. Cannot be used with label.\n\nReturns:\n    A dictionary containing the prompt details:\n    - id: Unique prompt identifier\n    - name: Prompt name\n    - version: Version number\n    - type: 'text' or 'chat'\n    - prompt: The prompt content (string for text, list for chat)\n    - labels: List of labels assigned to this version\n    - tags: List of tags\n    - config: Model configuration (temperature, model, etc.)\n\nRaises:\n    ValueError: If both label and version are specified\n    LookupError: If prompt not found","inputs":[{"name":"label","type":null,"required":false,"description":"Label to fetch (e.g., 'production', 'staging'). Mutually exclusive with version."},{"name":"name","type":"string","required":true,"description":"The name of the prompt to fetch"},{"name":"version","type":null,"required":false,"description":"Specific version number to fetch. Mutually exclusive with label."}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":274},{"name":"get_prompt_unresolved","title":null,"description":"Fetch a specific prompt by name WITHOUT resolving dependencies.\n\nReturns raw prompt content with dependency tags intact (e.g., @@@langfusePrompt:name=xxx@@@) when\nthe SDK supports resolve=false. Otherwise returns the resolved prompt and marks metadata.resolved=True.\nUseful for analyzing prompt composition and debugging dependency chains.\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    name: The name of the prompt to fetch\n    label: Optional label to fetch. Cannot be used with version.\n    version: Optional specific version number. Cannot be used with label.\n\nReturns:\n    A dictionary containing the raw prompt details with dependency tags preserved.\n\nRaises:\n    ValueError: If both label and version are specified\n    LookupError: If prompt not found","inputs":[{"name":"label","type":null,"required":false,"description":"Label to fetch (e.g., 'production', 'staging'). Mutually exclusive with version."},{"name":"name","type":"string","required":true,"description":"The name of the prompt to fetch"},{"name":"version","type":null,"required":false,"description":"Specific version number to fetch. Mutually exclusive with label."}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":221},{"name":"list_prompts","title":null,"description":"List and filter prompts in the project.\n\nReturns metadata about prompts including versions, labels, tags, and last updated time.\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    name: Optional filter by exact prompt name\n    label: Optional filter by label on any version\n    tag: Optional filter by tag\n    page: Page number for pagination (starts at 1)\n    limit: Maximum items per page (max 100)\n\nReturns:\n    A dictionary containing:\n    - data: List of prompt metadata objects\n    - metadata: Pagination info (page, limit, total)","inputs":[{"name":"label","type":null,"required":false,"description":"Filter by label (e.g., 'production', 'staging')"},{"name":"limit","type":"integer","required":false,"description":"Items per page (max 100)"},{"name":"name","type":null,"required":false,"description":"Filter by exact prompt name"},{"name":"page","type":"integer","required":false,"description":"Page number for pagination (starts at 1)"},{"name":"tag","type":null,"required":false,"description":"Filter by tag"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":199},{"name":"create_text_prompt","title":null,"description":"Create a new text prompt version in Langfuse.\n\nPrompts are immutable; creating a new version is the only way to update prompt content.\nLabels are unique across versions - assigning a label here will move it from other versions.","inputs":[{"name":"commit_message","type":null,"required":false,"description":"Optional commit message describing the changes"},{"name":"config","type":null,"required":false,"description":"Optional JSON config (e.g., {model: 'gpt-4', temperature: 0.7})"},{"name":"labels","type":null,"required":false,"description":"Labels to assign (e.g., ['production', 'staging'])"},{"name":"name","type":"string","required":true,"description":"The name of the prompt to create"},{"name":"prompt","type":"string","required":true,"description":"Prompt text content (supports {{variables}})"},{"name":"tags","type":null,"required":false,"description":"Optional tags for organization (e.g., ['experimental', 'v2'])"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":159},{"name":"create_chat_prompt","title":null,"description":"Create a new chat prompt version in Langfuse.\n\nChat prompts are arrays of role/content messages. Prompts are immutable; create a new\nversion to update content. Labels are unique across versions.","inputs":[{"name":"commit_message","type":null,"required":false,"description":"Optional commit message describing the changes"},{"name":"config","type":null,"required":false,"description":"Optional JSON config (e.g., {model: 'gpt-4', temperature: 0.7})"},{"name":"labels","type":null,"required":false,"description":"Labels to assign (e.g., ['production', 'staging'])"},{"name":"name","type":"string","required":true,"description":"The name of the prompt to create"},{"name":"prompt","type":"array","required":true,"description":"Chat messages in the format [{role: 'system'|'user'|'assistant', content: '...'}]"},{"name":"tags","type":null,"required":false,"description":"Optional tags for organization (e.g., ['experimental', 'v2'])"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":168},{"name":"update_prompt_labels","title":null,"description":"Update labels for a specific prompt version.\n\nThis is the only supported mutation for existing prompts. Provided labels are added\nto the version (existing labels are preserved). Labels are unique across versions,\nand the 'latest' label is managed by Langfuse.","inputs":[{"name":"labels","type":"array","required":true,"description":"Labels to add to this version (can be empty to add none). Existing labels are preserved; labels are unique across versions."},{"name":"name","type":"string","required":true,"description":"The name of the prompt to update"},{"name":"version","type":"integer","required":true,"description":"The prompt version to update"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":117},{"name":"find_route_decisions","title":null,"description":"Find generic agent route decisions emitted as Langfuse SPAN observations.\n\nThis tool is router-neutral. It only treats observations with\nmetadata.schema_version == \"mcp.route_decision.v1\" as route decisions, and\nit filters on fields inside observation metadata rather than display output.","inputs":[{"name":"age","type":"integer","required":false,"description":"Number of minutes to look back (positive integer, max 7 days/10080 minutes)"},{"name":"capability_id","type":null,"required":false,"description":"Optional route-decision metadata capability_id filter"},{"name":"decision_id","type":null,"required":false,"description":"Optional route-decision metadata decision_id filter"},{"name":"limit","type":"integer","required":false,"description":"Maximum number of route decisions to return per page"},{"name":"output_mode","type":"string","required":false,"description":"Controls the output format and action. 'compact' (default): Returns a summarized JSON object optimized for direct agent consumption. 'full_json_string': Returns the complete, raw JSON data serialized…"},{"name":"page","type":"integer","required":false,"description":"Page number for pagination (starts at 1)"},{"name":"provider","type":null,"required":false,"description":"Optional route-decision metadata provider filter"},{"name":"router_name","type":null,"required":false,"description":"Optional route-decision metadata router_name filter"},{"name":"session_id","type":null,"required":false,"description":"Optional route-decision metadata session_id filter"},{"name":"trace_id","type":null,"required":false,"description":"Optional Langfuse trace ID filter"}],"outputs":[{"name":"result","type":null,"required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":272},{"name":"get_route_decision","title":null,"description":"Fetch one route decision by metadata decision_id.","inputs":[{"name":"age","type":"integer","required":false,"description":"Number of minutes to look back (positive integer, max 7 days/10080 minutes)"},{"name":"decision_id","type":"string","required":true,"description":"Route-decision metadata decision_id to fetch"},{"name":"output_mode","type":"string","required":false,"description":"Controls the output format and action. 'compact' (default): Returns a summarized JSON object optimized for direct agent consumption. 'full_json_string': Returns the complete, raw JSON data serialized…"}],"outputs":[{"name":"result","type":null,"required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":127},{"name":"summarize_route_decisions","title":null,"description":"Summarize generic route decisions for a trace, session, router, provider, or capability.","inputs":[{"name":"age","type":"integer","required":false,"description":"Number of minutes to look back (positive integer, max 7 days/10080 minutes)"},{"name":"capability_id","type":null,"required":false,"description":"Optional route-decision metadata capability_id filter"},{"name":"limit","type":"integer","required":false,"description":"Maximum number of route decisions to summarize from the current page"},{"name":"max_confidence","type":"number","required":false,"description":"Confidence threshold used for low-confidence counts"},{"name":"page","type":"integer","required":false,"description":"Page number for pagination (starts at 1)"},{"name":"provider","type":null,"required":false,"description":"Optional route-decision metadata provider filter"},{"name":"router_name","type":null,"required":false,"description":"Optional route-decision metadata router_name filter"},{"name":"session_id","type":null,"required":false,"description":"Optional route-decision metadata session_id filter"},{"name":"trace_id","type":null,"required":false,"description":"Optional Langfuse trace ID filter"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":171},{"name":"find_low_confidence_route_decisions","title":null,"description":"Find route decisions that are low-confidence or explicitly uncallable.","inputs":[{"name":"age","type":"integer","required":false,"description":"Number of minutes to look back (positive integer, max 7 days/10080 minutes)"},{"name":"capability_id","type":null,"required":false,"description":"Optional route-decision metadata capability_id filter"},{"name":"include_uncallable","type":"boolean","required":false,"description":"Also return decisions with metadata callable=false"},{"name":"limit","type":"integer","required":false,"description":"Maximum number of matching route decisions to return"},{"name":"max_confidence","type":"number","required":false,"description":"Return route decisions with confidence at or below this value"},{"name":"output_mode","type":"string","required":false,"description":"Controls the output format and action. 'compact' (default): Returns a summarized JSON object optimized for direct agent consumption. 'full_json_string': Returns the complete, raw JSON data serialized…"},{"name":"page","type":"integer","required":false,"description":"Page number for pagination (starts at 1)"},{"name":"provider","type":null,"required":false,"description":"Optional route-decision metadata provider filter"},{"name":"router_name","type":null,"required":false,"description":"Optional route-decision metadata router_name filter"},{"name":"session_id","type":null,"required":false,"description":"Optional route-decision metadata session_id filter"},{"name":"trace_id","type":null,"required":false,"description":"Optional Langfuse trace ID filter"}],"outputs":[{"name":"result","type":null,"required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":252},{"name":"get_data_schema","title":null,"description":"Get schema of trace, span and event objects.\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    dummy: Unused parameter for API compatibility (can be left empty)\n\nReturns:\n    String containing the detailed schema definitions for traces, spans, events,\n    and other core Langfuse data structures","inputs":[{"name":"dummy","type":"string","required":false,"description":null}],"outputs":[{"name":"result","type":"string","required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":83},{"name":"list_scores_v2","title":null,"description":"List scores via Scores API v3 with optional filters (GET /v2/scores where v3 is not served).\n\nWith operator ``=`` and a value, v3 defaults an omitted data_type to NUMERIC; pass BOOLEAN for boolean scores.\nStrict ``>``/``<`` can return fewer than limit rows on a page after boundary rows are dropped; next_page shows whether more rows exist.","inputs":[{"name":"config_id","type":null,"required":false,"description":"Optional score config ID"},{"name":"data_type","type":null,"required":false,"description":"Optional score data type"},{"name":"environment","type":null,"required":false,"description":"Optional environment filter"},{"name":"from_timestamp","type":null,"required":false,"description":"Optional ISO8601 timestamp lower bound"},{"name":"limit","type":"integer","required":false,"description":"Items per page (max 100)"},{"name":"name","type":null,"required":false,"description":"Optional score name filter"},{"name":"operator","type":null,"required":false,"description":"Optional comparison for value: =, >, >=, < or <= (default =)"},{"name":"page","type":"integer","required":false,"description":"Page number for pagination (starts at 1)"},{"name":"queue_id","type":null,"required":false,"description":"Optional annotation queue ID"},{"name":"score_ids","type":null,"required":false,"description":"Optional comma-separated score IDs"},{"name":"session_id","type":null,"required":false,"description":"Optional session ID (not together with trace_id)"},{"name":"source","type":null,"required":false,"description":"Optional score source filter"},{"name":"to_timestamp","type":null,"required":false,"description":"Optional ISO8601 timestamp upper bound"},{"name":"trace_id","type":null,"required":false,"description":"Optional trace ID"},{"name":"trace_tags","type":null,"required":false,"description":"Optional comma-separated trace tags (Scores API v3 has none: uses GET /v2/scores, which Langfuse Cloud removes on 2026-11-16)"},{"name":"user_id","type":null,"required":false,"description":"Optional user ID filter (Scores API v3 has none: uses GET /v2/scores, which Langfuse Cloud removes on 2026-11-16)"},{"name":"value","type":null,"required":false,"description":"Optional numeric score value filter"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":351},{"name":"get_score_v2","title":null,"description":"Get a score by ID from Scores API v3 (the v2 route where v3 is not served).","inputs":[{"name":"score_id","type":"string","required":true,"description":"Score ID"}],"outputs":[],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":42},{"name":"fetch_sessions","title":null,"description":"Get a list of sessions in the current project.\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    age: Minutes ago to start looking (e.g., 1440 for 24 hours)\n    page: Page number for pagination (starts at 1)\n    limit: Maximum number of sessions to return per page\n    output_mode: Controls the output format and detail level\n\nReturns:\n    Based on output_mode:\n    - compact: List of summarized session objects\n    - full_json_string: String containing the full JSON response\n    - full_json_file: List of summarized session objects with file save info","inputs":[{"name":"age","type":"integer","required":true,"description":"Minutes ago to start looking (e.g., 1440 for 24 hours)"},{"name":"limit","type":"integer","required":false,"description":"Maximum number of sessions to return per page"},{"name":"output_mode","type":"string","required":false,"description":"Controls the output format and action. 'compact' (default): Returns a summarized JSON object optimized for direct agent consumption. 'full_json_string': Returns the complete, raw JSON data serialized…"},{"name":"page","type":"integer","required":false,"description":"Page number for pagination (starts at 1)"}],"outputs":[{"name":"result","type":null,"required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":259},{"name":"get_session_details","title":null,"description":"Get detailed information about a specific session.\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    session_id: The ID of the session to retrieve (unique identifier string)\n    include_observations: If True, fetch and include the full observation objects instead of just IDs.\n        Use this when you need access to system prompts, model parameters, or other details stored\n        within observations. Significantly increases response time but provides complete data.\n    output_mode: Controls the output format and detail level\n\nReturns:\n    Based on output_mode:\n    - compact: Summarized session details object\n    - full_json_string: String containing the full JSON response\n    - full_json_file: Summarized session details object with file save info\n\nUsage Tips:\n    - For quick browsing: use include_observations=False with output_mode=\"compact\"\n    - For full data but viewable in responses: use include_observations=True with output_mode=\"compact\"\n    - For complete data dumps: use include_observations=True with output_mode=\"full_json_file\"","inputs":[{"name":"include_observations","type":"boolean","required":false,"description":"If True, fetch and include the full observation objects instead of just IDs. Use this when you need access to system prompts, model parameters, or other details stored within observations. Significan…"},{"name":"output_mode","type":"string","required":false,"description":"Controls the output format and action. 'compact' (default): Returns a summarized JSON object optimized for direct agent consumption. 'full_json_string': Returns the complete, raw JSON data serialized…"},{"name":"session_id","type":"string","required":true,"description":"The ID of the session to retrieve (unique identifier string)"}],"outputs":[{"name":"result","type":null,"required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":386},{"name":"get_user_sessions","title":null,"description":"Get sessions for a user within a time range.\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    user_id: The ID of the user to retrieve sessions for (unique identifier string)\n    age: Minutes ago to start looking (e.g., 1440 for 24 hours)\n    include_observations: If True, fetch and include the full observation objects instead of just IDs.\n        Use this when you need access to system prompts, model parameters, or other details stored\n        within observations. Significantly increases response time but provides complete data.\n    output_mode: Controls the output format and detail level\n\nReturns:\n    Based on output_mode:\n    - compact: List of summarized session objects\n    - full_json_string: String containing the full JSON response\n    - full_json_file: List of summarized session objects with file save info\n\nUsage Tips:\n    - For quick browsing: use include_observations=False with output_mode=\"compact\"\n    - For full data but viewable in responses: use include_observations=True with output_mode=\"compact\"\n    - For complete data dumps: use include_observations=True with output_mode=\"full_json_file\"","inputs":[{"name":"age","type":"integer","required":true,"description":"Minutes ago to start looking (e.g., 1440 for 24 hours)"},{"name":"include_observations","type":"boolean","required":false,"description":"If True, fetch and include the full observation objects instead of just IDs. Use this when you need access to system prompts, model parameters, or other details stored within observations. Significan…"},{"name":"output_mode","type":"string","required":false,"description":"Controls the output format and action. 'compact' (default): Returns a summarized JSON object optimized for direct agent consumption. 'full_json_string': Returns the complete, raw JSON data serialized…"},{"name":"user_id","type":"string","required":true,"description":"The ID of the user to retrieve sessions for"}],"outputs":[{"name":"result","type":null,"required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":429},{"name":"fetch_traces","title":null,"description":"Find traces based on filters. All filter parameters are optional.\n\nOn Observations API v2, each trace is built from its root observation; traces without a root observation do not appear.","inputs":[{"name":"age","type":"integer","required":true,"description":"Minutes ago to start looking (e.g., 1440 for 24 hours)"},{"name":"include_observations","type":"boolean","required":false,"description":"If True, fetch and include the full observation objects instead of just IDs. Use this when you need access to system prompts, model parameters, or other details stored within observations. Significan…"},{"name":"limit","type":"integer","required":false,"description":"Maximum number of traces to return per page"},{"name":"metadata","type":null,"required":false,"description":"Metadata fields to filter by"},{"name":"name","type":null,"required":false,"description":"Name of the trace to filter by"},{"name":"output_mode","type":"string","required":false,"description":"Controls the output format: 'compact' (default) returns summarized JSON, 'full_json_string' returns complete raw JSON as string, 'full_json_file' saves complete data to file and returns summary with…"},{"name":"page","type":"integer","required":false,"description":"Page number for pagination (starts at 1)"},{"name":"session_id","type":null,"required":false,"description":"Session ID to filter traces by"},{"name":"tags","type":null,"required":false,"description":"Tag or comma-separated list of tags to filter traces by"},{"name":"user_id","type":null,"required":false,"description":"User ID to filter traces by"}],"outputs":[{"name":"result","type":null,"required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":267},{"name":"fetch_trace","title":null,"description":"Get a single trace by ID with full details.\n\nOn Observations API v2, a trace is built from its root observation; a trace with no observations is not found.\n\nArgs:\n    ctx: Context object containing lifespan context with Langfuse client\n    trace_id: The ID of the trace to fetch (unique identifier string)\n    include_observations: If True, fetch and include the full observation objects. If False, the\n        observations field group is dropped entirely to avoid expensive per-observation IO.\n        Use True when you need access to system prompts, model parameters, or other details stored\n        within observations. Significantly increases response time but provides complete data.\n    output_mode: Controls the output format and detail level\n\nReturns:\n    One of the following based on output_mode:\n    - For 'compact' and 'full_json_file': A response dictionary with the structure:\n      {\n          \"data\": Single trace object,\n          \"metadata\": {\n              \"file_path\": Path to saved file (only for full_json_file mode),\n              \"file_info\": File save details (only for full_json_file mode)\n          }\n      }\n    - For 'full_json_string': A string containing the full JSON response\n\nUsage Tips:\n    - For quick browsing: use include_observations=False with output_mode=\"compact\"\n    - For full data but viewable in responses: use include_observations=True with output_mode=\"compact\"\n    - For complete data dumps: use include_observations=True with output_mode=\"full_json_file\"","inputs":[{"name":"include_observations","type":"boolean","required":false,"description":"If True, fetch and include the full observation objects. If False, the observations field group is dropped entirely to avoid the expensive per-observation IO that dominates large-trace payloads. Use…"},{"name":"output_mode","type":"string","required":false,"description":"Controls the output format and action. 'compact' (default): Returns a summarized JSON object optimized for direct agent consumption. 'full_json_string': Returns the complete, raw JSON data serialized…"},{"name":"trace_id","type":"string","required":true,"description":"The ID of the trace to fetch (unique identifier string)"}],"outputs":[{"name":"result","type":null,"required":true,"description":null}],"hasOutputSchema":true,"hasExamples":false,"tokenEstimate":500}],"toolsTruncatedAtCapture":false,"diagnostics":{"capturedAt":"2026-11-21T05:00:23.000Z","track":"package","endpoint":null,"declaredUrl":null,"truncated":false,"tls":null,"dnssec":null,"auth":null,"httpsRedirect":null,"transports":[],"provenance":{"outcome":"verified","label":"Verified","reason":"verified","reasonLabel":"Verified","discovery":"github_attestations","discoveryLabel":"GitHub artifact attestations","sourceRepo":null,"attestationSkipped":null,"attestationSkippedLabel":null},"installScripts":[{"hook":"build_backend","tier":"allowlisted"},{"hook":"build_hook","tier":"unreviewed"}],"installScriptsTotal":null,"vulnerabilities":[],"vulnerabilitiesTotal":null,"dependencies":{"nodes":49,"partial":false,"deprecated":null,"stale":1,"noRepo":1}},"mismatches":[],"changelog":{"trackingSince":"2026-09-25","recent":[{"id":"chg_01a1fc7a-1ad9-7d69-9e0b-84ba9d3b4148","kind":"check.verdict","summary":"Stability (0.97 → pass)","materiality":"security","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-21","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1fc7a-1ad9-7d69-9e0b-84ba9d3b4148"},{"id":"chg_01a1fc7a-1adb-7b84-a8c5-e4e70dc8728c","kind":"score.total_changed","summary":"Trust score (75 → 76)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-21","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1fc7a-1adb-7b84-a8c5-e4e70dc8728c"},{"id":"chg_01a1f23d-053c-7099-afaa-a44aec3ef307","kind":"check.verdict","summary":"Stability (pass → 0.93)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-19","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1f23d-053c-7099-afaa-a44aec3ef307"},{"id":"chg_01a1f23d-053e-7895-89bb-90d57ee6b8f5","kind":"score.total_changed","summary":"Trust score (76 → 75)","materiality":"functional","direction":"regression","scoreDelta":-1,"occurredOn":"2026-11-19","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1f23d-053e-7895-89bb-90d57ee6b8f5"},{"id":"chg_01a1d36f-9ace-7613-aae8-7c6af3f5b4b7","kind":"check.unverifiable","summary":"Malware scan (pass → unverified)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-13","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1d36f-9ace-7613-aae8-7c6af3f5b4b7"},{"id":"chg_01a1d36f-9acf-7888-83a0-aec792a34252","kind":"check.verdict","summary":"Stability (0.97 → pass)","materiality":"security","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-13","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1d36f-9acf-7888-83a0-aec792a34252"},{"id":"chg_01a1d36f-9acf-7ec4-9d4c-b057d9eeaf81","kind":"package.version_changed","summary":"Package version (0.13.0 → 0.14.0)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-13","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1d36f-9acf-7ec4-9d4c-b057d9eeaf81"},{"id":"chg_01a1d36f-9ad0-7560-886c-7947636a0d6f","kind":"score.total_changed","summary":"Trust score (90 → 76)","materiality":"functional","direction":"regression","scoreDelta":-14,"occurredOn":"2026-11-13","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1d36f-9ad0-7560-886c-7947636a0d6f"},{"id":"chg_01a1cd7d-3f8b-7bbb-95ea-512319aaf6c9","kind":"check.reverified","summary":"Malware scan (unverified → pass)","materiality":"security","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-12","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1cd7d-3f8b-7bbb-95ea-512319aaf6c9"},{"id":"chg_01a1cd7d-3f8e-72f7-bafa-4eb5707f429e","kind":"score.total_changed","summary":"Trust score (75 → 90)","materiality":"functional","direction":"improvement","scoreDelta":15,"occurredOn":"2026-11-12","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1cd7d-3f8e-72f7-bafa-4eb5707f429e"},{"id":"chg_01a1c8fa-c1d6-7eea-8f1e-8b87172d8fd8","kind":"check.unverifiable","summary":"Malware scan (pass → unverified)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-11","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1c8fa-c1d6-7eea-8f1e-8b87172d8fd8"},{"id":"chg_01a1c8fa-c1d9-720e-97c7-e914bf3986a0","kind":"score.total_changed","summary":"Trust score (89 → 75)","materiality":"functional","direction":"regression","scoreDelta":-14,"occurredOn":"2026-11-11","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1c8fa-c1d9-720e-97c7-e914bf3986a0"},{"id":"chg_01a1be0d-e214-7164-bc5d-5859ff72cf21","kind":"score.total_changed","summary":"Trust score (88 → 89)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-09","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1be0d-e214-7164-bc5d-5859ff72cf21"},{"id":"chg_01a1b3c0-a622-726c-ad2e-a4c0f41eb559","kind":"check.verdict","summary":"Stability (pass → 0.80)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-07","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1b3c0-a622-726c-ad2e-a4c0f41eb559"},{"id":"chg_01a1b3c0-a623-7623-ab50-6b4810a01986","kind":"score.total_changed","summary":"Trust score (91 → 88)","materiality":"functional","direction":"regression","scoreDelta":-3,"occurredOn":"2026-11-07","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1b3c0-a623-7623-ab50-6b4810a01986"},{"id":"chg_01a1af09-dd62-7431-8e87-f690ee2e8744","kind":"check.reverified","summary":"Malware scan (unverified → pass)","materiality":"security","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-06","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1af09-dd62-7431-8e87-f690ee2e8744"},{"id":"chg_01a1af09-dd6c-700b-bf51-4825d1b33291","kind":"score.total_changed","summary":"Trust score (76 → 91)","materiality":"functional","direction":"improvement","scoreDelta":15,"occurredOn":"2026-11-06","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1af09-dd6c-700b-bf51-4825d1b33291"},{"id":"chg_01a1aa20-54eb-71ff-94c0-2f02d31557a5","kind":"check.unverifiable","summary":"Malware scan (pass → unverified)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-05","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1aa20-54eb-71ff-94c0-2f02d31557a5"},{"id":"chg_01a1aa20-54ec-7b1c-b2a9-b5309b11e006","kind":"score.total_changed","summary":"Trust score (91 → 76)","materiality":"functional","direction":"regression","scoreDelta":-15,"occurredOn":"2026-11-05","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1aa20-54ec-7b1c-b2a9-b5309b11e006"},{"id":"chg_01a1a44c-2b13-7413-bcc6-7c8e381889ae","kind":"check.reverified","summary":"Malware scan (unverified → pass)","materiality":"security","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-04","url":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp#chg-chg_01a1a44c-2b13-7413-bcc6-7c8e381889ae"}],"truncated":true,"feedUrl":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp/changelog.json"},"links":{"html":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp","markdown":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp.md","changelogJson":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp/changelog.json","changelogRss":"https://verifymcp.io/servers/avivsinai-langfuse-mcp/langfuse-mcp.xml","external":[{"label":"PyPI project","href":"https://pypi.org/project/langfuse-mcp/"},{"label":"Socket report","href":"https://socket.dev/pypi/package/langfuse-mcp"},{"label":"Repository","href":"https://github.com/avivsinai/langfuse-mcp"}]}}