# Guance Cloud MCP for AI Agents AI Agent Connect

> Guance Cloud MCP connects your AI client to the Guance Cloud observability platform. It lets you manage monitors, query logs with DQL, and audit system events through natural language instead of clicking through a complex console.

## Overview
- **Category:** cloud-infrastructure
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_AANzdKMqG2pZyVDyBezhkEvdo4gPXGC9YiQz8RcU/ai-agent-connect
- **Tags:** system-monitoring, incident-response, dashboarding, application-performance, infrastructure-metrics, real-time-alerts

## Description

This Connector connects Guance Cloud to your AI client so you can talk to your infrastructure. Instead of clicking through a complex console to find a needle in a haystack, you can just ask your agent what's going on. It lets you pull up specific monitor configs, scan for recent alerts, or run complex queries to find specific log entries. It turns your observability stack into a conversational interface. You're no longer hunting for buttons; you're just getting answers. Since Vinkius hosts this, it's easy to plug into your existing workflow and let your agent handle the heavy lifting of data retrieval and status checks. It makes sure your infrastructure stays healthy without making you a full-time dashboard watcher.

When a production incident hits, every second counts. You can ask your agent to summarize the latest events or pull up the exact configuration of a failing monitor. This removes the friction of navigating nested menus or remembering specific query syntax. Whether you're auditing your workspace for security gaps or checking your monthly spend, the agent handles the interaction with the platform. You get a direct line to your metrics and logs without the overhead of manual navigation. It’s about moving from looking at data to getting answers as fast as you can think them.

## Tools

### get_event
Pull specific details for a single system event. This helps you drill down into a specific alert or error.

### get_monitor
Fetch the full configuration for a specific monitor. Use this to see exactly what triggers an alert.

### get_workspace
Grab metadata and status for your Guance Cloud workspace. This provides context for your entire environment.

### list_access_keys
View all API keys associated with your workspace. This is useful for security audits and permission management.

### list_dashboards
See a full list of all dashboards in your account. Use this to get an overview of your monitoring layout.

### list_events
Browse a list of recent alerts, errors, and system changes. This is your first stop during an incident.

### list_log_sources
See all the different log sources your system is tracking. Use this to verify your data ingestion.

### query_data
Execute DQL statements to get specific metrics or logs. Use this to run complex data lookups via natural language.

### get_billing
Check your current spending and usage costs. Use this to stay on top of your infrastructure budget.

### list_monitors
Get a list of every monitor currently active in your workspace. Use this to see your overall system health.

## Prompt Examples

**Prompt:** 
```
What are my active monitors?
```

**Response:** 
```
I've pulled your active monitors. You have 12 active alerts currently:

| Monitor Name | Status | Severity |
| :--- | :--- | :--- |
| **High CPU Alert** | Firing | Critical |
| **API Latency** | Warning | High |
| **DB Conn Pool** | OK | Info |

Would you like me to pull the details for the High CPU alert?
```

**Prompt:** 
```
Show me the last 5 events.
```

**Response:** 
```
Here are the 5 most recent events from your workspace:

- **Critical**: Storage Full (2 mins ago)
- **Warning**: High Memory Usage (5 mins ago)
- **Info**: System Update Complete (12 mins ago)
- **Info**: User 'admin' logged in (15 mins ago)
- **Info**: Backup Started (20 mins ago)

Should I get more details on that Storage Full alert?
```

**Prompt:** 
```
Query the average CPU for the production cluster.
```

**Response:** 
```
I've executed that query for you. 

**Production Cluster CPU Usage:**
- **Last 5 mins**: 42%
- **Last 15 mins**: 38%
- **Last 1 hour**: 45%

Trend is stable. Do you want a breakdown by individual host?
```

## Capabilities

### Query logs with DQL
Use query_data to run specific Data Query Language statements for metrics or logs.

### Check monitor statuses
Use list_monitors to see a list of every active monitor in your workspace.

### Audit workspace events
Use list_events to browse recent alerts, errors, and system changes.

### Manage API keys
Use list_access_keys to view and manage the keys for your workspace.

### View billing usage
Use get_billing to see your current spending and usage costs.

## Use Cases

### Rapid Incident Response
An SRE notices a spike in latency and asks the agent to list_events and query_data to find the root cause in the logs.

### Security Auditing
An infrastructure lead asks the agent to list_access_keys to ensure only authorized users have access to the workspace.

### Cost Monitoring
A manager asks the agent for get_billing to see how much the production cluster spent over the last month.

### Log Source Verification
A developer asks the agent to list_log_sources to confirm that the new microservice is sending data correctly.

## Benefits

- Stop digging through tabs by using list_monitors to see every active alert in one go.
- Get precise data faster by using query_data to run DQL statements for specific logs.
- Secure your workspace by using list_access_keys to audit who has API permissions.
- Keep a pulse on your costs by using get_billing to check usage and spending.
- Map out your infrastructure by using list_dashboards to see all your custom views.

## How It Works

The bottom line is you get a conversational interface for your entire observability stack.

1. Subscribe to the Connector and grab your DF-API-KEY from the Guance Cloud console.
2. Input your credentials into your AI client's settings.
3. Ask your agent to list monitors, check events, or run data queries.

## Frequently Asked Questions

**Can Guance Cloud MCP help me with production outages?**
Yes. It allows your agent to quickly pull alerts and logs so you can identify the root cause of an outage without manually searching through dashboards.

**How do I use Guance Cloud MCP to query logs?**
You can just ask your agent a question like 'Find the last 10 error logs for the login service.' The Connector will handle the data query for you.

**Does Guance Cloud MCP support DQL?**
Yes, it supports Data Query Language (DQL), allowing your agent to perform complex data lookups and metric retrievals on your behalf.

**Can I check my billing with Guance Cloud MCP?**
Absolutely. Your agent can check your current spending and usage costs instantly, helping you stay on top of your infrastructure budget.

**How does Guance Cloud MCP help with security audits?**
It makes auditing much faster by letting your agent list all workspace access keys and metadata, so you can verify permissions in seconds.

**Can I see my dashboard list using Guance Cloud MCP?**
Yes, your agent can retrieve a full list of all dashboards in your workspace to give you a high-level overview of your monitoring setup.

**How do I find my Guance Cloud API Key?**
Log in to your Guance Cloud workspace, navigate to [Management] → [API Key Management], and generate a new key. Use the provided value as your DF-API-KEY.

**What is DQL?**
Data Query Language (DQL) is the query syntax used by Guance Cloud to retrieve metrics, logs, and other observability data. You can use the `query_data` tool to execute these statements.

**Can I check my data usage via the agent?**
Yes. Use the `get_billing` tool to retrieve current data usage and billing statistics for your workspace, helping you manage costs and resource allocation.