
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 toolsPublic 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_WORKDIRAbsolute path to project root (walk-up from here finds .artillery-mcp.config.json).
ARTILLERY_CLOUD_API_KEYsecretArtillery Cloud API key. Forwarded to artillery CLI when record=true.
ARTILLERY_MCP_CONFIGAbsolute path to .artillery-mcp.config.json. Enables run_project_lt + counterBreakdown when set.
ARTILLERY_TIMEOUT_MSMax duration of a single artillery command. Default 1800000 (30min).
Readme
@kosiakmd/artillery-mcp
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.
Details
- Repository
- github.com/kosiakmd/artillery-mcp
- Category
- Cloud & Infrastructure
- Package
@kosiakmd/artillery-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active