kosiakmd avatar

Artillery Mcp

kosiakmd/artillery-mcp

A drop-in replacement for the original Artillery MCP with full flag coverage for load testing workflows. Exposes `artillery run` and `artillery run-fargate` with every CLI option Artillery 2.x supports, including Cloud recording, custom tags, variable overrides, and Fargate infrastructure parameters. Parses both JSON reports and raw stdout captures to extract all counters, rates, and nested percentile summaries, not just HTTP metrics. Ships with an optional project launcher, counter grouping for custom metrics, and a multi-arch Docker image with Artillery preinstalled. Includes an init scaffolder that drops agent-oriented skill documentation and a config template into your project. Useful when you need programmatic access to Artillery's full feature set without writing wrapper scripts or manually parsing test output.

tools
19
auth
Secret needed
transport
STDIO
env vars
4
last updated
Apr 15, 2026

Tools

19 tools

Public tool metadata for what this MCP can expose to an agent.

run_test_from_fileFull-flag `artillery run` wrapper.

Full-flag `artillery run` wrapper.

No parameter schema in public metadata yet.

run_test_inlineSame as run_test_from_file but takes YAML text and writes it to a tmp file.

Same as run_test_from_file but takes YAML text and writes it to a tmp file.

No parameter schema in public metadata yet.

quick_testRuns `artillery quick <url>` with rate, count, duration, method, headers and body.

Runs `artillery quick <url>` with rate, count, duration, method, headers and body.

No parameter schema in public metadata yet.

run_fargateRuns `artillery run-fargate` with region, cluster, CPU, memory, launch-type, spot, subnet and security group options, plus all run-shared flags.

Runs `artillery run-fargate` with region, cluster, CPU, memory, launch-type, spot, subnet and security group options, plus all run-shared flags.

No parameter schema in public metadata yet.

run_preset_testRuns smoke, baseline, soak or spike presets against a URL.

Runs smoke, baseline, soak or spike presets against a URL.

No parameter schema in public metadata yet.

run_saved_configRe-runs a saved config by name.

Re-runs a saved config by name.

No parameter schema in public metadata yet.

parse_resultsReads an Artillery JSON report and returns summary, counters, rates, summaries, scenarios and metadata.

Reads an Artillery JSON report and returns summary, counters, rates, summaries, scenarios and metadata.

No parameter schema in public metadata yet.

read_artillery_outputReads a raw Artillery stdout dump and returns rawText, summaryBlock, counters, rates and metrics.

Reads a raw Artillery stdout dump and returns rawText, summaryBlock, counters, rates and metrics.

No parameter schema in public metadata yet.

run_reportConverts an existing JSON results file to HTML via `artillery report`.

Converts an existing JSON results file to HTML via `artillery report`.

No parameter schema in public metadata yet.

compare_resultsDiffs two Artillery JSON results for regression detection.

Diffs two Artillery JSON results for regression detection.

No parameter schema in public metadata yet.

save_configSaves a persistent named Artillery config.

Saves a persistent named Artillery config.

No parameter schema in public metadata yet.

list_configsLists saved Artillery configs.

Lists saved Artillery configs.

No parameter schema in public metadata yet.

get_configGets a saved Artillery config.

Gets a saved Artillery config.

No parameter schema in public metadata yet.

delete_configDeletes a saved Artillery config.

Deletes a saved Artillery config.

No parameter schema in public metadata yet.

wizard_startStarts the interactive test builder.

Starts the interactive test builder.

No parameter schema in public metadata yet.

wizard_stepAdvances the interactive test builder.

Advances the interactive test builder.

No parameter schema in public metadata yet.

wizard_finalizeFinalizes the interactive test builder.

Finalizes the interactive test builder.

No parameter schema in public metadata yet.

list_capabilitiesReturns versions of Artillery, Node and this server, configured paths and limits.

Returns versions of Artillery, Node and this server, configured paths and limits.

No parameter schema in public metadata yet.

run_project_ltProject launcher, activated when a .artillery-mcp.config.json file is discovered, for one-liner test invocations.

Project launcher, activated when a .artillery-mcp.config.json file is discovered, for one-liner test invocations.

No parameter schema in public metadata yet.

Sponsors

Configuration

ARTILLERY_WORKDIR

Absolute path to project root (walk-up from here finds .artillery-mcp.config.json).

ARTILLERY_CLOUD_API_KEYsecret

Artillery Cloud API key. Forwarded to artillery CLI when record=true.

ARTILLERY_MCP_CONFIG

Absolute path to .artillery-mcp.config.json. Enables run_project_lt + counterBreakdown when set.

ARTILLERY_TIMEOUT_MS

Max duration of a single artillery command. Default 1800000 (30min).

Readme

@kosiakmd/artillery-mcp

ci npm version license MIT

Richer drop-in MCP server for Artillery 2.x — exposes the full artillery run and artillery run-fargate flag surface, parses raw text output (artillery-output.txt), returns every counter/rate/summary Artillery produces (not just http.*), and optionally adds a config-driven project launcher and counter-grouping for your custom counters.

Why another MCP server?

The upstream @jch1887/artillery-mcp-server was a solid start but missed several flags our team needed day-to-day. This package is a MIT-licensed fork with broader coverage. See Credits.


View the full README on GitHub

Details

Repository
github.com/kosiakmd/artillery-mcp
Category
Cloud & Infrastructure
Package
@kosiakmd/artillery-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Cloud & Infrastructure MCP servers

View all
1mishaal-cloud avatarAscend GTM Gatewaymishaal-cloud/ascend-gtm-ops34-tool GTM gateway: CRMs, ad platforms, analytics, Google Workspace, AWS, and LLM orchestration.0stars
2unbearabledev avatarIAC Audit Packunbearabledev/iac-audit-packFour IaC audits in one call: Compose, Dockerfile, GitHub Actions, Kubernetes. 131 checks.0stars
3useorgx avatarOrgXuseorgx/orgx-mcpOrgX is coordination infrastructure for AI-native teams. It gives your LLM a persistent organizational layer: initiatives with milestones and tasks, human-in-th0stars
4ykshah1309 avatarGlobal Sentinel Mcpykshah1309/global-sentinel-mcpPolymarket, GDELT, OpenSky, Cloudflare Radar unified as one MCP server.0stars
5beehiveinnovations avatarPALbeehiveinnovations/pal-mcp-serverThe power of Claude Code / GeminiCLI / CodexCLI + [Gemini / OpenAI / OpenRouter / Azure / Grok / Ollama / Custom Model / All Of The Above] working as one.11.5Kstars
6skyhook-io avatarRadar Kubernetes MCP Serverskyhook-io/radarKubernetes MCP server for diagnosis, resource management, GitOps, and RBAC-enforced operations.4.1Kstars