Honeycomb MCP Server

A Model Context Protocol server for interacting with Honeycomb observability data. This server enables LLMs like Claude to directly analyze and query your Honeycomb datasets across multiple environments.

Features

Query Honeycomb datasets across multiple environments
Analyze columns and data patterns
Run basic analytics queries
Monitor SLOs and their status
View and analyze Triggers
Access dataset metadata and schema information

Installation

npm install
npm run build

Configuration

Create a configuration file at ~/.hny/config.json with your Honeycomb environments and API keys:

{
  "environments": [
    {
      "name": "production",
      "apiKey": "your_prod_api_key"
    },
    {
      "name": "staging",
      "apiKey": "your_staging_api_key"
    }
  ]
}

Each environment entry can also optionally include a baseUrl if you're using a different API endpoint.

Usage

With Claude Desktop

Add this to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "honeycomb": {
      "command": "node",
      "args": ["/path/to/build/index.mjs"]
    }
  }
}

Available Tools

list-datasets: List all datasets in an environment
get-columns: List all columns in a dataset
run-query: Run basic analytics queries with aggregations
analyze-column: Get detailed analysis of specific columns
list-slos: View all SLOs for a dataset
get-slo: Get detailed SLO status including compliance
list-triggers: View all triggers for a dataset
get-trigger: Get detailed trigger information

Resources

The server exposes Honeycomb datasets as resources with the URI format: honeycomb://{environment}/{dataset-slug}

For example:

honeycomb://production/api-requests
honeycomb://staging/backend-services

Development

pnpm install
pnpm run build

Requirements

Node.js 16+
Honeycomb API keys with appropriate permissions:
- Query access for analytics
- Read access for SLOs and Triggers
- Environment-level access for dataset operations

Example Queries

Ask Claude things like:

"What datasets are available in the production environment?"
"Show me the SLO compliance for the API availability in production"
"Are there any active triggers in the staging environment?"
"What's the error rate in the production API dataset over the last hour?"

License

MIT