Connect Honeycomb MCP to your AI agent
Honeycomb is an observability platform for high-cardinality event data. The Honeycomb MCP server lets agents query datasets, run analyses and inspect telemetry.
We set up the connection using your own Honeycomb MCP account, with keys you control, and keep it running. Your agent picks it up and starts doing the work.
Actions
What your agent can do in Honeycomb MCP
Each one is a real action the agent can take on its own, the same things a person clicking around Honeycomb MCP could do. Read-only by default; write actions are confirmed against your policy.
- Canvas agent invoke Kick off a single-turn run of the Honeycomb Canvas agent. Pass investigation_id to extend an existing investigation visible to the caller's team. Omit investigation_id to create a new investigation for this prompt; the…
- Canvas agent poll response Poll for the result of a previously-issued canvas_agent_invoke call. Pass the investigation_id and session_id returned from canvas_agent_invoke. Each call waits up to wait_seconds (default 30, max 50) for a terminal eve…
- Create board Create a board (dashboard) with query, SLO, and text panels. When to use: - "Create a dashboard for service X" / "build a board with latency and error queries" — primary creation path. - After running queries and collec…
- Create marker Creates a marker (a vertical annotation on charts) to mark a point or window in time, such as a deploy, incident, or config change. Scope it to one dataset or, with dataset_slug='__all__', the whole environment.
- Create recipient Create a notification recipient (email, Slack, PagerDuty, or webhook) so it can be attached to triggers and SLO burn alerts. When to use: - "Alert the on-call channel when this trigger fires" — create a Slack recipient…
- Create slo Create an SLO (Service Level Objective) backed by an auto-created SLI derived column. When to use: - "Create an SLO for API latency" / "set a 99.9% availability target" — primary creation path. - When a user asks to tra…
- Create trigger Create a trigger that fires alerts when a query result crosses a threshold. When to use: - "Alert me when error rate exceeds 5%" / "page on-call when request count drops below 100" — primary alerting path. - "Create a t…
- Feedback Submit feedback about Honeycomb's MCP server to the agentic-intelligence team. When to use: - A tool returned unexpected, wrong, or confusing data. - You wanted a capability that no tool in this server provides. - A wor…
- Find columns Search for columns and calculated fields by intent across one or all datasets in an environment. When to use: - "What column has the error rate?" / "Find columns related to duration or latency" — intent-based discovery.…
- Find queries Search query history and saved queries by intent; returns matching queries with their run PKs. When to use: - "Has anyone queried the error rate for checkout?" — check existing work before composing a new query. - Befor…
- Get aiconversation Fetch the full event timeline for a single AI conversation, identified by its OpenTelemetry gen_ai.conversation.id attribute value. Prefer this over ad-hoc run_query filtered by conversation ID — it returns every LLM ca…
- Get dataset Get dataset metadata and its full column schema (columns + calculated fields), sorted by most recent write activity. When to use: - "What columns does the api-service dataset have?" — retrieve the schema for one dataset…
- Get dataset columns Get the full column schema for one dataset, with optional sample values for specific columns. When to use: - Validating column names before composing a run_query (check the column exists and note its type). - "What valu…
- Get environment Get details for a specific environment, including its dataset list sorted by most recent activity. When to use: - After get_workspace_context returns environment slugs, drill into one to see which datasets it contains.…
- Get query results Retrieve results and metadata from an existing query execution. Accepts a Honeycomb URL, a run_pk, or a query_id (returns most recent run). Provide exactly one of these three inputs. When to use: - After find_queries re…
- Get semconv attribute Get the full definitions of one or more semantic convention attributes by their exact names. Returns complete metadata for each attribute: type, brief description, detailed note, stability, deprecation status, requireme…
- Get span details Summarize attributes and their common values observed on spans with a specific name. USE THIS AFTER list_spans (or whenever you already know a span_name) and BEFORE run_query. It tells you which attributes are populated…
- Get trace Retrieve all spans for a specific trace ID and render them as a waterfall. When to use: - User pastes a trace ID from logs, a Slack alert, or the Honeycomb UI — fetch it here. - Drilling into a specific trace from a run…
- Get triggers List triggers (alert rules) for the team, or fetch full configuration for a single trigger. When to use: - "What alerts are firing?" / "What triggers do we have?" — list mode (no trigger_id). - "Show me the config for t…
- Get workspace context Call this tool first to orient yourself in a Honeycomb workspace. Takes no parameters. Returns the team name and slug, the current time, and a list of available environments with their slugs and dataset counts. Use the…
- List aiconversations Discover recent AI agent conversations (gen_ai.conversation.id values) in an environment, ordered by total event count (most active first) with per-agent activity. Use this tool as the starting point for any investigati…
- List boards List boards (saved dashboards) in an environment, or fetch one board's full contents by ID. When to use: - "What dashboards do we have for service X" / "is there an existing board for Y" — list mode with tag filters. -…
- List recipients List all pre-registered notification recipients (email, Slack, PagerDuty, webhook) for the team. When to use: - Before create_trigger or update_trigger, to find the recipient IDs to attach. - "What Slack channels are co…
- List semconv namespaces List the top-level semantic convention namespaces available in this team's registry. Returns namespace prefixes like "http", "db", "messaging", "rpc", "k8s". Use this to orient yourself before calling search_semconv — i…
- List spans List span names in trace data, ranked by count, with how often each is a trace root and which dataset the count came from. USE THIS FIRST for any question about what's happening in the system: "what's slow", "what's err…
- Refinery docs Read Honeycomb Refinery documentation. Refinery is Honeycomb's trace-aware tail-based sampling proxy. Available topics: - overview: Refinery overview and key concepts - architecture: Architecture, deployment patterns, a…
- Run bubbleup Run BubbleUp analysis to find what makes a selected data subset different from the baseline. BubbleUp compares value distributions across all schema columns between a "foreground" selection (the interesting region) and…
- Run query Run a time-series aggregation query against a Honeycomb dataset and return computed results. When to use this tool: - "Compute a percentile / histogram of X" — use P50/P99/HEATMAP calculations. - "Show me error rate bef…
- Search semconv Search the semantic convention registry for attributes matching a query. Returns structured attribute definitions including name, type, brief description, stability, and deprecation status. Use this to discover canonica…
- Update board Edit an existing board (dashboard) in place. Add, remove, update, or reorder panels; rename; and replace preset filters or tags. When to use: - "Add the new error-rate query to the API board" — append panels to an exist…
- Update slo Update an existing SLO. Only the fields you supply change; omitted fields keep their current values. When to use: - "Tighten the SLO target to 99.95%" / "extend the window to 30 days" — adjust reliability parameters. -…
- Update trigger Update an existing trigger. Partial update — only the fields you supply change; omitted fields keep their current values. When to use: - "Disable this trigger temporarily" — set disabled=true without touching other fiel…
Setup
How we connect it
- 1
Connect your account
You log in with your own Honeycomb MCP account. We never see your password, and you can revoke access from Honeycomb MCP at any time.
- 2
Set the guardrails
Read-only by default. You choose which write actions the agent may take, and anything outside that policy gets confirmed with you first.
- 3
We keep it running
Health checks on every connection, updates handled for you, and we watch the first week of activity to make sure the work lands.
FAQ
Honeycomb MCP questions, answered.
You sign in with your own Honeycomb MCP account. Permissions are scoped to the minimum the agent needs, the connection is health-checked, and you can revoke access from Honeycomb MCP at any time.
The actions Honeycomb MCP's API allows, the same things a person clicking around the app could do. Connections start read-only by default; write actions are confirmed against the policy you set before the agent takes them.
Connections are priced per tool on top of the base plan. Some are included, some are premium. See pricing for how connection charges work.
Standard tools are ready inside 7 business days of the setup call. We test the connection end to end, walk you through how the agent uses it, and watch the first week of activity.
Ready to put Honeycomb MCP to work?
Tell us what your team runs on. We set up the connection, secure it, and your agent takes it from there.
All product names, logos, and brands are property of their respective owners; used for identification only. ZeroToClaw is not affiliated with or endorsed by Honeycomb MCP.