Langfuse

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: Basic auth.
  • Connection: HTTP Basic auth with LANGFUSE_PUBLIC_KEY as the username and LANGFUSE_SECRET_KEY as the password.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
LANGFUSE_PUBLIC_KEYYesLangfuse project public key (starts with pk-lf-), used as the HTTP Basic username Docs.
LANGFUSE_SECRET_KEYYesLangfuse project secret key (starts with sk-lf-), used as the HTTP Basic password Docs.
LANGFUSE_HOSTYesLangfuse host without scheme or port. Use cloud.langfuse.com (EU), us.cloud.langfuse.com (US), or your self-hosted domain.

Setup

  1. Create a Langfuse account: Sign up at https://cloud.langfuse.com (EU) or https://us.cloud.langfuse.com (US). The free Hobby plan is enough for testing. Self-hosting is also supported.
  2. Create project API keys: In your Langfuse project, open Settings → API Keys and create a key pair. You get a public key (pk-lf-...) and a secret key (sk-lf-...).
  3. Store the keys: Add LANGFUSE_PUBLIC_KEY=pk-lf-.... and LANGFUSE_SECRET_KEY=sk-lf-.... to your .env file. The API uses HTTP Basic auth with the public key as username and secret key as password.
  4. Verify access: Run the List Traces tool. If your project is in the US region, set LANGFUSE_HOST=us.cloud.langfuse.com in your .env; EU projects use the default cloud.langfuse.com.

Provider notes

  • API keys are project-scoped; create separate keys per project/environment
  • All tools send their requests to the host set in the LANGFUSE_HOST environment variable (default cloud.langfuse.com for EU); US cloud is us.cloud.langfuse.com and self-hosted deployments use their own domain

Provider API reference.

Tools

ToolAccessDescription
List Traces<br /><code className="reference-identifier">langfuse__list_traces</code>ReadList traces
Get Trace<br /><code className="reference-identifier">langfuse__get_trace</code>ReadGet trace
List Observations<br /><code className="reference-identifier">langfuse__list_observations</code>ReadList observations
Create Score<br /><code className="reference-identifier">langfuse__create_score</code>WriteScore trace or observation

Verify the connection

Call a read tool such as langfuse__list_traces with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.