hny-mcp

by honeycombio
MIT License
2
16
  • Linux
  • Apple

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
HONEYCOMB_API_KEYNoYour Honeycomb API key
HONEYCOMB_API_ENDPOINTNoOptional custom API endpoint (defaults to https://api.honeycomb.io)https://api.honeycomb.io
HONEYCOMB_CACHE_ENABLEDNoEnable/disable cachingtrue
HONEYCOMB_CACHE_SLO_TTLNoSLO-specific TTL in seconds900
HONEYCOMB_CACHE_AUTH_TTLNoAuth-specific TTL in seconds3600
HONEYCOMB_CACHE_MAX_SIZENoMaximum cache size (items per resource type)1000
HONEYCOMB_CACHE_BOARD_TTLNoBoard-specific TTL in seconds900
HONEYCOMB_CACHE_COLUMN_TTLNoColumn-specific TTL in seconds900
HONEYCOMB_CACHE_MARKER_TTLNoMarker-specific TTL in seconds900
HONEYCOMB_ENV_PROD_API_KEYNoYour Honeycomb production environment API key
HONEYCOMB_CACHE_DATASET_TTLNoDataset-specific TTL in seconds900
HONEYCOMB_CACHE_DEFAULT_TTLNoDefault TTL in seconds300
HONEYCOMB_CACHE_TRIGGER_TTLNoTrigger-specific TTL in seconds900
HONEYCOMB_CACHE_RECIPIENT_TTLNoRecipient-specific TTL in seconds900
HONEYCOMB_ENV_STAGING_API_KEYNoYour Honeycomb staging environment API key

Schema

Prompts

Interactive templates invoked by user choice

NameDescription
instrumentation-guidance

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Tools

Functions exposed to the LLM to take actions

NameDescription
list_datasets

Lists available datasets for the active environment with pagination, sorting, and search support. Returns dataset names, slugs, descriptions, and timestamps.

list_columns

Lists all columns available in the specified dataset, including their names, types, descriptions, and hidden status. Supports pagination, sorting by type/name/created_at, and searching by name/description. Note: all is NOT supported as a dataset name.

run_query

Executes a Honeycomb query, returning results with statistical summaries.

CRITICAL RULE: For COUNT operations, NEVER include a "column" field in your calculation, even as null or undefined. Example: Use {"op": "COUNT"} NOT {"op": "COUNT", "column": "anything"}.

Additional Rules:

  1. All parameters must be at the TOP LEVEL (not nested inside a 'query' property)
  2. Field names must be exact - use 'op' (not 'operation'), 'breakdowns' (not 'group_by')
  3. Only use the exact operation names listed in the schema (e.g., use "P95" for 95th percentile, not "PERCENTILE")
  4. For all operations EXCEPT COUNT and CONCURRENCY, you must specify a "column" field
analyze_columns

Analyzes specific columns in a dataset by running statistical queries and returning computed metrics. This tool allows users to get statistical information about a specific column, including value distribution, top values, and numeric statistics (for numeric columns). Supports analyzing up to 10 columns at once by specifying an array of column names in the 'columns' parameter. When multiple columns are specified, they will be analyzed together as a group, showing the distribution of their combined values. Use this tool before running queries to get a better understanding of the data in your dataset.

list_boards

Lists available boards (dashboards) for a specific environment with pagination, sorting, and search support. Returns board IDs, names, descriptions, creation times, and last update times.

get_board

Retrieves a specific board (dashboard) from a Honeycomb environment. This tool returns a detailed object containing the board's ID, name, description, creation time, and last update time.

list_markers

Lists available markers (deployment events) for a specific dataset or environment with pagination, sorting, and search support. Returns IDs, messages, types, URLs, creation times, start times, and end times.

list_recipients

Lists available recipients for notifications in a specific environment. This tool returns a list of all recipients available in the specified environment, including their names, types, targets, and metadata.

list_slos

Lists available SLOs (Service Level Objectives) for a specific dataset. This tool returns a list of all SLOs available in the specified environment, including their names, descriptions, time periods, and target per million events expected to succeed. NOTE: all is NOT supported as a dataset name -- it is not possible to list all SLOs in an environment.

get_slo

Retrieves a specific SLO (Service Level Objective) by ID with detailed information. This tool returns a detailed object containing the SLO's ID, name, description, time period, target per million, compliance, budget remaining, SLI alias, and timestamps.

list_triggers

Lists available triggers (alerts) for a specific dataset. This tool returns a list of all triggers available in the specified dataset, including their names, descriptions, thresholds, and other metadata. NOTE: all is NOT supported as a dataset name -- it is not possible to list all triggers in an environment.

get_trigger

Retrieves a specific trigger (alert) by ID with detailed information. This tool returns a detailed object containing the trigger's ID, name, description, threshold, frequency, alert type, triggered status, disabled status, recipients, evaluation schedule type, and timestamps.

get_trace_link

Generates a direct deep link to a specific trace in the Honeycomb UI. This tool creates a URL that opens a specific distributed trace, optionally positioning to a particular span and time range. If no time range is specified, the trace must have been generated within two hours from the current time. If only the start time is provided, the end time is assumed to be 10 minutes from the start time.

get_instrumentation_help

Provides important guidance for how to instrument code with OpenTelemetry traces and logs. It is intended to be used when someone wants to instrument their code, or improve instrumentation (such as getting advice on improving their logs or tracing, or creating new instrumentation). It is BEST used after inspecting existing code and telemetry data to understand some operational characteristics. However, if there is no telemetry data to read from Honeycomb, it can still provide guidance on how to instrument code.

ID: 8zeou4ict1