MCP Directory

How to add Honeycomb MCP Server to Windsurf

Honeycomb observability via AI: query datasets, alerts and boards (community + official). Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 250★ · stdio · apikey · official

Windsurf config for Honeycomb MCP Server

npx -y @kajirita2002/honeycomb-mcp-server
{
  "mcpServers": {
    "honeycomb-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@kajirita2002/honeycomb-mcp-server"
      ],
      "env": {
        "HONEYCOMB_API_KEY": "<your-honeycomb-api-key>"
      }
    }
  }
}

Setup steps

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

Before you start

  • Node.js 18 or higher
  • A Honeycomb Enterprise subscription (required)
  • A Honeycomb API key with full permissions: query access for analytics, read access for SLOs and Triggers, and environment-level access for dataset operations — created in Honeycomb's environment settings
  • pnpm to install and build the server locally
  • EU customers must set HONEYCOMB_API_ENDPOINT to https://api.eu1.honeycomb.io/

What Honeycomb MCP Server can do in Windsurf

list_datasets

List datasets in an environment

get_columns

Get a dataset's columns/schema

run_query

Run an analytics query against a dataset

analyze_columns

Analyze columns to understand cardinality/usage

list_slos

List Service Level Objectives

get_slo

Get details for a specific SLO

list_triggers

List Triggers (alerts)

get_trigger

Get details for a specific Trigger

Security

The official self-hosted server requires Honeycomb Enterprise and is being deprecated toward a hosted MCP, so check entitlement before relying on it. API keys grant read access to all events in their environment, so scope keys per-environment and avoid management keys.

Honeycomb MCP Server + Windsurf FAQ

Where is the Windsurf config file?

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

Is Honeycomb MCP Server safe to use with Windsurf?

The official self-hosted server requires Honeycomb Enterprise and is being deprecated toward a hosted MCP, so check entitlement before relying on it. API keys grant read access to all events in their environment, so scope keys per-environment and avoid management keys.

Is this server still maintained?

It is officially deprecated. Honeycomb recommends migrating to its hosted MCP solution; this self-hosted stdio server remains as a reference.

Do I need a paid plan?

Yes — the documentation states a Honeycomb Enterprise subscription is required to use the MCP server.

What permissions does the API key need?

Full permissions: query access for analytics, read access for SLOs and Triggers, and environment-level access for dataset operations.

View repo Full Honeycomb MCP Server page