mcpField
L
langfuse-api

langfuse-api

github.com/langfuseAgent workflows31955 installsUpdated 1d ago
Repository

About langfuse-api

langfuse-api is a skill for carrying out Langfuse tasks through its REST API. It covers traces, prompts, datasets, scores, projects, and API keys, and requires checking current API documentation before making requests.

Key features

  1. 01Query and export traces
  2. 02Manage prompts programmatically
  3. 03Create datasets and dataset items
  4. 04Fetch and create scores
  5. 05Manage projects and API keys
  6. 06Use current API reference and pagination

Use cases

  1. 01Export traces for a selected time period
  2. 02Create a dataset and add items
  3. 03Retrieve scores associated with a trace
  4. 04List or fetch Langfuse prompts

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/langfuse/skills --skill langfuse-api

After installing, type/langfuse-apiin Claude Code to confirm it loaded.

Details

From the project README

Langfuse API

Help users interact with Langfuse via the REST API.

When to Use

  • User wants to query or export traces
  • User wants to manage prompts programmatically
  • User wants to create/update datasets or dataset items
  • User wants to fetch or create scores
  • User wants to manage projects or API keys
  • Any other Langfuse API interaction

Workflow

1. Check Credentials

Before making any API call, verify credentials are available:

echo $LANGFUSE_PUBLIC_KEY   # pk-...
echo $LANGFUSE_SECRET_KEY   # sk-...
echo $LANGFUSE_HOST         # https://cloud.langfuse.com (or self-hosted/EU/US URL)

If not set, ask user:

  • "I need your Langfuse API credentials. You can find them in Settings → API Keys in the Langfuse UI."
  • "Which Langfuse host are you using? (cloud.langfuse.com, us.cloud.langfuse.com, eu.cloud.langfuse.com, or self-hosted URL)"
2. Fetch Fresh API Reference

Always fetch the current API reference before making calls. The API may have new endpoints or changed parameters.

Fetch: https://api.reference.langfuse.com

Look for the specific endpoint needed for the user's request. The reference contains:

  • All available endpoints
  • Required and optional parameters
  • Request/response schemas
  • Authentication details
3. Make the API Call

Authentication: Basic Auth with LANGFUSE_PUBLIC_KEY as username and LANGFUSE_SECRET_KEY as password.

Base URL: {LANGFUSE_HOST}/api/public

Example:

curl -X GET "${LANGFUSE_HOST}/api/public/traces" \
  -u "${LANGFUSE_PUBLIC_KEY}:${LANGFUSE_SECRET_KEY}" \
  -H "Content-Type: application/json"
4. Handle Pagination

Many endpoints return paginated results. Check for:

  • page and limit parameters
  • meta.totalItems and meta.totalPages in response
  • Iterate if user needs all results

Common Use Cases

User RequestEndpoint to Look Up
"Get my recent traces"GET /traces
"Export traces from last week"GET /traces with date filters
"Fetch a specific prompt"GET /prompts/{name}
"Create a dataset"POST /datasets
"Add items to dataset"POST /dataset-items
"Get scores for a trace"GET /scores with traceId filter
"List all prompts"GET /prompts

Important Notes

  • Always fetch fresh docs - Don't rely on cached knowledge of the API
  • Check rate limits - The API has rate limits; handle 429 responses
  • Validate responses - Check for errors before processing data
  • Large exports - For bulk data, use pagination and consider streaming to file

OpenAPI Spec

For programmatic access or generating types:

https://cloud.langfuse.com/generated/api/openapi.yml

Comments

Markdown supported