How to Use the HyperDX (Open Source Observability) MCP in CrewAI

Q: How do I pass HyperDX (Open Source Observability) credentials to CrewAI agents?

You supply your Vinkius endpoint URL directly in the mcps array of your CrewAI agent configuration. The platform manages the authentication headers, exposing tools like listlogs and listalerts securely through the MCP connection.

Q: Can a CrewAI agent autonomously delete alerts in HyperDX (Open Source Observability)?

Yes, if you give it access to the deletealert tool. To prevent accidental deletions, you can use a custom tool filter to restrict write access while keeping read-only tools like listlogs open.

Q: What is the best transport method for connecting this tool to CrewAI?

Use the HTTP transport by configuring the MCPServerHTTP class. This handles connection pooling and ensures reliable tool execution during heavy debugging sessions.

Deploy specialized agent teams to monitor logs and manage alerts with CrewAI and this MCP server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HyperDX (Open Source Observability) MCP to CrewAI

Create your Vinkius account to connect HyperDX (Open Source Observability) to CrewAI 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 HyperDX (Open Source Observability) with CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Resolve Incidents Autonomously with CrewAI Agents

The `list_logs` tool lets your SRE agent search for error patterns across your services. When it finds a spike, it shares the log details with an analyzer agent in the same crew. The analyzer agent then calls `list_events` to trace the failure across microservices. Together, they isolate the broken dependency and write a summary for the on-call engineer.

Coordinate Alert Management via this MCP Server

The `list_alerts` tool allows a monitoring coordinator agent to audit all active alert configurations. It identifies overlapping or redundant rules that cause alert fatigue. Once identified, a writer agent uses `create_alert` to consolidate rules, while another agent uses `delete_alert` to remove the old ones. This keeps your alerting configuration clean and actionable.

Audit Team Dashboards with Specialized Agents

The `list_dashboards` tool retrieves all active dashboards to check for missing service views. Your agent crew verifies that every new microservice has a corresponding monitoring panel. If a panel is missing, the agent uses `get_dashboard` to copy a template configuration and alert the team. This ensures your observability coverage never drops behind your deployment rate.

Setup guide

Set up HyperDX (Open Source Observability) MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke HyperDX (Open Source Observability) tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="HyperDX (Open Source Observability) Analyst",
    goal="Access and analyze HyperDX (Open Source Observability) data via MCP.",
    backstory="Expert analyst with direct HyperDX (Open Source Observability) access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent HyperDX (Open Source Observability) transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="HyperDX (Open Source Observability) Analyst",
        goal="Access and analyze HyperDX (Open Source Observability) data via MCP.",
        backstory="Expert analyst with direct HyperDX (Open Source Observability) access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent HyperDX (Open Source Observability) transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

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 HyperDX. 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 HyperDX (Open Source Observability) 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 HyperDX (Open Source Observability) MCP in CrewAI

You supply your Vinkius endpoint URL directly in the `mcps` array of your CrewAI agent configuration. The platform manages the authentication headers, exposing tools like `list_logs` and `list_alerts` securely through the MCP connection.

Yes, if you give it access to the `delete_alert` tool. To prevent accidental deletions, you can use a custom tool filter to restrict write access while keeping read-only tools like `list_logs` open.

Agents use CrewAI's shared memory to pass log snippets from `list_logs` or dashboard configurations from `get_dashboard` between tasks. This allows the researcher agent to hand off clean data to the analyzer agent.

Use the HTTP transport by configuring the `MCPServerHTTP` class. This handles connection pooling and ensures reliable tool execution during heavy debugging sessions.

The server processes all log payloads and alert parameters within an ephemeral V8 sandbox. No data from `list_logs` or `list_events` is stored or analyzed outside your active session.

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