{
  "schemaVersion": "1.0",
  "title": "Langfuse MCP Servers",
  "description": "Connect MCP clients to Langfuse Cloud for project-scoped prompt management and to Langfuse Docs for public documentation search and retrieval.",
  "build": {
    "generatedAt": "2026-11-11T12:33:51.955Z",
    "generator": "src/lib/reference-builder.ts",
    "sourceConfig": "mcp-reference.config.json",
    "serverCount": 2,
    "toolCount": 106
  },
  "servers": [
    {
      "id": "langfuse-cloud",
      "name": "Langfuse Cloud MCP",
      "description": "Authenticated project-scoped MCP server for Langfuse Cloud projects.",
      "canonicalUrl": "https://cloud.langfuse.com/api/public/mcp",
      "auth": {
        "type": "basic",
        "publicKeyEnv": "LANGFUSE_PUBLIC_KEY",
        "secretKeyEnv": "LANGFUSE_SECRET_KEY"
      },
      "variants": [
        {
          "label": "Cloud EU",
          "url": "https://cloud.langfuse.com/api/public/mcp"
        },
        {
          "label": "Cloud US",
          "url": "https://us.cloud.langfuse.com/api/public/mcp"
        },
        {
          "label": "Cloud Japan",
          "url": "https://jp.cloud.langfuse.com/api/public/mcp"
        },
        {
          "label": "HIPAA US",
          "url": "https://hipaa.cloud.langfuse.com/api/public/mcp"
        },
        {
          "label": "Self-Hosted",
          "url": "https://your-domain.com/api/public/mcp"
        },
        {
          "label": "Local Development",
          "url": "http://localhost:3000/api/public/mcp"
        }
      ],
      "setupSnippets": [
        {
          "id": "langfuse-cloud-cursor",
          "client": "Cursor",
          "title": "Cursor mcp.json",
          "language": "json",
          "code": "{\n  \"mcpServers\": {\n    \"langfuse-cloud\": {\n      \"url\": \"https://cloud.langfuse.com/api/public/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Basic <base64(LANGFUSE_PUBLIC_KEY:LANGFUSE_SECRET_KEY)>\"\n      }\n    }\n  }\n}"
        },
        {
          "id": "langfuse-cloud-claude-code",
          "client": "Claude Code",
          "title": "Claude Code CLI",
          "language": "bash",
          "code": "export LANGFUSE_PUBLIC_KEY=pk-lf-your-public-key\nexport LANGFUSE_SECRET_KEY=sk-lf-your-secret-key\nclaude mcp add --transport http langfuse-cloud https://cloud.langfuse.com/api/public/mcp \\\n  --header \"Authorization: Basic $(printf '%s:%s' \"$LANGFUSE_PUBLIC_KEY\" \"$LANGFUSE_SECRET_KEY\" | base64)\""
        },
        {
          "id": "langfuse-cloud-generic",
          "client": "Generic MCP client",
          "title": "Streamable HTTP JSON",
          "language": "json",
          "code": "{\n  \"servers\": {\n    \"langfuse-cloud\": {\n      \"transport\": {\n        \"type\": \"streamable-http\",\n        \"url\": \"https://cloud.langfuse.com/api/public/mcp\",\n        \"headers\": {\n          \"Authorization\": \"Basic <base64(LANGFUSE_PUBLIC_KEY:LANGFUSE_SECRET_KEY)>\"\n        }\n      }\n    }\n  }\n}"
        }
      ],
      "discovery": {
        "protocolVersion": "2025-06-18",
        "serverInfo": {
          "name": "langfuse",
          "version": "0.3.0-unstable"
        },
        "capabilities": {
          "tools": {},
          "resources": {},
          "extensions": {
            "io.modelcontextprotocol/skills": {}
          }
        },
        "discoveredAt": "2026-11-11T12:33:51.643Z"
      },
      "tools": [
        {
          "name": "getPrompt",
          "description": "Fetch a specific prompt by name with optional label or version parameter.\n\nRetrieval options:\n- label: Get prompt with specific label (e.g., 'production', 'staging')\n- version: Get specific version number (e.g., 1, 2, 3)\n- neither: Returns 'latest' version by default\n\nNote: label and version are mutually exclusive. Returns full prompt content with resolved dependencies.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 255,
                "description": "The name of the prompt"
              },
              "label": {
                "description": "Label to retrieve (e.g., \"production\", \"staging\"). Defaults to \"latest\".",
                "type": "string",
                "minLength": 1,
                "maxLength": 36,
                "pattern": "^[a-z0-9_\\-.]+$"
              },
              "version": {
                "description": "Specific version number to retrieve (e.g., 1, 2, 3)",
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              }
            },
            "required": [
              "name"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getPrompt",
              "arguments": {
                "name": "string",
                "label": "string",
                "version": 1
              }
            }
          }
        },
        {
          "name": "getPromptUnresolved",
          "description": "Fetch a specific prompt by name with optional label or version parameter WITHOUT resolving dependencies.\n\nReturns the raw prompt content with dependency tags intact. Useful for:\n- Understanding prompt composition/stacking before resolution\n- Debugging prompt dependencies\n- Analyzing the dependency graph structure\n\nRetrieval options:\n- label: Get prompt with specific label (e.g., 'production', 'staging')\n- version: Get specific version number (e.g., 1, 2, 3)\n- neither: Returns 'latest' version by default\n\nNote: label and version are mutually exclusive. To get resolved prompts, use the 'getPrompt' tool instead.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 255,
                "description": "The name of the prompt"
              },
              "label": {
                "description": "Label to retrieve (e.g., \"production\", \"staging\"). Defaults to \"latest\".",
                "type": "string",
                "minLength": 1,
                "maxLength": 36,
                "pattern": "^[a-z0-9_\\-.]+$"
              },
              "version": {
                "description": "Specific version number to retrieve (e.g., 1, 2, 3)",
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              }
            },
            "required": [
              "name"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getPromptUnresolved",
              "arguments": {
                "name": "string",
                "label": "string",
                "version": 1
              }
            }
          }
        },
        {
          "name": "listPrompts",
          "description": "List and filter prompts in the project. Returns metadata including versions, labels, tags, last updated timestamp, and prompt type.\n\nOptional filters:\n- name: Filter by exact prompt name\n- label: Filter by label on any version\n- tag: Filter by tag\n- fromUpdatedAt: Filter prompts updated at or after this timestamp\n- toUpdatedAt: Filter prompts updated at or before this timestamp\n\nPagination: page (default: 1), limit (default: 50, max: 100)",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "name": {
                "description": "Filter by exact prompt name match",
                "type": "string",
                "minLength": 1,
                "maxLength": 255
              },
              "label": {
                "description": "Filter by label (e.g., 'production', 'staging')",
                "type": "string",
                "minLength": 1,
                "maxLength": 36,
                "pattern": "^[a-z0-9_\\-.]+$"
              },
              "tag": {
                "description": "Filter by tag (e.g., 'experimental', 'v1')",
                "type": "string"
              },
              "fromUpdatedAt": {
                "description": "Filter prompts updated at or after this timestamp (ISO 8601 with timezone, e.g. 2026-02-02T00:00:00Z)",
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$"
              },
              "toUpdatedAt": {
                "description": "Filter prompts updated at or before this timestamp (ISO 8601 with timezone, e.g. 2026-02-02T00:00:00Z)",
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$"
              },
              "page": {
                "default": 1,
                "description": "Page number for pagination (default: 1)",
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740991
              },
              "limit": {
                "default": 50,
                "description": "Number of items to return (1-100, default: 50)",
                "type": "integer",
                "minimum": 1,
                "maximum": 100
              }
            },
            "required": [
              "page",
              "limit"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listPrompts",
              "arguments": {
                "limit": 50,
                "page": 1,
                "fromUpdatedAt": "string",
                "label": "string",
                "name": "string",
                "tag": "string",
                "toUpdatedAt": "string"
              }
            }
          }
        },
        {
          "name": "createTextPrompt",
          "description": "Create a new text prompt version in Langfuse.\n\nImportant:\n- Prompts are immutable - cannot modify existing versions\n- To update content, create a new version\n- New prompt versions receive the 'latest' label automatically\n- Cannot assign the 'production' label during creation\n- To promote to production, use updatePromptLabels only when the user explicitly requests it\n- Labels are unique across versions\n- Use {{variable_name}} syntax for dynamic content\n\nAccepts: name, prompt (string), optional labels, config, tags, commitMessage",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 255,
                "description": "The name of the prompt"
              },
              "prompt": {
                "type": "string",
                "description": "The prompt text content (supports {{variables}})"
              },
              "labels": {
                "description": "Optional labels to assign, excluding 'production'. New prompt versions receive the 'latest' label automatically.",
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "config": {
                "description": "Optional JSON config (e.g., {model: 'gpt-4', temperature: 0.7})",
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              },
              "tags": {
                "description": "Optional tags for organization (e.g., ['experimental', 'v2'])",
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "commitMessage": {
                "description": "Optional commit message describing the changes",
                "type": "string"
              }
            },
            "required": [
              "name",
              "prompt"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "createTextPrompt",
              "arguments": {
                "name": "string",
                "prompt": "string",
                "commitMessage": "string",
                "config": {
                  "property": {}
                },
                "labels": [
                  "string"
                ],
                "tags": [
                  "string"
                ]
              }
            }
          }
        },
        {
          "name": "createChatPrompt",
          "description": "Create a new chat prompt version in Langfuse. Chat prompts are arrays of messages with roles and content.\n\nImportant:\n- Prompts are immutable - cannot modify existing versions\n- To update content, create a new version\n- New prompt versions receive the 'latest' label automatically\n- Cannot assign the 'production' label during creation\n- To promote to production, use updatePromptLabels only when the user explicitly requests it\n- Labels are unique across versions\n\nMessage roles: system (instructions), user (input, can contain {{variables}}), assistant (examples)\nPlaceholder messages: {type: 'placeholder', name: '<variable>'} reference runtime variable values (e.g. conversation history) inserted when the prompt is used\nAccepts: name, prompt (array of {role, content} or {type: 'placeholder', name}), optional labels, config, tags, commitMessage",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 255,
                "description": "The name of the prompt"
              },
              "prompt": {
                "minItems": 1,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "type": {
                      "description": "Message type. Defaults to 'message'. Use 'placeholder' to reference a runtime variable value (e.g. conversation history) instead of a literal message.",
                      "type": "string",
                      "enum": [
                        "message",
                        "placeholder"
                      ]
                    },
                    "role": {
                      "description": "The role (e.g., 'system', 'user', 'assistant'). Required for 'message' type.",
                      "type": "string"
                    },
                    "content": {
                      "description": "The message content. Required for 'message' type.",
                      "type": "string"
                    },
                    "name": {
                      "description": "The variable name for 'placeholder' type messages (e.g. 'history'). Required for 'placeholder' type.",
                      "type": "string"
                    }
                  },
                  "additionalProperties": false
                },
                "description": "Array of chat messages. Each message is either {role, content} or a placeholder {type: 'placeholder', name: '<variable>'} that is replaced with a runtime variable value"
              },
              "labels": {
                "description": "Optional labels to assign, excluding 'production'. New prompt versions receive the 'latest' label automatically.",
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "config": {
                "description": "Optional JSON config (e.g., {model: 'gpt-4', temperature: 0.7})",
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              },
              "tags": {
                "description": "Optional tags for organization (e.g., ['experimental', 'v2'])",
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "commitMessage": {
                "description": "Optional commit message describing the changes",
                "type": "string"
              }
            },
            "required": [
              "name",
              "prompt"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "createChatPrompt",
              "arguments": {
                "name": "string",
                "prompt": [
                  {
                    "content": "string",
                    "name": "string",
                    "role": "string",
                    "type": "message"
                  }
                ],
                "commitMessage": "string",
                "config": {
                  "property": {}
                },
                "labels": [
                  "string"
                ],
                "tags": [
                  "string"
                ]
              }
            }
          }
        },
        {
          "name": "updatePromptLabels",
          "description": "Update labels for a specific prompt version.\n\nImportant:\n- ONLY way to modify existing prompts (labels only)\n- Specified labels are added to the version (preserving others not mentioned)\n- Labels are unique across versions - setting a label on one version automatically removes it from others\n- 'latest' label is auto-managed and cannot be set manually\n- Only add the 'production' label when the user explicitly asks to promote this prompt version to production\n- Cannot modify prompt content, type, or tags - use createTextPrompt or createChatPrompt for new versions\n\nAccepts: name, version (required), newLabels (array, can be empty to remove all labels)",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 255,
                "description": "The name of the prompt"
              },
              "version": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991,
                "description": "The version number to update (required)"
              },
              "newLabels": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Array of new labels to assign to the prompt version (can be empty to remove all labels). The 'latest' label is auto-managed and cannot be supplied."
              }
            },
            "required": [
              "name",
              "version",
              "newLabels"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "updatePromptLabels",
              "arguments": {
                "name": "string",
                "newLabels": [
                  "string"
                ],
                "version": 1
              }
            }
          }
        },
        {
          "name": "listSkills",
          "description": "List and search project skills with tags and version summaries. Supports filtering and pagination.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64,
                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
              },
              "search": {
                "type": "string",
                "maxLength": 1000
              },
              "tag": {
                "type": "string"
              },
              "page": {
                "default": 1,
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740991
              },
              "limit": {
                "default": 10,
                "type": "integer",
                "minimum": 1,
                "maximum": 100
              },
              "fromUpdatedAt": {
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$"
              },
              "toUpdatedAt": {
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$"
              }
            },
            "required": [
              "page",
              "limit"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listSkills",
              "arguments": {
                "limit": 10,
                "page": 1,
                "fromUpdatedAt": "string",
                "name": "string",
                "search": "string",
                "tag": "string",
                "toUpdatedAt": "string"
              }
            }
          }
        },
        {
          "name": "getSkill",
          "description": "Get skill metadata and file paths, without file contents. Version and label are optional; defaults to production, or latest if no production label is set. Use the returned version with loadSkill and loadSkillResource to read files from the same immutable version.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64,
                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
              },
              "version": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "label": {
                "type": "string",
                "minLength": 1,
                "maxLength": 36,
                "pattern": "^[a-z0-9_\\-.]+$"
              }
            },
            "required": [
              "name"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getSkill",
              "arguments": {
                "name": "string",
                "label": "string",
                "version": 1
              }
            }
          }
        },
        {
          "name": "loadSkill",
          "description": "Read a skill's SKILL.md as text. Version and label are optional; defaults to production, or latest if no production label is set. Reuse the version returned by getSkill when loading multiple files.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64,
                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
              },
              "version": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "label": {
                "type": "string",
                "minLength": 1,
                "maxLength": 36,
                "pattern": "^[a-z0-9_\\-.]+$"
              }
            },
            "required": [
              "name"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "loadSkill",
              "arguments": {
                "name": "string",
                "label": "string",
                "version": 1
              }
            }
          }
        },
        {
          "name": "loadSkillResource",
          "description": "Read a skill file as text by path (see getSkill). Version and label are optional; defaults to production, or latest if no production label is set. Reuse the version returned by getSkill when loading multiple files.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64,
                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
              },
              "path": {
                "type": "string",
                "minLength": 1,
                "maxLength": 512
              },
              "version": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "label": {
                "type": "string",
                "minLength": 1,
                "maxLength": 36,
                "pattern": "^[a-z0-9_\\-.]+$"
              }
            },
            "required": [
              "name",
              "path"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "loadSkillResource",
              "arguments": {
                "name": "string",
                "path": "string",
                "label": "string",
                "version": 1
              }
            }
          }
        },
        {
          "name": "createSkillVersion",
          "description": "Create a skill or a new immutable version of an existing skill in the current project. Provide all files as inline text, including SKILL.md with YAML frontmatter containing name and description. The name identifies the skill; using an existing name creates its next version. Omitted files are absent from the new version, while earlier versions remain unchanged. New versions receive the latest label; this does not promote them to production or install them into Halo's own instructions.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "files": {
                "minItems": 1,
                "maxItems": 200,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "path": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 512
                    },
                    "content": {
                      "type": "string",
                      "description": "Full UTF-8 text content of the file"
                    }
                  },
                  "required": [
                    "path",
                    "content"
                  ],
                  "additionalProperties": false
                },
                "description": "Complete set of files for this version, including a root SKILL.md with YAML name and description frontmatter. Maximum 1 MB of text in total."
              },
              "commitMessage": {
                "description": "Optional description of the changes",
                "type": "string",
                "maxLength": 500
              }
            },
            "required": [
              "files"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "createSkillVersion",
              "arguments": {
                "files": [
                  {
                    "content": "string",
                    "path": "string"
                  }
                ],
                "commitMessage": "string"
              }
            }
          }
        },
        {
          "name": "updateSkillLabels",
          "description": "Replace the user-managed labels on a specific skill version in the current project. Include every label to retain; an empty labels array removes all user-managed labels from that version. Labels are unique across versions of a skill: assigning a label moves it from any other version. The latest label is automatically managed, is preserved, and must not be supplied. Only assign the production label when the user explicitly asks to promote that version. Read its current labels first and include any labels the user wants to retain. Protected-label permissions apply to both adding and removing labels, even after approval.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "labels": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 36,
                  "pattern": "^[a-z0-9_\\-.]+$"
                }
              },
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64,
                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
              },
              "version": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              }
            },
            "required": [
              "labels",
              "name",
              "version"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "updateSkillLabels",
              "arguments": {
                "labels": [
                  "string"
                ],
                "name": "string",
                "version": 1
              }
            }
          }
        },
        {
          "name": "updateSkillTags",
          "description": "Replace the tags on a skill in the current project, across all of its versions. Read the current tags first and include every tag to retain; an empty tags array removes all tags. This does not create a version or change version labels. Returns the latest version's metadata. Adding or removing discovery tags can change which skills integrations, including Halo, load.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "tags": {
                "maxItems": 50,
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100
                }
              },
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64,
                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
              }
            },
            "required": [
              "tags",
              "name"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "updateSkillTags",
              "arguments": {
                "name": "string",
                "tags": [
                  "string"
                ]
              }
            }
          }
        },
        {
          "name": "listObservations",
          "description": "Find and review observations in the current Langfuse project, such as generations, spans, events, agent steps, and tool calls.\nTraces consist of observations. Use this tool when the user asks to inspect traces: pass traceId to page through the observations for a specific trace; those observation records are the trace data returned by the API.\nPrefer structured filters such as trace, name, type, level, and environment, combined with narrow time ranges. Use input/output/metadata content search only when matching that content is necessary to answer the user's question. Results are paginated with an opaque cursor.\nFor metadata filters, first inspect metadata by passing both fromStartTime and toStartTime with a maximum range of 14 days (336 elapsed hours) and fields: [\"id\", \"metadata\"]. Then use a discovered key in a stringObject filter.\n\nStart with the default compact summary fields, then use getObservation to fetch full input/output only for selected observations that need closer inspection. Pass specific field names to limit the response size; fields: [\"*\"] returns the full observation.\nImportant: if you request metadata explicitly, for example fields: [\"id\", \"metadata\"], metadata values are truncated to 200 UTF-8 characters per key unless you also pass expandMetadataKeys with the keys that may need full values.\nAll requests must include explicit fromStartTime (inclusive) and toStartTime (exclusive) with 0 < toStartTime - fromStartTime <= 336 hours (14 days), even when scoped by traceId or observation id. This is elapsed time, not a count of calendar dates. For example, 2026-10-01T00:00:00Z to 2026-10-15T00:00:00Z is valid; ending at 2026-10-15T23:59:59Z exceeds the limit. Split longer ranges into adjacent windows, using each window's toStartTime as the next window's fromStartTime. Reuse timestamps from earlier results to narrow the search. Input/output projections support a maximum limit of 50.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "fields": {
                "description": "Observation fields to include in the response. Omit for compact defaults, use [\"*\"] for all available fields, or pass specific field names to keep responses small. Call getObservationFieldSchema to list accepted fields.",
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "expandMetadataKeys": {
                "description": "Metadata keys that may need full values. Metadata values are truncated to 200 UTF-8 characters per key by default when metadata is projected without this option.",
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "limit": {
                "default": 50,
                "description": "Number of observations to return (1-100, default: 50)",
                "type": "integer",
                "minimum": 1,
                "maximum": 100
              },
              "cursor": {
                "description": "Cursor returned by a previous listObservations call",
                "type": "string"
              },
              "type": {
                "type": "string",
                "enum": [
                  "SPAN",
                  "EVENT",
                  "GENERATION",
                  "AGENT",
                  "TOOL",
                  "CHAIN",
                  "RETRIEVER",
                  "EVALUATOR",
                  "EMBEDDING",
                  "GUARDRAIL"
                ]
              },
              "name": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "level": {
                "type": "string",
                "enum": [
                  "DEBUG",
                  "DEFAULT",
                  "WARNING",
                  "ERROR"
                ]
              },
              "traceId": {
                "type": "string"
              },
              "version": {
                "type": "string"
              },
              "parentObservationId": {
                "description": "Physical parent observation ID to match exactly.",
                "type": "string"
              },
              "isRootObservation": {
                "description": "Filter by logical root status. App-root observations can match true while retaining a non-null parentObservationId.",
                "type": "boolean"
              },
              "environment": {
                "description": "Environment to filter by. Multiple environments are temporarily unsupported until the public observations API applies allow-multiple environment filters correctly.",
                "type": "string"
              },
              "fromStartTime": {
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$",
                "description": "Required inclusive lower bound on observation startTime, as an ISO 8601 timestamp with timezone (Z or an explicit offset). Must be before toStartTime; the elapsed duration must not exceed 14 days (336 hours)."
              },
              "toStartTime": {
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$",
                "description": "Required exclusive upper bound on observation startTime, as an ISO 8601 timestamp with timezone. Must be after fromStartTime and at most 336 hours later. For 14 full UTC calendar days starting 2026-10-01T00:00:00Z, use 2026-10-15T00:00:00Z, not 2026-10-15T23:59:59Z. Split longer ranges into adjacent requests of at most 336 hours each."
              },
              "filter": {
                "description": "Advanced filters. Each item must be an object with column, operator, value, optional type, and optional key. Type is inferred from getObservationFilterSchema columns when omitted. Use key for metadata filters.",
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "column": {
                      "type": "string"
                    },
                    "operator": {
                      "type": "string"
                    },
                    "value": {},
                    "type": {
                      "type": "string"
                    },
                    "key": {
                      "description": "Metadata/object key to filter on. Required when column is metadata.",
                      "type": "string"
                    }
                  },
                  "required": [
                    "column",
                    "operator",
                    "value"
                  ],
                  "additionalProperties": false,
                  "description": "Advanced observation filter object. Example: {\"column\":\"totalCost\",\"operator\":\">\",\"value\":0.0029}. The explicit form {\"type\":\"number\",\"column\":\"totalCost\",\"operator\":\">\",\"value\":0.0029} is also accepted."
                }
              }
            },
            "required": [
              "limit",
              "fromStartTime",
              "toStartTime"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listObservations",
              "arguments": {
                "fromStartTime": "string",
                "limit": 50,
                "toStartTime": "string",
                "cursor": "string",
                "environment": "string",
                "expandMetadataKeys": [
                  "string"
                ],
                "fields": [
                  "string"
                ],
                "filter": [
                  {
                    "column": "string",
                    "operator": "string",
                    "value": {},
                    "key": "string",
                    "type": "string"
                  }
                ],
                "isRootObservation": true,
                "level": "DEBUG",
                "name": "string",
                "parentObservationId": "string",
                "traceId": "string",
                "type": "SPAN",
                "userId": "string",
                "version": "string"
              }
            }
          },
          "requiresV4": true
        },
        {
          "name": "getObservation",
          "description": "Get the details for a single observation in the current Langfuse project by observation ID.\nUse this when you already know the observation ID and want to inspect its timing, model, status, payload, metadata, usage, cost, or prompt fields.\nRequires explicit fromStartTime (inclusive) and toStartTime (exclusive) with 0 < toStartTime - fromStartTime <= 2160 hours (90 days). The limit measures elapsed time, not calendar dates; do not extend the upper bound to the end of the 90th day. Reuse the observation startTime and traceId from earlier results to narrow the lookup; traceId does not replace time bounds. When using the observation startTime as fromStartTime, choose a later toStartTime.\n\nBy default this returns compact summary fields. After reviewing listObservations summaries, request full input/output only for selected observations that need closer inspection. Pass specific field names to limit the response size; fields: [\"*\"] returns the full observation.\nImportant: if you request metadata explicitly, for example fields: [\"id\", \"metadata\"], metadata values are truncated to 200 UTF-8 characters per key unless you also pass expandMetadataKeys with the keys that may need full values.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "observationId": {
                "type": "string",
                "minLength": 1
              },
              "traceId": {
                "type": "string",
                "minLength": 1
              },
              "fromStartTime": {
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$",
                "description": "Required inclusive lower bound on observation startTime, as an ISO 8601 timestamp with timezone (Z or an explicit offset). Must be before toStartTime; the elapsed duration must not exceed 90 days (2160 hours)."
              },
              "toStartTime": {
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$",
                "description": "Required exclusive upper bound on observation startTime, as an ISO 8601 timestamp with timezone. Must be after fromStartTime and at most 2160 hours later. The observation's startTime must be strictly before this bound."
              },
              "fields": {
                "description": "Observation fields to include in the response. Omit for compact defaults, use [\"*\"] for all available fields, or pass specific field names to keep responses small. Call getObservationFieldSchema to list accepted fields.",
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "expandMetadataKeys": {
                "description": "Metadata keys that may need full values. Metadata values are truncated to 200 UTF-8 characters per key by default when metadata is projected without this option.",
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "observationId",
              "fromStartTime",
              "toStartTime"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getObservation",
              "arguments": {
                "fromStartTime": "string",
                "observationId": "string",
                "toStartTime": "string",
                "expandMetadataKeys": [
                  "string"
                ],
                "fields": [
                  "string"
                ],
                "traceId": "string"
              }
            }
          },
          "requiresV4": true
        },
        {
          "name": "getObservationFieldSchema",
          "description": "Show which observation fields can be requested from listObservations and getObservation. The response marks default fields and fields that may be large or contain sensitive application data.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {},
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getObservationFieldSchema",
              "arguments": {}
            }
          },
          "requiresV4": true
        },
        {
          "name": "getObservationFilterSchema",
          "description": "Show which observation fields can be used in listObservations filters, including the supported operators for each field.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {},
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getObservationFilterSchema",
              "arguments": {}
            }
          },
          "requiresV4": true
        },
        {
          "name": "getObservationFilterValues",
          "description": "List example values for a string or boolean observation filter field, such as names, types, levels, environments, model names, tags, users, or sessions. For numeric metric fields, returns a range with min, max, avg, and count. Use the returned cursor to page through long value lists.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "column": {
                "type": "string",
                "enum": [
                  "name",
                  "type",
                  "environment",
                  "version",
                  "userId",
                  "sessionId",
                  "traceName",
                  "level",
                  "promptName",
                  "promptVersion",
                  "modelId",
                  "providedModelName",
                  "totalCost",
                  "totalTokens",
                  "latency",
                  "timeToFirstToken",
                  "tags",
                  "isRootObservation",
                  "hasParentObservation"
                ]
              },
              "fromStartTime": {
                "description": "Optional inclusive lower bound on observation startTime, as an ISO 8601 timestamp with timezone (Z or an explicit offset). Use the same time window as the observations you intend to search.",
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$"
              },
              "toStartTime": {
                "description": "Optional exclusive upper bound on observation startTime, as an ISO 8601 timestamp with timezone. For a full calendar day, use midnight at the start of the next day, not 23:59:59.",
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$"
              },
              "observationType": {
                "type": "string",
                "enum": [
                  "SPAN",
                  "EVENT",
                  "GENERATION",
                  "AGENT",
                  "TOOL",
                  "CHAIN",
                  "RETRIEVER",
                  "EVALUATOR",
                  "EMBEDDING",
                  "GUARDRAIL"
                ]
              },
              "isRootObservation": {
                "type": "boolean"
              },
              "hasParentObservation": {
                "type": "boolean"
              },
              "limit": {
                "default": 50,
                "description": "Number of observations to return (1-100, default: 50)",
                "type": "integer",
                "minimum": 1,
                "maximum": 100
              },
              "cursor": {
                "type": "string"
              }
            },
            "required": [
              "column",
              "limit"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getObservationFilterValues",
              "arguments": {
                "column": "name",
                "limit": 50,
                "cursor": "string",
                "fromStartTime": "string",
                "hasParentObservation": true,
                "isRootObservation": true,
                "observationType": "SPAN",
                "toStartTime": "string"
              }
            }
          },
          "requiresV4": true
        },
        {
          "name": "listAnnotationQueues",
          "description": "List annotation queues, worklists that collect trace or observation items for human review and scoring, with pagination.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "page": {
                "default": 1,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "limit": {
                "default": 50,
                "type": "integer",
                "minimum": 1,
                "maximum": 100
              }
            },
            "required": [
              "page",
              "limit"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listAnnotationQueues",
              "arguments": {
                "limit": 50,
                "page": 1
              }
            }
          }
        },
        {
          "name": "createAnnotationQueue",
          "description": "Create an annotation queue, a worklist that collects trace or observation items for human review and scoring.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "scoreConfigIds": {
                "minItems": 1,
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "name",
              "scoreConfigIds"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "createAnnotationQueue",
              "arguments": {
                "name": "string",
                "scoreConfigIds": [
                  "string"
                ],
                "description": "string"
              }
            }
          }
        },
        {
          "name": "getAnnotationQueue",
          "description": "Get an annotation queue, a worklist of trace or observation items for human review and scoring, by ID.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "queueId": {
                "type": "string"
              }
            },
            "required": [
              "queueId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getAnnotationQueue",
              "arguments": {
                "queueId": "string"
              }
            }
          }
        },
        {
          "name": "listAnnotationQueueItems",
          "description": "List annotation queue items, each linking one trace or observation to a queue with a review status, with optional status filtering.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "page": {
                "default": 1,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "limit": {
                "default": 50,
                "type": "integer",
                "minimum": 1,
                "maximum": 100
              },
              "queueId": {
                "type": "string"
              },
              "status": {
                "type": "string",
                "enum": [
                  "PENDING",
                  "COMPLETED"
                ]
              }
            },
            "required": [
              "page",
              "limit",
              "queueId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listAnnotationQueueItems",
              "arguments": {
                "limit": 50,
                "page": 1,
                "queueId": "string",
                "status": "PENDING"
              }
            }
          }
        },
        {
          "name": "getAnnotationQueueItem",
          "description": "Get an annotation queue item, one queued trace or observation with review status, by queue ID and item ID.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "queueId": {
                "type": "string"
              },
              "itemId": {
                "type": "string"
              }
            },
            "required": [
              "queueId",
              "itemId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getAnnotationQueueItem",
              "arguments": {
                "itemId": "string",
                "queueId": "string"
              }
            }
          }
        },
        {
          "name": "createAnnotationQueueItem",
          "description": "Add an annotation queue item, one trace or observation to review, to a queue.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "queueId": {
                "type": "string"
              },
              "objectId": {
                "type": "string"
              },
              "objectType": {
                "type": "string",
                "enum": [
                  "TRACE",
                  "OBSERVATION",
                  "SESSION"
                ]
              },
              "status": {
                "default": "PENDING",
                "type": "string",
                "enum": [
                  "PENDING",
                  "COMPLETED"
                ]
              }
            },
            "required": [
              "queueId",
              "objectId",
              "objectType",
              "status"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "createAnnotationQueueItem",
              "arguments": {
                "objectId": "string",
                "objectType": "TRACE",
                "queueId": "string",
                "status": "PENDING"
              }
            }
          }
        },
        {
          "name": "updateAnnotationQueueItem",
          "description": "Update an annotation queue item's review status, such as pending or completed.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "queueId": {
                "type": "string"
              },
              "itemId": {
                "type": "string"
              },
              "status": {
                "type": "string",
                "enum": [
                  "PENDING",
                  "COMPLETED"
                ]
              }
            },
            "required": [
              "queueId",
              "itemId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "updateAnnotationQueueItem",
              "arguments": {
                "itemId": "string",
                "queueId": "string",
                "status": "PENDING"
              }
            }
          }
        },
        {
          "name": "deleteAnnotationQueueItem",
          "description": "Remove an annotation queue item, the queued trace or observation, from a queue.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "queueId": {
                "type": "string"
              },
              "itemId": {
                "type": "string"
              }
            },
            "required": [
              "queueId",
              "itemId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "deleteAnnotationQueueItem",
              "arguments": {
                "itemId": "string",
                "queueId": "string"
              }
            }
          }
        },
        {
          "name": "createAnnotationQueueAssignment",
          "description": "Assign a project user to an annotation queue so they can work through its review items.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "queueId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              }
            },
            "required": [
              "queueId",
              "userId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "createAnnotationQueueAssignment",
              "arguments": {
                "queueId": "string",
                "userId": "string"
              }
            }
          }
        },
        {
          "name": "deleteAnnotationQueueAssignment",
          "description": "Remove a project user's assignment from an annotation queue.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "queueId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              }
            },
            "required": [
              "queueId",
              "userId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "deleteAnnotationQueueAssignment",
              "arguments": {
                "queueId": "string",
                "userId": "string"
              }
            }
          }
        },
        {
          "name": "createComment",
          "description": "Create a comment on a trace, observation, session, or prompt.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "content": {
                "type": "string",
                "minLength": 1,
                "maxLength": 5000
              },
              "objectId": {
                "type": "string"
              },
              "objectType": {
                "type": "string",
                "enum": [
                  "TRACE",
                  "OBSERVATION",
                  "SESSION",
                  "PROMPT"
                ]
              },
              "authorUserId": {
                "type": "string"
              }
            },
            "required": [
              "content",
              "objectId",
              "objectType"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "createComment",
              "arguments": {
                "content": "string",
                "objectId": "string",
                "objectType": "TRACE",
                "authorUserId": "string"
              }
            }
          }
        },
        {
          "name": "listComments",
          "description": "List comments in the current Langfuse project, optionally filtered by object or author.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "objectType": {
                "type": "string",
                "enum": [
                  "TRACE",
                  "OBSERVATION",
                  "SESSION",
                  "PROMPT"
                ]
              },
              "objectId": {
                "type": "string"
              },
              "authorUserId": {
                "type": "string"
              },
              "page": {
                "default": 1,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "limit": {
                "default": 50,
                "type": "integer",
                "minimum": 1,
                "maximum": 100
              }
            },
            "required": [
              "page",
              "limit"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listComments",
              "arguments": {
                "limit": 50,
                "page": 1,
                "authorUserId": "string",
                "objectId": "string",
                "objectType": "TRACE"
              }
            }
          }
        },
        {
          "name": "getComment",
          "description": "Get a comment by ID from the current Langfuse project.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "commentId": {
                "type": "string"
              }
            },
            "required": [
              "commentId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getComment",
              "arguments": {
                "commentId": "string"
              }
            }
          }
        },
        {
          "name": "upsertDataset",
          "description": "Upsert a dataset, a named collection of input and optional expected-output examples for experiments and evaluations.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1
              },
              "name": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "metadata": {},
              "inputSchema": {},
              "expectedOutputSchema": {}
            },
            "required": [
              "name"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "upsertDataset",
              "arguments": {
                "name": "string",
                "description": "string",
                "expectedOutputSchema": {},
                "id": "string",
                "inputSchema": {},
                "metadata": {}
              }
            }
          }
        },
        {
          "name": "listDatasets",
          "description": "List datasets, named collections of input and optional expected-output examples for experiments and evaluations. Optionally filter by dataset name to find a dataset ID.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "page": {
                "default": 1,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "limit": {
                "default": 50,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 100
              }
            },
            "required": [
              "page",
              "limit"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listDatasets",
              "arguments": {
                "limit": 50,
                "page": 1,
                "name": "string"
              }
            }
          }
        },
        {
          "name": "getDataset",
          "description": "Get a dataset, a named collection of input and optional expected-output examples for experiments and evaluations, by ID.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "datasetId": {
                "type": "string"
              }
            },
            "required": [
              "datasetId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getDataset",
              "arguments": {
                "datasetId": "string"
              }
            }
          }
        },
        {
          "name": "upsertDatasetItem",
          "description": "Upsert a dataset item (one example in a dataset) by dataset ID. Item IDs are unique per project across all datasets, so an ID used in one dataset cannot be reused in another.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "input": {},
              "expectedOutput": {
                "description": "Omit to keep the existing value. Set to null to clear it."
              },
              "metadata": {},
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 255
              },
              "sourceTraceId": {
                "type": "string"
              },
              "sourceObservationId": {
                "type": "string"
              },
              "status": {
                "type": "string",
                "enum": [
                  "ACTIVE",
                  "ARCHIVED"
                ]
              },
              "datasetId": {
                "type": "string"
              }
            },
            "required": [
              "datasetId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "upsertDatasetItem",
              "arguments": {
                "datasetId": "string",
                "expectedOutput": {},
                "id": "string",
                "input": {},
                "metadata": {},
                "sourceObservationId": "string",
                "sourceTraceId": "string",
                "status": "ACTIVE"
              }
            }
          }
        },
        {
          "name": "batchUpsertDatasetItems",
          "description": "Upsert up to 100 dataset items in one dataset. Items are processed in order. The operation stops on the first failure and is not atomic.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "datasetId": {
                "type": "string"
              },
              "items": {
                "minItems": 1,
                "maxItems": 100,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "input": {},
                    "expectedOutput": {
                      "description": "Omit to keep the existing value. Set to null to clear it."
                    },
                    "metadata": {},
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 255
                    },
                    "sourceTraceId": {
                      "type": "string"
                    },
                    "sourceObservationId": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "ACTIVE",
                        "ARCHIVED"
                      ]
                    }
                  },
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "datasetId",
              "items"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "batchUpsertDatasetItems",
              "arguments": {
                "datasetId": "string",
                "items": [
                  {
                    "expectedOutput": {},
                    "id": "string",
                    "input": {},
                    "metadata": {},
                    "sourceObservationId": "string",
                    "sourceTraceId": "string",
                    "status": "ACTIVE"
                  }
                ]
              }
            }
          }
        },
        {
          "name": "listDatasetItems",
          "description": "List dataset items, individual examples with input and optional expected output, optionally filtered by dataset ID, source trace, source observation, or version.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "datasetId": {
                "type": "string"
              },
              "sourceTraceId": {
                "type": "string"
              },
              "sourceObservationId": {
                "type": "string"
              },
              "version": {
                "type": "string"
              },
              "page": {
                "default": 1,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "limit": {
                "default": 50,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 100
              }
            },
            "required": [
              "page",
              "limit"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listDatasetItems",
              "arguments": {
                "limit": 50,
                "page": 1,
                "datasetId": "string",
                "sourceObservationId": "string",
                "sourceTraceId": "string",
                "version": "string"
              }
            }
          }
        },
        {
          "name": "getDatasetItem",
          "description": "Get a dataset item, one example in a dataset with input and optional expected output, by ID.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "datasetItemId": {
                "type": "string"
              }
            },
            "required": [
              "datasetItemId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getDatasetItem",
              "arguments": {
                "datasetItemId": "string"
              }
            }
          }
        },
        {
          "name": "deleteDatasetItem",
          "description": "Delete a dataset item, one example in a dataset, and all its run items.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "datasetItemId": {
                "type": "string"
              }
            },
            "required": [
              "datasetItemId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "deleteDatasetItem",
              "arguments": {
                "datasetItemId": "string"
              }
            }
          }
        },
        {
          "name": "createDatasetRunItem",
          "description": "Create a dataset run item, a result that links one dataset item to a trace or observation in a dataset run.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "runName": {
                "type": "string"
              },
              "runDescription": {
                "type": "string"
              },
              "metadata": {},
              "datasetItemId": {
                "type": "string"
              },
              "observationId": {
                "description": "Observation ID linked to this run item. Provide this or traceId.",
                "type": "string"
              },
              "traceId": {
                "description": "Trace ID linked to this run item. Provide this or observationId.",
                "type": "string"
              },
              "datasetVersion": {
                "type": "string"
              },
              "createdAt": {
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$"
              }
            },
            "required": [
              "runName",
              "datasetItemId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "createDatasetRunItem",
              "arguments": {
                "datasetItemId": "string",
                "runName": "string",
                "createdAt": "string",
                "datasetVersion": "string",
                "metadata": {},
                "observationId": "string",
                "runDescription": "string",
                "traceId": "string"
              }
            }
          }
        },
        {
          "name": "listDatasetRunItems",
          "description": "List dataset run items, each linking one dataset item to a trace or observation within a dataset run, by dataset ID and run ID.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "datasetId": {
                "type": "string"
              },
              "datasetRunId": {
                "type": "string"
              },
              "page": {
                "default": 1,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "limit": {
                "default": 50,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 100
              }
            },
            "required": [
              "datasetId",
              "datasetRunId",
              "page",
              "limit"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listDatasetRunItems",
              "arguments": {
                "datasetId": "string",
                "datasetRunId": "string",
                "limit": 50,
                "page": 1
              }
            }
          }
        },
        {
          "name": "listDatasetRuns",
          "description": "List dataset runs, each experiment or evaluation execution over a dataset, by dataset ID.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "datasetId": {
                "type": "string"
              },
              "page": {
                "default": 1,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "limit": {
                "default": 50,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 100
              }
            },
            "required": [
              "datasetId",
              "page",
              "limit"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listDatasetRuns",
              "arguments": {
                "datasetId": "string",
                "limit": 50,
                "page": 1
              }
            }
          }
        },
        {
          "name": "getDatasetRun",
          "description": "Get a dataset run, one experiment or evaluation execution over a dataset, and its run items by dataset ID and run ID.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "datasetId": {
                "type": "string"
              },
              "datasetRunId": {
                "type": "string"
              }
            },
            "required": [
              "datasetId",
              "datasetRunId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getDatasetRun",
              "arguments": {
                "datasetId": "string",
                "datasetRunId": "string"
              }
            }
          }
        },
        {
          "name": "deleteDatasetRun",
          "description": "Delete a dataset run by dataset ID and run ID, and enqueue deletion of its run items.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "datasetId": {
                "type": "string"
              },
              "datasetRunId": {
                "type": "string"
              }
            },
            "required": [
              "datasetId",
              "datasetRunId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "deleteDatasetRun",
              "arguments": {
                "datasetId": "string",
                "datasetRunId": "string"
              }
            }
          }
        },
        {
          "name": "getHealth",
          "description": "Check Langfuse API health. Optionally verify database availability and recent trace/observation ingestion.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "failIfDatabaseUnavailable": {
                "default": false,
                "type": "boolean"
              },
              "failIfNoRecentEvents": {
                "default": false,
                "type": "boolean"
              }
            },
            "required": [
              "failIfDatabaseUnavailable",
              "failIfNoRecentEvents"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getHealth",
              "arguments": {
                "failIfDatabaseUnavailable": false,
                "failIfNoRecentEvents": false
              }
            }
          }
        },
        {
          "name": "listScores",
          "description": "Find scores in Langfuse.\nUse this to review quality, evaluation, or feedback scores for traces, observations, sessions, and experiments (dataset runs).\nEach score carries a polymorphic value matching its dataType (number, boolean, or string) and a subject describing what it scores: { kind: trace | observation | session | experiment, id }.\nResults are paginated with an opaque cursor: pass meta.cursor from the previous response to fetch the next page; a response without meta.cursor is the last page.\nFiltering by trace user or trace tags is not supported. To find scores for a specific user, first resolve the user's trace IDs (e.g. via listObservations with userId), then filter scores by traceId.\nScore reads are eventually consistent: a score created with createScore may not appear in listScores immediately. If a newly created score is missing, wait briefly and retry.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "limit": {
                "default": 50,
                "type": "integer",
                "minimum": 1,
                "maximum": 100
              },
              "cursor": {
                "type": "string"
              },
              "scoreIds": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "name": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "source": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "API",
                    "EVAL",
                    "ANNOTATION"
                  ]
                }
              },
              "dataType": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "NUMERIC",
                    "CATEGORICAL",
                    "BOOLEAN",
                    "CORRECTION",
                    "TEXT"
                  ]
                }
              },
              "environment": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "configId": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "queueId": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "authorUserId": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "value": {
                "description": "string-encoded, requires a single dataType (NUMERIC, BOOLEAN, or CATEGORICAL)",
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "valueMin": {
                "description": "inclusive, requires dataType: [\"NUMERIC\"]",
                "type": "number"
              },
              "valueMax": {
                "description": "inclusive, requires dataType: [\"NUMERIC\"]",
                "type": "number"
              },
              "traceId": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "sessionId": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "observationId": {
                "description": "requires traceId",
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "experimentId": {
                "description": "same ID as datasetRunId in createScore",
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "fromTimestamp": {
                "description": "Optional inclusive lower bound on the score timestamp, as an ISO 8601 timestamp with timezone (Z or an explicit offset). Filters scores by their own timestamp, not the associated observation's startTime.",
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$"
              },
              "toTimestamp": {
                "description": "Optional exclusive upper bound on the score timestamp, as an ISO 8601 timestamp with timezone. For a full calendar day, use midnight at the start of the next day, not 23:59:59.",
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$"
              }
            },
            "required": [
              "limit"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listScores",
              "arguments": {
                "limit": 50,
                "authorUserId": [
                  "string"
                ],
                "configId": [
                  "string"
                ],
                "cursor": "string",
                "dataType": [
                  "NUMERIC"
                ],
                "environment": [
                  "string"
                ],
                "experimentId": [
                  "string"
                ],
                "fromTimestamp": "string",
                "name": [
                  "string"
                ],
                "observationId": [
                  "string"
                ],
                "queueId": [
                  "string"
                ],
                "scoreIds": [
                  "string"
                ],
                "sessionId": [
                  "string"
                ],
                "source": [
                  "API"
                ],
                "toTimestamp": "string",
                "traceId": [
                  "string"
                ],
                "value": [
                  "string"
                ],
                "valueMax": 1.23,
                "valueMin": 1.23
              }
            }
          }
        },
        {
          "name": "getScore",
          "description": "Fetch one score by ID from the current Langfuse project.\nThe score carries a polymorphic value matching its dataType (number, boolean, or string) and a subject describing what it scores: { kind: trace | observation | session | experiment, id }.\nScore reads are eventually consistent: a score created with createScore may not be returned by getScore immediately. If a newly created score is not found, wait briefly and retry.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "scoreId": {
                "type": "string"
              }
            },
            "required": [
              "scoreId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getScore",
              "arguments": {
                "scoreId": "string"
              }
            }
          }
        },
        {
          "name": "createScore",
          "description": "Create one score in the current Langfuse project.\nScore reads are eventually consistent: after creation, getScore and listScores may not return the new score immediately. Wait briefly and retry reads when confirming creation.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string",
                "minLength": 1
              },
              "traceId": {
                "description": "Target trace ID.",
                "type": "string"
              },
              "sessionId": {
                "description": "Target session ID.",
                "type": "string"
              },
              "datasetRunId": {
                "description": "Target dataset run ID.",
                "type": "string"
              },
              "observationId": {
                "description": "Optional observation ID for trace-scoped scores.",
                "type": "string"
              },
              "comment": {
                "type": "string"
              },
              "metadata": {},
              "environment": {
                "type": "string"
              },
              "queueId": {
                "type": "string"
              },
              "source": {
                "type": "string",
                "enum": [
                  "API",
                  "ANNOTATION"
                ]
              },
              "value": {
                "description": "Score value. Must be a JSON number for NUMERIC and BOOLEAN scores; numeric strings like \"0.92\" are invalid. Use a string for CATEGORICAL, TEXT, and CORRECTION scores."
              },
              "dataType": {
                "description": "Score data type. When omitted, legacy scoring accepts string or number values.",
                "type": "string",
                "enum": [
                  "NUMERIC",
                  "CATEGORICAL",
                  "BOOLEAN",
                  "CORRECTION",
                  "TEXT"
                ]
              },
              "configId": {
                "type": "string"
              }
            },
            "required": [
              "name",
              "value"
            ],
            "additionalProperties": false,
            "description": "Create score request. Provide exactly one of traceId, sessionId, or datasetRunId. observationId may only be provided together with traceId."
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "createScore",
              "arguments": {
                "name": "string",
                "value": {},
                "comment": "string",
                "configId": "string",
                "datasetRunId": "string",
                "dataType": "NUMERIC",
                "environment": "string",
                "id": "string",
                "metadata": {},
                "observationId": "string",
                "queueId": "string",
                "sessionId": "string",
                "source": "API",
                "traceId": "string"
              }
            }
          }
        },
        {
          "name": "listScoreConfigs",
          "description": "List score configurations. Returns exactly data and meta at the top level.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "page": {
                "default": 1,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "limit": {
                "default": 50,
                "type": "integer",
                "minimum": 1,
                "maximum": 100
              }
            },
            "required": [
              "page",
              "limit"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listScoreConfigs",
              "arguments": {
                "limit": 50,
                "page": 1
              }
            }
          }
        },
        {
          "name": "getScoreConfig",
          "description": "Fetch one score configuration by ID from the current Langfuse project. Returns the public score config object directly.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "configId": {
                "type": "string"
              }
            },
            "required": [
              "configId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getScoreConfig",
              "arguments": {
                "configId": "string"
              }
            }
          }
        },
        {
          "name": "createScoreConfig",
          "description": "Create a score configuration. Supports numeric, categorical, boolean, and text configs. Boolean configs automatically receive True and False categories.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 80,
                "description": "Allowed characters: letters, numbers, spaces, underscores, periods, parentheses, and hyphens."
              },
              "description": {
                "type": "string"
              },
              "dataType": {
                "type": "string",
                "enum": [
                  "NUMERIC",
                  "CATEGORICAL",
                  "BOOLEAN",
                  "TEXT"
                ],
                "description": "Score config type. Numeric range fields only apply to NUMERIC configs; categorical categories only apply to CATEGORICAL configs."
              },
              "numericMinValue": {
                "description": "Minimum allowed value for NUMERIC score configs.",
                "type": "number"
              },
              "numericMaxValue": {
                "description": "Maximum allowed value for NUMERIC score configs.",
                "type": "number"
              },
              "categoricalCategories": {
                "description": "Allowed categories for CATEGORICAL score configs as an array of { label, value } objects."
              }
            },
            "required": [
              "name",
              "dataType"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "createScoreConfig",
              "arguments": {
                "dataType": "NUMERIC",
                "name": "string",
                "categoricalCategories": {},
                "description": "string",
                "numericMaxValue": 1.23,
                "numericMinValue": 1.23
              }
            }
          }
        },
        {
          "name": "updateScoreConfig",
          "description": "Update a score configuration. Use this to rename, describe, or adjust allowed numeric/category fields.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "configId": {
                "type": "string"
              },
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 80,
                "description": "Allowed characters: letters, numbers, spaces, underscores, periods, parentheses, and hyphens."
              },
              "numericMinValue": {
                "description": "Minimum allowed value for NUMERIC score configs.",
                "type": "number"
              },
              "numericMaxValue": {
                "description": "Maximum allowed value for NUMERIC score configs.",
                "type": "number"
              },
              "categoricalCategories": {
                "description": "Allowed categories for CATEGORICAL score configs as an array of { label, value } objects."
              },
              "description": {
                "type": "string"
              }
            },
            "required": [
              "configId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "updateScoreConfig",
              "arguments": {
                "configId": "string",
                "categoricalCategories": {},
                "description": "string",
                "name": "string",
                "numericMaxValue": 1.23,
                "numericMinValue": 1.23
              }
            }
          }
        },
        {
          "name": "deleteScoreConfig",
          "description": "Delete a score configuration from the current Langfuse project by archiving it.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "configId": {
                "type": "string"
              }
            },
            "required": [
              "configId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "deleteScoreConfig",
              "arguments": {
                "configId": "string"
              }
            }
          }
        },
        {
          "name": "queryMetrics",
          "description": "Answer analytics questions about the current Langfuse project, such as usage over time, model costs, latency, errors, scores, or grouped breakdowns by environment, trace, observation, model, user, session, tag, or score name.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "view": {
                "type": "string",
                "enum": [
                  "observations",
                  "scores-numeric",
                  "scores-categorical",
                  "scores-boolean"
                ]
              },
              "dimensions": {
                "default": [],
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "field": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "field"
                  ],
                  "additionalProperties": false
                }
              },
              "metrics": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "measure": {
                      "type": "string"
                    },
                    "aggregation": {
                      "type": "string",
                      "enum": [
                        "sum",
                        "avg",
                        "count",
                        "max",
                        "min",
                        "p50",
                        "p75",
                        "p90",
                        "p95",
                        "p99",
                        "histogram",
                        "uniq"
                      ]
                    }
                  },
                  "required": [
                    "measure",
                    "aggregation"
                  ],
                  "additionalProperties": false
                }
              },
              "filters": {
                "default": [],
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "column": {
                      "type": "string"
                    },
                    "operator": {
                      "type": "string"
                    },
                    "value": {},
                    "type": {
                      "type": "string"
                    },
                    "key": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "column",
                    "operator",
                    "value",
                    "type"
                  ],
                  "additionalProperties": false
                }
              },
              "timeDimension": {
                "type": "object",
                "properties": {
                  "granularity": {
                    "type": "string",
                    "enum": [
                      "auto",
                      "minute",
                      "hour",
                      "day",
                      "week",
                      "month"
                    ]
                  }
                },
                "required": [
                  "granularity"
                ],
                "additionalProperties": false
              },
              "fromTimestamp": {
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$",
                "description": "Required start of the analytics time range, as an ISO 8601 timestamp with timezone (Z or an explicit offset). Must be before toTimestamp."
              },
              "toTimestamp": {
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$",
                "description": "Required end of the analytics time range, as an ISO 8601 timestamp with timezone. Must be after fromTimestamp. timeDimension.granularity controls aggregation buckets; it does not replace these explicit time bounds."
              },
              "orderBy": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "field": {
                      "type": "string"
                    },
                    "direction": {
                      "type": "string",
                      "enum": [
                        "asc",
                        "desc"
                      ]
                    }
                  },
                  "required": [
                    "field",
                    "direction"
                  ],
                  "additionalProperties": false
                }
              },
              "config": {
                "type": "object",
                "properties": {
                  "bins": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100
                  },
                  "row_limit": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 1000
                  }
                },
                "additionalProperties": false
              }
            },
            "required": [
              "view",
              "dimensions",
              "metrics",
              "filters",
              "fromTimestamp",
              "toTimestamp"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "queryMetrics",
              "arguments": {
                "dimensions": [],
                "filters": [],
                "fromTimestamp": "string",
                "metrics": [
                  {
                    "aggregation": "sum",
                    "measure": "string"
                  }
                ],
                "toTimestamp": "string",
                "view": "observations",
                "config": {
                  "bins": 1,
                  "row_limit": 1
                },
                "orderBy": [
                  {
                    "direction": "asc",
                    "field": "string"
                  }
                ],
                "timeDimension": {
                  "granularity": "auto"
                }
              }
            }
          },
          "requiresV4": true
        },
        {
          "name": "getMetricsSchema",
          "description": "Discover which Langfuse metrics can be analyzed and how to group, filter, aggregate, and time-bucket them before calling queryMetrics.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "view": {
                "description": "Limit the response to one v2 metrics view",
                "type": "string",
                "enum": [
                  "observations",
                  "scores-numeric",
                  "scores-categorical",
                  "scores-boolean"
                ]
              }
            },
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getMetricsSchema",
              "arguments": {
                "view": "observations"
              }
            }
          },
          "requiresV4": true
        },
        {
          "name": "listModels",
          "description": "List custom and Langfuse-managed model definitions visible to the current project.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "page": {
                "default": 1,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "limit": {
                "default": 50,
                "type": "integer",
                "minimum": 1,
                "maximum": 100
              }
            },
            "required": [
              "page",
              "limit"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listModels",
              "arguments": {
                "limit": 50,
                "page": 1
              }
            }
          }
        },
        {
          "name": "createModel",
          "description": "Create a custom model definition to calculate costs from submitted observation usage in the current project.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "modelName": {
                "type": "string"
              },
              "matchPattern": {
                "type": "string"
              },
              "startDate": {
                "type": "string"
              },
              "inputPrice": {
                "type": "number",
                "minimum": 0
              },
              "outputPrice": {
                "type": "number",
                "minimum": 0
              },
              "totalPrice": {
                "type": "number",
                "minimum": 0
              },
              "unit": {
                "type": "string",
                "enum": [
                  "TOKENS",
                  "CHARACTERS",
                  "MILLISECONDS",
                  "SECONDS",
                  "REQUESTS",
                  "IMAGES"
                ]
              },
              "tokenizerId": {
                "description": "Legacy field retained for compatibility. Ingestion does not infer observation usage from content.",
                "type": "string",
                "enum": [
                  "openai",
                  "claude"
                ]
              },
              "tokenizerConfig": {
                "description": "Legacy field retained for compatibility. Ingestion does not infer observation usage from content."
              },
              "pricingTiers": {
                "type": "array",
                "items": {}
              }
            },
            "required": [
              "modelName",
              "matchPattern",
              "unit"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "createModel",
              "arguments": {
                "matchPattern": "string",
                "modelName": "string",
                "unit": "TOKENS",
                "inputPrice": 1.23,
                "outputPrice": 1.23,
                "pricingTiers": [
                  {}
                ],
                "startDate": "string",
                "tokenizerConfig": {},
                "tokenizerId": "openai",
                "totalPrice": 1.23
              }
            }
          }
        },
        {
          "name": "getModel",
          "description": "Get a model definition by ID from the current project scope.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "modelId": {
                "type": "string"
              }
            },
            "required": [
              "modelId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getModel",
              "arguments": {
                "modelId": "string"
              }
            }
          }
        },
        {
          "name": "deleteModel",
          "description": "Delete a custom model definition from the current project. Built-in models cannot be deleted.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "modelId": {
                "type": "string"
              }
            },
            "required": [
              "modelId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "deleteModel",
              "arguments": {
                "modelId": "string"
              }
            }
          }
        },
        {
          "name": "listLlmConnections",
          "description": "List the LLM connections usable in the current project, including connections inherited from the organization. A project connection replaces an organization connection with the same provider name. `provider` is a user-chosen name, not the vendor; use `adapter` to identify the API (e.g. openai, anthropic, bedrock). Pass `provider` and one of `availableModels` as an evaluator's modelConfig. Returns metadata only, never credentials.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {},
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listLlmConnections",
              "arguments": {}
            }
          }
        },
        {
          "name": "getMedia",
          "description": "Fetch metadata and a signed download URL for one media asset.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "mediaId": {
                "type": "string"
              }
            },
            "required": [
              "mediaId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getMedia",
              "arguments": {
                "mediaId": "string"
              }
            }
          }
        },
        {
          "name": "listManagedEvaluatorTemplates",
          "description": "List the evaluator templates maintained by Langfuse and partners. LLM-as-a-judge and code definitions can be copied into createEvaluator. For decision-model templates, copy questions, convert each state entry into a variableMapping entry, and provide a modelConfig for an OpenAI connection using an allowlisted decision model (currently `gpt-6-luna`) or a TypeSafe connection. Call listLlmConnections to find valid modelConfig provider names and models.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "search": {
                "type": "string",
                "maxLength": 200
              },
              "category": {
                "type": "string",
                "minLength": 1
              },
              "type": {
                "type": "string",
                "enum": [
                  "LLM_AS_JUDGE",
                  "CODE",
                  "DECISION_MODEL"
                ]
              }
            },
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listManagedEvaluatorTemplates",
              "arguments": {
                "category": "string",
                "search": "string",
                "type": "LLM_AS_JUDGE"
              }
            }
          }
        },
        {
          "name": "listEvaluators",
          "description": "List LLM-as-a-judge, code, and decision-model evaluators defined in the current Langfuse project. Results are paginated.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "page": {
                "default": 1,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "limit": {
                "default": 50,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 100
              }
            },
            "required": [
              "page",
              "limit"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listEvaluators",
              "arguments": {
                "limit": 50,
                "page": 1
              }
            }
          }
        },
        {
          "name": "getEvaluator",
          "description": "Fetch a single evaluator by id, including its LLM prompt, code, or decision-model questions and state mapping, plus how many evaluation rules reference it.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "evaluatorId": {
                "type": "string"
              }
            },
            "required": [
              "evaluatorId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getEvaluator",
              "arguments": {
                "evaluatorId": "string"
              }
            }
          }
        },
        {
          "name": "testEvaluator",
          "description": "Test an evaluator draft or the latest saved version of an evaluator against one observation in the current Langfuse project. For a saved evaluator, provide evaluatorId. For an unsaved draft, omit evaluatorId and provide type plus the matching LLM-as-a-judge, code, or decision-model evaluator fields. Pass the observationId, traceId, and startTime returned by the observation tools. This executes the evaluator, emits an internal trace, and may incur model or code execution cost.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "evaluatorId": {
                "description": "Saved evaluator ID. Provide this or a draft evaluator definition, but not both.",
                "type": "string",
                "minLength": 1
              },
              "type": {
                "type": "string",
                "enum": [
                  "LLM_AS_JUDGE",
                  "CODE",
                  "DECISION_MODEL"
                ]
              },
              "prompt": {
                "type": "string",
                "minLength": 1
              },
              "modelConfig": {
                "description": "Model configuration. Required for decision-model evaluators. Optional for LLM-as-a-judge evaluators, which use the project default when omitted.",
                "type": "object",
                "properties": {
                  "provider": {
                    "type": "string",
                    "minLength": 1
                  },
                  "model": {
                    "type": "string",
                    "minLength": 1
                  },
                  "modelParams": {
                    "type": "object",
                    "properties": {
                      "max_tokens": {
                        "type": "number"
                      },
                      "temperature": {
                        "type": "number"
                      },
                      "top_p": {
                        "type": "number"
                      },
                      "maxReasoningTokens": {
                        "type": "number"
                      },
                      "providerOptions": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {}
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "required": [
                  "provider",
                  "model"
                ],
                "additionalProperties": false
              },
              "outputDefinition": {
                "description": "Required for LLM-as-a-judge evaluators. Defines the reasoning and score returned by the evaluator.",
                "type": "object",
                "properties": {
                  "dataType": {
                    "type": "string",
                    "enum": [
                      "NUMERIC",
                      "CATEGORICAL",
                      "BOOLEAN"
                    ],
                    "description": "The score type returned by the evaluator."
                  },
                  "reasoning": {
                    "type": "object",
                    "properties": {
                      "description": {
                        "description": "Instructions for the evaluator's reasoning output.",
                        "type": "string"
                      }
                    },
                    "additionalProperties": false,
                    "description": "Definition of the evaluator's textual reasoning output."
                  },
                  "score": {
                    "type": "object",
                    "properties": {
                      "description": {
                        "description": "Instructions for the evaluator's score output.",
                        "type": "string"
                      },
                      "minValue": {
                        "description": "Optional minimum score for NUMERIC evaluators.",
                        "type": "number"
                      },
                      "maxValue": {
                        "description": "Optional maximum score for NUMERIC evaluators.",
                        "type": "number"
                      },
                      "categories": {
                        "description": "Allowed score labels for CATEGORICAL evaluators. Provide at least two unique values.",
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "shouldAllowMultipleMatches": {
                        "description": "Whether CATEGORICAL evaluators may return multiple score labels.",
                        "type": "boolean"
                      }
                    },
                    "additionalProperties": false,
                    "description": "Definition of the evaluator's typed score output. Type-specific fields are validated against dataType."
                  }
                },
                "required": [
                  "dataType",
                  "reasoning",
                  "score"
                ],
                "additionalProperties": false
              },
              "questions": {
                "description": "Required for decision-model evaluators. Each question produces its own score.",
                "minItems": 1,
                "maxItems": 50,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 64,
                      "description": "Stable question identifier."
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "choice",
                        "score",
                        "noul"
                      ],
                      "description": "Decision question type."
                    },
                    "scoreName": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100,
                      "description": "Name of the score produced by the question."
                    },
                    "instructions": {
                      "description": "Question instructions as text or structured JSON."
                    },
                    "options": {
                      "description": "Choice options. Required when type is `choice`.",
                      "minItems": 2,
                      "maxItems": 255,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "value": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "description": {
                            "description": "Option description as text or structured JSON."
                          }
                        },
                        "required": [
                          "value"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "levels": {
                      "description": "Ordered score levels. Required when type is `score`.",
                      "minItems": 2,
                      "maxItems": 10,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "description": {
                            "description": "Level description as text or structured JSON."
                          }
                        },
                        "required": [
                          "description"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "criteria": {
                      "description": "Optional true/false criteria when type is `noul`.",
                      "type": "object",
                      "properties": {
                        "true": {},
                        "false": {}
                      },
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "id",
                    "type",
                    "scoreName",
                    "instructions"
                  ],
                  "additionalProperties": false
                }
              },
              "sourceCode": {
                "type": "string",
                "minLength": 1,
                "maxLength": 262144
              },
              "sourceCodeLanguage": {
                "type": "string",
                "enum": [
                  "PYTHON",
                  "TYPESCRIPT"
                ]
              },
              "variableMapping": {
                "description": "Variable mappings for LLM-as-a-judge and decision-model evaluators. Decision-model mappings define the state and require at least one entry.",
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "templateVariable": {
                      "type": "string"
                    },
                    "selectedColumnId": {
                      "type": "string"
                    },
                    "jsonSelector": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "templateVariable",
                    "selectedColumnId"
                  ],
                  "additionalProperties": false
                }
              },
              "observationId": {
                "type": "string",
                "minLength": 1
              },
              "traceId": {
                "type": "string",
                "minLength": 1
              },
              "startTime": {
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$"
              }
            },
            "required": [
              "observationId",
              "traceId",
              "startTime"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "testEvaluator",
              "arguments": {
                "observationId": "string",
                "startTime": "string",
                "traceId": "string",
                "evaluatorId": "string",
                "modelConfig": {
                  "model": "string",
                  "provider": "string",
                  "modelParams": {
                    "max_tokens": 1.23,
                    "maxReasoningTokens": 1.23,
                    "providerOptions": {
                      "property": {}
                    },
                    "temperature": 1.23,
                    "top_p": 1.23
                  }
                },
                "outputDefinition": {
                  "dataType": "NUMERIC",
                  "reasoning": {
                    "description": "string"
                  },
                  "score": {
                    "categories": [
                      "string"
                    ],
                    "description": "string",
                    "maxValue": 1.23,
                    "minValue": 1.23,
                    "shouldAllowMultipleMatches": true
                  }
                },
                "prompt": "string",
                "questions": [
                  {
                    "id": "string",
                    "instructions": {},
                    "scoreName": "string",
                    "type": "choice",
                    "criteria": {
                      "false": {},
                      "true": {}
                    },
                    "levels": [
                      {
                        "description": {}
                      }
                    ],
                    "options": [
                      {
                        "value": "string",
                        "description": {}
                      }
                    ]
                  }
                ],
                "sourceCode": "string",
                "sourceCodeLanguage": "PYTHON",
                "type": "LLM_AS_JUDGE",
                "variableMapping": [
                  {
                    "selectedColumnId": "string",
                    "templateVariable": "string",
                    "jsonSelector": "string"
                  }
                ]
              }
            }
          }
        },
        {
          "name": "createEvaluator",
          "description": "Create a new evaluator with a stable id. Names do not act as identity and may be reused. For `LLM_AS_JUDGE`, provide prompt + outputDefinition and optionally modelConfig. For `CODE`, provide sourceCode + sourceCodeLanguage. For `DECISION_MODEL`, provide questions, a modelConfig with provider and model only, and variableMapping entries defining its state. Use an OpenAI connection with an allowlisted decision model (currently `gpt-6-luna`), or a TypeSafe connection. Call listLlmConnections to find valid modelConfig provider names and models. Use updateEvaluator with the returned evaluatorId to update it or append a new immutable definition version.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1
              },
              "description": {
                "type": "string",
                "maxLength": 2000
              },
              "type": {
                "type": "string",
                "enum": [
                  "LLM_AS_JUDGE",
                  "CODE",
                  "DECISION_MODEL"
                ]
              },
              "prompt": {
                "type": "string",
                "minLength": 1
              },
              "modelConfig": {
                "description": "Model configuration. Required for decision-model evaluators. Optional for LLM-as-a-judge evaluators, which use the project default when omitted.",
                "type": "object",
                "properties": {
                  "provider": {
                    "type": "string",
                    "minLength": 1
                  },
                  "model": {
                    "type": "string",
                    "minLength": 1
                  },
                  "modelParams": {
                    "type": "object",
                    "properties": {
                      "max_tokens": {
                        "type": "number"
                      },
                      "temperature": {
                        "type": "number"
                      },
                      "top_p": {
                        "type": "number"
                      },
                      "maxReasoningTokens": {
                        "type": "number"
                      },
                      "providerOptions": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {}
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "required": [
                  "provider",
                  "model"
                ],
                "additionalProperties": false
              },
              "outputDefinition": {
                "description": "Required for LLM-as-a-judge evaluators. Defines the reasoning and score returned by the evaluator.",
                "type": "object",
                "properties": {
                  "dataType": {
                    "type": "string",
                    "enum": [
                      "NUMERIC",
                      "CATEGORICAL",
                      "BOOLEAN"
                    ],
                    "description": "The score type returned by the evaluator."
                  },
                  "reasoning": {
                    "type": "object",
                    "properties": {
                      "description": {
                        "description": "Instructions for the evaluator's reasoning output.",
                        "type": "string"
                      }
                    },
                    "additionalProperties": false,
                    "description": "Definition of the evaluator's textual reasoning output."
                  },
                  "score": {
                    "type": "object",
                    "properties": {
                      "description": {
                        "description": "Instructions for the evaluator's score output.",
                        "type": "string"
                      },
                      "minValue": {
                        "description": "Optional minimum score for NUMERIC evaluators.",
                        "type": "number"
                      },
                      "maxValue": {
                        "description": "Optional maximum score for NUMERIC evaluators.",
                        "type": "number"
                      },
                      "categories": {
                        "description": "Allowed score labels for CATEGORICAL evaluators. Provide at least two unique values.",
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "shouldAllowMultipleMatches": {
                        "description": "Whether CATEGORICAL evaluators may return multiple score labels.",
                        "type": "boolean"
                      }
                    },
                    "additionalProperties": false,
                    "description": "Definition of the evaluator's typed score output. Type-specific fields are validated against dataType."
                  }
                },
                "required": [
                  "dataType",
                  "reasoning",
                  "score"
                ],
                "additionalProperties": false
              },
              "questions": {
                "description": "Required for decision-model evaluators. Each question produces its own score.",
                "minItems": 1,
                "maxItems": 50,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 64,
                      "description": "Stable question identifier."
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "choice",
                        "score",
                        "noul"
                      ],
                      "description": "Decision question type."
                    },
                    "scoreName": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100,
                      "description": "Name of the score produced by the question."
                    },
                    "instructions": {
                      "description": "Question instructions as text or structured JSON."
                    },
                    "options": {
                      "description": "Choice options. Required when type is `choice`.",
                      "minItems": 2,
                      "maxItems": 255,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "value": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "description": {
                            "description": "Option description as text or structured JSON."
                          }
                        },
                        "required": [
                          "value"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "levels": {
                      "description": "Ordered score levels. Required when type is `score`.",
                      "minItems": 2,
                      "maxItems": 10,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "description": {
                            "description": "Level description as text or structured JSON."
                          }
                        },
                        "required": [
                          "description"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "criteria": {
                      "description": "Optional true/false criteria when type is `noul`.",
                      "type": "object",
                      "properties": {
                        "true": {},
                        "false": {}
                      },
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "id",
                    "type",
                    "scoreName",
                    "instructions"
                  ],
                  "additionalProperties": false
                }
              },
              "sourceCode": {
                "type": "string",
                "minLength": 1,
                "maxLength": 262144
              },
              "sourceCodeLanguage": {
                "type": "string",
                "enum": [
                  "PYTHON",
                  "TYPESCRIPT"
                ]
              },
              "variableMapping": {
                "description": "Variable mappings for LLM-as-a-judge and decision-model evaluators. Decision-model mappings define the state and require at least one entry.",
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "templateVariable": {
                      "type": "string"
                    },
                    "selectedColumnId": {
                      "type": "string"
                    },
                    "jsonSelector": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "templateVariable",
                    "selectedColumnId"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "name",
              "type"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "createEvaluator",
              "arguments": {
                "name": "string",
                "type": "LLM_AS_JUDGE",
                "description": "string",
                "modelConfig": {
                  "model": "string",
                  "provider": "string",
                  "modelParams": {
                    "max_tokens": 1.23,
                    "maxReasoningTokens": 1.23,
                    "providerOptions": {
                      "property": {}
                    },
                    "temperature": 1.23,
                    "top_p": 1.23
                  }
                },
                "outputDefinition": {
                  "dataType": "NUMERIC",
                  "reasoning": {
                    "description": "string"
                  },
                  "score": {
                    "categories": [
                      "string"
                    ],
                    "description": "string",
                    "maxValue": 1.23,
                    "minValue": 1.23,
                    "shouldAllowMultipleMatches": true
                  }
                },
                "prompt": "string",
                "questions": [
                  {
                    "id": "string",
                    "instructions": {},
                    "scoreName": "string",
                    "type": "choice",
                    "criteria": {
                      "false": {},
                      "true": {}
                    },
                    "levels": [
                      {
                        "description": {}
                      }
                    ],
                    "options": [
                      {
                        "value": "string",
                        "description": {}
                      }
                    ]
                  }
                ],
                "sourceCode": "string",
                "sourceCodeLanguage": "PYTHON",
                "variableMapping": [
                  {
                    "selectedColumnId": "string",
                    "templateVariable": "string",
                    "jsonSelector": "string"
                  }
                ]
              }
            }
          }
        },
        {
          "name": "updateEvaluator",
          "description": "Update an evaluator by stable id. Definition changes append an immutable version; name and description changes do not. For `LLM_AS_JUDGE`, provide prompt + outputDefinition and optionally modelConfig. For `CODE`, provide sourceCode + sourceCodeLanguage. For `DECISION_MODEL`, provide questions, a modelConfig with provider and model only, and variableMapping entries defining its state. Use an OpenAI connection with an allowlisted decision model (currently `gpt-6-luna`), or a TypeSafe connection. Call listLlmConnections to find valid modelConfig provider names and models.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1
              },
              "description": {
                "type": "string",
                "maxLength": 2000
              },
              "type": {
                "type": "string",
                "enum": [
                  "LLM_AS_JUDGE",
                  "CODE",
                  "DECISION_MODEL"
                ]
              },
              "prompt": {
                "type": "string",
                "minLength": 1
              },
              "modelConfig": {
                "description": "Model configuration. Required for decision-model evaluators. Optional for LLM-as-a-judge evaluators, which use the project default when omitted.",
                "type": "object",
                "properties": {
                  "provider": {
                    "type": "string",
                    "minLength": 1
                  },
                  "model": {
                    "type": "string",
                    "minLength": 1
                  },
                  "modelParams": {
                    "type": "object",
                    "properties": {
                      "max_tokens": {
                        "type": "number"
                      },
                      "temperature": {
                        "type": "number"
                      },
                      "top_p": {
                        "type": "number"
                      },
                      "maxReasoningTokens": {
                        "type": "number"
                      },
                      "providerOptions": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {}
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "required": [
                  "provider",
                  "model"
                ],
                "additionalProperties": false
              },
              "outputDefinition": {
                "description": "Required for LLM-as-a-judge evaluators. Defines the reasoning and score returned by the evaluator.",
                "type": "object",
                "properties": {
                  "dataType": {
                    "type": "string",
                    "enum": [
                      "NUMERIC",
                      "CATEGORICAL",
                      "BOOLEAN"
                    ],
                    "description": "The score type returned by the evaluator."
                  },
                  "reasoning": {
                    "type": "object",
                    "properties": {
                      "description": {
                        "description": "Instructions for the evaluator's reasoning output.",
                        "type": "string"
                      }
                    },
                    "additionalProperties": false,
                    "description": "Definition of the evaluator's textual reasoning output."
                  },
                  "score": {
                    "type": "object",
                    "properties": {
                      "description": {
                        "description": "Instructions for the evaluator's score output.",
                        "type": "string"
                      },
                      "minValue": {
                        "description": "Optional minimum score for NUMERIC evaluators.",
                        "type": "number"
                      },
                      "maxValue": {
                        "description": "Optional maximum score for NUMERIC evaluators.",
                        "type": "number"
                      },
                      "categories": {
                        "description": "Allowed score labels for CATEGORICAL evaluators. Provide at least two unique values.",
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "shouldAllowMultipleMatches": {
                        "description": "Whether CATEGORICAL evaluators may return multiple score labels.",
                        "type": "boolean"
                      }
                    },
                    "additionalProperties": false,
                    "description": "Definition of the evaluator's typed score output. Type-specific fields are validated against dataType."
                  }
                },
                "required": [
                  "dataType",
                  "reasoning",
                  "score"
                ],
                "additionalProperties": false
              },
              "questions": {
                "description": "Required for decision-model evaluators. Each question produces its own score.",
                "minItems": 1,
                "maxItems": 50,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 64,
                      "description": "Stable question identifier."
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "choice",
                        "score",
                        "noul"
                      ],
                      "description": "Decision question type."
                    },
                    "scoreName": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100,
                      "description": "Name of the score produced by the question."
                    },
                    "instructions": {
                      "description": "Question instructions as text or structured JSON."
                    },
                    "options": {
                      "description": "Choice options. Required when type is `choice`.",
                      "minItems": 2,
                      "maxItems": 255,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "value": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "description": {
                            "description": "Option description as text or structured JSON."
                          }
                        },
                        "required": [
                          "value"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "levels": {
                      "description": "Ordered score levels. Required when type is `score`.",
                      "minItems": 2,
                      "maxItems": 10,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "description": {
                            "description": "Level description as text or structured JSON."
                          }
                        },
                        "required": [
                          "description"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "criteria": {
                      "description": "Optional true/false criteria when type is `noul`.",
                      "type": "object",
                      "properties": {
                        "true": {},
                        "false": {}
                      },
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "id",
                    "type",
                    "scoreName",
                    "instructions"
                  ],
                  "additionalProperties": false
                }
              },
              "sourceCode": {
                "type": "string",
                "minLength": 1,
                "maxLength": 262144
              },
              "sourceCodeLanguage": {
                "type": "string",
                "enum": [
                  "PYTHON",
                  "TYPESCRIPT"
                ]
              },
              "variableMapping": {
                "description": "Variable mappings for LLM-as-a-judge and decision-model evaluators. Decision-model mappings define the state and require at least one entry.",
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "templateVariable": {
                      "type": "string"
                    },
                    "selectedColumnId": {
                      "type": "string"
                    },
                    "jsonSelector": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "templateVariable",
                    "selectedColumnId"
                  ],
                  "additionalProperties": false
                }
              },
              "evaluatorId": {
                "type": "string"
              }
            },
            "required": [
              "name",
              "type",
              "evaluatorId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "updateEvaluator",
              "arguments": {
                "evaluatorId": "string",
                "name": "string",
                "type": "LLM_AS_JUDGE",
                "description": "string",
                "modelConfig": {
                  "model": "string",
                  "provider": "string",
                  "modelParams": {
                    "max_tokens": 1.23,
                    "maxReasoningTokens": 1.23,
                    "providerOptions": {
                      "property": {}
                    },
                    "temperature": 1.23,
                    "top_p": 1.23
                  }
                },
                "outputDefinition": {
                  "dataType": "NUMERIC",
                  "reasoning": {
                    "description": "string"
                  },
                  "score": {
                    "categories": [
                      "string"
                    ],
                    "description": "string",
                    "maxValue": 1.23,
                    "minValue": 1.23,
                    "shouldAllowMultipleMatches": true
                  }
                },
                "prompt": "string",
                "questions": [
                  {
                    "id": "string",
                    "instructions": {},
                    "scoreName": "string",
                    "type": "choice",
                    "criteria": {
                      "false": {},
                      "true": {}
                    },
                    "levels": [
                      {
                        "description": {}
                      }
                    ],
                    "options": [
                      {
                        "value": "string",
                        "description": {}
                      }
                    ]
                  }
                ],
                "sourceCode": "string",
                "sourceCodeLanguage": "PYTHON",
                "variableMapping": [
                  {
                    "selectedColumnId": "string",
                    "templateVariable": "string",
                    "jsonSelector": "string"
                  }
                ]
              }
            }
          }
        },
        {
          "name": "deleteEvaluator",
          "description": "Delete an evaluator. This cannot be undone.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "evaluatorId": {
                "type": "string"
              }
            },
            "required": [
              "evaluatorId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "deleteEvaluator",
              "arguments": {
                "evaluatorId": "string"
              }
            }
          }
        },
        {
          "name": "listEvaluationRules",
          "description": "List observation evaluation rules in the current Langfuse project, including all evaluator assignments. Results are paginated.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "page": {
                "default": 1,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "limit": {
                "default": 50,
                "type": "integer",
                "minimum": 1,
                "maximum": 100
              },
              "orderBy": {
                "type": "object",
                "properties": {
                  "column": {
                    "type": "string",
                    "enum": [
                      "name",
                      "enabled",
                      "sampling",
                      "createdAt",
                      "updatedAt"
                    ]
                  },
                  "order": {
                    "type": "string",
                    "enum": [
                      "ASC",
                      "DESC"
                    ]
                  }
                },
                "required": [
                  "column",
                  "order"
                ],
                "additionalProperties": false
              },
              "search": {
                "type": "string",
                "maxLength": 200
              },
              "enabled": {
                "type": "boolean"
              },
              "targetObjects": {
                "minItems": 1,
                "maxItems": 2,
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "event",
                    "experiment"
                  ]
                }
              },
              "filter": {
                "description": "Conditions filtering the returned evaluation rules.",
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "column": {
                      "type": "string"
                    },
                    "operator": {
                      "type": "string"
                    },
                    "value": {},
                    "type": {
                      "type": "string"
                    },
                    "key": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "column",
                    "operator",
                    "value",
                    "type"
                  ],
                  "additionalProperties": false,
                  "description": "Observation filter condition, e.g. {\"column\":\"version\",\"operator\":\"=\",\"value\":\"1.0.0\",\"type\":\"string\"}. Use `key` for object columns such as `metadata`."
                }
              }
            },
            "required": [
              "page",
              "limit"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listEvaluationRules",
              "arguments": {
                "limit": 50,
                "page": 1,
                "enabled": true,
                "filter": [
                  {
                    "column": "string",
                    "operator": "string",
                    "type": "string",
                    "value": {},
                    "key": "string"
                  }
                ],
                "orderBy": {
                  "column": "name",
                  "order": "ASC"
                },
                "search": "string",
                "targetObjects": [
                  "event"
                ]
              }
            }
          }
        },
        {
          "name": "getEvaluationRule",
          "description": "Fetch an observation evaluation rule by ID, including all evaluator assignments, filters, sampling, and status.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "evaluationRuleId": {
                "type": "string"
              }
            },
            "required": [
              "evaluationRuleId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getEvaluationRule",
              "arguments": {
                "evaluationRuleId": "string"
              }
            }
          }
        },
        {
          "name": "createEvaluationRule",
          "description": "Create an observation evaluation rule with one or more evaluator assignments. Each assignment references a project evaluator by stable ID. LLM-as-a-judge and decision-model assignments may override their variable mapping; code evaluator assignments must omit it.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1
              },
              "sampling": {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              },
              "enabled": {
                "type": "boolean"
              },
              "evaluatorAssignments": {
                "minItems": 1,
                "maxItems": 100,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "evaluatorId": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Stable project evaluator ID."
                    },
                    "variableMapping": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "variable": {
                            "type": "string",
                            "minLength": 1
                          },
                          "source": {
                            "type": "string",
                            "enum": [
                              "input",
                              "output",
                              "metadata",
                              "tool_calls"
                            ]
                          },
                          "jsonPath": {
                            "type": "string",
                            "minLength": 1
                          }
                        },
                        "required": [
                          "variable",
                          "source"
                        ],
                        "additionalProperties": false
                      },
                      "description": "Optional rule-specific variable mapping for LLM-as-a-judge and decision-model evaluators. Omit for code evaluators, whose mapping is managed by Langfuse."
                    }
                  },
                  "required": [
                    "evaluatorId"
                  ],
                  "additionalProperties": false
                }
              },
              "filter": {
                "description": "Conditions selecting which observations the rule runs on.",
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "column": {
                      "type": "string"
                    },
                    "operator": {
                      "type": "string"
                    },
                    "value": {},
                    "type": {
                      "type": "string"
                    },
                    "key": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "column",
                    "operator",
                    "value",
                    "type"
                  ],
                  "additionalProperties": false,
                  "description": "Observation filter condition, e.g. {\"column\":\"version\",\"operator\":\"=\",\"value\":\"1.0.0\",\"type\":\"string\"}. Use `key` for object columns such as `metadata`."
                }
              }
            },
            "required": [
              "name",
              "sampling",
              "enabled",
              "evaluatorAssignments"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "createEvaluationRule",
              "arguments": {
                "enabled": true,
                "evaluatorAssignments": [
                  {
                    "evaluatorId": "string",
                    "variableMapping": [
                      {
                        "source": "input",
                        "variable": "string",
                        "jsonPath": "string"
                      }
                    ]
                  }
                ],
                "name": "string",
                "sampling": 1.23,
                "filter": [
                  {
                    "column": "string",
                    "operator": "string",
                    "type": "string",
                    "value": {},
                    "key": "string"
                  }
                ]
              }
            }
          }
        },
        {
          "name": "updateEvaluationRule",
          "description": "Update an observation evaluation rule, including replacing all evaluator assignments.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1
              },
              "sampling": {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              },
              "enabled": {
                "type": "boolean"
              },
              "evaluationRuleId": {
                "type": "string"
              },
              "filter": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "column": {
                      "type": "string"
                    },
                    "operator": {
                      "type": "string"
                    },
                    "value": {},
                    "type": {
                      "type": "string"
                    },
                    "key": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "column",
                    "operator",
                    "value",
                    "type"
                  ],
                  "additionalProperties": false,
                  "description": "Observation filter condition, e.g. {\"column\":\"version\",\"operator\":\"=\",\"value\":\"1.0.0\",\"type\":\"string\"}. Use `key` for object columns such as `metadata`."
                }
              },
              "evaluatorAssignments": {
                "maxItems": 100,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "evaluatorId": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Stable project evaluator ID."
                    },
                    "variableMapping": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "variable": {
                            "type": "string",
                            "minLength": 1
                          },
                          "source": {
                            "type": "string",
                            "enum": [
                              "input",
                              "output",
                              "metadata",
                              "tool_calls"
                            ]
                          },
                          "jsonPath": {
                            "type": "string",
                            "minLength": 1
                          }
                        },
                        "required": [
                          "variable",
                          "source"
                        ],
                        "additionalProperties": false
                      },
                      "description": "Optional rule-specific variable mapping for LLM-as-a-judge and decision-model evaluators. Omit for code evaluators, whose mapping is managed by Langfuse."
                    }
                  },
                  "required": [
                    "evaluatorId"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "evaluationRuleId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "updateEvaluationRule",
              "arguments": {
                "evaluationRuleId": "string",
                "enabled": true,
                "evaluatorAssignments": [
                  {
                    "evaluatorId": "string",
                    "variableMapping": [
                      {
                        "source": "input",
                        "variable": "string",
                        "jsonPath": "string"
                      }
                    ]
                  }
                ],
                "filter": [
                  {
                    "column": "string",
                    "operator": "string",
                    "type": "string",
                    "value": {},
                    "key": "string"
                  }
                ],
                "name": "string",
                "sampling": 1.23
              }
            }
          }
        },
        {
          "name": "attachEvaluatorToEvaluationRule",
          "description": "Attach a project evaluator to an observation evaluation rule using their stable IDs. For LLM-as-a-judge and decision-model evaluators, omit variableMapping to inherit the evaluator version's mapping or provide an override. Code evaluators must omit variableMapping.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "evaluationRuleId": {
                "type": "string",
                "description": "Stable evaluation rule ID."
              },
              "evaluatorId": {
                "type": "string",
                "minLength": 1,
                "description": "Stable project evaluator ID."
              },
              "variableMapping": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "variable": {
                      "type": "string",
                      "minLength": 1
                    },
                    "source": {
                      "type": "string",
                      "enum": [
                        "input",
                        "output",
                        "metadata",
                        "tool_calls"
                      ]
                    },
                    "jsonPath": {
                      "type": "string",
                      "minLength": 1
                    }
                  },
                  "required": [
                    "variable",
                    "source"
                  ],
                  "additionalProperties": false
                },
                "description": "Optional rule-specific variable mapping for LLM-as-a-judge and decision-model evaluators. Omit for code evaluators, whose mapping is managed by Langfuse."
              }
            },
            "required": [
              "evaluationRuleId",
              "evaluatorId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "attachEvaluatorToEvaluationRule",
              "arguments": {
                "evaluationRuleId": "string",
                "evaluatorId": "string",
                "variableMapping": [
                  {
                    "source": "input",
                    "variable": "string",
                    "jsonPath": "string"
                  }
                ]
              }
            }
          }
        },
        {
          "name": "detachEvaluatorFromEvaluationRule",
          "description": "Detach a project evaluator from an observation evaluation rule using their stable IDs.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "evaluationRuleId": {
                "type": "string",
                "description": "Stable evaluation rule ID."
              },
              "evaluatorId": {
                "type": "string",
                "minLength": 1,
                "description": "Stable project evaluator ID."
              }
            },
            "required": [
              "evaluationRuleId",
              "evaluatorId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "detachEvaluatorFromEvaluationRule",
              "arguments": {
                "evaluationRuleId": "string",
                "evaluatorId": "string"
              }
            }
          }
        },
        {
          "name": "deleteEvaluationRule",
          "description": "Delete an observation evaluation rule by ID. This cannot be undone.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "evaluationRuleId": {
                "type": "string"
              }
            },
            "required": [
              "evaluationRuleId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "deleteEvaluationRule",
              "arguments": {
                "evaluationRuleId": "string"
              }
            }
          }
        },
        {
          "name": "getDefaultEvaluationModel",
          "description": "Get the project's default evaluation model: the provider, model, and model parameters that LLM-as-a-judge evaluators without their own modelConfig run on. Returns `defaultModel: null` when no default is configured; such evaluators cannot run until one is set with setDefaultEvaluationModel.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {},
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getDefaultEvaluationModel",
              "arguments": {}
            }
          }
        },
        {
          "name": "setDefaultEvaluationModel",
          "description": "Set the project's default evaluation model, replacing the current one. LLM-as-a-judge evaluators without their own modelConfig use it. Call listLlmConnections to find valid provider names and models. The model is validated with a test call to the provider before it is saved. Evaluators paused because no default model was configured resume automatically.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "provider": {
                "type": "string",
                "minLength": 1
              },
              "model": {
                "type": "string",
                "minLength": 1
              },
              "modelParams": {
                "type": "object",
                "properties": {
                  "max_tokens": {
                    "type": "number"
                  },
                  "temperature": {
                    "type": "number"
                  },
                  "top_p": {
                    "type": "number"
                  },
                  "maxReasoningTokens": {
                    "type": "number"
                  },
                  "providerOptions": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {}
                  }
                },
                "additionalProperties": false
              }
            },
            "required": [
              "provider",
              "model"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "setDefaultEvaluationModel",
              "arguments": {
                "model": "string",
                "provider": "string",
                "modelParams": {
                  "max_tokens": 1.23,
                  "maxReasoningTokens": 1.23,
                  "providerOptions": {
                    "property": {}
                  },
                  "temperature": 1.23,
                  "top_p": 1.23
                }
              }
            }
          }
        },
        {
          "name": "deleteDefaultEvaluationModel",
          "description": "Delete the project's default evaluation model. LLM-as-a-judge evaluators without their own modelConfig are paused until a new default is set.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {},
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "deleteDefaultEvaluationModel",
              "arguments": {}
            }
          }
        },
        {
          "name": "runBatchEvaluation",
          "description": "Run one or more saved evaluators over the existing observations that match a filter in the current Langfuse project, like Run Evaluation in the observations table. Preview the selection with listObservations using the same filter and time range before running. Observations older than the plan's data-access window are never evaluated. The run is queued and processed asynchronously; this returns the batch action id. Results are written as scores on the evaluated observations, and each score and evaluator trace carries the batch action id as batch_action_id metadata. This executes every selected evaluator on every selected observation and may incur model or code execution cost.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "evaluatorIds": {
                "minItems": 1,
                "maxItems": 100,
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "IDs of the evaluators to run, as returned by listEvaluators. Each must be observation-scoped and not attached to a trace- or dataset-level evaluation rule."
              },
              "fromStartTime": {
                "description": "Optional inclusive lower bound on observation startTime, as an ISO 8601 timestamp with timezone (Z or an explicit offset). Use the same time window as the observations you intend to search.",
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$"
              },
              "toStartTime": {
                "description": "Optional exclusive upper bound on observation startTime, as an ISO 8601 timestamp with timezone. For a full calendar day, use midnight at the start of the next day, not 23:59:59.",
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$"
              },
              "filter": {
                "description": "Observation filters in the listObservations filter format; call getObservationFilterSchema for accepted columns and operators. The full-text `matches` operator is not supported here. Bound the selection by time with fromStartTime and toStartTime.",
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "column": {
                      "type": "string"
                    },
                    "operator": {
                      "type": "string"
                    },
                    "value": {},
                    "type": {
                      "type": "string"
                    },
                    "key": {
                      "description": "Metadata/object key to filter on. Required when column is metadata.",
                      "type": "string"
                    }
                  },
                  "required": [
                    "column",
                    "operator",
                    "value"
                  ],
                  "additionalProperties": false,
                  "description": "Advanced observation filter object. Example: {\"column\":\"totalCost\",\"operator\":\">\",\"value\":0.0029}. The explicit form {\"type\":\"number\",\"column\":\"totalCost\",\"operator\":\">\",\"value\":0.0029} is also accepted."
                }
              },
              "sampling": {
                "description": "Fraction of matching observations to evaluate, between 0 and 1. Defaults to 1.",
                "type": "number",
                "minimum": 0,
                "maximum": 1
              },
              "rowLimit": {
                "description": "Maximum number of observations to evaluate. Without it, the run is rejected when more observations match than the instance's batch evaluation limit.",
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 25000
              }
            },
            "required": [
              "evaluatorIds"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "runBatchEvaluation",
              "arguments": {
                "evaluatorIds": [
                  "string"
                ],
                "filter": [
                  {
                    "column": "string",
                    "operator": "string",
                    "value": {},
                    "key": "string",
                    "type": "string"
                  }
                ],
                "fromStartTime": "string",
                "rowLimit": 1,
                "sampling": 1.23,
                "toStartTime": "string"
              }
            }
          }
        },
        {
          "name": "listDashboardWidgets",
          "description": "List dashboard widgets in the current project.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "page": {
                "default": 1,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "limit": {
                "default": 50,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 100
              }
            },
            "required": [
              "page",
              "limit"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listDashboardWidgets",
              "arguments": {
                "limit": 50,
                "page": 1
              }
            }
          }
        },
        {
          "name": "createDashboardWidget",
          "description": "Create a dashboard widget (a standalone chart definition you place on any dashboard). Widgets are useful to visualize Langfuse project data and give informative breakdowns to the user. This creates the widget only; place it on a dashboard with the addDashboardPlacement tool. The result includes a url field; use it to link to the created widget.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1,
                "description": "Human-readable widget name."
              },
              "description": {
                "description": "Human-readable widget description. Defaults to empty.",
                "type": "string"
              },
              "view": {
                "type": "string",
                "enum": [
                  "observations",
                  "scores-numeric",
                  "scores-boolean",
                  "scores-categorical"
                ],
                "description": "Data view for the widget. Traces widgets are not supported by this unstable API."
              },
              "dimensions": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "field": {
                      "type": "string",
                      "minLength": 1
                    }
                  },
                  "required": [
                    "field"
                  ],
                  "additionalProperties": false
                },
                "description": "Breakdown dimensions. Non-pivot charts support at most one dimension."
              },
              "metrics": {
                "minItems": 1,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "measure": {
                      "type": "string",
                      "minLength": 1
                    },
                    "agg": {
                      "type": "string",
                      "enum": [
                        "sum",
                        "avg",
                        "count",
                        "max",
                        "min",
                        "p50",
                        "p75",
                        "p90",
                        "p95",
                        "p99",
                        "histogram",
                        "uniq"
                      ]
                    }
                  },
                  "required": [
                    "measure",
                    "agg"
                  ],
                  "additionalProperties": false
                },
                "description": "Measures and aggregations to plot."
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "column": {
                      "type": "string"
                    },
                    "operator": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string"
                    },
                    "value": {},
                    "key": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "column",
                    "operator",
                    "type"
                  ],
                  "additionalProperties": {}
                },
                "description": "Widget filters in the same shape as exported dashboard widget JSON."
              },
              "chartType": {
                "type": "string",
                "enum": [
                  "LINE_TIME_SERIES",
                  "AREA_TIME_SERIES",
                  "BAR_TIME_SERIES",
                  "HORIZONTAL_BAR",
                  "VERTICAL_BAR",
                  "PIE",
                  "NUMBER",
                  "HISTOGRAM",
                  "PIVOT_TABLE"
                ]
              },
              "chartConfig": {
                "description": "Chart-specific config. Optional; type defaults to chartType and must match it when given.",
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "enum": [
                      "LINE_TIME_SERIES",
                      "AREA_TIME_SERIES",
                      "BAR_TIME_SERIES",
                      "HORIZONTAL_BAR",
                      "VERTICAL_BAR",
                      "PIE",
                      "NUMBER",
                      "HISTOGRAM",
                      "PIVOT_TABLE"
                    ]
                  },
                  "row_limit": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 1000
                  },
                  "show_value_labels": {
                    "type": "boolean"
                  },
                  "bins": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100
                  },
                  "defaultSort": {
                    "type": "object",
                    "properties": {
                      "column": {
                        "type": "string"
                      },
                      "order": {
                        "type": "string",
                        "enum": [
                          "ASC",
                          "DESC"
                        ]
                      }
                    },
                    "required": [
                      "column",
                      "order"
                    ],
                    "additionalProperties": false
                  }
                },
                "additionalProperties": false
              }
            },
            "required": [
              "name",
              "view",
              "dimensions",
              "metrics",
              "filters",
              "chartType"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "createDashboardWidget",
              "arguments": {
                "chartType": "LINE_TIME_SERIES",
                "dimensions": [
                  {
                    "field": "string"
                  }
                ],
                "filters": [
                  {
                    "column": "string",
                    "operator": "string",
                    "type": "string",
                    "key": "string",
                    "value": {}
                  }
                ],
                "metrics": [
                  {
                    "agg": "sum",
                    "measure": "string"
                  }
                ],
                "name": "string",
                "view": "observations",
                "chartConfig": {
                  "bins": 1,
                  "defaultSort": {
                    "column": "string",
                    "order": "ASC"
                  },
                  "row_limit": 1,
                  "show_value_labels": true,
                  "type": "LINE_TIME_SERIES"
                },
                "description": "string"
              }
            }
          }
        },
        {
          "name": "getDashboardWidget",
          "description": "Get a dashboard widget by ID.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "widgetId": {
                "type": "string"
              }
            },
            "required": [
              "widgetId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getDashboardWidget",
              "arguments": {
                "widgetId": "string"
              }
            }
          }
        },
        {
          "name": "updateDashboardWidget",
          "description": "Partially update a dashboard widget.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "widgetId": {
                "type": "string"
              },
              "name": {
                "type": "string",
                "minLength": 1
              },
              "description": {
                "type": "string"
              },
              "view": {
                "type": "string",
                "enum": [
                  "observations",
                  "scores-numeric",
                  "scores-boolean",
                  "scores-categorical"
                ]
              },
              "dimensions": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "field": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "field"
                  ],
                  "additionalProperties": false
                }
              },
              "metrics": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "measure": {
                      "type": "string"
                    },
                    "agg": {
                      "type": "string",
                      "enum": [
                        "sum",
                        "avg",
                        "count",
                        "max",
                        "min",
                        "p50",
                        "p75",
                        "p90",
                        "p95",
                        "p99",
                        "histogram",
                        "uniq"
                      ]
                    }
                  },
                  "required": [
                    "measure",
                    "agg"
                  ],
                  "additionalProperties": false
                }
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "column": {
                      "type": "string"
                    },
                    "operator": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string"
                    },
                    "value": {},
                    "key": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "column",
                    "operator",
                    "type"
                  ],
                  "additionalProperties": {}
                }
              },
              "chartType": {
                "type": "string",
                "enum": [
                  "LINE_TIME_SERIES",
                  "AREA_TIME_SERIES",
                  "BAR_TIME_SERIES",
                  "HORIZONTAL_BAR",
                  "VERTICAL_BAR",
                  "PIE",
                  "NUMBER",
                  "HISTOGRAM",
                  "PIVOT_TABLE"
                ]
              },
              "chartConfig": {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "enum": [
                      "LINE_TIME_SERIES",
                      "AREA_TIME_SERIES",
                      "BAR_TIME_SERIES",
                      "HORIZONTAL_BAR",
                      "VERTICAL_BAR",
                      "PIE",
                      "NUMBER",
                      "HISTOGRAM",
                      "PIVOT_TABLE"
                    ]
                  },
                  "row_limit": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 1000
                  },
                  "show_value_labels": {
                    "type": "boolean"
                  },
                  "bins": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100
                  },
                  "defaultSort": {
                    "type": "object",
                    "properties": {
                      "column": {
                        "type": "string"
                      },
                      "order": {
                        "type": "string",
                        "enum": [
                          "ASC",
                          "DESC"
                        ]
                      }
                    },
                    "required": [
                      "column",
                      "order"
                    ],
                    "additionalProperties": false
                  }
                },
                "additionalProperties": false
              }
            },
            "required": [
              "widgetId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "updateDashboardWidget",
              "arguments": {
                "widgetId": "string",
                "chartConfig": {
                  "bins": 1,
                  "defaultSort": {
                    "column": "string",
                    "order": "ASC"
                  },
                  "row_limit": 1,
                  "show_value_labels": true,
                  "type": "LINE_TIME_SERIES"
                },
                "chartType": "LINE_TIME_SERIES",
                "description": "string",
                "dimensions": [
                  {
                    "field": "string"
                  }
                ],
                "filters": [
                  {
                    "column": "string",
                    "operator": "string",
                    "type": "string",
                    "key": "string",
                    "value": {}
                  }
                ],
                "metrics": [
                  {
                    "agg": "sum",
                    "measure": "string"
                  }
                ],
                "name": "string",
                "view": "observations"
              }
            }
          }
        },
        {
          "name": "deleteDashboardWidget",
          "description": "Delete a dashboard widget. It must first be removed from every dashboard placement.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "widgetId": {
                "type": "string"
              }
            },
            "required": [
              "widgetId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "deleteDashboardWidget",
              "arguments": {
                "widgetId": "string"
              }
            }
          }
        },
        {
          "name": "listDashboards",
          "description": "List editable dashboards in the current project.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "page": {
                "default": 1,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "limit": {
                "default": 50,
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 100
              }
            },
            "required": [
              "page",
              "limit"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listDashboards",
              "arguments": {
                "limit": 50,
                "page": 1
              }
            }
          }
        },
        {
          "name": "getDashboard",
          "description": "Get an editable dashboard by ID, including its current layout: definition.widgets lists every placement with 12-column-grid coordinates (x/y top-left cell, width/height in cells).",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "dashboardId": {
                "type": "string"
              }
            },
            "required": [
              "dashboardId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getDashboard",
              "arguments": {
                "dashboardId": "string"
              }
            }
          }
        },
        {
          "name": "createDashboard",
          "description": "Create an editable dashboard.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1
              },
              "description": {
                "type": "string"
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": {}
                }
              },
              "definition": {
                "type": "object",
                "properties": {
                  "widgets": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {},
                      "additionalProperties": {}
                    }
                  }
                },
                "required": [
                  "widgets"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "name"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "createDashboard",
              "arguments": {
                "name": "string",
                "definition": {
                  "widgets": [
                    {
                      "property": {}
                    }
                  ]
                },
                "description": "string",
                "filters": [
                  {
                    "property": {}
                  }
                ]
              }
            }
          }
        },
        {
          "name": "updateDashboard",
          "description": "Partially update dashboard metadata, filters, or its complete definition.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "dashboardId": {
                "type": "string"
              },
              "name": {
                "type": "string",
                "minLength": 1
              },
              "description": {
                "type": "string"
              },
              "filters": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": {}
                }
              },
              "definition": {
                "type": "object",
                "properties": {
                  "widgets": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {},
                      "additionalProperties": {}
                    }
                  }
                },
                "required": [
                  "widgets"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "dashboardId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "updateDashboard",
              "arguments": {
                "dashboardId": "string",
                "definition": {
                  "widgets": [
                    {
                      "property": {}
                    }
                  ]
                },
                "description": "string",
                "filters": [
                  {
                    "property": {}
                  }
                ],
                "name": "string"
              }
            }
          }
        },
        {
          "name": "deleteDashboard",
          "description": "Delete an editable dashboard.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "dashboardId": {
                "type": "string"
              }
            },
            "required": [
              "dashboardId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "deleteDashboard",
              "arguments": {
                "dashboardId": "string"
              }
            }
          }
        },
        {
          "name": "addDashboardPlacement",
          "description": "Add a widget or preset placement to a dashboard's 12-column grid. Prefer omitting id and position: the server generates an id and appends the tile below existing ones at the default 6x6 size. Explicit positions are not checked for overlap. After adding, call getDashboard to verify the full grid arrangement; use updateDashboardPlacement to move or resize the new tile when needed. Returns the created placement.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "dashboardId": {
                "type": "string"
              },
              "type": {
                "type": "string",
                "enum": [
                  "widget",
                  "preset"
                ]
              },
              "id": {
                "type": "string"
              },
              "widgetId": {
                "type": "string"
              },
              "presetId": {
                "type": "string"
              },
              "x": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "y": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "width": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "height": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              }
            },
            "required": [
              "dashboardId",
              "type"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "addDashboardPlacement",
              "arguments": {
                "dashboardId": "string",
                "type": "widget",
                "height": 1,
                "id": "string",
                "presetId": "string",
                "widgetId": "string",
                "width": 1,
                "x": 1,
                "y": 1
              }
            }
          }
        },
        {
          "name": "updateDashboardPlacement",
          "description": "Move or resize an existing dashboard placement on the 12-column grid. Pass any of x, y (top-left cell), width, height (in cells); omitted fields keep their current value. The placement's content and id cannot change. Use getDashboard to read the current layout first. Overlaps are not checked. Returns the updated placement.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "dashboardId": {
                "type": "string"
              },
              "placementId": {
                "type": "string"
              },
              "x": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "y": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "width": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "height": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              }
            },
            "required": [
              "dashboardId",
              "placementId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "updateDashboardPlacement",
              "arguments": {
                "dashboardId": "string",
                "placementId": "string",
                "height": 1,
                "width": 1,
                "x": 1,
                "y": 1
              }
            }
          }
        },
        {
          "name": "deleteDashboardPlacement",
          "description": "Remove a placement from a dashboard without deleting the underlying widget.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "dashboardId": {
                "type": "string"
              },
              "placementId": {
                "type": "string"
              }
            },
            "required": [
              "dashboardId",
              "placementId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "deleteDashboardPlacement",
              "arguments": {
                "dashboardId": "string",
                "placementId": "string"
              }
            }
          }
        },
        {
          "name": "submitFeedback",
          "description": "Submit explicit user-approved feedback to the Langfuse team about Langfuse skills, MCP tools, CLI, docs, or public API.\nBefore calling, ask the user for permission and show the exact feedback payload, including any optional goal/use-case context.\nIf the user wants a reply, ask them to include their email address in the feedback text; only use an address they explicitly provide and show it in the exact payload preview.\nDo not include secrets, credentials, customer/project data, trace payloads, or unrelated context; the only contact detail to include is an explicitly provided reply email.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "targetType": {
                "type": "string",
                "enum": [
                  "skill",
                  "mcp-tool",
                  "cli",
                  "docs",
                  "public-api",
                  "other"
                ],
                "description": "Category of the thing the feedback is about."
              },
              "target": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "description": "The specific instance within targetType: the skill name, MCP tool name, CLI command, API endpoint path, or docs page path (e.g. 'queryMetrics', '/docs/mcp'). An identifier, not a sentence."
              },
              "feedback": {
                "type": "string",
                "minLength": 1,
                "maxLength": 3000,
                "description": "The concise feedback text approved by the user."
              },
              "goal": {
                "description": "Optional user-approved goal or use case they were trying to achieve. Do not infer or add secrets, customer data, trace payloads, or broad unrelated context.",
                "type": "string",
                "minLength": 1,
                "maxLength": 1500
              },
              "referenceUrl": {
                "description": "Optional URL reference. Langfuse stores it as text only.",
                "type": "string",
                "maxLength": 2048,
                "format": "uri"
              }
            },
            "required": [
              "targetType",
              "target",
              "feedback"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "submitFeedback",
              "arguments": {
                "feedback": "string",
                "target": "string",
                "targetType": "skill",
                "goal": "string",
                "referenceUrl": "https://example.com"
              }
            }
          }
        },
        {
          "name": "listExperiments",
          "description": "List experiments in the current Langfuse project with cursor-based pagination.\nUse this to find experiment IDs, inspect experiment summaries, and optionally include metadata or experiment-level scores.\nResults are sorted newest first by the latest event for each experiment, not by the returned experiment startTime.\nfromStartTime is required. Time filters and cursor bounds are applied before experiments are grouped, so a time range can return partial experiment aggregates.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "fields": {
                "description": "Response field groups to include. Available groups: core, metadata, scores.",
                "default": [
                  "core"
                ],
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "core",
                    "metadata",
                    "scores"
                  ]
                }
              },
              "limit": {
                "default": 50,
                "type": "integer",
                "minimum": 1,
                "maximum": 100
              },
              "scoreLimit": {
                "default": 50,
                "type": "integer",
                "minimum": 1,
                "maximum": 50
              },
              "cursor": {
                "type": "string",
                "description": "Base64url-encoded cursor for pagination"
              },
              "fromStartTime": {
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$",
                "description": "Required lower time bound for the events scanned before grouping experiments, as an ISO 8601 timestamp with timezone (Z or an explicit offset). This does not filter directly on the returned experiment startTime; aggregates may be partial."
              },
              "toStartTime": {
                "description": "Optional upper time bound for the events scanned before grouping experiments, as an ISO 8601 timestamp with timezone. Omit to leave the upper bound open. Aggregates only include events within the requested time window.",
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$"
              },
              "id": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "name": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "datasetId": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "filter": {
                "description": "Advanced experiment filters as objects with column, operator, value, and type. Supported columns: id, name, datasetId.",
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "column": {
                      "type": "string"
                    },
                    "operator": {
                      "type": "string"
                    },
                    "value": {},
                    "type": {
                      "type": "string"
                    },
                    "key": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "column",
                    "operator",
                    "value",
                    "type"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "fields",
              "limit",
              "scoreLimit",
              "fromStartTime"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listExperiments",
              "arguments": {
                "fields": [
                  "core"
                ],
                "fromStartTime": "string",
                "limit": 50,
                "scoreLimit": 50,
                "cursor": "string",
                "datasetId": [
                  "string"
                ],
                "filter": [
                  {
                    "column": "string",
                    "operator": "string",
                    "type": "string",
                    "value": {},
                    "key": "string"
                  }
                ],
                "id": [
                  "string"
                ],
                "name": [
                  "string"
                ],
                "toStartTime": "string"
              }
            }
          },
          "requiresV4": true
        },
        {
          "name": "listExperimentItems",
          "description": "List experiment items in the current Langfuse project with cursor-based pagination.\nUse this to inspect experiment item inputs, outputs, expected outputs, metadata, and optionally item or trace scores.\nResults are sorted newest first by experiment item startTime.\nfromStartTime is required. Request io and metadata fields only when needed because they can be large.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "fields": {
                "description": "Response field groups to include. Available groups: core, dataset, io, metadata, itemMetadata, experimentMetadata, scores.",
                "default": [
                  "core",
                  "dataset"
                ],
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "core",
                    "dataset",
                    "io",
                    "metadata",
                    "itemMetadata",
                    "experimentMetadata",
                    "scores"
                  ]
                }
              },
              "limit": {
                "default": 50,
                "type": "integer",
                "minimum": 1,
                "maximum": 100
              },
              "scoreLimit": {
                "default": 50,
                "type": "integer",
                "minimum": 1,
                "maximum": 50
              },
              "cursor": {
                "type": "string",
                "description": "Base64url-encoded cursor for pagination"
              },
              "fromStartTime": {
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$",
                "description": "Required lower bound on experiment item startTime, as an ISO 8601 timestamp with timezone (Z or an explicit offset)."
              },
              "toStartTime": {
                "description": "Optional upper bound on experiment item startTime, as an ISO 8601 timestamp with timezone. Omit to leave the upper bound open.",
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$"
              },
              "experimentId": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "experimentName": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "experimentItemId": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "datasetId": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "filter": {
                "description": "Advanced experiment item filters as objects with column, operator, value, and type. Supported columns: experimentId, experimentName, experimentItemId, datasetId.",
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "column": {
                      "type": "string"
                    },
                    "operator": {
                      "type": "string"
                    },
                    "value": {},
                    "type": {
                      "type": "string"
                    },
                    "key": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "column",
                    "operator",
                    "value",
                    "type"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "fields",
              "limit",
              "scoreLimit",
              "fromStartTime"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listExperimentItems",
              "arguments": {
                "fields": [
                  "core",
                  "dataset"
                ],
                "fromStartTime": "string",
                "limit": 50,
                "scoreLimit": 50,
                "cursor": "string",
                "datasetId": [
                  "string"
                ],
                "experimentId": [
                  "string"
                ],
                "experimentItemId": [
                  "string"
                ],
                "experimentName": [
                  "string"
                ],
                "filter": [
                  {
                    "column": "string",
                    "operator": "string",
                    "type": "string",
                    "value": {},
                    "key": "string"
                  }
                ],
                "toStartTime": "string"
              }
            }
          },
          "requiresV4": true
        },
        {
          "name": "getExternalMediaStorage",
          "description": "Get the external media storage configuration for the current project. Secret credentials are never returned.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {},
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getExternalMediaStorage",
              "arguments": {}
            }
          }
        },
        {
          "name": "configureExternalMediaStorage",
          "description": "Create or update the S3 external media storage configuration for the current project. Leave secretAccessKey empty to retain the saved secret; it is required again when type, endpoint, bucketName, or accessKeyId changes.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "S3",
                  "S3_COMPATIBLE"
                ]
              },
              "bucketName": {
                "type": "string"
              },
              "endpoint": {
                "type": "string"
              },
              "region": {
                "type": "string"
              },
              "accessKeyId": {
                "type": "string"
              },
              "secretAccessKey": {
                "type": "string"
              },
              "prefix": {
                "type": "string"
              },
              "forcePathStyle": {
                "type": "boolean"
              }
            },
            "required": [
              "type",
              "bucketName",
              "region",
              "accessKeyId",
              "forcePathStyle"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "configureExternalMediaStorage",
              "arguments": {
                "accessKeyId": "string",
                "bucketName": "string",
                "forcePathStyle": true,
                "region": "string",
                "type": "S3",
                "endpoint": "string",
                "prefix": "string",
                "secretAccessKey": "string"
              }
            }
          }
        },
        {
          "name": "deleteExternalMediaStorage",
          "description": "Delete the external media storage configuration for the current project.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {},
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "deleteExternalMediaStorage",
              "arguments": {}
            }
          }
        },
        {
          "name": "testExternalMediaStorage",
          "description": "Generate a short-lived signed URL for an existing S3 object using the current project's external media storage configuration.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "uri": {
                "type": "string",
                "description": "S3 URI in the form s3://bucket/path/to/object"
              }
            },
            "required": [
              "uri"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "testExternalMediaStorage",
              "arguments": {
                "uri": "string"
              }
            }
          }
        },
        {
          "name": "listAlerts",
          "description": "List alerts, optionally filtered by severity or tags and ordered by alert properties.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "page": {
                "default": 1,
                "type": "number",
                "minimum": 0
              },
              "limit": {
                "default": 50,
                "type": "integer",
                "minimum": 1,
                "maximum": 100
              },
              "orderBy": {
                "type": "object",
                "properties": {
                  "column": {
                    "type": "string",
                    "enum": [
                      "name",
                      "status",
                      "severity",
                      "severityChangedAt",
                      "alertedAt",
                      "createdAt",
                      "updatedAt"
                    ]
                  },
                  "order": {
                    "type": "string",
                    "enum": [
                      "ASC",
                      "DESC"
                    ]
                  }
                },
                "required": [
                  "column",
                  "order"
                ],
                "additionalProperties": false
              },
              "filter": {
                "description": "Filter alerts by severity or tags.",
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "column": {
                      "type": "string"
                    },
                    "operator": {
                      "type": "string"
                    },
                    "value": {},
                    "type": {
                      "type": "string"
                    },
                    "key": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "column",
                    "operator",
                    "value",
                    "type"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "page",
              "limit"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "listAlerts",
              "arguments": {
                "limit": 50,
                "page": 1,
                "filter": [
                  {
                    "column": "string",
                    "operator": "string",
                    "type": "string",
                    "value": {},
                    "key": "string"
                  }
                ],
                "orderBy": {
                  "column": "name",
                  "order": "ASC"
                }
              }
            }
          }
        },
        {
          "name": "getAlert",
          "description": "Get an alert by ID.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {
              "monitorId": {
                "type": "string",
                "description": "ID of the alert to retrieve."
              }
            },
            "required": [
              "monitorId"
            ],
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getAlert",
              "arguments": {
                "monitorId": "string"
              }
            }
          }
        },
        {
          "name": "getV4MigrationData",
          "description": "Get project-specific evidence for upgrading to Langfuse v4, including SDK versions and compatibility, experiment instrumentation, legacy integrations, deprecated API usage, and trace-level evaluators. Use this before giving v4 migration guidance.",
          "inputSchema": {
            "$schema": "http://json-schema.org/draft-07/schema#",
            "type": "object",
            "properties": {},
            "additionalProperties": false
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getV4MigrationData",
              "arguments": {}
            }
          }
        }
      ],
      "resources": [
        {
          "uri": "skill://langfuse/langfuse/SKILL.md",
          "name": "langfuse",
          "description": "Interact with Langfuse and access its documentation: tracing, monitoring, creating datasets, running experiments, and evaluating AI applications. Use when needing to (1) query or modify Langfuse data, (2) look up Langfuse documentation, concepts, integration guides, a feature or SDK usage, or (3) do any AI engineering task (AI observability, prompt engineering/management, evaluation and evaluator management, experimentation, dataset management, evaluation-driven CI/CD, feedback collection). Invoke it for tasks in this scope even when Langfuse is not configured or explicitly mentioned.",
          "mimeType": "text/markdown"
        },
        {
          "uri": "skill://langfuse/migrate-to-langfuse/SKILL.md",
          "name": "migrate-to-langfuse",
          "description": "Migrate to Langfuse from another LLM observability/evals platform (LangSmith, Arize AX, Phoenix, Braintrust, Helicone, Promptfoo, ...). A one-off vendor switch: live tracing cutover plus transfer of historical traces, datasets, prompts, and evaluators. Not for anything Langfuse-to-Langfuse — SDK or version upgrades, project/region moves, self-hosted to Cloud — and not for moving in-code prompts into Langfuse; the main langfuse skill covers those.",
          "mimeType": "text/markdown"
        }
      ],
      "prompts": []
    },
    {
      "id": "langfuse-docs",
      "name": "Langfuse Docs MCP",
      "description": "Unauthenticated MCP server for Langfuse documentation search and retrieval.",
      "canonicalUrl": "https://langfuse.com/api/mcp",
      "auth": {
        "type": "none"
      },
      "variants": [],
      "setupSnippets": [
        {
          "id": "langfuse-docs-cursor",
          "client": "Cursor",
          "title": "Cursor mcp.json",
          "language": "json",
          "code": "{\n  \"mcpServers\": {\n    \"langfuse-docs\": {\n      \"url\": \"https://langfuse.com/api/mcp\"\n    }\n  }\n}"
        },
        {
          "id": "langfuse-docs-vscode",
          "client": "VS Code Copilot",
          "title": "VS Code settings.json",
          "language": "json",
          "code": "{\n  \"mcp\": {\n    \"servers\": {\n      \"langfuse-docs\": {\n        \"type\": \"http\",\n        \"url\": \"https://langfuse.com/api/mcp\"\n      }\n    }\n  }\n}"
        },
        {
          "id": "langfuse-docs-claude-code",
          "client": "Claude Code",
          "title": "Claude Code CLI",
          "language": "bash",
          "code": "claude mcp add --transport http langfuse-docs https://langfuse.com/api/mcp"
        },
        {
          "id": "langfuse-docs-windsurf",
          "client": "Windsurf",
          "title": "Proxy command",
          "language": "json",
          "code": "{\n  \"mcpServers\": {\n    \"langfuse-docs\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"mcp-remote\",\n        \"https://langfuse.com/api/mcp\"\n      ]\n    }\n  }\n}"
        },
        {
          "id": "langfuse-docs-generic",
          "client": "Generic MCP client",
          "title": "Streamable HTTP JSON",
          "language": "json",
          "code": "{\n  \"servers\": {\n    \"langfuse-docs\": {\n      \"transport\": {\n        \"type\": \"streamable-http\",\n        \"url\": \"https://langfuse.com/api/mcp\"\n      }\n    }\n  }\n}"
        }
      ],
      "discovery": {
        "protocolVersion": "2025-06-18",
        "serverInfo": {
          "name": "mcp-typescript server on vercel",
          "version": "0.1.0"
        },
        "capabilities": {
          "tools": {
            "listChanged": true
          }
        },
        "discoveredAt": "2026-11-11T12:33:51.955Z"
      },
      "tools": [
        {
          "name": "submitFeedback",
          "description": "Submit explicit user-approved feedback to the Langfuse team.\nBefore calling, ask permission and show the exact payload.\nIf the user wants a reply, ask them to include their email address in the feedback text; only use an address they explicitly provide and show it in the exact payload preview.\nDo not include secrets, credentials, customer/project data, trace payloads, or unrelated context; the only contact detail to include is an explicitly provided reply email.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "targetType": {
                "type": "string",
                "enum": [
                  "skill",
                  "mcp-tool",
                  "cli",
                  "docs",
                  "public-api",
                  "other"
                ],
                "description": "Category of the thing the feedback is about."
              },
              "target": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "description": "The specific instance within targetType: the skill name, MCP tool name, CLI command, API endpoint path, or docs page path (e.g. 'queryMetrics', '/docs/mcp'). An identifier, not a sentence."
              },
              "feedback": {
                "type": "string",
                "minLength": 1,
                "maxLength": 3000
              },
              "goal": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1500
              },
              "referenceUrl": {
                "type": "string",
                "format": "uri",
                "maxLength": 2048
              }
            },
            "required": [
              "targetType",
              "target",
              "feedback"
            ],
            "additionalProperties": false,
            "$schema": "http://json-schema.org/draft-07/schema#"
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "submitFeedback",
              "arguments": {
                "feedback": "string",
                "target": "string",
                "targetType": "skill",
                "goal": "string",
                "referenceUrl": "https://example.com"
              }
            }
          }
        },
        {
          "name": "searchLangfuseDocs",
          "description": "Semantic search (RAG) over the Langfuse documentation. Use this whenever the user asks a broader question that cannot be answered by a specific single page. Returns a concise answer synthesized from relevant docs. Prefer this before guessing. If a specific page is needed call getLangfuseDocsPage first. The raw provider response is included in _meta.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "query": {
                "type": "string",
                "description": "The user's question in natural language. Include helpful context like SDK/language (e.g., Python v3, JS v4), self-hosted vs cloud, and short error messages (trim long stack traces). Keep under ~600 characters."
              }
            },
            "required": [
              "query"
            ],
            "additionalProperties": false,
            "$schema": "http://json-schema.org/draft-07/schema#"
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "searchLangfuseDocs",
              "arguments": {
                "query": "string"
              }
            }
          }
        },
        {
          "name": "getLangfuseDocsPage",
          "description": "Fetch the raw Markdown for a single Langfuse docs page. Accepts a docs path (e.g., /docs/observability/overview) or a full https://langfuse.com URL. Returns the exact Markdown (may include front matter). Use when you need a specific page content (Integration, Features, API, etc.) or code samples. Prefer searchLangfuseDocs for broader questions where there is not one specific page about it. Changelog pages (/changelog/...) are historical release notes: use them only to confirm that a feature exists or when it shipped, not as an implementation reference. Their code samples reflect the SDK/API at release time and may be outdated, so for implementation follow the current docs and the API/SDK reference instead.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "pathOrUrl": {
                "type": "string",
                "description": "Docs path starting with \"/\" (e.g., /docs/observability/overview) or a full URL on https://langfuse.com. Do not include anchors (#...) or queries (?foo=bar) — they will be ignored."
              }
            },
            "required": [
              "pathOrUrl"
            ],
            "additionalProperties": false,
            "$schema": "http://json-schema.org/draft-07/schema#"
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getLangfuseDocsPage",
              "arguments": {
                "pathOrUrl": "string"
              }
            }
          }
        },
        {
          "name": "getLangfuseOverview",
          "description": "Get a high-level, machine-readable index by downloading https://langfuse.com/llms.txt. Use this at the start of a session when needed to discover key docs endpoints or to seed follow-up calls to searchLangfuseDocs or getLangfuseDocsPage. Returns the plain text contents of llms.txt. Avoid repeated calls within the same session.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false,
            "$schema": "http://json-schema.org/draft-07/schema#"
          },
          "exampleRequest": {
            "jsonrpc": "2.0",
            "id": 1,
            "method": "tools/call",
            "params": {
              "name": "getLangfuseOverview",
              "arguments": {}
            }
          }
        }
      ],
      "resources": [],
      "prompts": []
    }
  ]
}
