# HyperDX MCP for AI Agents AI Agent Connect > HyperDX MCP lets you query logs, manage alert rules, and inspect dashboards directly through your AI agent. It turns your agent into an on-call assistant that can filter structured events by time or severity, making it way faster to debug production issues without leaving your chat interface. ## Overview - **Category:** devops-cicd - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_lc01BEQeS86qzu5Tsala3mRU7FKVPIY7tYMD90oU/ai-agent-connect - **Tags:** observability, logging, monitoring, alerts, dashboards ## Description HyperDX connects your observability data to your AI agent so you can interact with your infrastructure using natural language. Instead of jumping between browser tabs to find why a service is failing, you can just ask your agent to dig into the data. This connection lets you treat your observability stack like a conversation. If a production alert goes off, you don't have to hunt for the right dashboard or write complex queries manually. You just tell your agent what happened, and it pulls the logs, checks the alert status, and looks at the trends for you. It works like having an SRE sitting next to you who already knows where all the data lives. You can filter by specific time ranges, like the last 15 minutes, or look for specific error levels across different services. Because it's part of the Vinkius catalog, getting this set up is straightforward. It takes the friction out of incident response by keeping you in your primary workspace while giving you the deep visibility you need to actually fix things. You get answers in seconds rather than spending minutes navigating menus. ## Tools ### list_events HyperDX uses this to pull structured logs or spans using query filters. It helps you find specific events quickly. ### get_dashboard HyperDX uses this to show the specific details and metrics for a single dashboard. It gives you a deep look at one view. ### list_logs HyperDX uses this to retrieve a list of logs based on search criteria like error levels or service names. It simplifies log hunting. ### list_alerts HyperDX uses this to return a full list of all alert rules currently configured in your instance. It helps you audit your monitoring. ### create_alert HyperDX uses this to set up a new alert rule based on your specific requirements. You can build new monitors using natural language. ### list_dashboards HyperDX uses this to fetch all dashboards available within your organization. It gives you a quick overview of all your views. ### delete_alert HyperDX uses this to remove a specific alert rule from your system using its unique ID. It helps you keep your alerts clean. ## Prompt Examples **Prompt:** ``` List all logs with level:error for the auth service from the last hour. ``` **Response:** ``` I've retrieved the logs for the auth service. I found 12 error entries in the last hour, mostly related to 'Invalid Token' exceptions. | Time | Level | Message | | :--- | :--- | :--- | | 10:05 | ERROR | Invalid Token | 10:07 | ERROR | Invalid Token | Would you like to see the full details of the most recent one? ``` **Prompt:** ``` Create a new alert named 'High Error Rate' that triggers when errors exceed 50 in 5 minutes. ``` **Response:** ``` Successfully created the alert **High Error Rate**. * **Query:** `level:error` * **Threshold:** > 50 * **Window:** 5 minutes It is now active and will notify you if the error count spikes. ``` **Prompt:** ``` Show me all my available dashboards in HyperDX. ``` **Response:** ``` I found 3 dashboards in your organization: * **System Health** * **API Performance** * **User Analytics** Which one would you like to inspect in detail? ``` ## Capabilities ### Search logs and structured events HyperDX lets you query through logs and spans using filters. ### Manage alert rules HyperDX lets you create or delete alert rules to keep your monitoring current. ### List organization dashboards HyperDX lets you see every dashboard available in your organization. ### Fetch dashboard details HyperDX lets you pull specific metrics and details for a single dashboard. ### Filter by relative time HyperDX lets you query data from specific windows like the last hour. ### Retrieve all alerts HyperDX lets you see a full list of every alert rule you have set up. ## Use Cases ### Debugging a failed auth request A developer asks the agent to find all logs for the auth service from the last 10 minutes to see why a user can't log in. The agent uses list_logs to find the specific error. ### Setting up a new high-traffic alert An SRE tells the agent to create a new alert that triggers if error rates exceed 50 in a 5-minute window. The agent uses create_alert to set this up. ### Checking system health during a deploy A DevOps engineer asks the agent to list all dashboards and then check the status of the main health dashboard. The agent uses list_dashboards and get_dashboard. ### Cleaning up stale alerts A team lead asks the agent to list all alerts and delete the ones that are no longer relevant to the current infrastructure. The agent uses list_alerts and delete_alert. ## Benefits - HyperDX improves your speed by using list_logs to find errors without switching to a browser. - HyperDX speeds up incident response by using list_events to filter structured data by time. - HyperDX makes health management easier by using create_alert to set new thresholds on the fly. - HyperDX gives you a bird's eye view of your metrics by using list_dashboards to see all available views. - HyperDX simplifies dashboard navigation by using get_dashboard to pull specific data points. - HyperDX helps you clean up your monitoring by using delete_alert to remove old or redundant rules. ## How It Works The bottom line is HyperDX provides a conversational interface for your entire observability stack. 1. Subscribe to the Connector and provide your HyperDX API Key. 2. Connect your preferred AI client like Claude or Cursor. 3. Ask your agent to find logs or manage alerts in plain English. ## Frequently Asked Questions **Can I use HyperDX MCP to find specific errors?** Yes, you can ask your agent to search for logs based on error levels or specific services. It'll pull the relevant data so you don't have to dig through everything yourself. **How does HyperDX MCP help with incident response?** It lets you query logs and check alert rules in real time. You can get a summary of what's happening during an outage without leaving your chat window. **Can I manage my alerts using HyperDX MCP?** You can create, list, and delete alert rules using plain English. This makes it much easier to keep your monitoring updated as your infrastructure changes. **Will HyperDX MCP show me my dashboards?** Yes, your agent can list all your dashboards and then pull the specific details for any one you choose. It's a great way to get a quick status update. **Does HyperDX MCP support time-based filtering?** It does. You can ask your agent to look at data from the last 15 minutes, the last hour, or any specific timestamp you provide. **Is HyperDX MCP good for DevOps teams?** It's a huge time saver for DevOps and SRE teams who need to monitor system health and debug logs quickly during high-pressure situations. **Can I search for specific errors in my logs using this server?** Yes! Use the `list_logs` tool with a query like `level:error`. You can also specify a time range using the `from` parameter (e.g., '1h' or '24h') to narrow down the results. **How do I set up a new alert for a specific service?** You can use the `create_alert` tool. You'll need to provide a name, the search query (e.g., `service:auth level:error`), a threshold value, the type of alert (like 'count'), and the evaluation interval (e.g., '5m'). **Is it possible to delete an alert rule if it's no longer needed?** Yes, simply use the `delete_alert` tool and provide the unique ID of the alert rule you wish to remove.