{
  "info": {
    "name": "Langfuse — mcp.ai",
    "description": "REST API for the Langfuse MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/langfuse",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "langfuse_create_score",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/score",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "score"
          ]
        },
        "description": "Attach an evaluation score to exactly one Langfuse trace, session, or dataset run, optionally narrowing a trace score to an observation.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"value\": \"\",\n  \"source\": \"\",\n  \"comment\": \"\",\n  \"metadata\": {},\n  \"queue_id\": \"\",\n  \"score_id\": \"\",\n  \"trace_id\": \"\",\n  \"config_id\": \"\",\n  \"data_type\": \"\",\n  \"session_id\": \"\",\n  \"environment\": \"\",\n  \"dataset_run_id\": \"\",\n  \"observation_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "langfuse_get_annotation_queue",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/annotation/queue",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "annotation",
            "queue"
          ]
        },
        "description": "Retrieve one Langfuse annotation queue by its ID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"queue_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "langfuse_get_prompt",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/prompt",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "prompt"
          ]
        },
        "description": "Retrieve a Langfuse text or chat prompt by name, deployment label, or exact version, with optional dependency resolution.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"label\": \"\",\n  \"resolve\": false,\n  \"version\": 0,\n  \"prompt_name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "langfuse_list_annotation_queues",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/annotation/queues",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "annotation",
            "queues"
          ]
        },
        "description": "List annotation queues configured for human evaluation in the connected Langfuse project.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"next_cursor\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "langfuse_list_dataset_items",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/dataset/items",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "dataset",
            "items"
          ]
        },
        "description": "List dataset items, optionally scoped to a dataset, source trace or observation, or historical dataset version.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"version\": \"\",\n  \"next_cursor\": \"\",\n  \"dataset_name\": \"\",\n  \"source_trace_id\": \"\",\n  \"source_observation_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "langfuse_list_dataset_run_items",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/dataset/run/items",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "dataset",
            "run",
            "items"
          ]
        },
        "description": "List run items for a specific Langfuse dataset and run name.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"limit\": 0,\n  \"runName\": \"\",\n  \"datasetId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "langfuse_list_datasets",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/datasets",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "datasets"
          ]
        },
        "description": "List datasets available to the connected Langfuse project.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"next_cursor\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "langfuse_list_experiments",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/experiments",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "experiments"
          ]
        },
        "description": "List Langfuse experiments active in a required time range, optionally including metadata and directly attached scores.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"names\": \"\",\n  \"fields\": \"\",\n  \"dataset_ids\": \"\",\n  \"filter_json\": \"\",\n  \"next_cursor\": \"\",\n  \"score_limit\": 0,\n  \"to_start_time\": \"\",\n  \"experiment_ids\": \"\",\n  \"from_start_time\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "langfuse_list_models",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/models",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "models"
          ]
        },
        "description": "List Langfuse-managed and project-custom model pricing definitions used for usage and cost calculation.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"next_cursor\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "langfuse_list_observations",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/observations",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "observations"
          ]
        },
        "description": "Search Langfuse observations such as generations, spans, events, agents, and tool calls, selecting only the field groups needed.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"level\": \"\",\n  \"limit\": 0,\n  \"fields\": \"\",\n  \"user_id\": \"\",\n  \"version\": \"\",\n  \"trace_id\": \"\",\n  \"session_id\": \"\",\n  \"filter_json\": \"\",\n  \"next_cursor\": \"\",\n  \"environments\": \"\",\n  \"to_start_time\": \"\",\n  \"expand_metadata\": \"\",\n  \"from_start_time\": \"\",\n  \"observation_type\": \"\",\n  \"is_root_observation\": false,\n  \"parent_observation_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "langfuse_list_scores",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/scores",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "scores"
          ]
        },
        "description": "Search numeric, boolean, categorical, text, and correction scores with subject and annotation context.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"names\": \"\",\n  \"fields\": \"\",\n  \"values\": \"\",\n  \"sources\": \"\",\n  \"queue_ids\": \"\",\n  \"score_ids\": \"\",\n  \"trace_ids\": \"\",\n  \"value_max\": 0,\n  \"value_min\": 0,\n  \"config_ids\": \"\",\n  \"data_types\": \"\",\n  \"next_cursor\": \"\",\n  \"session_ids\": \"\",\n  \"environments\": \"\",\n  \"to_timestamp\": \"\",\n  \"experiment_ids\": \"\",\n  \"from_timestamp\": \"\",\n  \"author_user_ids\": \"\",\n  \"observation_ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "langfuse_query_metrics",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/query/metrics",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "query",
            "metrics"
          ]
        },
        "description": "Run an aggregate Langfuse metrics query over observations or numeric, boolean, or categorical scores.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"view\": \"\",\n  \"filters\": \"\",\n  \"metrics\": \"\",\n  \"order_by\": \"\",\n  \"row_limit\": 0,\n  \"dimensions\": \"\",\n  \"to_timestamp\": \"\",\n  \"from_timestamp\": \"\",\n  \"histogram_bins\": 0,\n  \"time_granularity\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "langfuse_upsert_llm_connection",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/upsert/llm/connection",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "upsert",
            "llm",
            "connection"
          ]
        },
        "description": "Create or update a Langfuse LLM provider connection by provider name.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"config\": {},\n  \"adapter\": \"\",\n  \"baseURL\": \"\",\n  \"provider\": \"\",\n  \"secretKey\": \"\",\n  \"customModels\": \"\",\n  \"extraHeaders\": {},\n  \"withDefaultModels\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}