How to Use the Honeycomb MCP in Claude

Q: How do I run a Honeycomb query inside Claude Desktop?

You configure your claudedesktopconfig.json file to run this server, then ask Claude Desktop to execute runquery on your Honeycomb datasets. The agent handles the polling using getqueryresult and displays the raw JSON output or a formatted table in your chat bubble.

Q: How does the Honeycomb MCP Server handle rate limits in Claude Desktop?

If you hit Honeycomb rate limits while running runquery inside Claude Desktop, the stdio transport returns the standard API error directly to your chat window.

Q: Can I view my shared Honeycomb dashboards inside Claude Desktop?

Yes. Ask the Claude Desktop agent to run listhoneycombboards to retrieve your shared boards. You can find specific performance charts without digging through the Honeycomb web UI.

Run Honeycomb queries and mark production deploys directly inside Claude Desktop without context-switching to a browser.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Honeycomb MCP to Claude Desktop

Create your Vinkius account to connect Honeycomb to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Honeycomb with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Investigate Incidents Inside Claude Desktop

Configuring your `claude_desktop_config.json` file lets you query Honeycomb datasets via `list_datasets` directly inside your Claude Desktop chat window. You can immediately inspect telemetry schemas with `list_dataset_columns` to find the exact database fields you need to query without manual UI navigation. Your local Claude Desktop stdio subprocess executes `run_query` and polls Honeycomb via `get_query_result` to render telemetry tables directly in your active chat bubble. No more copy-pasting JSON blocks into a terminal to see why your production environment is throwing 500s.

Annotate Deploys and Outages on the Fly

When you push a hotfix, you need to track its impact immediately. Your Claude Desktop agent uses this MCP integration to drop a timestamped line right onto your Honeycomb timeline using `create_marker` so you never forget to mark when a mitigation went live. Claude Desktop's hammer icon lets you trigger `list_markers` to see if a recent Honeycomb deploy correlates with your active error rate spikes. This gives your local chat app direct access to your system's timeline events.

Track Shared Boards and Alert Triggers

Stop hunting for that one dashboard your teammate built last month. Use Claude Desktop's stdio transport to pull shared Honeycomb dashboards using `list_honeycomb_boards` directly into your chat. Your Claude Desktop developer panel displays Honeycomb triggers via `list_triggers` to show you alert limits right next to your conversational thread. It keeps your team's operational context right in your local chat window.

Setup guide

Set up Honeycomb MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Honeycomb MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Honeycomb MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under honeycomb-mcp.

json

{
  "mcpServers": {
    "honeycomb-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Honeycomb. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Honeycomb now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Honeycomb MCP in Claude Desktop

You configure your `claude_desktop_config.json` file to run this server, then ask Claude Desktop to execute `run_query` on your Honeycomb datasets. The agent handles the polling using `get_query_result` and displays the raw JSON output or a formatted table in your chat bubble.

Yes. When you are chatting in Claude Desktop, you can instruct your agent to run `create_marker` with your deploy message. This writes the annotation directly to your Honeycomb dataset timeline.

If you hit Honeycomb rate limits while running `run_query` inside Claude Desktop, the stdio transport returns the standard API error directly to your chat window.

Yes. Ask the Claude Desktop agent to run `list_honeycomb_boards` to retrieve your shared boards. You can find specific performance charts without digging through the Honeycomb web UI.

This server only touches your Honeycomb API keys, query specifications, and dataset metadata. Because Vinkius runs this MCP Server in an isolated V8 sandbox for Claude Desktop, your telemetry data never touches our persistent storage and is processed entirely in memory.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript