# io.github.kosiakMD/artillery-mcp (oci · docker.io/kosiakmd/artillery-mcp:0.1.7)

MCP server for Artillery 2.x — full flags, Fargate, raw-text parser, project launcher (MIT)

- Trust score: 39/100 (low)
- Change this week: −1
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@kosiakmd/artillery-mcp`: 46/100, [markdown](https://verifymcp.io/servers/kosiakmd-artillery-mcp/kosiakmd-artillery-mcp.md), [page](https://verifymcp.io/servers/kosiakmd-artillery-mcp/kosiakmd-artillery-mcp)
- oci · `docker.io/kosiakmd/artillery-mcp:0.1.7`: 39/100 (this document), [markdown](https://verifymcp.io/servers/kosiakmd-artillery-mcp/docker-io-kosiakmd-artillery-mcp-0-1-7.md), [page](https://verifymcp.io/servers/kosiakmd-artillery-mcp/docker-io-kosiakmd-artillery-mcp-0-1-7)
- oci · `ghcr.io/kosiakmd/artillery-mcp:0.1.7`: 37/100, [markdown](https://verifymcp.io/servers/kosiakmd-artillery-mcp/ghcr-io-kosiakmd-artillery-mcp-0-1-7.md), [page](https://verifymcp.io/servers/kosiakmd-artillery-mcp/ghcr-io-kosiakmd-artillery-mcp-0-1-7)

## Channel facts

- Registry: `oci`
- Package: `docker.io/kosiakmd/artillery-mcp:0.1.7`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 0/100
  - Malware scan not yet available for this package.
  - CVE data not yet available for this package.
  - Install-script risk not yet assessed.
  - Dependency-health data not yet available.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 110 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 64/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 1711 tokens (~95/item across 18 items; 18 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 90/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 70% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add kosiakmd-artillery-mcp -- docker run --rm -i docker.io/kosiakmd/artillery-mcp:0.1.7
```

### Codex

```bash
codex mcp add kosiakmd-artillery-mcp -- docker run --rm -i docker.io/kosiakmd/artillery-mcp:0.1.7
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "kosiakmd-artillery-mcp": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "--rm",
        "-i",
        "docker.io/kosiakmd/artillery-mcp:0.1.7"
      ],
      "enabled": true
    }
  }
}
```

### Hermes

```yaml
mcp_servers:
  kosiakmd-artillery-mcp:
    command: "docker"
    args: ["run", "--rm", "-i", "docker.io/kosiakmd/artillery-mcp:0.1.7"]
```

### Other

```json
{
  "mcpServers": {
    "kosiakmd-artillery-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "docker.io/kosiakmd/artillery-mcp:0.1.7"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 39, +3)

- [functional improvement] Stability: unverified → 0.23

### 2026-07-31 (score 36, −4)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-27 (score 40, +29)

- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Schema quality: good
- [functional] First check of Schema quality: pass
- [functional] First check of Tool coverage: 70
- [functional] First check of Schema quality: fail

### 2026-07-26 (score 11)

First indexed and scored.

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

## MCP tools (18)

### `run_test_from_file` (~359 tokens)

Run an Artillery test from a config file path (supports --record/--tags/--name/--note/-t/-e/--scenario-name/-v/--overrides/-p/--dotenv/-k/--count/-s).

Input parameters:

- `count` (number): --count: number of instances
- `cwd` (string): Working directory
- `dotenv` (string): --dotenv: env file
- `env` (object): Environment variables
- `environment` (string): -e: pick config.environments
- `extraArgs` (array): Raw extra CLI args (escape hatch)
- `insecure` (boolean): -k: allow insecure TLS
- `name` (string): --name: run name in Cloud dashboard
- `note` (string): --note: annotation
- `outputJson` (string): Path for JSON results output
- `overrides`: --overrides: JSON object or string
- `path` (string, required): Path to Artillery config file
- `payload` (string): -p: CSV payload path
- `record` (boolean): --record: stream to Artillery Cloud (uses ARTILLERY_CLOUD_API_KEY)
- `reportHtml` (string): Path for HTML report output (generated via `artillery report` after run; requires outputJson)
- `scenarioName` (string): --scenario-name
- `solo` (boolean): -s / --solo: single VU
- `tags` (string): --tags: comma-separated key:value tags
- `target` (string): -t / --target: override target URL
- `validateOnly` (boolean): Only validate config, do not run
- `variables`: -v: JSON object or string

### `run_test_inline` (~91 tokens)

Run an Artillery test from inline configuration text.

Input parameters:

- `configText` (string, required): Artillery configuration as text
- `cwd` (string): Working directory
- `env` (object): Environment variables
- `outputJson` (string): Path for JSON results output
- `reportHtml` (string): Path for HTML report output
- `validateOnly` (boolean): Only validate config, do not run

### `quick_test` (~93 tokens)

Run a quick HTTP test (if supported by Artillery).

Input parameters:

- `body` (string): Request body
- `count` (number): Total request count
- `duration` (string): Test duration (e.g., "1m")
- `headers` (object): HTTP headers
- `method` (string): HTTP method
- `rate` (number): Requests per second
- `target` (string, required): URL to test

### `list_capabilities` (~19 tokens)

Report versions, detected features, and server limits.

### `parse_results` (~32 tokens)

Parse Artillery JSON results and return summary.

Input parameters:

- `jsonPath` (string, required): Path to Artillery JSON results file

### `run_fargate` (~311 tokens)

Launch an Artillery load test on AWS ECS/Fargate (run-fargate). Requires AWS credentials and an artilleryio cluster in the target region.

Input parameters:

- `cluster` (string)
- `containerDnsServers` (string)
- `count` (number): Number of Fargate workers
- `cpu`
- `cwd` (string)
- `dotenv` (string)
- `env` (object)
- `environment` (string)
- `extraArgs` (array)
- `insecure` (boolean)
- `launchConfig` (string)
- `launchType` (string)
- `maxDuration` (string)
- `memory`
- `name` (string)
- `noAssignPublicIp` (boolean)
- `note` (string)
- `outputJson` (string)
- `overrides`
- `packages` (string)
- `path` (string, required): Path to Artillery config
- `payload` (string)
- `record` (boolean)
- `region` (string, required): AWS region, e.g. us-east-1
- `scenarioName` (string)
- `secret` (array)
- `securityGroupIds` (string)
- `spot` (boolean)
- `subnetIds` (string)
- `tags` (string)
- `target` (string)
- `taskEphemeralStorage` (number)
- `taskRoleName` (string)
- `variables`

### `read_artillery_output` (~142 tokens)

Read an Artillery stdout text dump (e.g. artillery-output.txt from CI) and extract summary block, counters, rates, nested latency metrics — without needing a JSON report. Optionally returns counterBreakdown when a project config with counterGroups is loaded.

Input parameters:

- `block` (string): Parse metrics from "summary" (last Summary report section) or "full" file. Default: summary.
- `maxBytes` (number): Truncate rawText from the head if file exceeds this many bytes (default 65536). Counters/metrics are still parsed from the full file.
- `path` (string, required): Absolute path to the text output file

### `run_report` (~86 tokens)

Convert an existing Artillery JSON results file to an HTML report via `artillery report`. Use when you have JSON (e.g. CI artifact) and want shareable HTML without re-running the test.

Input parameters:

- `jsonPath` (string, required): Absolute path to Artillery JSON results file
- `outputHtml` (string): Absolute path for generated HTML. Defaults to <jsonPath>.html

### `save_config` (~67 tokens)

Save a new Artillery configuration or update an existing one.

Input parameters:

- `content` (string, required): Artillery configuration as YAML or JSON string
- `description` (string): Optional description
- `name` (string, required): Unique name for the config
- `tags` (array): Optional tags for organization

### `list_configs` (~28 tokens)

List all saved Artillery configurations.

Input parameters:

- `tag` (string): Optional tag to filter configs by

### `get_config` (~30 tokens)

Retrieve a saved Artillery configuration by name.

Input parameters:

- `name` (string, required): Name of the config to retrieve

### `delete_config` (~28 tokens)

Delete a saved Artillery configuration.

Input parameters:

- `name` (string, required): Name of the config to delete

### `run_saved_config` (~84 tokens)

Run an Artillery test using a previously saved configuration.

Input parameters:

- `env` (object): Environment variables
- `name` (string, required): Name of the saved config to run
- `outputJson` (string): Path for JSON results output
- `reportHtml` (string): Path for HTML report output
- `validateOnly` (boolean): Only validate config, do not run

### `wizard_start` (~38 tokens)

Start a new interactive wizard for building Artillery test configurations.

Input parameters:

- `fromSavedConfig` (string): Optional saved config name to use as starting point

### `wizard_step` (~52 tokens)

Advance the wizard to the next step based on user input.

Input parameters:

- `action` (string, required): The action to perform
- `state` (object, required): The current wizard state
- `value` (required): The value for the action

### `wizard_finalize` (~78 tokens)

Generate final Artillery config from completed wizard state. Optionally save and/or run it.

Input parameters:

- `outputJson` (string): Path for JSON results output
- `reportHtml` (string): Path for HTML report output
- `runImmediately` (boolean): If true, run the test immediately
- `state` (object, required): The completed wizard state

### `run_preset_test` (~118 tokens)

Run a preset test type (smoke, baseline, soak, spike) with minimal configuration.

Input parameters:

- `body` (object): Request body for POST/PUT
- `env` (object): Environment variables
- `method` (string): HTTP method
- `outputJson` (string): Path for JSON results
- `path` (string): Endpoint path (default: /)
- `preset` (string, required): Test type preset
- `reportHtml` (string): Path for HTML report
- `target` (string, required): Target URL to test

### `compare_results` (~55 tokens)

Compare two Artillery test results to detect performance regressions.

Input parameters:

- `baselinePath` (string, required): Path to baseline JSON results
- `currentPath` (string, required): Path to current JSON results
- `thresholds` (object): Custom thresholds

## Diagnostics

Captured diagnostic sections: Provenance. The full working is on the page: https://verifymcp.io/servers/kosiakmd-artillery-mcp/docker-io-kosiakmd-artillery-mcp-0-1-7#diagnostics

## Score history

- 2026-08-03: 39
- 2026-08-02: 36
- 2026-08-01: 36
- 2026-07-31: 36
- 2026-07-30: 40
- 2026-07-29: 40
- 2026-07-28: 40
- 2026-07-27: 40
- 2026-07-26: 11

## Links

- Repository: https://github.com/kosiakMD/artillery-mcp
- Changelog RSS feed: https://verifymcp.io/servers/kosiakmd-artillery-mcp/docker-io-kosiakmd-artillery-mcp-0-1-7/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/kosiakmd-artillery-mcp/docker-io-kosiakmd-artillery-mcp-0-1-7/changelog.json
- HTML version of this page: https://verifymcp.io/servers/kosiakmd-artillery-mcp/docker-io-kosiakmd-artillery-mcp-0-1-7