Grafana MCP Server
Provides tools for managing and automating Grafana, including dashboards, panels, data sources, template variables, query validation, and read/operational/administrative workflows.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Grafana MCP Server crie um dashboard de CPU e memória para o servidor web"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
📊 Grafana MCP Server — 100 Ferramentas em Português
Servidor corporativo oficial Model Context Protocol (MCP) para gerenciamento inteligente, observabilidade e automação do Grafana. Equipado com 100 ferramentas funcionais em português, preparadas para equipes de SRE, DevOps, NOC, SOC e Engenharia de Infraestrutura operarem em ambientes de produção no mundo todo.
🌟 Destaques do Projeto
🤖 Motor de Dashboards por Prompt (9 Estágios): Criação autônoma de dashboards completos a partir de pedidos em linguagem natural, com validação de gridPos, layout responsivo e publicação na API.
🔍 Validação Estática de Consultas: Verificação prévia de expressões PromQL, LogQL, TraceQL e restrição estrita de leitura (
SELECT/WITH) em fontes SQL relacionais contra comandos destrutivos.📑 Relatórios Executivos Multi-Formato: Exportação nativa de relatórios de disponibilidade (SLA/SLO), desempenho e capacidade em PDF corporativo, planilhas Excel (.xlsx), CSV e JSON.
🛡️ Segurança Defensiva e RBAC: 3 modos de operação (
somente_leitura,operacional,administrativo), aprovação em dois passos via tokens criptográficos HMAC-SHA256 para deleções e redação automática de credenciais.🌐 Compatibilidade Universal: Testado e homologado no Grafana v13.0.2, suportando também versões 9.x, 10.x, 11.x e 12.x (OSS, Enterprise e Grafana Cloud).
⚡ Transporte Duplo: Suporte nativo tanto a STDIO (para IDEs locais) quanto SSE (Server-Sent Events) para contêineres Docker e Kubernetes em rede.
Related MCP server: Grafana MCP Server
🚀 Passo a Passo de Instalação e Configuração
1. Pré-requisitos
Python 3.11 ou superior instalado na máquina.
Instância do Grafana acessível via rede (ex:
http://192.168.0.107:3000ouhttp://localhost:3000).
2. Gerar o Token de Acesso no Grafana
O método recomendado em produção é o Service Account Token:
No menu do Grafana, navegue até Administration ➔ Users and access ➔ Service accounts.
Clique em Add service account, atribua o nome
mcp-servere o papel (Role)EditorouAdmin.Clique em Add service account token, copie a chave gerada (prefixo
glsa_...).
3. Instalação Local (Ambiente Virtual)
# 1. Clone o repositório
git clone https://github.com/nks1097/grafana-mcp-server.git
cd grafana-mcp-server
# 2. Crie e ative o ambiente virtual
python -m venv .venv
# No Linux/macOS:
source .venv/bin/activate
# No Windows (PowerShell):
.\.venv\Scripts\Activate.ps1
# 3. Instale o pacote em modo editável
pip install --upgrade pip
pip install -e .4. Configuração das Variáveis de Ambiente (.env)
Copie o arquivo de exemplo:
cp .env.example .envAjuste as configurações no .env:
# URL da sua instância do Grafana
GRAFANA_URL=http://192.168.0.107:3000
# Token da Service Account
GRAFANA_API_TOKEN=glsa_seu_token_de_servico_aqui_exemplo12345
# Nível de Governança (somente_leitura | operacional | administrativo)
MCP_MODE=operacional
MCP_READ_ONLY=false
MCP_REQUIRE_APPROVAL_DESTRUCTIVE=true💻 Integração com Clientes de IA (MCP Clients)
A. Claude Desktop
Edite o arquivo de configuração do Claude Desktop:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"grafana-mcp": {
"command": "C:\\SEU_CAMINHO\\grafana-mcp-server\\.venv\\Scripts\\python.exe",
"args": ["-m", "grafana_mcp.server", "--transport", "stdio"],
"env": {
"GRAFANA_URL": "http://SEU_IP:3000",
"GRAFANA_API_TOKEN": "glsa_seu_token_de_servico_aqui_exemplo12345",
"MCP_MODE": "operacional"
}
}
}
}B. Antigravity IDE / VS Code (Continue / Cline / Roo Code)
No arquivo mcp_config.json:
{
"mcpServers": {
"grafana-mcp": {
"command": "C:\\SEU_CAMINHO\\grafana-mcp-server\\.venv\\Scripts\\python.exe",
"args": ["-m", "grafana_mcp.server"],
"env": {
"GRAFANA_URL": "http://SEU_IP:3000",
"GRAFANA_API_TOKEN": "glsa_seu_token_de_servico_aqui_exemplo12345",
"MCP_MODE": "operacional"
}
}
}
}C. Cursor IDE
No arquivo ~/.cursor/mcp.json:
{
"mcpServers": {
"grafana-mcp": {
"command": "python",
"args": ["-m", "grafana_mcp.server"],
"cwd": "C:\\SEU_CAMINHO\\grafana-mcp-server\\.venv\\Scripts\\python.exe",
"env": {
"GRAFANA_URL": "http://SEU_IP:3000",
"GRAFANA_API_TOKEN": "glsa_seu_token_de_servico_aqui_exemplo12345"
}
}
}
}VIDEO DE CONFIGURAÇÃO DE FORMA SIMPLIFICADA
▶️ Clique aqui para assistir ao vídeo completo no Google Drive Assiste em Full Hd (1080P)
🐳 Execução via Docker Compose (Transporte SSE)
Para executar o servidor isolado em contêiner com transporte HTTP Server-Sent Events (SSE):
docker compose up -d --buildO servidor estará disponível na porta 8001: http://localhost:8001/sse.
📋 Catálogo Completo das 100 Ferramentas (Para que serve cada uma)
Abaixo estão listadas todas as 100 ferramentas disponíveis organizadas por categoria, com identificador oficial e finalidade prática:
Categoria A: Dashboards e Painéis (001 a 020)
# | Ferramenta | Para que serve (Descrição) |
001 |
| Pesquisa e lista dashboards cadastrados no Grafana com filtros por texto, tags e pastas. |
002 |
| Recupera a definição JSON completa de um dashboard pelo seu identificador único (UID). |
003 |
| Retorna um resumo técnico compacto (título, quantidade de painéis, variáveis) sem sobrecarregar o contexto. |
004 |
| Extrai a configuração detalhada de um único painel pelo seu ID numérico dentro de um dashboard. |
005 |
| Cria um novo dashboard no Grafana persistindo a estrutura JSON fornecida na pasta desejada. |
006 |
| Atualiza a definição de um dashboard existente com mensagem de commit e controle de versão. |
007 |
| Exclui permanentemente um dashboard (protegido por token de aprovação em dois passos). |
008 |
| Clona um dashboard modelo com novo título, gerando novo UID e preservando painéis. |
009 |
| Consulta, adiciona ou atualiza variáveis dinâmicas de template (host, ambiente, interval) em dashboards. |
010 |
| Constrói uma URL web completa e clicável com intervalo temporal e variáveis aplicadas. |
011 |
| Motor autônomo em 9 etapas: entende o pedido, planeja painéis, valida queries e publica o dashboard. |
012 |
| Gera o plano arquitetural do dashboard (estágio 3 do motor) para revisão prévia sem salvar na API. |
013 |
| Adiciona um novo painel com visualização configurada e posicionamento automático na grade 24 colunas. |
014 |
| Altera título, descrição, tipo de gráfico ou consultas de um painel específico. |
015 |
| Remove um painel específico de um dashboard pelo seu ID numérico. |
016 |
| Consulta ou substitui as consultas de métricas (targets) configuradas em um painel. |
017 |
| Ajusta propriedades visuais (estilo de linha, preenchimento, modo de tooltip e legendas). |
018 |
| Configura réguas de limiares (thresholds) e paleta de cores (verde, amarelo, vermelho) para stat/gauges. |
019 |
| Valida o schema JSON do dashboard contra a especificação oficial do Grafana antes da publicação. |
020 |
| Pós-valida todas as consultas de todos os painéis disparando requisições de teste para certificar que retornam dados. |
Categoria B: Fontes de Dados e Plugins (021 a 030)
# | Ferramenta | Para que serve (Descrição) |
021 |
| Lista todas as fontes de dados configuradas (Prometheus, Loki, Tempo, Zabbix, SQL, etc.). |
022 |
| Consulta detalhes técnicos e configurações de conexão de uma datasource específica. |
023 |
| Provisiona uma nova fonte de dados no Grafana com parâmetros de rede e autenticação. |
024 |
| Atualiza credenciais, URL de endpoint ou opções de TLS de uma datasource existente. |
025 |
| Remove uma fonte de dados da instância (requer token de aprovação). |
026 |
| Dispara o teste de saúde nativo do Grafana na datasource para verificar conectividade e autenticação. |
027 |
| Executa varredura de saúde em todas as fontes simultaneamente, emitindo diagnóstico geral. |
028 |
| Lista todos os plugins instalados na instância (aplicativos, painéis e datasources). |
029 |
| Checa se determinado plugin está presente e se é compatível com a versão instalada do Grafana. |
030 |
| Retorna somente as fontes de dados de uma tecnologia específica (ex: apenas |
Categoria C: Consultas e Métricas (031 a 040)
# | Ferramenta | Para que serve (Descrição) |
031 |
| Executa consultas genéricas através do endpoint unificado |
032 |
| Executa consultas PromQL otimizadas diretamente em fontes Prometheus ou Mimir. |
033 |
| Executa consultas de agregação métrica LogQL em fontes Loki. |
034 |
| Executa consultas TraceQL ou busca por Trace ID em fontes de rastreamento Tempo. |
035 |
| Executa consultas temporais Flux ou InfluxQL em fontes InfluxDB. |
036 |
| Executa consultas SQL estritamente de leitura (SELECT) em bancos relacionais com bloqueio preventivo de DDL/DML. |
037 |
| Executa exatamente as queries configuradas em um painel já existente, retornando os valores renderizados. |
038 |
| Compara uma métrica entre dois períodos temporais distintos (ex: hoje vs ontem) calculando a variação delta. |
039 |
| Analisa a tendência histórica de uma métrica calculando média, desvio padrão e inclinação de crescimento. |
040 |
| Identifica valores atípicos (outliers) aplicando cálculo de desvio padrão (Z-Score) em séries temporais. |
Categoria D: Logs, Traces e Observabilidade (041 a 050)
# | Ferramenta | Para que serve (Descrição) |
041 |
| Pesquisa linhas de log em fontes Loki com filtros de streams e busca textual. |
042 |
| Agrupa e quantifica padrões frequentes de mensagens de erro em logs. |
043 |
| Localiza spans de rastreamento com latência acima de um limiar pré-estabelecido. |
044 |
| Recupera a árvore completa de spans de uma transação distribuída pelo ID do trace. |
045 |
| Compara um trace saudável contra um trace degradado para isolar a operação gargalo. |
046 |
| Lista tags indexadas e atributos de spans de um determinado serviço. |
047 |
| Realiza correlação 360° unindo métricas, logs e traces na mesma janela de tempo para um serviço. |
048 |
| Conduz triagem diagnóstica rápida no serviço (taxa de erro, throughput e latência). |
049 |
| Identifica falhas em cascata no ambiente recente e aponta o provável foco inicial do incidente. |
050 |
| Monta linha do tempo cronológica com todos os eventos, deploys e anotações durante uma parada. |
Categoria E: Alertas e Notificações (051 a 060)
# | Ferramenta | Para que serve (Descrição) |
051 |
| Lista todas as regras de alerta configuradas no Grafana Unified Alerting. |
052 |
| Consulta os detalhes técnicos, expressões e limiares de uma regra de alerta específica. |
053 |
| Cadastra uma nova regra de alerta com condições e labels validadas. |
054 |
| Modifica limiares de acionamento ou labels de uma regra existente. |
055 |
| Remove uma regra de alerta da plataforma (requer aprovação em dois passos). |
056 |
| Lista os alertas que estão atualmente disparados (firing), pendentes ou normais. |
057 |
| Consulta ou atualiza a árvore de políticas de roteamento de notificações para as equipes. |
058 |
| Lista, cadastra ou testa canais de contato como Slack, Telegram, Webhook, PagerDuty e E-mail. |
059 |
| Cria, consulta ou cancela silenciamentos temporários de alertas durante manutenções programadas. |
060 |
| Audita a saúde dos alertas, detectando regras em flapping, sem ponto de contato ou com erro de entrega. |
Categoria F: Pastas, Tags e Anotações (061 a 070)
# | Ferramenta | Para que serve (Descrição) |
061 |
| Lista todas as pastas de organização de dashboards com paginação. |
062 |
| Cria uma nova pasta no Grafana para agrupar dashboards de um projeto ou departamento. |
063 |
| Renomeia uma pasta existente mantendo seus dashboards associados. |
064 |
| Exclui uma pasta e seus dashboards contidos (requer aprovação administrativa). |
065 |
| Transfere um dashboard de sua pasta atual para uma nova pasta de destino. |
066 |
| Lista todas as tags utilizadas na organização com respectiva contagem de uso. |
067 |
| Busca unificada por dashboards, pastas e painéis em um único comando por palavra-chave. |
068 |
| Constrói uma URL direta para a aba Grafana Explore com a consulta pré-carregada para o operador. |
069 |
| Cria ou lista snapshots congelados no tempo para compartilhamento público ou interno. |
070 |
| Registra e lista anotações na linha do tempo dos dashboards (ex: marcar momentos de deploys ou crises). |
Categoria G: Relatórios e Renderização (071 a 080)
# | Ferramenta | Para que serve (Descrição) |
071 |
| Consolida a saúde do ambiente, datasources, dashboards e alertas em relatório PDF, Excel ou Markdown. |
072 |
| Emite relatório técnico de disponibilidade de serviços, percentual de SLA e tempos de indisponibilidade. |
073 |
| Gera relatório de performance com latência de API (p95/p99), QPS e consumo de recursos. |
074 |
| Consolida o histórico de alarmes acionados, severidade e frequência no período. |
075 |
| Gera relatório de resposta a incidentes contendo MTTD, MTTR e resoluções aplicadas. |
076 |
| Gera relatório de planejamento de capacidade (Capacity Planning) com projeções para 90 dias. |
077 |
| Gera a URL direta do serviço Image Renderer para download de imagem PNG de um painel individual. |
078 |
| Gera a URL para captura de tela completa em alta definição de todo o dashboard em PNG. |
079 |
| Exporta dados tabulares customizados fornecidos pelo agente para documento PDF corporativo formatado. |
080 |
| Exporta matrizes de dados analíticos para planilhas Excel formatadas ( |
Categoria H: Incidentes, SLOs e OnCall (081 a 090)
# | Ferramenta | Para que serve (Descrição) |
081 |
| Consulta a lista de incidentes operacionais ativos ou resolvidos no Grafana Incident. |
082 |
| Declara formalmente um novo incidente operacional com severidade e descrição de impacto. |
083 |
| Consulta os detalhes completos, responsáveis e status de um incidente pelo seu ID. |
084 |
| Altera o status do incidente ( |
085 |
| Adiciona notas, comentários ou evidências na linha do tempo de um incidente em andamento. |
086 |
| Consulta e gerencia as escalas de sobreaviso e plantão no Grafana OnCall. |
087 |
| Consulta grupos de alertas pendentes de atendimento na fila do plantão OnCall. |
088 |
| Consulta os objetivos de nível de serviço (SLOs) configurados e a conformidade atual de SLIs. |
089 |
| Calcula o consumo do orçamento de erro (Error Budget) e a taxa de queima (Burn Rate) de um SLO. |
090 |
| Gera minuta estruturada de relatório de pós-mortem em Markdown com RCA e plano de ação. |
Categoria I: Administração, Governança e Auditoria (091 a 100)
# | Ferramenta | Para que serve (Descrição) |
091 |
| Retorna a versão exata do Grafana, commit de build e integridade da base de dados. |
092 |
| Lista todas as organizações cadastradas em instâncias multitenant. |
093 |
| Lista os usuários membros da organização atual, seus papéis (roles) e e-mails de acesso. |
094 |
| Lista equipes e times de trabalho (teams) configurados na organização. |
095 |
| Cria, atualiza ou exclui equipes no Grafana com confirmação em dois passos para exclusão. |
096 |
| Consulta a lista de controle de acesso (ACL) de um dashboard ou pasta específica. |
097 |
| Atribui ou modifica permissões de acesso (Viewer, Editor, Admin) de um dashboard. |
098 |
| Define permissões herdadas por todos os dashboards contidos em determinada pasta. |
099 |
| Executa auditoria 360° de conformidade e segurança na instância, gerando pontuação (0 a 100) e alertas. |
100 |
| Testa conectividade imediata, autenticação, mede latência em milissegundos e valida a versão do Grafana. |
🧪 Testes Automatizados
Para executar a suíte completa de testes unitários e testes de integração com a instância real do Grafana:
# Ative o ambiente virtual
.\.venv\Scripts\Activate.ps1
# Execute o pytest com relatório detalhado
pytest tests -vSaída dos testes:
============================= 16 passed in 2.04s ==============================Para verificar estilo e conformidade de código:
ruff check src tests
ruff format --check src tests📄 Documentação Adicional
Acesse a pasta docs/ para guias especializados:
🤝 Como Contribuir
Contribuições são muito bem-vindas! Consulte o arquivo CONTRIBUTING.md para diretrizes de desenvolvimento, padrões de commits e boas práticas de código.
📜 Licença
Este projeto é distribuído sob a licença MIT. Consulte o arquivo LICENSE para obter detalhes completos.
Available Tools
100 toolsgrafana_adicionar_atividade_incidenteC
Adicionar notas, ações ou comentários na linha do tempo de um incidente.
Inputs: mensagem (required), incidente_id (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_adicionar_painelC
Adicionar um novo painel a um dashboard existente.
Inputs: titulo (required), uid_dashboard (required), tipo, unidade, +3 more. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_analisar_orcamento_erroC
Analisar queima de orçamento de erro (Error Budget Burn Rate) e riscos de violação de SLO.
Inputs: slo_id_ou_nome (required), periodo. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_analisar_tendencias_metricasC
Analisar tendências estatísticas de subida, descida ou estabilidade de uma métrica.
Inputs: consulta (required), datasource_uid (required), intervalo. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_atualizar_dashboardC
Atualizar a definição de um dashboard existente.
Inputs: dashboard (required), pasta_id, pasta_uid, mensagem_commit. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_atualizar_fonte_dadosC
Atualizar propriedades e configurações permitidas de uma fonte de dados existente.
Inputs: uid (required), url, nome, padrao, +1 more. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_atualizar_incidenteC
Atualizar status de incidente operacional (ex: 'investigating', 'mitigated', 'resolved').
Inputs: incidente_id (required), resumo, status. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_atualizar_painelC
Atualizar propriedades (título, tipo, consulta, unidade) de um painel específico.
Inputs: id_painel (required), uid_dashboard (required), tipo, titulo, +2 more. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_atualizar_pastaC
Atualizar o título ou propriedades de uma pasta existente.
Inputs: uid (required), novo_titulo (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_atualizar_regra_alertaC
Atualizar propriedades, expressões, limites ou anotações de uma regra de alerta.
Inputs: uid_regra (required), regra_payload (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_auditar_configuracoesB
Executar auditoria de segurança, conformidade e boas práticas na instância Grafana.
Inputs: no named parameters. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_comparar_metricas_periodosC
Comparar o comportamento de uma métrica entre dois períodos temporais distintos.
Inputs: consulta (required), datasource_uid (required), periodo_atual_de, periodo_atual_ate, +2 more. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_comparar_tracesC
Comparar dois traces distribuídos (ex: execução rápida vs execução lenta com erro).
Inputs: trace_id_1 (required), trace_id_2 (required), datasource_uid. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_configurar_limites_coresC
Configurar unidade de medida, limiares (thresholds) e escala de cores de um painel.
Inputs: id_painel (required), uid_dashboard (required), unidade, thresholds_steps. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_configurar_visualizacaoC
Configurar o tipo e as opções visuais de um painel (linhas, barras, stat, gauge, tabela).
Inputs: id_painel (required), uid_dashboard (required), tipo_visualizacao (required), opcoes. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_consultar_fonte_sqlB
Executar consultas SQL seguras (estritamente SELECT) em fontes relacionais (Postgres, MySQL, MSSQL).
Inputs: sql_query (required), datasource_uid (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_consultar_grupos_alerta_oncallB
Consultar grupos de alertas ativos na fila do Grafana OnCall.
Inputs: no named parameters. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_consultar_influxdbC
Consultar métricas no InfluxDB (Flux ou InfluxQL) através do proxy do Grafana.
Inputs: consulta (required), datasource_uid (required), de, ate. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_consultar_lokiC
Executar consulta LogQL para pesquisar fluxos de logs no Grafana Loki.
Inputs: logql (required), de, ate, limite, +1 more. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_consultar_permissoesC
Consultar permissões de acesso (ACL) de um dashboard ou pasta no Grafana.
Inputs: recurso_id (required), tipo_recurso (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_consultar_prometheusC
Executar consulta PromQL (instantânea ou de intervalo) em fonte Prometheus.
Inputs: promql (required), de, ate, datasource_uid, +1 more. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_consultar_slosC
Consultar objetivos de nível de serviço (SLOs) e métricas SLI configuradas.
Inputs: nome_ou_tag. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_consultar_tempoC
Pesquisar e recuperar traces distribuídos no Grafana Tempo por ID ou TraceQL.
Inputs: trace_id_ou_traceql (required), datasource_uid. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_correlacionar_logs_metricas_tracesC
Correlacionar simultaneamente métricas de CPU/RAM, logs de erro e traces de um serviço.
Inputs: nome_servico (required), janela_de, janela_ate. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_criar_dashboardC
Criar um novo dashboard validado no Grafana.
Inputs: dashboard (required), pasta_id, pasta_uid, sobrescrever, +1 more. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_criar_fonte_dadosC
Criar uma nova fonte de dados no Grafana com parâmetros validados.
Inputs: url (required), nome (required), tipo (required), acesso, +2 more. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_criar_incidenteC
Declarar um novo incidente operacional no Grafana com severidade e descrição.
Inputs: titulo (required), rotulos, descricao, severidade. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_criar_pastaC
Criar uma nova pasta no Grafana com título e UID opcional.
Inputs: titulo (required), uid. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_criar_regra_alertaC
Criar uma nova regra de alerta no Grafana Alerting com parâmetros validados.
Inputs: regra_payload (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_detectar_anomalias_metricasC
Identificar anomalias e desvios estatísticos atípicos (outliers) na telemetria.
Inputs: consulta (required), datasource_uid (required), intervalo. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_diagnosticar_alertasA
Investigar e diagnosticar a saúde do ecossistema de alertas e identificar triggers com flapping.
Inputs: no named parameters. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_diagnosticar_degradacaoC
Diagnosticar a causa raiz provável de degradação com base em evidências de telemetria.
Inputs: nome_servico (required), sintoma_relatado (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_diagnosticar_fontes_dadosB
Diagnosticar a saúde e conectividade de todas as fontes de dados cadastradas.
Inputs: no named parameters. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_duplicar_dashboardC
Duplicar um dashboard existente com um novo título e UID.
Inputs: uid_origem (required), novo_titulo (required), nova_pasta_id. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_excluir_dashboardB
Excluir um dashboard pelo UID (Ação destrutiva - requer aprovação em dois passos).
Inputs: uid (required), token_aprovacao. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_excluir_fonte_dadosB
Excluir uma fonte de dados (Ação destrutiva - requer aprovação em dois passos).
Inputs: uid (required), token_aprovacao. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_excluir_pastaC
Excluir uma pasta e opcionalmente seus dashboards dependentes (Ação destrutiva - requer aprovação).
Inputs: uid (required), token_aprovacao. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_excluir_regra_alertaB
Excluir uma regra de alerta (Ação destrutiva - requer aprovação em dois passos).
Inputs: uid_regra (required), token_aprovacao. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_executar_consultaC
Executar consulta através do endpoint unificado /api/ds/query do Grafana.
Inputs: datasource_uid (required), consulta_expressao (required), de, ate, +1 more. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_executar_consulta_painelC
Recuperar e executar a consulta configurada em um painel de dashboard.
Inputs: id_painel (required), uid_dashboard (required), de, ate. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_explorar_atributos_traceC
Extrair e tabular tags, atributos HTTP e erros embutidos nos spans de um trace.
Inputs: trace_id (required), datasource_uid. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_exportar_relatorio_csv_excelC
Exportar dados analíticos tabulares para planilha Excel (.xlsx) ou arquivo .csv.
Inputs: linhas (required), titulo (required), cabecalhos (required), formato, +1 more. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_exportar_relatorio_pdfC
Exportar dados e tabelas customizadas para documento PDF corporativo formatado.
Inputs: linhas (required), resumo (required), titulo (required), cabecalhos (required), +1 more. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerar_dashboard_por_promptC
Gerar e publicar um dashboard completo a partir de uma solicitação em linguagem natural (9 Estágios).
Inputs: prompt (required), pasta_id, pasta_uid, titulo_customizado. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerar_linha_tempo_incidenteB
Gerar uma cronologia ordenada de eventos, alertas e anotações para análise pós-incidente.
Inputs: nome_servico (required), horario_inicio (required), horario_fim. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerar_link_dashboardC
Gerar links e URLs navegáveis válidas para dashboards e painéis específicos.
Inputs: uid (required), id_painel, variaveis, intervalo_tempo. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerar_link_exploreC
Gerar link navegável direto para o modo Explore com a consulta pré-carregada.
Inputs: consulta (required), datasource_uid (required), de, ate. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerar_relatorio_alertasC
Gerar relatório de alertas disparados, histórico de acionamentos e frequência.
Inputs: estado, formato, periodo. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerar_relatorio_capacidadeC
Gerar relatório de capacidade e planejamento de crescimento (Capacity Planning).
Inputs: formato, periodo, recursos. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerar_relatorio_desempenhoC
Gerar relatório de desempenho, latência de consultas e consumo de recursos.
Inputs: formato, periodo, dashboard_uid. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerar_relatorio_disponibilidadeC
Gerar relatório técnico de disponibilidade de serviços, SLIs e uptime monitorados.
Inputs: formato, periodo, servicos_ou_tags. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerar_relatorio_executivoC
Gerar relatório executivo consolidando saúde da instância, datasources, dashboards e alertas.
Inputs: titulo, formato, periodo, incluir_graficos. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerar_relatorio_incidentesC
Gerar relatório de incidentes operacionais, severidade e tempos de resolução (MTTR).
Inputs: formato, periodo. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerar_resumo_pos_incidenteC
Gerar relatório estruturado de Post-Mortem e análise de causa raiz (RCA) de incidente.
Inputs: incidente_id (required), formato. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerenciar_agendas_oncallC
Consultar ou gerenciar escalas de plantão e rotas de plantonistas no Grafana OnCall.
Inputs: acao, agenda_dados. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerenciar_anotacoesC
Consultar, criar e excluir anotações em timelines de dashboards.
Inputs: acao (required), tags, texto, id_anotacao, +1 more. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerenciar_consultas_painelD
Gerenciar consultas (targets) de um painel específico.
Inputs: acao (required), id_painel (required), uid_dashboard (required), ref_id, +1 more. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerenciar_equipesC
Criar, atualizar ou excluir equipes no Grafana com controle de aprovação.
Inputs: acao, nome, email, team_id, +1 more. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerenciar_permissoes_dashboardC
Atualizar a lista de permissões (ACL) de um dashboard específico.
Inputs: dashboard_uid (required), itens_permissao (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerenciar_permissoes_pastaC
Atualizar a lista de permissões (ACL) de uma pasta de dashboards.
Inputs: folder_uid (required), itens_permissao (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerenciar_politicas_notificacaoC
Consultar ou atualizar políticas e árvores de roteamento de notificações do Alertmanager.
Inputs: acao (required), arvore_rotas. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerenciar_pontos_contatoC
Gerenciar canais e pontos de contato (E-mail, Slack, Teams, Telegram, Webhook).
Inputs: acao (required), uid_ponto, ponto_contato. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerenciar_silenciamentosC
Consultar, criar ou expirar silenciamentos temporários (silences) de alertas.
Inputs: acao (required), silenciamento, id_silenciamento. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerenciar_snapshotsD
Gerenciar snapshots estáticos e compartilháveis de dashboards.
Inputs: acao (required), nome, chave_snapshot, dashboard_dict. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_gerenciar_variaveis_dashboardC
Gerenciar variáveis de templating (filtros dinâmicos) de um dashboard.
Inputs: acao (required), uid_dashboard (required), variavel, nome_variavel. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_identificar_padroes_erroC
Agrupar e categorizar padrões frequentes de mensagens de erro nos logs.
Inputs: seletor_app (required), de, ate, datasource_uid. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_identificar_requisicoes_lentasC
Identificar operações e requisições HTTP/gRPC com latência excessiva.
Inputs: de, ate, datasource_uid, limiar_segundos. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_investigar_servicoC
Realizar uma investigação abrangente de saúde, taxa de erro, latência e dependências de um serviço.
Inputs: nome_servico (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_listar_dashboardsC
Pesquisar e listar dashboards cadastrados no Grafana com filtros por nome, tag e pasta.
Inputs: tag, limite, pagina, consulta, +1 more. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_listar_equipesC
Listar equipes (teams) de trabalho configuradas no Grafana.
Inputs: query. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_listar_fontes_dadosB
Listar todas as fontes de dados (datasources) configuradas no Grafana.
Inputs: no named parameters. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_listar_fontes_por_tipoC
Filtrar fontes de dados por tecnologia (ex: prometheus, loki, tempo, zabbix, postgres).
Inputs: tipo (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_listar_incidentesC
Listar incidentes operacionais via Grafana Incident ou anotações de incidentes.
Inputs: limit, status. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_listar_instancias_alertaB
Consultar instâncias de alertas em andamento (estados: firing, normal, pending, nodata).
Inputs: no named parameters. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_listar_organizacoesB
Listar organizações configuradas na instância Grafana.
Inputs: no named parameters. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_listar_pastasC
Listar todas as pastas cadastradas no Grafana.
Inputs: limite, pagina. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_listar_pluginsB
Listar plugins instalados no Grafana (datasources, apps, painéis).
Inputs: no named parameters. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_listar_regras_alertaA
Listar regras de alerta configuradas no Grafana Unified Alerting.
Inputs: no named parameters. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_listar_tagsB
Listar todas as tags associadas a dashboards no Grafana.
Inputs: no named parameters. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_listar_usuariosC
Listar usuários membros da organização atual no Grafana.
Inputs: page, limit. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_mover_dashboardC
Mover um dashboard existente para outra pasta no Grafana.
Inputs: nova_pasta_id (required), uid_dashboard (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_obter_dashboardC
Recuperar a definição JSON completa de um dashboard pelo seu UID.
Inputs: uid (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_obter_detalhes_traceC
Recuperar a árvore de spans, duração e metadados de um trace distribuído no Tempo.
Inputs: trace_id (required), datasource_uid. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_obter_fonte_dadosB
Consultar detalhes e configurações não-sensíveis de uma fonte de dados específica.
Inputs: uid_ou_id (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_obter_incidenteB
Obter detalhes completos, linha do tempo e status de um incidente operacional.
Inputs: incidente_id (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_obter_informacoes_instanciaA
Obter informações de versão, integridade do banco de dados e build da instância.
Inputs: no named parameters. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_obter_painelC
Recuperar a configuração e consultas de um painel específico de um dashboard.
Inputs: id_painel (required), uid_dashboard (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_obter_regra_alertaB
Consultar detalhes completos, expressões e labels de uma regra de alerta específica.
Inputs: uid_regra (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_obter_resumo_dashboardC
Recuperar metadados e lista resumida de painéis sem retornar JSON excessivo.
Inputs: uid (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_pesquisar_logsC
Pesquisar logs estruturados com filtros temporais e texto no Loki.
Inputs: seletor_stream (required), de, ate, limite, +2 more. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_pesquisar_recursosC
Pesquisar recursos de forma ampla (dashboards, pastas e painéis) por palavra-chave.
Inputs: consulta (required), tipo, limite. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_planejar_dashboardB
Planejar a estrutura, painéis, consultas e métricas de um dashboard sem salvar.
Inputs: prompt (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_remover_painelC
Remover um painel específico de um dashboard.
Inputs: id_painel (required), uid_dashboard (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_renderizar_dashboardC
Renderizar visão completa do dashboard em imagem ou gerar snapshot estático.
Inputs: dashboard_uid (required), de, ate, altura, +1 more. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_renderizar_painelC
Renderizar imagem PNG de painel individual do Grafana via Image Renderer.
Inputs: panel_id (required), dashboard_uid (required), de, ate, +2 more. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_testar_conexaoB
Testar conectividade imediata, autenticação, latência e compatibilidade com o Grafana.
Inputs: no named parameters. Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_testar_consultas_dashboardC
Executar e testar todas as consultas de todos os painéis de um dashboard.
Inputs: uid_dashboard (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_testar_fonte_dadosC
Verificar conectividade e integridade de saúde de uma fonte de dados.
Inputs: uid_ou_id (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_validar_dashboardB
Validar a integridade estrutural, referências de fontes e sintaxe de um dashboard.
Inputs: dashboard_dict (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
grafana_verificar_compatibilidade_pluginC
Verificar metadados e requisitos de compatibilidade de um plugin específico.
Inputs: plugin_id (required). Returns: Envelope padrão de resposta para todas as 100 ferramentas do Grafana MCP.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 100 tools
Several tools overlap heavily: multiple query execution endpoints (executar_consulta, consultar_prometheus/loki/tempo/influxdb/sql, executar_consulta_painel), dashboard retrieval variants, and many broad 'gerenciar_*' tools compete with more specific CRUD tools. An agent can often infer intent, but the boundaries are unclear in many places.
All tools use the grafana_ prefix and Portuguese snake_case verb_noun naming, making names readable and mostly predictable. The main deviations are varied verb choices such as gerenciar, consultar, executar, and diagnosticar, plus some long noun phrases, but the convention is not chaotic.
100 tools is extreme for a single MCP server and far beyond a well-scoped set. Even for a broad Grafana domain, many endpoints could be consolidated, so the count creates substantial cognitive overhead.
Coverage spans dashboards, panels, datasources, queries, alerting, folders, reports, incidents, OnCall, SLOs, permissions, and audit, with lifecycle support for core Grafana workflows. Some secondary resources such as users, organizations, and plugins are read-mostly, but the gaps are relatively minor for the stated domain.
Maintenance
Related MCP Connectors
Lets AI agents analyze API metrics, request logs, and traces, and manage apps and alerts.
Autonomous and governed SRE & MLOps control plane for AI agent platforms.
Query your team's drift, vulnerability, and upgrade data from any AI assistant. OAuth 2.1, 51 tools.
Manage uptime monitors and incidents and search logs, metrics and traces from an AI assistant.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI-powered integration with Grafana instances through 52 MCP tools for dashboard management, Prometheus/Loki queries, alerting, and administrative functions. Supports complete Grafana functionality including metrics exploration, log analysis, and incident response through natural language.801MIT
- AlicenseBqualityDmaintenanceEnables AI assistants to interact with Grafana dashboards, datasources, alerts, incidents, and monitoring data through 43 comprehensive tools. Supports querying Prometheus metrics, Loki logs, managing incidents, and dashboard operations with full authentication support.43690 npm3MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to query Grafana dashboards, alerts, and datasources for observability insights and incident investigation.MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to query Grafana datasources (Prometheus/Loki metrics and SQL databases like ClickHouse/Postgres/MySQL) and search or inspect dashboards through natural language, using read-only access to Grafana's API.6MIT