{
  "markdown": "# artillery-mcp-plugin\n\nClaude Code plugin for [`@kosiakmd/artillery-mcp`](https://github.com/kosiakMD/artillery-mcp) — Artillery 2.x load-testing via MCP. Installs the MCP server + agent skill in one command, no manual `claude mcp add`.\n\n## What's in the box\n\n- **MCP server:** `@kosiakmd/artillery-mcp` (stdio, via `npx` — no global install required)\n- **Agent skill:** `SKILL.md` with decision tree / tool call patterns / common gotchas, auto-loaded by Claude Code when the plugin is enabled\n\n## Install\n\nIn a Claude Code session:\n\n```\n/plugin marketplace add kosiakMD/artillery-mcp-plugin\n/plugin install artillery-mcp@artillery-mcp\n```\n\nRestart your session. You now have 18 MCP tools (19 if the target project has `.artillery-mcp.config.json` for the opt-in project launcher).\n\n## Prerequisites\n\n- **Artillery CLI** on `PATH` — `npm install -g artillery@latest`. The MCP wraps it; the npm package doesn't bundle the binary.\n- **Node.js ≥ 20**\n- **`ARTILLERY_CLOUD_API_KEY`** — only if you want to record runs to Artillery Cloud. Export it in your shell before launching Claude Code, or load via a dotenv wrapper; see the [MCP README § Security](https://github.com/kosiakMD/artillery-mcp#security).\n\nPrefer Docker (no host Node/Artillery)? Skip this plugin — use the Docker variant directly as documented in the [MCP README § Docker](https://github.com/kosiakMD/artillery-mcp#docker).\n\n## What you can do after install\n\n```\nYou: \"Run a quick HTTP test against https://api.example.com at 50 req/s for 30 seconds\"\nClaude: [calls mcp__artillery-mcp__quick_test → returns summary]\n\nYou: \"Parse results.json and show me the latency breakdown\"\nClaude: [calls mcp__artillery-mcp__parse_results → formatted p50/p95/p99]\n\nYou: \"Compare baseline.json vs yesterday.json — did anything regress?\"\nClaude: [calls mcp__artillery-mcp__compare_results → diff with thresholds]\n```\n\nFull tool reference: [MCP README § tools](https://github.com/kosiakMD/artillery-mcp#18-base-tools-no-config-needed).\n\n## Optional — project launcher\n\nIf your project uses multiple named flows (e.g. `free`, `paid`, `combined` for different checkout variants), add `.artillery-mcp.config.json` at the repo root:\n\n```json\n{\n  \"flows\": { \"smoke\": \"tests/load/smoke.yml\" },\n  \"environments\": [\"local\", \"staging\", \"prod\"],\n  \"defaultTags\": { \"repo\": \"my-app\" },\n  \"tagTemplates\": [\"type:{flow}\", \"env:{env}\"],\n  \"outputDir\": \"load-test-results\"\n}\n```\n\nThen `run_project_lt` appears as a 19th tool:\n\n```\nYou: \"Run smoke on staging, note 'canary v42'\"\nClaude: [calls run_project_lt(flow=\"smoke\", environment=\"staging\", note=\"canary v42\")]\n```\n\nFull config schema: [MCP README § Full config reference](https://github.com/kosiakMD/artillery-mcp#full-config-reference). To scaffold: `npx @kosiakmd/artillery-mcp init` in your project.\n\n## Versioning\n\n| Component | Version | Where pinned |\n|---|---|---|\n| Plugin | `0.1.0` | `.claude-plugin/marketplace.json` + `plugins/artillery-mcp/.claude-plugin/plugin.json` |\n| MCP server | `^0.1` (resolves to latest `0.1.x`) | `plugins/artillery-mcp/.claude-plugin/plugin.json` → `mcpServers.artillery-mcp.args` |\n\nPlugin bumps happen for skill content / manifest changes. MCP bumps are independent and auto-picked via caret-minor.\n\n## See also\n\n- [**MCP server source**](https://github.com/kosiakMD/artillery-mcp) — runtime code, `run_report`, `run_fargate`, config loader, tests\n- [**npm package**](https://www.npmjs.com/package/@kosiakmd/artillery-mcp) — `@kosiakmd/artillery-mcp`\n- [**Docker image**](https://hub.docker.com/r/kosiakmd/artillery-mcp) — `kosiakmd/artillery-mcp:latest`\n- [**MCP Official Registry entry**](https://registry.modelcontextprotocol.io/) — `io.github.kosiakMD/artillery-mcp`\n\n## License\n\nMIT. See [LICENSE](./LICENSE).\n",
  "bytes": 3746,
  "sha": "c32505195d1bde3156abf1e2de63ee4f40387955760be4e815f05823879b61e6",
  "repo_slug": "kosiakmd/artillery-mcp-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_kosiakmd_artillery_mcp_plugin_artillery__ddf6a7e5/readme"
}