MaxoPerf MCP

https://app.maxoperf.com/mcp

Configuração

É um servidor remoto e hospedado — nada para instalar ou executar. Adicione isto à configuração do seu cliente MCP e defina MAXOPERF_API_KEY (crie uma no console → Configurações → Chaves de API):

{
  "mcpServers": {
    "maxoperf": {
      "type": "http",
      "url": "https://app.maxoperf.com/mcp",
      "headers": {
        "Authorization": "Bearer ${MAXOPERF_API_KEY}"
      }
    }
  }
}

Sua chave é validada em cada chamada pela plataforma real (auth, tenancy, OpenFGA, auditoria) — o servidor não armazena nada e não adiciona nova fronteira de confiança. Revogue a chave, o acesso morre instantaneamente. Envie o cabeçalho X-MaxoPerf-MCP-Mode: read-only para uma sessão de apenas visualização (ferramentas de escrita ocultas).

Instalação (escolha seu cliente)

Claude Code — o plugin inclui o servidor e a skill do agente:

/plugin marketplace add MaxoPerf/mcp
/plugin install maxoperf

Ou adicione apenas o conector:

claude mcp add --transport http maxoperf https://app.maxoperf.com/mcp \
  --header "Authorization: Bearer ${MAXOPERF_API_KEY}"

Cursor · VS Code / Copilot · Codex · ChatGPT · Claude Desktop — deeplinks de um clique e configuração copiar-e-colar em packaging/. Todos usam o mesmo bloco mcpServers acima.

Ferramentas

29 ferramentas selecionadas. Leituras usam response_format: "concise" por padrão (passe "detailed" para o payload completo); ferramentas de escrita exigem uma sessão não somente-leitura, e cancel_run fica oculta no modo somente-leitura.

Contexto e tenancy

• whoami — Resolve a conta + workspace padrão por trás da sua chave de API
• list_workspaces — Lista os workspaces visíveis para a conta
• set_active_workspace — Define o workspace ativo para a sessão
• list_projects — Lista projetos (com permissões de edição/exclusão)
• create_project — Cria um projeto

Testes

• list_tests — Lista testes (filtre por projeto / workspace / tipo)
• get_test — Obtém um teste + seu resumo de validação
• create_test — Cria um esqueleto de teste (escolha o engine/executor)
• get_test_overview — Visão geral do histórico de execuções de um teste

Arquivos de teste

• upload_test_file — Envia um arquivo de script/dados em uma única chamada (fluxo presigned real de 3 etapas)
• list_test_files — Lista os arquivos de um teste + estado do upload
• download_test_file — Obtém uma URL de download de curta duração para um arquivo

Execuções

• start_run — Inicia uma execução de carga/navegador em runners gerenciados na nuvem (idempotente)
• get_run_status — Consulta o status do ciclo de vida (na fila → em execução → aprovado/falhou/cancelado)
• list_runs — Histórico de execuções paginado com filtros
• cancel_run — Cancela uma execução (destrutivo; oculto no modo somente-leitura)
• rerun_run — Reexecuta a partir de um snapshot ou do teste atual
• add_runners — Escala uma execução ativa nos locais existentes

Resultados

• get_run_results — Visão geral de KPIs: throughput, percentis de latência, taxa de erro
• query_run_metrics — Métricas de série temporal (latência / throughput / erros / carga / saúde)
• get_run_errors — Linhas de erro agrupadas (mensagem / contagem / código)

Diagnóstico — causa raiz e detecção de anomalias

• get_run_summary — Resumo executivo + quais critérios de falha foram acionados
• get_run_error_bodies — Corpos de requisição/resposta de erro amostrados + códigos de status
• get_run_logs — Linhas de log de engine/sistema em nível de erro
• get_runner_health — Tendência de CPU/mem do runner + targetVus vs peakAchievedVus (vuShortfallPct)
• detect_run_anomalies — Varredura determinística de outliers robustos (mediana/MAD); limitada por terminal, baixa taxa de falsos positivos

Saída de emergência e descoberta

• call_platform_api — Acessa qualquer endpoint público /v1/* (segredos, ambientes, agendamentos, BYOC); admin/interno na lista de bloqueio, seguro contra SSRF
• get_openapi — O documento OpenAPI público
• search_endpoints — Busca por palavras-chave na API para encontrar o endpoint certo

Prompts

Receitas de texto que codificam a sequência correta de ferramentas — ótimas para clientes somente-chat que não conseguem ler um repositório:

• run-baseline-load-test — Inicia uma execução de baseline e a acompanha até a conclusão
• diagnose-latency-regression — Compara o p95 entre duas execuções
• summarize-run — Resumo em linguagem simples de uma execução
• plan-and-build-test — Transforma um objetivo em projeto → teste → upload → execução
• choose-executor — Recomenda um engine (k6 / JMeter / Playwright / Selenium)
• scan-endpoints-for-hotspots — Classifica possíveis hotspots a partir de uma spec OpenAPI ou lista colada
• setup-secrets-and-envs — Configura segredos do workspace + multi-ambiente antes de uma execução
• diagnose-run-failure — Causa raiz classificada para uma execução com falha
• explain-run-anomalies — Explica cada outlier detectado

Recursos

• maxoperf://openapi — A spec OpenAPI pública
• maxoperf://run/{id} — Um resumo de relatório de execução

Experimente

• "Faça um teste de carga em https://api.example.com/checkout com 500 usuários por 5 minutos e falhe se o p95 passar de 800ms."
• "Varra meu repositório em busca dos endpoints que mais valem um teste de carga e depois crie e execute um teste para o mais arriscado."
• "Por que a execução run-0000000001 falhou? Verifique os erros, os logs e se os runners realmente atingiram a carga alvo."

Combine com o cérebro

O servidor MCP é as mãos. A skill de agente MaxoPerf incluída (npx @maxoperf/agent-skill install, incluída no plugin do Claude, ou em agent-skill/ aqui) é o cérebro — ela lê seu código, encontra os hotspots, cria e executa o teste e diagnostica por que quebrou, acionando essas ferramentas automaticamente.

O que há neste repositório