Skip to main content
Glama
Grafana MCP Server
by nks1097

📊 Grafana MCP Server — 100 Ferramentas em Português

CI Pipeline Python 3.11+ MCP Specification Grafana Compatibility License: MIT

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:3000 ou http://localhost:3000).


2. Gerar o Token de Acesso no Grafana

O método recomendado em produção é o Service Account Token:

  1. No menu do Grafana, navegue até Administration ➔ Users and access ➔ Service accounts.

  2. Clique em Add service account, atribua o nome mcp-server e o papel (Role) Editor ou Admin.

  3. 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 .env

Ajuste 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.json

  • macOS: ~/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 --build

O 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

grafana_listar_dashboards

Pesquisa e lista dashboards cadastrados no Grafana com filtros por texto, tags e pastas.

002

grafana_obter_dashboard

Recupera a definição JSON completa de um dashboard pelo seu identificador único (UID).

003

grafana_obter_resumo_dashboard

Retorna um resumo técnico compacto (título, quantidade de painéis, variáveis) sem sobrecarregar o contexto.

004

grafana_obter_painel

Extrai a configuração detalhada de um único painel pelo seu ID numérico dentro de um dashboard.

005

grafana_criar_dashboard

Cria um novo dashboard no Grafana persistindo a estrutura JSON fornecida na pasta desejada.

006

grafana_atualizar_dashboard

Atualiza a definição de um dashboard existente com mensagem de commit e controle de versão.

007

grafana_excluir_dashboard

Exclui permanentemente um dashboard (protegido por token de aprovação em dois passos).

008

grafana_duplicar_dashboard

Clona um dashboard modelo com novo título, gerando novo UID e preservando painéis.

009

grafana_gerenciar_variaveis_dashboard

Consulta, adiciona ou atualiza variáveis dinâmicas de template (host, ambiente, interval) em dashboards.

010

grafana_gerar_link_dashboard

Constrói uma URL web completa e clicável com intervalo temporal e variáveis aplicadas.

011

grafana_gerar_dashboard_por_prompt

Motor autônomo em 9 etapas: entende o pedido, planeja painéis, valida queries e publica o dashboard.

012

grafana_planejar_dashboard

Gera o plano arquitetural do dashboard (estágio 3 do motor) para revisão prévia sem salvar na API.

013

grafana_adicionar_painel

Adiciona um novo painel com visualização configurada e posicionamento automático na grade 24 colunas.

014

grafana_atualizar_painel

Altera título, descrição, tipo de gráfico ou consultas de um painel específico.

015

grafana_remover_painel

Remove um painel específico de um dashboard pelo seu ID numérico.

016

grafana_gerenciar_consultas_painel

Consulta ou substitui as consultas de métricas (targets) configuradas em um painel.

017

grafana_configurar_visualizacao

Ajusta propriedades visuais (estilo de linha, preenchimento, modo de tooltip e legendas).

018

grafana_configurar_limites_cores

Configura réguas de limiares (thresholds) e paleta de cores (verde, amarelo, vermelho) para stat/gauges.

019

grafana_validar_dashboard

Valida o schema JSON do dashboard contra a especificação oficial do Grafana antes da publicação.

020

grafana_testar_consultas_dashboard

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

grafana_listar_fontes_dados

Lista todas as fontes de dados configuradas (Prometheus, Loki, Tempo, Zabbix, SQL, etc.).

022

grafana_obter_fonte_dados

Consulta detalhes técnicos e configurações de conexão de uma datasource específica.

023

grafana_criar_fonte_dados

Provisiona uma nova fonte de dados no Grafana com parâmetros de rede e autenticação.

024

grafana_atualizar_fonte_dados

Atualiza credenciais, URL de endpoint ou opções de TLS de uma datasource existente.

025

grafana_excluir_fonte_dados

Remove uma fonte de dados da instância (requer token de aprovação).

026

grafana_testar_fonte_dados

Dispara o teste de saúde nativo do Grafana na datasource para verificar conectividade e autenticação.

027

grafana_diagnosticar_fontes_dados

Executa varredura de saúde em todas as fontes simultaneamente, emitindo diagnóstico geral.

028

grafana_listar_plugins

Lista todos os plugins instalados na instância (aplicativos, painéis e datasources).

029

grafana_verificar_compatibilidade_plugin

Checa se determinado plugin está presente e se é compatível com a versão instalada do Grafana.

030

grafana_listar_fontes_por_tipo

Retorna somente as fontes de dados de uma tecnologia específica (ex: apenas prometheus ou loki).

Categoria C: Consultas e Métricas (031 a 040)

#

Ferramenta

Para que serve (Descrição)

031

grafana_executar_consulta

Executa consultas genéricas através do endpoint unificado /api/ds/query do Grafana.

032

grafana_consultar_prometheus

Executa consultas PromQL otimizadas diretamente em fontes Prometheus ou Mimir.

033

grafana_consultar_loki

Executa consultas de agregação métrica LogQL em fontes Loki.

034

grafana_consultar_tempo

Executa consultas TraceQL ou busca por Trace ID em fontes de rastreamento Tempo.

035

grafana_consultar_influxdb

Executa consultas temporais Flux ou InfluxQL em fontes InfluxDB.

036

grafana_consultar_fonte_sql

Executa consultas SQL estritamente de leitura (SELECT) em bancos relacionais com bloqueio preventivo de DDL/DML.

037

grafana_executar_consulta_painel

Executa exatamente as queries configuradas em um painel já existente, retornando os valores renderizados.

038

grafana_comparar_metricas_periodos

Compara uma métrica entre dois períodos temporais distintos (ex: hoje vs ontem) calculando a variação delta.

039

grafana_analisar_tendencias_metricas

Analisa a tendência histórica de uma métrica calculando média, desvio padrão e inclinação de crescimento.

040

grafana_detectar_anomalias_metricas

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

grafana_pesquisar_logs

Pesquisa linhas de log em fontes Loki com filtros de streams e busca textual.

042

grafana_identificar_padroes_erro

Agrupa e quantifica padrões frequentes de mensagens de erro em logs.

043

grafana_identificar_requisicoes_lentas

Localiza spans de rastreamento com latência acima de um limiar pré-estabelecido.

044

grafana_obter_detalhes_trace

Recupera a árvore completa de spans de uma transação distribuída pelo ID do trace.

045

grafana_comparar_traces

Compara um trace saudável contra um trace degradado para isolar a operação gargalo.

046

grafana_explorar_atributos_trace

Lista tags indexadas e atributos de spans de um determinado serviço.

047

grafana_correlacionar_logs_metricas_traces

Realiza correlação 360° unindo métricas, logs e traces na mesma janela de tempo para um serviço.

048

grafana_investigar_servico

Conduz triagem diagnóstica rápida no serviço (taxa de erro, throughput e latência).

049

grafana_diagnosticar_degradacao

Identifica falhas em cascata no ambiente recente e aponta o provável foco inicial do incidente.

050

grafana_gerar_linha_tempo_incidente

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

grafana_listar_regras_alerta

Lista todas as regras de alerta configuradas no Grafana Unified Alerting.

052

grafana_obter_regra_alerta

Consulta os detalhes técnicos, expressões e limiares de uma regra de alerta específica.

053

grafana_criar_regra_alerta

Cadastra uma nova regra de alerta com condições e labels validadas.

054

grafana_atualizar_regra_alerta

Modifica limiares de acionamento ou labels de uma regra existente.

055

grafana_excluir_regra_alerta

Remove uma regra de alerta da plataforma (requer aprovação em dois passos).

056

grafana_listar_instancias_alerta

Lista os alertas que estão atualmente disparados (firing), pendentes ou normais.

057

grafana_gerenciar_politicas_notificacao

Consulta ou atualiza a árvore de políticas de roteamento de notificações para as equipes.

058

grafana_gerenciar_pontos_contato

Lista, cadastra ou testa canais de contato como Slack, Telegram, Webhook, PagerDuty e E-mail.

059

grafana_gerenciar_silenciamentos

Cria, consulta ou cancela silenciamentos temporários de alertas durante manutenções programadas.

060

grafana_diagnosticar_alertas

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

grafana_listar_pastas

Lista todas as pastas de organização de dashboards com paginação.

062

grafana_criar_pasta

Cria uma nova pasta no Grafana para agrupar dashboards de um projeto ou departamento.

063

grafana_atualizar_pasta

Renomeia uma pasta existente mantendo seus dashboards associados.

064

grafana_excluir_pasta

Exclui uma pasta e seus dashboards contidos (requer aprovação administrativa).

065

grafana_mover_dashboard

Transfere um dashboard de sua pasta atual para uma nova pasta de destino.

066

grafana_listar_tags

Lista todas as tags utilizadas na organização com respectiva contagem de uso.

067

grafana_pesquisar_recursos

Busca unificada por dashboards, pastas e painéis em um único comando por palavra-chave.

068

grafana_gerar_link_explore

Constrói uma URL direta para a aba Grafana Explore com a consulta pré-carregada para o operador.

069

grafana_gerenciar_snapshots

Cria ou lista snapshots congelados no tempo para compartilhamento público ou interno.

070

grafana_gerenciar_anotacoes

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

grafana_gerar_relatorio_executivo

Consolida a saúde do ambiente, datasources, dashboards e alertas em relatório PDF, Excel ou Markdown.

072

grafana_gerar_relatorio_disponibilidade

Emite relatório técnico de disponibilidade de serviços, percentual de SLA e tempos de indisponibilidade.

073

grafana_gerar_relatorio_desempenho

Gera relatório de performance com latência de API (p95/p99), QPS e consumo de recursos.

074

grafana_gerar_relatorio_alertas

Consolida o histórico de alarmes acionados, severidade e frequência no período.

075

grafana_gerar_relatorio_incidentes

Gera relatório de resposta a incidentes contendo MTTD, MTTR e resoluções aplicadas.

076

grafana_gerar_relatorio_capacidade

Gera relatório de planejamento de capacidade (Capacity Planning) com projeções para 90 dias.

077

grafana_renderizar_painel

Gera a URL direta do serviço Image Renderer para download de imagem PNG de um painel individual.

078

grafana_renderizar_dashboard

Gera a URL para captura de tela completa em alta definição de todo o dashboard em PNG.

079

grafana_exportar_relatorio_pdf

Exporta dados tabulares customizados fornecidos pelo agente para documento PDF corporativo formatado.

080

grafana_exportar_relatorio_csv_excel

Exporta matrizes de dados analíticos para planilhas Excel formatadas (.xlsx) ou arquivos .csv.

Categoria H: Incidentes, SLOs e OnCall (081 a 090)

#

Ferramenta

Para que serve (Descrição)

081

grafana_listar_incidentes

Consulta a lista de incidentes operacionais ativos ou resolvidos no Grafana Incident.

082

grafana_criar_incidente

Declara formalmente um novo incidente operacional com severidade e descrição de impacto.

083

grafana_obter_incidente

Consulta os detalhes completos, responsáveis e status de um incidente pelo seu ID.

084

grafana_atualizar_incidente

Altera o status do incidente (investigating -> mitigated -> resolved) e adiciona resumos de ações.

085

grafana_adicionar_atividade_incidente

Adiciona notas, comentários ou evidências na linha do tempo de um incidente em andamento.

086

grafana_gerenciar_agendas_oncall

Consulta e gerencia as escalas de sobreaviso e plantão no Grafana OnCall.

087

grafana_consultar_grupos_alerta_oncall

Consulta grupos de alertas pendentes de atendimento na fila do plantão OnCall.

088

grafana_consultar_slos

Consulta os objetivos de nível de serviço (SLOs) configurados e a conformidade atual de SLIs.

089

grafana_analisar_orcamento_erro

Calcula o consumo do orçamento de erro (Error Budget) e a taxa de queima (Burn Rate) de um SLO.

090

grafana_gerar_resumo_pos_incidente

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

grafana_obter_informacoes_instancia

Retorna a versão exata do Grafana, commit de build e integridade da base de dados.

092

grafana_listar_organizacoes

Lista todas as organizações cadastradas em instâncias multitenant.

093

grafana_listar_usuarios

Lista os usuários membros da organização atual, seus papéis (roles) e e-mails de acesso.

094

grafana_listar_equipes

Lista equipes e times de trabalho (teams) configurados na organização.

095

grafana_gerenciar_equipes

Cria, atualiza ou exclui equipes no Grafana com confirmação em dois passos para exclusão.

096

grafana_consultar_permissoes

Consulta a lista de controle de acesso (ACL) de um dashboard ou pasta específica.

097

grafana_gerenciar_permissoes_dashboard

Atribui ou modifica permissões de acesso (Viewer, Editor, Admin) de um dashboard.

098

grafana_gerenciar_permissoes_pasta

Define permissões herdadas por todos os dashboards contidos em determinada pasta.

099

grafana_auditar_configuracoes

Executa auditoria 360° de conformidade e segurança na instância, gerando pontuação (0 a 100) e alertas.

100

grafana_testar_conexao

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 -v

Saí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 tools
grafana_adicionar_atividade_incidenteC
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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_relatorio_alertasC
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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
  1. 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

    C2.5/5.0

    Scored across 100 tools

    Disambiguation2/5

    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.

    Naming Consistency4/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Enables 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.
      80
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables 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.
      43
      690 npm
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to query Grafana dashboards, alerts, and datasources for observability insights and incident investigation.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      6
      MIT