Splunk Enterprise MCP Server
Integrates with Splunk Enterprise and Splunk Cloud via the REST API (port 8089) or the Splunk Web proxy (port 8000), exposing 100 tools across 10 domains for running and managing SPL searches, discovering indexes and data sources, managing saved searches and alerts, dashboards and reports, administration and configuration, data ingestion and forwarders, SIEM/security operations, performance and capacity monitoring, operational management, and analytics.
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., "@Splunk Enterprise MCP Server show failed login attempts in the last 24 hours"
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.
Servidor MCP para Splunk Enterprise (100 Ferramentas)
Um servidor Model Context Protocol (MCP) robusto, seguro e pronto para ambientes corporativos de produção, integrando agentes inteligentes de Inteligência Artificial (Claude Desktop, Cursor, Antigravity IDE, VS Code, LangChain) diretamente ao Splunk Enterprise.
O servidor disponibiliza 100 ferramentas tipadas, validadas e auditadas, abrangendo desde buscas SPL analíticas, auditoria forense de SIEM, caça a ameaças (Threat Hunting), gestão de dashboards e relatórios até governança e diagnóstico de performance de clusters.
Destaques e Diferenciais do Projeto
100 Ferramentas Prontas para Produção: 10 domínios operacionais completos com 10 ferramentas especializadas por domínio.
Taxa de Sucesso de 100% em Testes Reais: Todas as 100 ferramentas foram rigorosamente testadas e homologadas contra uma instância ativa do Splunk Enterprise (versão
10.6.1.1).Conectividade Dual-Mode:
API REST Direta (Porta
8089): Conexão corporativa HTTPS padrão com suporte a Bearer Token e autenticação básica.Splunk Web Proxy (Porta
8000): Conexão HTTP/HTTPS com negociação automática de sessão e tokens anti-CSRF, viabilizando operações em redes corporativas onde a porta 8089 é bloqueada por firewalls.
Arquitetura DevSecOps e Governança Rigorosa:
Modo Somente Leitura por Padrão (
MCP_READ_ONLY=true): Bloqueia nativamente qualquer tentativa de exclusão ou modificação acidental em produção.Portão de Confirmação Humana (Human-in-the-Loop): Ações destrutivas (ex: exclusão de dashboards, remoção de alertas, cancelamento de buscas) exigem obrigatoriamente
confirm=True.Defesa Ativa contra Injeção de Prompt: Eventos brutos de log são encapsulados em contêineres seguros com avisos explícitos para o LLM não executar comandos contidos dentro de logs.
Mascaramento Automático de Segredos: Senhas, Bearer Tokens, chaves privadas e cookies de sessão são automaticamente higienizados em logs e mensagens de erro.
Validador de AST para SPL: Impede comandos perigosos (
delete,outputcsv,script), valida limites temporais obrigatórios e aponta otimizações de busca.Trilha de Auditoria Imutável: Todas as chamadas geram registros correlacionados com ID único (
request_id), latência e status viasys.stderr, mantendo o canal STDIO JSON-RPC perfeitamente limpo.
Related MCP server: MCP Server for Splunk
Arquitetura do Sistema
graph TD
Agent["Agente de IA / Cliente LLM\n(Claude Desktop, Antigravity IDE, Cursor, LangChain)"]
MCP_STDIO["Camada de Protocolo MCP\n(STDIO / SSE / Streamable HTTP)"]
GOV["Motor de Política & Governança\n- Read-Only Default\n- Human-in-the-Loop Gate\n- Redação Automática de Segredos\n- Defesa contra Injeção de Prompt"]
VAL["Validador de SPL & Anti-Patterns\n- Parser de Pipeline AST\n- Enforçamento de Janela Temporal\n- Detecção de Comandos Mutantes"]
AUDIT["Auditoria & Observabilidade\n- Gerador de Request ID\n- Telemetria Estruturada (stderr)"]
subgraph "Matriz das 100 Ferramentas MCP"
DA["Domínio A: Buscas SPL (1-10)"]
DB["Domínio B: Índices & Descoberta (11-20)"]
DC["Domínio C: Buscas Salvas & Alertas (21-30)"]
DD["Domínio D: Dashboards & Relatórios (31-40)"]
DE["Domínio E: Administração & Configs (41-50)"]
DF["Domínio F: Ingestão & Forwarders (51-60)"]
DG["Domínio G: Segurança, SIEM & SOC (61-70)"]
DH["Domínio H: Performance & Capacidade (71-80)"]
DI["Domínio I: Gestão Operacional (81-90)"]
DJ["Domínio J: Inteligência & Análise (91-100)"]
end
CLIENT["SplunkClient Core"]
DIRECT["Splunkd REST API Direta\n(TCP 8089 - HTTPS)"]
PROXY["Splunk Web Proxy API\n(TCP 8000 - HTTP/HTTPS)"]
SPLUNK["Instância Splunk Enterprise / Splunk Cloud"]
Agent <--> MCP_STDIO
MCP_STDIO --> GOV
GOV --> VAL
VAL --> AUDIT
AUDIT --> DA & DB & DC & DD & DE & DF & DG & DH & DI & DJ
DA & DB & DC & DD & DE & DF & DG & DH & DI & DJ --> CLIENT
CLIENT --> DIRECT & PROXY
DIRECT & PROXY --> SPLUNKMatriz Detalhada: Para Que Serve Cada uma das 100 Ferramentas
O servidor disponibiliza 100 ferramentas organizadas em 10 domínios funcionais. Veja abaixo o objetivo operacional e quando utilizar cada ferramenta:
1. Domínio A: Buscas SPL & Execução (001 a 010)
# | Ferramenta | Permissão | Para que serve / Quando usar |
001 |
| Leitura | Execução síncrona de SPL com bloqueio. Utilizada para buscas rápidas onde o agente precisa dos dados imediatos para tomar uma decisão analítica. |
002 |
| Leitura | Busca em fluxo contínuo (streaming). Utilizada para exportar e processar grandes volumes de registros sem estourar a memória RAM do servidor. |
003 |
| Leitura | Despacho assíncrono de busca (Job SID). Utilizada para disparar queries pesadas ou varreduras históricas longas que rodam em segundo plano. |
004 |
| Leitura | Monitor de progresso de busca. Utilizada para consultar o percentual de conclusão ( |
005 |
| Leitura | Coleta de resultados tabulados e transformados. Utilizada para resgatar tabelas de agregação calculadas por comandos como |
006 |
| Leitura | Recuperação de eventos brutos ( |
007 |
| Leitura | Pré-visualização de resultados em tempo real. Utilizada para espiar uma amostra parcial de dados enquanto uma busca pesada ainda está em processamento. |
008 |
| Escrita + Confirmação | Cancelamento e expurgo de jobs ativos. Utilizada para abortar queries mal formuladas ou que estejam sobrecarregando a CPU do cluster. Requer |
009 |
| Leitura | Auditoria e análise sintática de SPL. Utilizada antes de executar queries para estimar custos computacionais e identificar comandos perigosos ou ineficientes. |
010 |
| Leitura | Histórico de buscas do usuário. Utilizada para auditar as últimas queries despachadas no Splunk, resgatar SIDs ou conferir comandos recentes. |
2. Domínio B: Descoberta de Dados & Índices (011 a 020)
# | Ferramenta | Permissão | Para que serve / Quando usar |
011 |
| Leitura | Inventário completo de índices. Utilizada para listar todas as bases de dados ativas no Splunk, tamanho ocupado em disco (MB) e tempos de retenção. |
012 |
| Leitura | Inspeção detalhada de índice. Utilizada para auditar configurações de buckets (Hot/Warm/Cold/Frozen) e caminhos de diretório de um índice específico. |
013 |
| Leitura | Estatísticas consolidadas de armazenamento. Utilizada em relatórios executivos de capacidade para verificar o crescimento global da base do Splunk. |
014 |
| Leitura | Catálogo de formatos de log (sourcetypes). Utilizada para identificar quais tipos de fontes de dados estão ativas e a data do último registro recebido. |
015 |
| Leitura | Listagem de caminhos de arquivos e origens. Utilizada para checar se determinado arquivo de log ou porta de rede está sendo indexado. |
016 |
| Leitura | Inventário de computadores e servidores. Utilizada para mapear todos os endpoints, servidores e dispositivos que reportam dados para o Splunk. |
017 |
| Leitura | Resumo estatístico profundo de campos. Utilizada para entender a distribuição, valores distintos e médias de campos extraídos de um índice/sourcetype. |
018 |
| Leitura | Cálculo de latência e frescor de dados. Utilizada para checar se os logs de firewalls e servidores estão chegando em tempo real ou se há atraso de rede. |
019 |
| Leitura | Detector de lacunas e apagões de telemetria. Utilizada para identificar intervalos onde a taxa de ingestão caiu a zero (falhas de conexão ou agentes parados). |
020 |
| Leitura | Amostragem rápida de eventos. Utilizada para inspecionar o formato dos eventos de um índice sem disparar varreduras custosas na base inteira. |
3. Domínio C: Buscas Salvas & Gestão de Alertas (021 a 030)
# | Ferramenta | Permissão | Para que serve / Quando usar |
021 |
| Leitura | Catálogo de buscas salvas e relatórios. Utilizada para mapear todas as buscas automáticas e regras de detecção cadastradas. |
022 |
| Leitura | Auditoria de regra ou alerta salvo. Utilizada para inspecionar a query SPL, agendamento cron e ações de alerta (e-mail, webhook) de uma busca salva. |
023 |
| Escrita | Criação de novas buscas salvas e alertas. Utilizada para provisionar programaticamente novos casos de uso de detecção do SOC ou relatórios periódicos. |
024 |
| Escrita | Atualização de parâmetros de busca salva. Utilizada para refinar limiares de alertas, corrigir falsos positivos ou atualizar expressões cron. |
025 |
| Escrita + Confirmação | Exclusão definitiva de busca salva. Utilizada para remover relatórios ou alertas obsoletos do catálogo. Requer confirmação explícita ( |
026 |
| Leitura | Disparo imediato de busca salva. Utilizada para forçar a execução instantânea de um relatório fora do seu horário agendado, gerando um novo SID. |
027 |
| Leitura | Fila de alertas disparados recentemente (fired alerts). Utilizada para verificar quais alertas de segurança foram acionados nas últimas horas na central. |
028 |
| Leitura | Histórico temporal de alertas no |
029 |
| Escrita | Reconhecimento de alerta por analista de SOC. Utilizada no fluxo de triagem de incidentes para anotar que um evento já está em análise e evitar retrabalho. |
030 |
| Escrita | Controle de supressão de ruído (Alert Fatigue). Utilizada durante manutenções para pausar notificações repetitivas sem precisar desativar a regra. |
4. Domínio D: Dashboards & Objetos de Conhecimento (031 a 040)
# | Ferramenta | Permissão | Para que serve / Quando usar |
031 |
| Leitura | Listagem de painéis e dashboards. Utilizada para mapear todos os dashboards Simple XML e Studio ativos e obter seus links diretos no Splunk Web. |
032 |
| Leitura | Extração do código-fonte Simple XML. Utilizada para auditar as queries SPL embutidas nos gráficos ou realizar backup do layout de um dashboard. |
033 |
| Escrita | Criação direta de dashboards no Splunk Web. Utilizada para construir painéis visuais do SOC, centros de comando ou monitores geográficos com mapas. |
034 |
| Escrita | Atualização dinâmica de dashboards. Utilizada para alterar o código XML, inserir novos painéis ou ajustar consultas de dashboards existentes. |
035 |
| Escrita + Confirmação | Exclusão definitiva de dashboard. Utilizada para remover painéis temporários ou projetos visuais descontinuados. Requer |
036 |
| Leitura | Enumeração de relatórios de negócio. Utilizada para auditar quais relatórios analíticos formatados estão disponíveis para as lideranças. |
037 |
| Leitura | Execução de relatório corporativo oficial. Utilizada para coletar a tabela de dados consolidada de um relatório sem reescrever a query manualmente. |
038 |
| Leitura | Catálogo de tipos de eventos taxonômicos. Utilizada para entender as classificações de logs cadastradas (ex: falhas de autenticação, acessos VPN). |
039 |
| Leitura | Consulta de tags do modelo CIM. Utilizada para checar a normalização de campos de segurança conforme o padrão do Splunk Enterprise Security (ES). |
040 |
| Leitura | Inventário de macros SPL reutilizáveis. Utilizada para inspecionar funções de atalho de busca e entender sua expansão lógica. |
5. Domínio E: Administração & Controle de Acesso (041 a 050)
# | Ferramenta | Permissão | Para que serve / Quando usar |
041 |
| Leitura | Dados fundamentais da instância. Utilizada para verificar versão exata (10.6.1.1), build, licença ativa, sistema operacional e modo do nó. |
042 |
| Leitura | Saúde de subsistemas internos. Utilizada para checar se as filas de indexação, agendador e discos estão em estado |
043 |
| Leitura | Inventário de aplicativos e add-ons (TAs). Utilizada para verificar quais pacotes e add-ons estão instalados e habilitados no Splunk. |
044 |
| Leitura | Detalhes cadastrais de um aplicativo. Utilizada em auditorias de conformidade para checar versão, autor, pasta e visibilidade de um app específico. |
045 |
| Leitura | Auditoria de contas de usuários. Utilizada para listar todos os usuários locais e integrados (AD/LDAP/SAML) com seus respectivos papéis de acesso. |
046 |
| Leitura | Inspeção de perfil de usuário. Utilizada em investigações para checar papéis, e-mail, fuso horário e último acesso de uma conta suspeita. |
047 |
| Leitura | Catálogo de funções e perfis RBAC. Utilizada para auditar a estrutura de privilégios de acesso do ambiente ( |
048 |
| Leitura | Inspeção de permissões granulares de uma função. Utilizada para verificar se determinado perfil possui permissões críticas como exclusão ou edição. |
049 |
| Leitura | Listagem de arquivos |
050 |
| Leitura | Leitura de diretivas de arquivos |
6. Domínio F: Monitoramento de Ingestão & Forwarders (051 a 060)
# | Ferramenta | Permissão | Para que serve / Quando usar |
051 |
| Leitura | Mapeamento de portas e canais de entrada. Utilizada para verificar quais monitores de log, portas de rede (TCP/UDP) e tokens HEC estão ativos. |
052 |
| Leitura | Diagnóstico de canal de entrada de dados. Utilizada para checar diretórios monitorados, índices de destino e expressões regulares de filtragem de arquivo. |
053 |
| Leitura | Auditoria do parque de Universal Forwarders. Utilizada para listar computadores clientes conectados com SO, versão do agente e volume transmitido em MB. |
054 |
| Leitura | Checagem de status de forwarder individual. Utilizada para verificar se um servidor específico está ativo ou se deixou de enviar telemetria. |
055 |
| Leitura | Detector de forwarders offline. Utilizada pelo SOC para alertar automaticamente quando endpoints ultrapassam um limite de tolerância de inatividade. |
056 |
| Leitura | Métricas de taxa de transferência e EPS. Utilizada para acompanhar a vazão de dados em KB/s e eventos por segundo sendo ingeridos no momento. |
057 |
| Leitura | Cálculo de atraso de ingestão (latência). Utilizada para diagnosticar represamento de rede ou relógios desincronizados entre servidores e Splunk (NTP). |
058 |
| Leitura | Varredura de erros de formatação de log. Utilizada para detectar falhas de timestamp ou quebra inadequada de eventos multilinhas no indexador. |
059 |
| Leitura | Auditoria de cobertura de fontes obrigatórias. Utilizada para validar se 100% dos servidores esperados estão ativamente gravando dados nos índices. |
060 |
| Leitura | Diagnóstico unificado de ingestão. Utilizada como ferramenta central de triagem quando eventos estiverem demorando para aparecer nas pesquisas. |
7. Domínio G: Segurança, SIEM & Caça a Ameaças (SOC) (061 a 070)
# | Ferramenta | Permissão | Para que serve / Quando usar |
061 |
| Leitura | Consolidação de falhas de autenticação. Utilizada para correlacionar eventos de senha incorreta em Windows ( |
062 |
| Leitura | Detecção heurística de força bruta. Utilizada para identificar ataques automatizados ou tentativas sucessivas de invasão (password spraying). |
063 |
| Leitura | Investigação forense 360° de endereço IP. Utilizada para correlacionar conexões de rede, acessos web e bloqueios de firewall originados de um IP suspeito. |
064 |
| Leitura | Auditoria de comportamento de usuário. Utilizada em investigações de credencial comprometida ou ameaça interna (insider threat). |
065 |
| Leitura | Análise forense de endpoint / servidor. Utilizada na resposta a incidentes para inspecionar processos executados e acessos no host comprometido. |
066 |
| Leitura | Varredura de Indicadores de Comprometimento (IOC). Utilizada para pesquisar hashes de malware (MD5/SHA256), domínios maliciosos ou IPs na base inteira. |
067 |
| Leitura | Correlação multi-fonte de eventos suspeitos. Utilizada para reconstruir a cadeia de ataque (cyber kill chain) ligando eventos de VPN, firewall e Active Directory. |
068 |
| Leitura | Detecção de anomalias estatísticas. Utilizada em Threat Hunting para descobrir picos incomuns de tráfego ou desvios de linha de base não cobertos por alertas. |
069 |
| Leitura | Fila de chamados de segurança pendentes. Utilizada para alimentar a esteira de triagem de analistas de segurança de primeiro e segundo nível. |
070 |
| Leitura | Reconstrução cronológica de incidente. Utilizada para gerar a linha do tempo comprobatória antes, durante e após o ataque para relatórios periciais. |
8. Domínio H: Performance & Capacidade do Cluster (071 a 080)
# | Ferramenta | Permissão | Para que serve / Quando usar |
071 |
| Leitura | Eficiência e tempo de resposta do Search Head. Utilizada para identificar quais usuários ou consultas estão sobrecarregando o cluster de buscas. |
072 |
| Leitura | Isolamento de buscas lentas e ineficientes. Utilizada para localizar queries que excedem 30 segundos ou consomem mais de 1GB de memória RAM. |
073 |
| Leitura | Monitor de limites de concorrência simultânea. Utilizada para verificar se o Splunk está enfileirando buscas por esgotamento de slots de CPU. |
074 |
| Leitura | Auditoria de buscas agendadas puladas (skipped searches). Utilizada para diagnosticar atrasos na execução de relatórios automáticos. |
075 |
| Leitura | Consolidação de falhas e erros críticos no |
076 |
| Leitura | Monitoramento diário de consumo de licença. Utilizada para prevenir violações (license warnings) que bloqueiam a execução de buscas por estouro de cota. |
077 |
| Leitura | Auditoria de espaço em disco e partições |
078 |
| Leitura | Saúde de clusters de Search Head e Indexadores. Utilizada em arquiteturas distribuídas para validar a sincronização entre nós. |
079 |
| Leitura | Checagem de Fatores de Replicação e Busca (RF/SF). Utilizada para assegurar a redundância e tolerância a falhas dos buckets de dados no cluster. |
080 |
| Leitura | Diagnóstico central de lentidão sistêmica. Utilizada para correlacionar consumo de CPU, I/O de disco e filas quando houver lentidão na plataforma. |
9. Domínio I: Ações Operacionais & Modificações (081 a 090)
# | Ferramenta | Permissão | Para que serve / Quando usar |
081 |
| Escrita | Criação programática de novos índices. Utilizada no provisionamento de bases de dados dedicadas para novos projetos ou sistemas corporativos. |
082 |
| Escrita | Ajuste de retenção e congelamento de buckets. Utilizada para estender o tempo de guarda histórica de logs de auditoria ou arquivar dados. |
083 |
| Escrita | Habilitação ou desabilitação de entradas de dados. Utilizada para pausar a coleta de arquivos durante janelas de manutenção de infraestrutura. |
084 |
| Escrita + Confirmação | Gestão de credenciais de usuários. Utilizada na automação de criação e desligamento de contas no Splunk com confirmação de segurança. |
085 |
| Escrita + Confirmação | Gestão de papéis e permissões RBAC. Utilizada para criar novos perfis de acesso com restrições granulares por índice. |
086 |
| Escrita + Confirmação | Gestão de ciclo de vida de aplicativos. Utilizada para habilitar ou desabilitar complementos e TAs com proteção humana. |
087 |
| Leitura | Validação sintática com |
088 |
| Leitura | Exportação estruturada em JSON ou CSV. Utilizada para alimentar Data Lakes externos ou gerar cópias de segurança de evidências periciais. |
089 |
| Escrita | Injeção de eventos sintéticos via REST ou HEC. Utilizada para testar pipelines de coleta e simular ataques para validação de regras de detecção. |
090 |
| Leitura | Reexecução retroativa de buscas salvas. Utilizada em auditorias para reaplicar a lógica de um relatório em janelas temporais do passado. |
10. Domínio J: Inteligência Analítica & Workflows (091 a 100)
# | Ferramenta | Permissão | Para que serve / Quando usar |
091 |
| Leitura | Tradução de linguagem natural para SPL. Utilizada para transformar perguntas humanas em buscas SPL otimizadas sem precisar memorizar comandos. |
092 |
| Leitura | Refatoração e otimização de consultas SPL. Utilizada para reescrever buscas pesadas, reduzindo o tempo de resposta e poupando CPU dos indexadores. |
093 |
| Leitura | Interpretação semântica de resultados. Utilizada para responder a dúvidas analíticas do operador e gerar resumos executivos claros sobre os dados. |
094 |
| Leitura | Comparação temporal quantitativa. Utilizada para medir variações percentuais de métricas entre duas janelas (ex: hoje vs ontem, ou pré vs pós-incidente). |
095 |
| Leitura | Auditoria de qualidade e anomalias de schema. Utilizada para detectar campos com excesso de valores nulos ou discrepâncias de formato nos índices. |
096 |
| Leitura | Geração de relatório executivo em Markdown. Utilizada para emitir relatórios consolidados de saúde da infraestrutura para passagem de turno. |
097 |
| Leitura / Escrita | Orquestração de pipelines automatizadas. Utilizada na triagem sequencial de incidentes ( |
098 |
| Leitura | Simulação prévia de risco (dry-run). Utilizada antes de ações administrativas críticas para avaliar previamente dependências e impactos. |
099 |
| Leitura | Consulta à trilha de auditoria em memória. Utilizada para auditar em tempo real as ações executadas pelo assistente de IA durante a sessão. |
100 |
| Leitura | Teste diagnóstico de conectividade ponta a ponta. Utilizada para validar handshake HTTP/HTTPS, latência de rede, TLS, autenticação e versão do Splunk. |
Guia de Início Rápido
1. Clonar o Repositório
git clone https://github.com/nks1097/Splunk_Enterprice_MCP.git
cd Splunk_Enterprice_MCP2. Criar e Ativar o Ambiente Virtual
No Windows (PowerShell):
Caso o PowerShell bloqueie a execução de scripts (running scripts is disabled on this system), libere a permissão para o usuário atual antes de ativar o ambiente:
No terminal do PowerShell, libere a execução de scripts para o seu usuário:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser(Pressione S ou A para confirmar caso solicitado).
Crie e ative o ambiente virtual normalmente:
python -m venv .venv
.\.venv\Scripts\activate(O prefixo (.venv) aparecerá no início da linha do terminal).
Instale o pacote em modo de desenvolvimento com as dependências:
pip install -e ".[dev]"No Linux / macOS:
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"3. Configurar as Variáveis de Ambiente
Copie o arquivo de exemplo .env.example para .env:
# Windows
copy .env.example .env
# Linux / macOS
cp .env.example .envEdite o arquivo .env com os dados da sua instância do Splunk:
# Configuração de Conexão com o Splunk Enterprise
SPLUNK_HOST=192.168.0.107
SPLUNK_PORT=8000
SPLUNK_SCHEME=http
# Credenciais de Acesso (ou use SPLUNK_TOKEN para Bearer Token)
SPLUNK_USERNAME=admin
SPLUNK_PASSWORD=sua_senha_aqui
# SPLUNK_TOKEN=seu_token_jwt_aqui
# Validação de Certificado TLS (defina false para certificados autoassinados)
SPLUNK_VERIFY_TLS=false
# Políticas de Governança e Segurança
MCP_READ_ONLY=false
MCP_TRANSPORT=stdioExemplo 1 das configurações do arquivo .env

Exemplo 2 das configurações do arquivo .env

Configuração nos Clientes MCP
Claude Desktop
Adicione ao arquivo de configuração:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"splunk": {
"command": "C:/caminho/para/Splunk_Enterprice_MCP/.venv/Scripts/python.exe",
"args": ["-m", "splunk_mcp.server", "--transport", "stdio"],
"cwd": "C:/caminho/para/Splunk_Enterprice_MCP",
"env": {
"SPLUNK_HOST": "192.168.0.107",
"SPLUNK_PORT": "8000",
"SPLUNK_SCHEME": "http",
"SPLUNK_USERNAME": "admin",
"SPLUNK_PASSWORD": "sua_senha_aqui",
"SPLUNK_VERIFY_TLS": "false",
"MCP_READ_ONLY": "false"
}
}
}
}Antigravity IDE (mcp_config.json)
{
"mcpServers": {
"splunk": {
"command": "C:/caminho/para/Splunk_Enterprice_MCP/.venv/Scripts/python.exe",
"args": ["-m", "splunk_mcp.server", "--transport", "stdio"],
"cwd": "C:/caminho/para/Splunk_Enterprice_MCP"
}
}
}imagem de Exemplo de configuração mcp_config.json para o Antigravity IDE

Cursor (.cursor/mcp.json)
{
"mcpServers": {
"splunk": {
"command": "python",
"args": ["-m", "splunk_mcp.server", "--transport", "stdio"],
"env": {
"SPLUNK_HOST": "192.168.0.107",
"SPLUNK_PORT": "8000",
"SPLUNK_SCHEME": "http",
"SPLUNK_USERNAME": "admin",
"SPLUNK_PASSWORD": "sua_senha_aqui",
"SPLUNK_VERIFY_TLS": "false"
}
}
}
}Execução via Docker & Docker Compose
Para rodar como um microserviço HTTP/SSE containerizado em Kubernetes ou Docker:
# Inicializar o container em segundo plano
docker compose up -d
# Verificar a integridade do serviço
curl -I http://localhost:8001/sseValidação e Bateria de Testes
O repositório inclui suítes completas de testes unitários e de integração:
# Executar os 24 testes unitários com mocks offline
pytest tests/unit -v
# Executar os testes de integração ao vivo contra o Splunk
pytest tests/integration/test_live_splunk.py -v -sVIDEO DE CONFIGURAÇÃO DE FORMA SIMPLIFICADA USANDO ANTIGRAVITY IDE
▶️ Clique aqui para assistir ao vídeo completo no Google Drive Assiste em Full Hd (1080P)
Documentação Técnica Aprofundada
Licença
Distribuído sob a licença de código aberto Apache License, Version 2.0.
Available Tools
100 toolssplunk_acknowledge_alertB
Acknowledge or update status of an alert finding (requires write mode).
Args: alert_id: Fired alert ID. comment: Operational acknowledgement comment.
Inputs: alert_id (required), comment. Returns: data, error, success, metadata, +2 more
splunk_audit_tool_activityA
Query recent MCP server tool invocations, execution duration, and audit logs.
Args: limit: Number of audit records to retrieve (default 50). tool_filter: Optional tool name filter. only_failures: Only retrieve failed tool executions.
Inputs: limit, tool_filter, only_failures. Returns: data, error, success, metadata, +2 more
splunk_build_incident_timelineC
Composite tool: construct a high-fidelity chronological timeline for an incident entity.
Args: entity_type: Type of entity ('ip', 'user', or 'host'). entity_value: The entity string (e.g. '10.0.0.5', 'jsmith', 'srv-db-01'). earliest_time: Incident timeline start. latest_time: Incident timeline end. max_events: Maximum chronological timeline events.
Inputs: entity_type (required), entity_value (required), max_events, latest_time, +1 more. Returns: data, error, success, metadata, +2 more
splunk_check_forwarder_connectivityA
Detect missing forwarders that stopped transmitting data beyond expected threshold.
Args: threshold_minutes: Minutes without data before flagging as disconnected (default 15).
Inputs: threshold_minutes. Returns: data, error, success, metadata, +2 more
splunk_check_source_coverageC
Verify that expected data sources are active and currently indexing data.
Args: expected_sources: List of expected source or sourcetype strings. index: Target index. lookback: Time interval to inspect.
Inputs: expected_sources (required), index, lookback. Returns: data, error, success, metadata, +2 more
splunk_compare_time_periodsC
Compare event volume or metric values between two distinct time periods.
Args: metric_spl: Search query ending in stats count or metric. period1_earliest: Current period start. period1_latest: Current period end. period2_earliest: Comparison period start. period2_latest: Comparison period end.
Inputs: metric_spl (required), period1_latest, period2_latest, period1_earliest, +1 more. Returns: data, error, success, metadata, +2 more
splunk_correlate_eventsB
Correlate multi-source events occurring within a synchronized time window around an entity.
Args: entity_value: Target identifier (e.g. IP, username, hostname). window_minutes: Time window in minutes before and after timestamp. timestamp: Anchor epoch or ISO timestamp (default current time).
Inputs: entity_value (required), timestamp, window_minutes. Returns: data, error, success, metadata, +2 more
splunk_create_dashboardA
Create a new Simple XML or Dashboard Studio dashboard (requires write mode).
Args: name: Unique dashboard view ID. label: Display title of dashboard. xml_data: XML or JSON dashboard definition. app: App namespace (default 'search').
Inputs: name (required), label (required), xml_data (required), app. Returns: data, error, success, metadata, +2 more
splunk_create_indexA
Create a new Splunk index with storage capacity and retention limits (requires write mode).
Args: name: Unique name of the new index. max_size_mb: Maximum index size in Megabytes (default 10,000 MB). frozen_retention_days: Optional retention window in days before aging to frozen.
Inputs: name (required), max_size_mb, frozen_retention_days. Returns: data, error, success, metadata, +2 more
splunk_create_saved_searchA
Create a new saved search or scheduled report (requires write mode).
Args: name: Unique name for the saved search. search: SPL search query. description: Description of the report/saved search. cron_schedule: Cron expression (e.g. '0 * * * *'). is_scheduled: Whether to enable automatic schedule. app: App namespace (default 'search').
Inputs: name (required), search (required), app, description, +2 more. Returns: data, error, success, metadata, +2 more
splunk_delete_dashboardB
Delete a dashboard (requires write mode and human confirmation).
Args: name: Name of dashboard to delete. app: Optional app namespace. confirm: Confirmation flag.
Inputs: name (required), app, confirm. Returns: data, error, success, metadata, +2 more
splunk_delete_saved_searchA
Delete an existing saved search (requires write mode and human confirmation).
Args: name: Name of the saved search to delete. confirm: Confirmation flag.
Inputs: name (required), confirm. Returns: data, error, success, metadata, +2 more
splunk_detect_anomaliesC
Execute statistical anomaly detection (outliers based on standard deviation) over time series.
Args: index: Index to inspect. sourcetype: Optional sourcetype. field_to_analyze: Metric or field (default 'count'). time_span: Aggregation bucket (default '1h').
Inputs: index (required), time_span, sourcetype, field_to_analyze. Returns: data, error, success, metadata, +2 more
splunk_detect_brute_forceB
Detect potential brute force attacks or credential stuffing based on repeated failed logins.
Args: threshold: Minimum failed attempts to flag (default 5). time_window: Bin duration (default '15m'). earliest_time: Time range to analyze (default '-4h').
Inputs: threshold, time_window, earliest_time. Returns: data, error, success, metadata, +2 more
splunk_detect_data_quality_issuesB
Audit an index and sourcetype for null values, timestamp skew, and format discrepancies.
Args: index: Index to audit. sourcetype: Optional sourcetype filter.
Inputs: index (required), sourcetype. Returns: data, error, success, metadata, +2 more
splunk_detect_failed_loginsB
Detect and aggregate failed authentication events across Splunk audit, Windows, and Linux logs.
Args: index: Optional specific index (defaults to searching _audit and default indexes). earliest_time: Earliest search window (default '-24h@h'). count: Maximum aggregated rows to return.
Inputs: count, index, earliest_time. Returns: data, error, success, metadata, +2 more
splunk_detect_slow_searchesC
Identify slow or expensive searches exceeding duration threshold.
Args: min_duration_seconds: Threshold in seconds to flag (default 30). earliest_time: Search window. count: Maximum slow searches to list.
Inputs: count, earliest_time, min_duration_seconds. Returns: data, error, success, metadata, +2 more
splunk_diagnose_ingestionB
Composite diagnostic: evaluate overall pipeline health, queue sizes, drop rates, and bottlenecks.
Inputs: no named parameters. Returns: data, error, success, metadata, +2 more
splunk_diagnose_performanceB
Composite tool: multi-dimensional assessment of CPU, memory, scheduler, disk, and search latency.
Inputs: no named parameters. Returns: data, error, success, metadata, +2 more
splunk_dispatch_saved_searchB
Dispatch and immediately run a saved search, returning its newly generated job SID.
Args: name: Name of the saved search. trigger_actions: Whether to fire configured alert actions (e.g. email, webhook).
Inputs: name (required), trigger_actions. Returns: data, error, success, metadata, +2 more
splunk_execute_workflowB
Execute an automated investigation or operational workflow pipeline.
Args: workflow_name: Workflow to run ('incident_triage', 'ingestion_audit', 'capacity_review'). parameters: Workflow specific parameters (e.g. {'entity': '10.0.0.1'}).
Inputs: workflow_name (required), parameters. Returns: data, error, success, metadata, +2 more
splunk_explain_search_resultsA
Interpret search results, highlight statistical distributions, and summarize key findings.
Args: results: Array of result dictionaries from a search. question: Optional analytical question being answered.
Inputs: results (required), question. Returns: data, error, success, metadata, +2 more
splunk_export_search_resultsC
Export search results in structured format (JSON, CSV, or raw events).
Args: spl: SPL search query. output_format: 'json', 'csv', or 'raw'. earliest_time: Optional earliest time. count: Maximum count of events to export.
Inputs: spl (required), count, earliest_time, output_format. Returns: data, error, success, metadata, +2 more
splunk_generate_operational_reportA
Generate an executive Markdown operational health report covering license, errors, and storage.
Inputs: no named parameters. Returns: data, error, success, metadata, +2 more
splunk_get_alert_historyB
Retrieve historical fired alert events over a time window.
Args: alert_name: Optional name filter for specific alert. earliest_time: Earliest time range (default '-7d@d'). count: Maximum history events.
Inputs: count, alert_name, earliest_time. Returns: data, error, success, metadata, +2 more
splunk_get_app_detailsB
Get metadata, configurations, and permissions for a specific Splunk app.
Args: name: App folder name (e.g. 'search', 'SplunkForwarder').
Inputs: name (required). Returns: data, error, success, metadata, +2 more
splunk_get_cluster_healthA
Check health status of indexer cluster or search head cluster (or report standalone topology).
Inputs: no named parameters. Returns: data, error, success, metadata, +2 more
splunk_get_configurationB
Read stanzas and properties from a configuration file with secrets scrubbed.
Args: conf_file: Name of conf file (e.g. 'server', 'props', 'transforms', 'inputs'). stanza: Optional specific stanza name.
Inputs: conf_file (required), stanza. Returns: data, error, success, metadata, +2 more
splunk_get_dashboardC
Retrieve full XML or JSON definition of a dashboard.
Args: name: Dashboard view name/id. app: Optional app namespace.
Inputs: name (required), app. Returns: data, error, success, metadata, +2 more
splunk_get_data_freshnessC
Evaluate data recency, latest event timestamp, and ingestion latency.
Args: index: Target index. sourcetype: Optional sourcetype.
Inputs: index (required), sourcetype. Returns: data, error, success, metadata, +2 more
splunk_get_field_summaryB
Obtain statistical distribution of fields and top values for an index and sourcetype.
Args: index: Target index name. sourcetype: Optional sourcetype filter. sample_count: Number of events to sample for summary.
Inputs: index (required), sourcetype, sample_count. Returns: data, error, success, metadata, +2 more
splunk_get_forwarder_statusB
Inspect transmission volume, connection drops, and status for a specific forwarder.
Args: hostname: Forwarder hostname.
Inputs: hostname (required). Returns: data, error, success, metadata, +2 more
splunk_get_indexB
Query configuration, retention policies, and storage paths for a specific index.
Args: name: Index name (e.g. 'main', '_internal', 'wineventlog').
Inputs: name (required). Returns: data, error, success, metadata, +2 more
splunk_get_ingestion_lagB
Measure pipeline processing lag between event occurrence timestamp and indexing time.
Args: index: Index to evaluate. sourcetype: Optional sourcetype filter. count: Sample size of events.
Inputs: index (required), count, sourcetype. Returns: data, error, success, metadata, +2 more
splunk_get_ingestion_metricsA
Retrieve historical ingestion throughput (MB/hour) broken down by index.
Args: time_span: Bucket span (e.g. '15m', '1h'). earliest_time: Earliest search window.
Inputs: time_span, earliest_time. Returns: data, error, success, metadata, +2 more
splunk_get_inputA
Get configuration and status of a specific input stanza.
Args: input_type: Input type (e.g. 'monitor', 'tcp/raw', 'http', 'script'). name: Stanza name or port.
Inputs: name (required), input_type (required). Returns: data, error, success, metadata, +2 more
splunk_get_internal_errorsA
Query recent internal daemon errors and warnings from index=_internal.
Args: log_level: Log severity filter ('ERROR', 'WARN', 'FATAL'). earliest_time: Time window (default '-4h'). count: Maximum errors to return.
Inputs: count, log_level, earliest_time. Returns: data, error, success, metadata, +2 more
splunk_get_license_usageA
Retrieve daily license quota, consumed bytes, warnings, and pool allocations.
Inputs: no named parameters. Returns: data, error, success, metadata, +2 more
splunk_get_parsing_errorsB
Detect timestamp parsing, line-breaking, and regex extraction errors recorded in _internal.
Args: earliest_time: Search window (default '-24h@h').
Inputs: earliest_time. Returns: data, error, success, metadata, +2 more
splunk_get_replication_statusB
Check bucket replication status, cluster fix-up tasks, and peer synchronizations.
Inputs: no named parameters. Returns: data, error, success, metadata, +2 more
splunk_get_role_capabilitiesB
Get granular capabilities and restrictions assigned to a specific role.
Args: role_name: Name of the role (e.g. 'admin', 'user', 'power').
Inputs: role_name (required). Returns: data, error, success, metadata, +2 more
splunk_get_saved_searchA
Retrieve full configuration, search query, schedule, and actions of a saved search.
Args: name: Name of the saved search.
Inputs: name (required). Returns: data, error, success, metadata, +2 more
splunk_get_scheduler_healthC
Inspect search scheduler health, skipped searches, delayed executions, and quota blocks.
Args: earliest_time: Scheduler audit window (default '-4h').
Inputs: earliest_time. Returns: data, error, success, metadata, +2 more
splunk_get_search_concurrencyB
Inspect active concurrent historical and real-time searches against system limits.
Inputs: no named parameters. Returns: data, error, success, metadata, +2 more
splunk_get_search_performanceC
Inspect search head performance, execution times, and resource utilization.
Args: earliest_time: Search audit window (default '-4h').
Inputs: earliest_time. Returns: data, error, success, metadata, +2 more
splunk_get_security_alertsB
Query security alerts, high-severity trigger events, and findings.
Args: severity: Optional severity filter ('critical', 'high', 'medium'). earliest_time: Time window (default '-24h@h'). count: Maximum alert items.
Inputs: count, severity, earliest_time. Returns: data, error, success, metadata, +2 more
splunk_get_server_healthB
Retrieve Splunk system health report, status features, and subsystem warnings.
Inputs: no named parameters. Returns: data, error, success, metadata, +2 more
splunk_get_server_infoA
Retrieve Splunk server runtime info, version, OS, license state, and topology roles.
Inputs: no named parameters. Returns: data, error, success, metadata, +2 more
splunk_get_storage_usageA
Inspect filesystem disk partitions, storage volume in $SPLUNK_DB, and retention capacities.
Inputs: no named parameters. Returns: data, error, success, metadata, +2 more
splunk_get_userA
Get details, assigned roles, and permissions of a specific user.
Args: username: Username to inspect.
Inputs: username (required). Returns: data, error, success, metadata, +2 more
splunk_index_statsB
Retrieve aggregate storage volume and event statistics across all accessible indexes.
Inputs: no named parameters. Returns: data, error, success, metadata, +2 more
splunk_investigate_hostB
Investigate system logs, processes, network connections, and errors for a host.
Args: hostname: Target host name or FQDN. earliest_time: Earliest search window. count: Maximum events.
Inputs: hostname (required), count, earliest_time. Returns: data, error, success, metadata, +2 more
splunk_investigate_ipA
Forensic investigation of an IP address across firewall, proxy, authentication, and web logs.
Args: ip_address: Target IP address to investigate. earliest_time: Time window to scan (default '-24h@h'). count: Maximum events to return.
Inputs: ip_address (required), count, earliest_time. Returns: data, error, success, metadata, +2 more
splunk_investigate_userB
Audit user actions, accessed resources, IP origins, and privilege usage.
Args: username: Target username. earliest_time: Time range to audit. count: Maximum results.
Inputs: username (required), count, earliest_time. Returns: data, error, success, metadata, +2 more
splunk_list_alertsB
List configured alerts and recent fired alert records.
Args: count: Maximum number of alerts to return.
Inputs: count. Returns: data, error, success, metadata, +2 more
splunk_list_appsB
List installed Splunk apps and add-ons with versions and status.
Inputs: count. Returns: data, error, success, metadata, +2 more
splunk_list_configurationsB
List available .conf configuration files accessible through REST properties.
Inputs: no named parameters. Returns: data, error, success, metadata, +2 more
splunk_list_dashboardsB
List dashboards (Simple XML or Dashboard Studio) in the Splunk instance.
Args: app: Optional Splunk app filter. count: Number of dashboards to retrieve. offset: Pagination offset.
Inputs: app, count, offset. Returns: data, error, success, metadata, +2 more
splunk_list_eventtypesB
List eventtypes, classifications, and search patterns.
Args: count: Maximum number of eventtypes.
Inputs: count. Returns: data, error, success, metadata, +2 more
splunk_list_forwardersB
List connected Universal and Heavy Forwarders observed in the indexing pipeline.
Args: count: Maximum number of forwarders.
Inputs: count. Returns: data, error, success, metadata, +2 more
splunk_list_hostsA
Discover hosts reporting data into Splunk with event counts and latest observed timestamp.
Args: index: Optional index filter. count: Maximum number of hosts to list.
Inputs: count, index. Returns: data, error, success, metadata, +2 more
splunk_list_indexesA
List accessible Splunk indexes with disk size, event count, and disabled status.
Args: count: Number of indexes to list. offset: Pagination offset.
Inputs: count, offset. Returns: data, error, success, metadata, +2 more
splunk_list_inputsC
List configured data inputs (TCP, UDP, monitor, scripts, HTTP Event Collector).
Args: count: Maximum number of inputs.
Inputs: count. Returns: data, error, success, metadata, +2 more
splunk_list_macrosC
List configured search macros, arguments, and definition strings.
Args: count: Maximum number of macros.
Inputs: count. Returns: data, error, success, metadata, +2 more
splunk_list_reportsC
List scheduled and ad-hoc reports in the environment.
Args: app: Optional app filter. count: Maximum number of reports to retrieve.
Inputs: app, count. Returns: data, error, success, metadata, +2 more
splunk_list_rolesC
List configured roles, inherited roles, and allowed search indexes.
Inputs: count. Returns: data, error, success, metadata, +2 more
splunk_list_saved_searchesB
List saved searches, scheduled reports, and alerts.
Args: app: Optional Splunk app context (e.g. 'search'). count: Number of saved searches to list. offset: Pagination offset.
Inputs: app, count, offset. Returns: data, error, success, metadata, +2 more
splunk_list_sourcesB
Discover event sources across indexes with event counts.
Args: index: Optional index filter. count: Maximum number of sources to list.
Inputs: count, index. Returns: data, error, success, metadata, +2 more
splunk_list_sourcetypesB
Discover sourcetypes with event count and last seen recency.
Args: index: Optional index filter (e.g. 'main', '_internal'). count: Maximum number of sourcetypes to retrieve.
Inputs: count, index. Returns: data, error, success, metadata, +2 more
splunk_list_tagsA
List tags assigned to fields and event classifications.
Args: count: Maximum number of tags.
Inputs: count. Returns: data, error, success, metadata, +2 more
splunk_list_usersB
List configured user accounts, roles, realnames, and authentication types with secrets redacted.
Inputs: count. Returns: data, error, success, metadata, +2 more
splunk_manage_alert_suppressionB
Configure or inspect suppression windows for an alert to prevent notification storms.
Args: alert_name: Name of saved search alert. suppression_period: Time duration to suppress (e.g. '1h', '30m'). enabled: Enable or disable suppression.
Inputs: alert_name (required), enabled, suppression_period. Returns: data, error, success, metadata, +2 more
splunk_manage_appA
Enable or disable a Splunk application (requires write mode and human confirmation).
Args: app_name: Target app folder name. action: 'enable' or 'disable'. confirm: Confirmation flag.
Inputs: app_name (required), action, confirm. Returns: data, error, success, metadata, +2 more
splunk_manage_inputA
Enable or disable a configured data input stanza (requires write mode).
Args: input_type: Type of input (e.g. 'monitor', 'tcp/raw', 'http'). name: Name or port of the input stanza. action: 'enable' or 'disable'.
Inputs: name (required), input_type (required), action. Returns: data, error, success, metadata, +2 more
splunk_manage_roleB
Create, modify, or delete a security role (requires write mode and human confirmation).
Args: role_name: Role identifier. action: 'create', 'update', or 'delete'. capabilities: List of granted capabilities. allowed_indexes: Allowed searchable indexes. confirm: Confirmation flag.
Inputs: role_name (required), action, confirm, capabilities, +1 more. Returns: data, error, success, metadata, +2 more
splunk_manage_userA
Create, update, or remove a Splunk user (requires write mode and human confirmation).
Args: username: Target username. action: 'create', 'update', or 'delete'. roles: List of roles to assign (e.g. ['user', 'power']). password: User password for creation/update (scrubbed from audit logs). realname: Optional display real name. email: Optional email address. confirm: Confirmation flag for user management.
Inputs: username (required), email, roles, action, +3 more. Returns: data, error, success, metadata, +2 more
splunk_natural_language_to_splB
Convert natural language questions or operational requirements into secure, optimized SPL.
Args: prompt: User's analytical goal (e.g. 'top 10 IP addresses by failed login count'). target_index: Optional target index hint (e.g. '_audit', 'main', 'firewall'). time_range: Intended time window (default '-24h@h').
Inputs: prompt (required), time_range, target_index. Returns: data, error, success, metadata, +2 more
splunk_optimize_splB
Analyze an SPL query, detect performance anti-patterns, and generate an optimized version.
Args: spl: SPL search string to optimize.
Inputs: spl (required). Returns: data, error, success, metadata, +2 more
splunk_preview_changeB
Preview the impact of a configuration or administrative modification before executing it.
Args: operation: Operation type (e.g. 'update_index', 'delete_saved_search', 'modify_role'). target: Target resource identifier. proposed_settings: Proposed parameter values to evaluate.
Inputs: target (required), operation (required), proposed_settings (required). Returns: data, error, success, metadata, +2 more
splunk_replay_saved_searchB
Replay and re-execute a saved search query over a custom historical time range.
Args: name: Saved search name. earliest_time: Historical start time (e.g. '-7d@d', '1710000000'). latest_time: Historical end time (e.g. 'now', '-1d@d').
Inputs: name (required), latest_time, earliest_time. Returns: data, error, success, metadata, +2 more
splunk_run_reportB
Execute a named report and retrieve its generated results.
Args: name: Name of the report/saved search. count: Maximum results to return.
Inputs: name (required), count. Returns: data, error, success, metadata, +2 more
splunk_sample_eventsA
Retrieve representative raw event samples without full table scans.
Args: index: Target index. sourcetype: Optional sourcetype filter. count: Number of sample events (default 10, max 100).
Inputs: index (required), count, sourcetype. Returns: data, error, success, metadata, +2 more
splunk_searchA
Execute a synchronous blocking SPL search within an explicit time window.
Args: spl: SPL search string (e.g. 'index=_internal | stats count by sourcetype'). earliest_time: Earliest time bound (e.g. '-24h@h', '-15m', '1710000000'). latest_time: Latest time bound (e.g. 'now', '@h'). count: Maximum number of results to retrieve (capped by SPLUNK_MAX_RESULTS). offset: Offset index for pagination.
Inputs: spl (required), count, offset, latest_time, +1 more. Returns: data, error, success, metadata, +2 more
splunk_search_asyncB
Initiate an asynchronous search job in the background and return its Job SID immediately.
Args: spl: SPL query. earliest_time: Earliest time bound. latest_time: Latest time bound. max_count: Optional maximum count limit.
Inputs: spl (required), max_count, latest_time, earliest_time. Returns: data, error, success, metadata, +2 more
splunk_search_cancelC
Cancel an active authorized search job.
Args: sid: Search Job ID to cancel. confirm: Confirmation flag for cancellation.
Inputs: sid (required), confirm. Returns: data, error, success, metadata, +2 more
splunk_search_data_gapsB
Detect time gaps in ingested data streams where expected events are missing.
Args: index: Index to analyze. sourcetype: Optional sourcetype filter. time_span: Bucket duration for binning (e.g. '15m', '1h'). earliest_time: Earliest search window.
Inputs: index (required), time_span, sourcetype, earliest_time. Returns: data, error, success, metadata, +2 more
splunk_search_eventsC
Retrieve raw events associated with a Search Job.
Args: sid: Search Job ID. offset: Offset into events. count: Number of events to fetch.
Inputs: sid (required), count, offset. Returns: data, error, success, metadata, +2 more
splunk_search_explainB
Validate SPL structure, analyze risk, performance anti-patterns, and cost estimation.
Args: spl: SPL query to analyze. earliest_time: Optional earliest time bound.
Inputs: spl (required), earliest_time. Returns: data, error, success, metadata, +2 more
splunk_search_historyB
Query recent search history and jobs dispatched by the current user.
Args: count: Maximum number of history jobs to list.
Inputs: count. Returns: data, error, success, metadata, +2 more
splunk_search_iocA
Search for Indicators of Compromise (hashes, domains, IPs, URLs) across all indexed data.
Args: ioc_value: The IOC string (e.g. SHA256 hash, malicious domain, external IP). ioc_type: Optional type description ('hash', 'ip', 'domain'). earliest_time: Time range (default '-7d@d').
Inputs: ioc_value (required), ioc_type, earliest_time. Returns: data, error, success, metadata, +2 more
splunk_search_previewB
Retrieve preliminary preview results for an in-progress search job.
Args: sid: Search Job ID. count: Number of preview results to fetch.
Inputs: sid (required), count. Returns: data, error, success, metadata, +2 more
splunk_search_resultsB
Retrieve paginated results for a completed or running Search Job.
Args: sid: Search Job ID. offset: Offset into results. count: Number of results to fetch.
Inputs: sid (required), count, offset. Returns: data, error, success, metadata, +2 more
splunk_search_statusB
Query execution status, progress percentage, and statistics of a Search Job by SID.
Args: sid: Search Job ID.
Inputs: sid (required). Returns: data, error, success, metadata, +2 more
splunk_search_streamB
Stream search results progressively via the Splunk export endpoint.
Args: spl: SPL search string. earliest_time: Earliest time bound. latest_time: Latest time bound. count: Maximum number of events to stream.
Inputs: spl (required), count, latest_time, earliest_time. Returns: data, error, success, metadata, +2 more
splunk_submit_eventA
Submit a synthetic test log event into a Splunk index via receiver endpoint (requires write mode).
Args: event_data: Raw log text or JSON payload. index: Destination index (default 'main'). sourcetype: Sourcetype marker. host: Optional origin host string.
Inputs: event_data (required), host, index, sourcetype. Returns: data, error, success, metadata, +2 more
splunk_test_connectionA
Verify end-to-end connectivity, TLS, authentication, server version, and operational permissions.
Inputs: no named parameters. Returns: data, error, success, metadata, +2 more
splunk_update_dashboardA
Update an existing dashboard definition (requires write mode).
Args: name: Name of dashboard to update. xml_data: Updated XML/JSON definition. label: Optional new display title. app: Optional app namespace.
Inputs: name (required), xml_data (required), app, label. Returns: data, error, success, metadata, +2 more
splunk_update_index_settingsA
Update settings, quotas, or disable/enable an index (requires write mode).
Args: name: Name of index to update. max_size_mb: Optional new maximum size in Megabytes. frozen_retention_days: Optional new retention in days. disabled: Set index disabled or enabled.
Inputs: name (required), disabled, max_size_mb, frozen_retention_days. Returns: data, error, success, metadata, +2 more
splunk_update_saved_searchB
Update settings or query of an existing saved search.
Args: name: Name of saved search to update. search: Optional new SPL query. description: Optional new description. cron_schedule: Optional new cron expression. is_scheduled: Enable/disable scheduled execution. disabled: Enable/disable the saved search.
Inputs: name (required), search, disabled, description, +2 more. Returns: data, error, success, metadata, +2 more
splunk_validate_configurationA
Audit and validate a configuration file for syntax errors or stanza duplicates.
Args: conf_file: Configuration file name (e.g. 'props', 'transforms', 'inputs').
Inputs: conf_file. Returns: data, error, success, metadata, +2 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 100 tools
The tool set has many overlapping areas: synchronous, async, streaming, exported, previewed, and saved-search execution tools all coexist, as do composite diagnostics and their granular component tools. Descriptions and predictable names help, but an agent can easily choose the wrong search, alert, report, or investigation tool among the roughly 100 options.
Almost every tool uses the splunk_ prefix and snake_case, with mostly verb_noun patterns such as splunk_get_saved_search, splunk_create_index, and splunk_detect_brute_force. Minor deviations appear in noun-oriented names like splunk_search_status and splunk_index_stats, and some overloaded verbs like manage are broader than others.
A total of 100 tools is an extreme mismatch for a single MCP surface, far beyond the typical 3-15 well-scoped range. Although Splunk is a broad platform, exposing nearly every operation as a separate tool creates a high cognitive and selection burden.
Coverage is unusually broad: search lifecycle, saved searches, alerts, indexes, dashboards, users, roles, apps, ingestion diagnostics, security investigations, performance, and audit are all represented. Some lifecycle gaps remain, such as creating or modifying inputs/configuration, installing apps, and lookup or data model management, but most core workflows are covered.
Maintenance
Related MCP Connectors
Governed AI agents for the software your company already runs. 400+ connectors, one endpoint.
Lets AI agents analyze API metrics, request logs, and traces, and manage apps and alerts.
Connect AI agents to 1000+ apps with managed authentication and tool-calling.
Agent-native security, trust, reliability, data and procurement tools for AI workflows.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Splunk Enterprise and Splunk Cloud instances through standardized MCP interface. Supports executing SPL queries, managing indexes and saved searches, listing applications, and retrieving server information with flexible authentication options.-
- AlicenseBqualityBmaintenanceEnables AI agents to interact seamlessly with Splunk environments through 20+ tools for search, analytics, data discovery, administration, and health monitoring. Features AI-powered troubleshooting workflows and supports multiple Splunk instances with production-ready security.57113 PyPI27Apache 2.0
- AlicenseBqualityDmaintenanceEnables AI-driven SOC investigations by providing automated Splunk querying, threat intelligence enrichment, and response actions through natural language. Includes tools for IP pivoting, lateral movement detection, and label harvesting.311Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to search, manage, and analyze data in Splunk instances through the Model Context Protocol. Supports SPL queries, index management, alerts, dashboards, and more.1,663 PyPI1Apache 2.0