# Grafana Cloud MCP

> Grafana Cloud MCP manages your entire observability infrastructure from chat. List organizations, provision new Grafana stacks, manage user accounts, and handle API keys without touching a dashboard. You can audit who has access and instantly spin up testing environments using just natural language commands.

## Overview
- **Category:** cloud-infrastructure
- **Price:** Free
- **Tags:** grafana, observability, stack-management, api-keys, infrastructure-as-code

## Description

Managing observability stacks used to mean navigating complex dashboards or writing boilerplate Terraform files. Now, you talk to your agent. This MCP connects directly to your Grafana Cloud account, letting you handle infrastructure tasks entirely through conversation. Need to provision a new staging environment? Just ask for it; the system handles the instance creation. You can also audit who has access by listing all users across multiple organizations or generate temporary API keys for specific roles. It’s about taking away the manual clicking and tedious role-checking. Everything is accessible via your AI client, making infrastructure management feel less like coding and more like talking to a highly skilled teammate. This entire catalog of capabilities is housed on Vinkius, so you never have to connect multiple services—just one connection gives you access to everything.

## Tools

### create_api_key
Generates a new, secure API key and assigns it a specific permission role (Viewer, Editor, or Admin).

### create_instance
Creates a new Grafana instance (stack), supporting both free and paid subscription plans.

### delete_api_key
Removes an existing API key from the system.

### get_instance
Gets the technical details and current status for one specific Grafana instance.

### get_org
Retrieves detailed information about a specific Grafana organization using its unique slug.

### list_api_keys
Lists all existing API keys for an organization, letting you see who has generated tokens.

### list_instances
Fetches a list of all active data stacks (instances) within a specified organization.

### list_org_users
Lists all users associated with an organization, helping you audit who has access to the data.

### list_orgs
Lists all Grafana Cloud organizations you belong to, allowing you to know which accounts are connected.

## Prompt Examples

**Prompt:** 
```
List all my Grafana Cloud organizations.
```

**Response:** 
```
I've retrieved your organizations. You have access to: 'Main-Ops' (slug: main-ops) and 'Dev-Sandbox' (slug: dev-sandbox). Which one would you like to explore?
```

**Prompt:** 
```
Show me all instances in the 'main-ops' organization.
```

**Response:** 
```
In the 'main-ops' organization, I found 2 instances: 'Production-Stack' (URL: main-ops.grafana.net) and 'Staging-Metrics' (URL: main-ops-staging.grafana.net).
```

**Prompt:** 
```
Create an Admin API key named 'automation-token' for the 'dev-sandbox' org.
```

**Response:** 
```
Successfully created the API key 'automation-token' with Admin role. The key is: `glc_...`. Please store it securely as it won't be shown again.
```

## Capabilities

### Audit all connected organizations
Lists every Grafana Cloud organization you belong to and fetches deep metadata about each one.

### Provision new data stacks (instances)
Creates brand-new Grafana instances, whether for free testing or paid Pro plans, directly from a prompt.

### Manage user access lists
Audits and retrieves a list of all users connected to your cloud organizations for easy access control review.

### Control API key lifecycle
Generates, reviews, or permanently deletes API keys while assigning specific security roles like Viewer, Editor, or Admin.

### Inspect instance details
Retrieves precise deployment status and configuration information for a specific Grafana instance without leaving your chat window.

## Use Cases

### Onboarding a new client environment
A Platform Engineer needs to set up a new monitoring stack for Client X. Instead of going through 15 clicks on the Grafana UI, they ask their agent to run `create_instance` and specify 'Client X Monitoring Stack'. The MCP handles the full provisioning process instantly.

### Investigating leaked credentials
A security team member suspects an old key was leaked. They use `list_api_keys` to find all active tokens, then run `delete_api_key` on the suspicious entry, isolating the vulnerability without logging into any dashboard.

### Auditing user access for compliance
A manager needs proof of who can view production dashboards. They ask the agent to run `list_org_users` across the 'main-ops' organization, getting a definitive list that is ready for audit documentation.

### Debugging deployment issues
An SRE notices performance drops but doesn't know why. They ask to `get_instance` details on the affected stack. The agent returns specific metadata, allowing them to pinpoint if it's a configuration issue or a resource limit.

## Benefits

- Instead of logging into the Grafana Portal to check deployment status, you just ask for it. Use the `get_instance` tool to pull precise details on any stack's operational status directly in your conversation.
- You don't need a dedicated security team member to audit permissions; simply run `list_org_users` and get a complete list of every user connected across all organizations you belong to.
- Spin up testing environments instantly. Use the `create_instance` tool to provision new stacks for development or QA on demand, eliminating manual resource requests.
- Need temporary access? The MCP lets you manage credentials with surgical precision. You can use `create_api_key` and immediately assign an 'Editor' role just for a specific service account.
- Handle compliance tasks effortlessly. With the ability to list all organizations (`list_orgs`), you maintain visibility across your entire cloud footprint from one single point of interaction.

## How It Works

The bottom line is, you manage complex observability infrastructure using simple chat commands instead of clicking through web dashboards.

1. Subscribe to this MCP on Vinkius and provide your Grafana Cloud API Key (the Cloud Access Policy token).
2. Directly prompt your AI client with the task: 'List all instances in my main production organization.'
3. The agent executes the request, fetching the real-time data and providing you with a clean list of operational stacks.

## Frequently Asked Questions

**How does Grafana Cloud MCP help me manage multiple organizations?**
The MCP runs `list_orgs` to show you every organization you belong to. You can then tell your agent which specific 'slug' to focus on for the next command, keeping everything organized.

**Can I use Grafana Cloud MCP to check if an instance is running?**
Yes, simply ask to `get_instance` details. The tool pulls precise status information about a specific stack right into your chat window for quick checks.

**What's the difference between list_api_keys and list_org_users?**
Listing API keys tells you what credentials exist, while listing org users shows you which human accounts have access. You use them to audit different types of risk.

**Does Grafana Cloud MCP require me to change my existing API key?**
No. The MCP manages the lifecycle for you; it can `list_api_keys` so you know what's active, and use `delete_api_key` when a token is no longer needed.

**What if I need to create an instance but don't know which plan to pick?**
You can ask the agent for guidance or specify 'Pro plan' directly in your prompt. The `create_instance` tool will handle the appropriate provisioning based on your request.