Skip to main content
Glama
Splunk Enterprise MCP Server

Splunk Enterprise MCP Server

by nks1097

Servidor MCP para Splunk Enterprise (100 Ferramentas)

Python 3.10+ Model Context Protocol Licença Testes Splunk

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 via sys.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 --> SPLUNK

Matriz 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

splunk_search

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

splunk_search_stream

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

splunk_search_async

Leitura

Despacho assíncrono de busca (Job SID). Utilizada para disparar queries pesadas ou varreduras históricas longas que rodam em segundo plano.

004

splunk_search_status

Leitura

Monitor de progresso de busca. Utilizada para consultar o percentual de conclusão (done_progress) e quantidade de eventos escaneados de um job.

005

splunk_search_results

Leitura

Coleta de resultados tabulados e transformados. Utilizada para resgatar tabelas de agregação calculadas por comandos como stats, chart e timechart.

006

splunk_search_events

Leitura

Recuperação de eventos brutos (_raw). Utilizada em investigações forenses profundas de SOC para inspecionar payloads originais com blindagem anti-injeção.

007

splunk_search_preview

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

splunk_search_cancel

Escrita + Confirmação

Cancelamento e expurgo de jobs ativos. Utilizada para abortar queries mal formuladas ou que estejam sobrecarregando a CPU do cluster. Requer confirm=True.

009

splunk_search_explain

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

splunk_search_history

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

splunk_list_indexes

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

splunk_get_index

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

splunk_index_stats

Leitura

Estatísticas consolidadas de armazenamento. Utilizada em relatórios executivos de capacidade para verificar o crescimento global da base do Splunk.

014

splunk_list_sourcetypes

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

splunk_list_sources

Leitura

Listagem de caminhos de arquivos e origens. Utilizada para checar se determinado arquivo de log ou porta de rede está sendo indexado.

016

splunk_list_hosts

Leitura

Inventário de computadores e servidores. Utilizada para mapear todos os endpoints, servidores e dispositivos que reportam dados para o Splunk.

017

splunk_get_field_summary

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

splunk_get_data_freshness

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

splunk_search_data_gaps

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

splunk_sample_events

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

splunk_list_saved_searches

Leitura

Catálogo de buscas salvas e relatórios. Utilizada para mapear todas as buscas automáticas e regras de detecção cadastradas.

022

splunk_get_saved_search

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

splunk_create_saved_search

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

splunk_update_saved_search

Escrita

Atualização de parâmetros de busca salva. Utilizada para refinar limiares de alertas, corrigir falsos positivos ou atualizar expressões cron.

025

splunk_delete_saved_search

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 (confirm=True).

026

splunk_dispatch_saved_search

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

splunk_list_alerts

Leitura

Fila de alertas disparados recentemente (fired alerts). Utilizada para verificar quais alertas de segurança foram acionados nas últimas horas na central.

028

splunk_get_alert_history

Leitura

Histórico temporal de alertas no _audit. Utilizada para analisar a frequência de acionamento de um alerta específico e identificar picos anormais.

029

splunk_acknowledge_alert

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

splunk_manage_alert_suppression

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

splunk_list_dashboards

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

splunk_get_dashboard

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

splunk_create_dashboard

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

splunk_update_dashboard

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

splunk_delete_dashboard

Escrita + Confirmação

Exclusão definitiva de dashboard. Utilizada para remover painéis temporários ou projetos visuais descontinuados. Requer confirm=True.

036

splunk_list_reports

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

splunk_run_report

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

splunk_list_eventtypes

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

splunk_list_tags

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

splunk_list_macros

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

splunk_get_server_info

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

splunk_get_server_health

Leitura

Saúde de subsistemas internos. Utilizada para checar se as filas de indexação, agendador e discos estão em estado GREEN, YELLOW ou RED.

043

splunk_list_apps

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

splunk_get_app_details

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

splunk_list_users

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

splunk_get_user

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

splunk_list_roles

Leitura

Catálogo de funções e perfis RBAC. Utilizada para auditar a estrutura de privilégios de acesso do ambiente (admin, power, user).

048

splunk_get_role_capabilities

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

splunk_list_configurations

Leitura

Listagem de arquivos .conf. Utilizada para mapear quais módulos de configuração do Splunk (inputs, props, transforms) possuem stanzas ativas.

050

splunk_get_configuration

Leitura

Leitura de diretivas de arquivos .conf. Utilizada para inspecionar parâmetros aplicados nos bastidores da configuração de indexação ou coleta.


6. Domínio F: Monitoramento de Ingestão & Forwarders (051 a 060)

#

Ferramenta

Permissão

Para que serve / Quando usar

051

splunk_list_inputs

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

splunk_get_input

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

splunk_list_forwarders

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

splunk_get_forwarder_status

Leitura

Checagem de status de forwarder individual. Utilizada para verificar se um servidor específico está ativo ou se deixou de enviar telemetria.

055

splunk_check_forwarder_connectivity

Leitura

Detector de forwarders offline. Utilizada pelo SOC para alertar automaticamente quando endpoints ultrapassam um limite de tolerância de inatividade.

056

splunk_get_ingestion_metrics

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

splunk_get_ingestion_lag

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

splunk_get_parsing_errors

Leitura

Varredura de erros de formatação de log. Utilizada para detectar falhas de timestamp ou quebra inadequada de eventos multilinhas no indexador.

059

splunk_check_source_coverage

Leitura

Auditoria de cobertura de fontes obrigatórias. Utilizada para validar se 100% dos servidores esperados estão ativamente gravando dados nos índices.

060

splunk_diagnose_ingestion

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

splunk_detect_failed_logins

Leitura

Consolidação de falhas de autenticação. Utilizada para correlacionar eventos de senha incorreta em Windows (EventID 4625), Linux (sshd) e Splunk.

062

splunk_detect_brute_force

Leitura

Detecção heurística de força bruta. Utilizada para identificar ataques automatizados ou tentativas sucessivas de invasão (password spraying).

063

splunk_investigate_ip

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

splunk_investigate_user

Leitura

Auditoria de comportamento de usuário. Utilizada em investigações de credencial comprometida ou ameaça interna (insider threat).

065

splunk_investigate_host

Leitura

Análise forense de endpoint / servidor. Utilizada na resposta a incidentes para inspecionar processos executados e acessos no host comprometido.

066

splunk_search_ioc

Leitura

Varredura de Indicadores de Comprometimento (IOC). Utilizada para pesquisar hashes de malware (MD5/SHA256), domínios maliciosos ou IPs na base inteira.

067

splunk_correlate_events

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

splunk_detect_anomalies

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

splunk_get_security_alerts

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

splunk_build_incident_timeline

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

splunk_get_search_performance

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

splunk_detect_slow_searches

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

splunk_get_search_concurrency

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

splunk_get_scheduler_health

Leitura

Auditoria de buscas agendadas puladas (skipped searches). Utilizada para diagnosticar atrasos na execução de relatórios automáticos.

075

splunk_get_internal_errors

Leitura

Consolidação de falhas e erros críticos no _internal. Utilizada em rotinas de sustentação para verificar a estabilidade dos serviços do daemon Splunkd.

076

splunk_get_license_usage

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

splunk_get_storage_usage

Leitura

Auditoria de espaço em disco e partições $SPLUNK_DB. Utilizada para evitar interrupções de serviço por esgotamento de armazenamento.

078

splunk_get_cluster_health

Leitura

Saúde de clusters de Search Head e Indexadores. Utilizada em arquiteturas distribuídas para validar a sincronização entre nós.

079

splunk_get_replication_status

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

splunk_diagnose_performance

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

splunk_create_index

Escrita

Criação programática de novos índices. Utilizada no provisionamento de bases de dados dedicadas para novos projetos ou sistemas corporativos.

082

splunk_update_index_settings

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

splunk_manage_input

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

splunk_manage_user

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

splunk_manage_role

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

splunk_manage_app

Escrita + Confirmação

Gestão de ciclo de vida de aplicativos. Utilizada para habilitar ou desabilitar complementos e TAs com proteção humana.

087

splunk_validate_configuration

Leitura

Validação sintática com btool. Utilizada após edições de arquivos .conf para checar erros de digitação e conflitos antes de reiniciar o serviço.

088

splunk_export_search_results

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

splunk_submit_event

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

splunk_replay_saved_search

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

splunk_natural_language_to_spl

Leitura

Tradução de linguagem natural para SPL. Utilizada para transformar perguntas humanas em buscas SPL otimizadas sem precisar memorizar comandos.

092

splunk_optimize_spl

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

splunk_explain_search_results

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

splunk_compare_time_periods

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

splunk_detect_data_quality_issues

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

splunk_generate_operational_report

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

splunk_execute_workflow

Leitura / Escrita

Orquestração de pipelines automatizadas. Utilizada na triagem sequencial de incidentes (incident_triage) para investigar usuário, falhas e anomalias em um passo.

098

splunk_preview_change

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

splunk_audit_tool_activity

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

splunk_test_connection

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_MCP

2. Criar e Ativar o Ambiente Virtual

No Windows (PowerShell):

TIP

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:

  1. 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).

  1. 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).

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

Edite 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=stdio
  • Exemplo 1 das configurações do arquivo .env

    Criando o arquivo .env

  • Exemplo 2 das configurações do arquivo .env

    Configurações do .env



Configuração nos Clientes MCP

Claude Desktop

Adicione ao arquivo de configuração:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Configuração mcp_config.json na 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/sse

Validaçã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 -s

VIDEO 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 tools
splunk_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_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_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_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_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_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_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_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

    B3.1/5.0

    Scored across 100 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      -
    • A
      license
      B
      quality
      B
      maintenance
      Enables 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.
      57
      113 PyPI
      27
      Apache 2.0
    • A
      license
      B
      quality
      D
      maintenance
      Enables 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.
      31
      1
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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 PyPI
      1
      Apache 2.0