Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions .changeset/split-query-tools.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
'@hyperdx/api': patch
---

refactor(mcp): split hyperdx_query into 5 display-type-specific tools

Replace the monolithic `hyperdx_query` tool with five narrow tools:
- `hyperdx_timeseries` (line + stacked_bar)
- `hyperdx_table` (table + number + pie, with shape auto-upgrade)
- `hyperdx_search` (raw event browsing)
- `hyperdx_event_patterns` (Drain pattern mining)
- `hyperdx_sql` (raw ClickHouse SQL)

Each tool's schema contains only its relevant parameters — no displayType
discriminator, no fields from other modes, no conditional required fields.
`hyperdx_query` is removed from the tool surface.
6 changes: 5 additions & 1 deletion MCP.md
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,11 @@ with:
| Tool | Description |
| ----------------------------- | -------------------------------------------------------------------------------------------- |
| `hyperdx_list_sources` | List all data sources and database connections, including column schemas and attribute keys |
| `hyperdx_query` | Query observability data (logs, metrics, traces) using builder mode, search mode, or raw SQL |
| `hyperdx_timeseries` | Plot metrics over time as a line or stacked bar chart |
| `hyperdx_table` | Compute aggregated metrics as a table, single number, or pie chart |
| `hyperdx_search` | Browse individual log, event, or trace rows |
| `hyperdx_event_patterns` | Discover the most common log messages and event patterns using Drain clustering |
| `hyperdx_sql` | Execute raw ClickHouse SQL for advanced queries (JOINs, CTEs, sub-queries) |
| `hyperdx_get_dashboard` | List all dashboards or get full detail for a specific dashboard |
| `hyperdx_save_dashboard` | Create or update a dashboard with tiles (charts, tables, numbers, search, markdown) |
| `hyperdx_delete_dashboard` | Permanently delete a dashboard and its attached alerts |
Expand Down
Loading
Loading