MCP Directory

How to add Langfuse Prompt Management MCP Server to Windsurf

Access and manage your Langfuse prompts through the Model Context Protocol. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 166★ · stdio · apikey · official

Windsurf config for Langfuse Prompt Management MCP Server

npm install && npm run build
{
  "mcpServers": {
    "langfuse-prompt-management-mcp-server": {
      "command": "node",
      "args": [
        "<absolute-path>/build/index.js"
      ],
      "env": {
        "LANGFUSE_PUBLIC_KEY": "your-public-key",
        "LANGFUSE_SECRET_KEY": "your-secret-key",
        "LANGFUSE_BASEURL": "https://cloud.langfuse.com"
      }
    }
  }
}

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Langfuse Prompt Management MCP Server config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Langfuse Prompt Management MCP Server's tools become available to Cascade.

Before you start

  • Node.js (to run the built server with `node`)
  • A Langfuse account with public and secret API keys
  • Build the server locally with `npm install` and `npm run build`

What Langfuse Prompt Management MCP Server can do in Windsurf

get-prompts

List available prompts. Optional `cursor` parameter for pagination. Returns a list of prompts with their arguments.

get-prompt

Retrieve and compile a specific prompt. Required `name` parameter (name of the prompt to retrieve) and optional `arguments` parameter (a JSON object with prompt variables).

Security

Requires your Langfuse public and secret API keys, passed via the LANGFUSE_PUBLIC_KEY and LANGFUSE_SECRET_KEY environment variables. The secret key grants access to your Langfuse project's prompts; keep it out of source control.

Langfuse Prompt Management MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Langfuse Prompt Management MCP Server config there under the "mcpServers" key and restart the client.

Is Langfuse Prompt Management MCP Server safe to use with Windsurf?

Requires your Langfuse public and secret API keys, passed via the LANGFUSE_PUBLIC_KEY and LANGFUSE_SECRET_KEY environment variables. The secret key grants access to your Langfuse project's prompts; keep it out of source control.

Which prompts are returned?

Only prompts with a `production` label in Langfuse are returned.

Are prompt arguments described?

All arguments are assumed to be optional and do not include descriptions, because variables do not have a specification in Langfuse.

How do I use it with Cursor?

Add a new server in Cursor of type `command`, with the command running `node absolute-path/build/index.js` and the LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEY, and LANGFUSE_BASEURL environment variables set inline.

View repo Full Langfuse Prompt Management MCP Server page