Gene Library Courses Download Pricing Contact Sign in
honeycomb logo
analytics Official Website

Honeycomb MCP Server – Observability AI Access

Honeycomb MCP lets AI agents query, analyze, and visualize Honeycomb telemetry and observability metadata through the Model Context Protocol. Agents can investigate traces, logs, metrics, triggers, SLOs, Boards, and Canvas investigations when granted the appropriate Honeycomb permissions.

#observability#telemetry#incident-response

Overview

Honeycomb MCP is Honeycomb's hosted Model Context Protocol server for connecting AI agents to Honeycomb observability data. It is designed for engineering and operations workflows where an agent needs live context from Honeycomb rather than relying on static documentation or pasted screenshots. Once connected, an agent can inspect telemetry, query behavior over time, and use Honeycomb-specific investigation tools from an IDE, CLI, or assistant interface.

What the MCP server enables

The server exposes Honeycomb tools for workspace discovery, query and analysis, traces and spans, service maps, semantic conventions, Boards, Triggers, Service Level Objectives, notification recipients, Canvas investigations, and AI conversation analysis. Typical read operations include discovering environments and datasets, running queries, retrieving trace waterfalls, listing spans, checking SLOs, reviewing Triggers, and analyzing prior AI-agent conversations captured with OpenTelemetry attributes. Write-capable tools can create or update Boards, Triggers, SLOs, notification recipients, and Canvas investigations when the connection has the required write scope.

When to use it

Use Honeycomb MCP when an AI agent should help diagnose latency spikes, error bursts, noisy alerts, slow services, or unusual traffic patterns using actual Honeycomb data. It is also useful for translating existing dashboards or alerts into Honeycomb queries, exploring schemas and semantic conventions, generating investigation notes on Boards, and helping teams preserve incident findings in a shared Honeycomb workspace.

Connection and authentication

Honeycomb provides hosted HTTP MCP endpoints for the US and EU regions. OAuth 2.1 is the recommended authentication method for interactive agents because it avoids sharing API keys. For headless or unattended agents that cannot complete OAuth, Honeycomb supports API key authentication using a Management API key with Model Context Protocol and Environments scopes. API-key access should use the narrowest required scopes; write access is needed only for mutating tools.

Key considerations

A Honeycomb team must have Honeycomb Intelligence enabled before using MCP. Most tools are read-only by default, while write tools require explicit mcp:write scope. Some tools depend on plan tier or feature availability, such as Enterprise service map access or anomaly detection. Honeycomb enforces per-tool rate limits, with lower limits for expensive or mutating operations, so agents should avoid unnecessary polling and repeated broad queries.

Supported Transports

streamable_http

URL: https://mcp.honeycomb.io/mcp

streamable_http

URL: https://mcp.eu1.honeycomb.io/mcp

Frequently Asked Questions

When should an AI agent use the Honeycomb MCP server?
Use it when an agent needs to investigate live Honeycomb observability data, such as latency spikes, error rates, slow traces, SLO status, alert configuration, or service behavior across datasets and environments.
What Honeycomb data and tools does this MCP server expose?
Honeycomb MCP exposes tools for workspace discovery, query execution, query-result retrieval, BubbleUp analysis, trace and span inspection, service maps, semantic conventions, Boards, Triggers, SLOs, notification recipients, Canvas investigations, AI conversation analysis, and feedback submission.
Can the Honeycomb MCP server modify Honeycomb resources?
Yes, but only when the connection is granted write access. Write tools include creating or updating Boards, Triggers, SLOs, notification recipients, and Canvas investigations; read-only access is sufficient for query, trace, metadata, and status inspection workflows.
How is authentication configured for Honeycomb MCP?
Honeycomb recommends OAuth 2.1 for interactive agents. For headless agents, a team owner can create a Management API key with Model Context Protocol and Environments scopes, then pass it as a Bearer token using an environment variable such as HONEYCOMB_API_KEY.
Which Honeycomb MCP endpoint should be used?
Use the hosted Streamable HTTP endpoint that matches the Honeycomb region for the team: https://mcp.honeycomb.io/mcp for US teams or https://mcp.eu1.honeycomb.io/mcp for EU teams. Honeycomb also documents mcp-remote as a bridge for clients that cannot connect to HTTP MCP directly, but the hosted HTTP endpoint is the primary server connection.