About octoperf
OctoPerf provides a hosted MCP server for managing load tests, with a Claude Code plugin that adds workflow skills and tool documentation. It is for teams and agents that create, run, and review OctoPerf load-testing scenarios.
Key features
- 01Manage workspaces, projects, and scenarios
- 02Import recordings and test scripts
- 03Compose and schedule load-test scenarios
- 04Validate tests and diagnose failures
- 05Review bench metrics and reports
- 06Install 22 workflow skills
Use cases
- 01Import a HAR recording or K6 script
- 02Migrate an existing load test
- 03Set scenario load shapes and SLAs
- 04Investigate test errors and response times
MCP support
The hosted OctoPerf MCP server uses Streamable HTTP and OAuth 2.1, and connects to any MCP client. The Claude Code plugin registers the server and provides skills and a tool reference.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.octoperf.com/mcpclaude mcp add --transport http octoperf-octoperf https://api.octoperf.com/mcp{"mcpServers":{"octoperf-octoperf":{"type":"http","url":"https://api.octoperf.com/mcp"}}}Open in Cursor{"servers":{"octoperf-octoperf":{"type":"http","url":"https://api.octoperf.com/mcp"}}}Open in VS Code{"mcpServers":{"octoperf-octoperf":{"type":"http","url":"https://api.octoperf.com/mcp"}}}{"mcpServers":{"octoperf-octoperf":{"serverUrl":"https://api.octoperf.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEOctoPerf — Claude Code plugins
Claude Code plugin marketplace for the OctoPerf load-testing platform.
Not using Claude Code? The OctoPerf MCP server is a hosted, client-agnostic remote server (
https://api.octoperf.com/mcp, Streamable HTTP, OAuth 2.1 — no API key). It works with any MCP client. This repo is just the one-step Claude Code entry point — see Other clients below.
This repo distributes one plugin (octoperf) that:
- registers the hosted OctoPerf MCP server (
https://api.octoperf.com/mcp, Streamable HTTP, OAuth 2.1 + PKCE + DCR — no API key); - installs twenty-two workflow skills that drive the MCP tools end-to-end (recording & import, K6 scripting, migration from BlazeMeter / Gatling / LoadRunner / NeoLoad, correlation, validation, scenario composition, SLAs, monitoring, bench reports, scheduling, notifications, on-premise agents, workspaces…);
- ships an
AGENTS.mdreference describing every MCP tool the server exposes.
Install
/plugin marketplace add OctoPerf/octoperf-claude-plugins
/plugin install octoperf@octoperf
The first MCP call opens a browser for OAuth login on api.octoperf.com.
Revoke at any time from Account → Connected applications on OctoPerf.
What you get
| Component | Location | Purpose |
|---|---|---|
| MCP server | plugins/octoperf/.mcp.json | Tools to manage workspaces, projects, VUs, scenarios, bench results |
| AGENTS.md | plugins/octoperf/AGENTS.md | Full MCP tool catalogue (also served as octoperf://templates/agents-md) |
| Skills | plugins/octoperf/skills/*/SKILL.md | Workflow recipes invoked on natural-language triggers |
Skills
| Skill | Triggers on |
|---|---|
octoperf-har-recording | "record my application", "capture a HAR", "import this .har" |
octoperf-jtl-import | "import my JTL", "analyse these JMeter results" |
octoperf-k6-scripting | "import my K6 script", "run my k6 test on OctoPerf" |
octoperf-blazemeter-migration | "migrate from BlazeMeter", "convert my Taurus test" |
octoperf-gatling-migration | "migrate from Gatling", "convert my Gatling simulation" |
octoperf-loadrunner-migration | "migrate from LoadRunner", "convert a .usr script" |
octoperf-neoload-migration | "migrate from NeoLoad", "convert a .nlp project" |
octoperf-auto-correlation | "correlate the VU", "fix replay errors", "401/403 on replay" |
octoperf-validation-triage | "the validation is red", "lots of errors after import" |
octoperf-scenario-composition | "build a scenario", "ramp-up / load shape", "user profiles" |
octoperf-sla | "define an SLA", "fail the test if response time > X" |
octoperf-monitoring | "monitor my servers during the test", "add a database monitor" |
octoperf-scenario-diagnosis | "the load test failed", "why are response times so high" |
octoperf-bench-reports | "what's the right tool for this widget", widget metric questions |
octoperf-report-item-editing | "change the metrics of this report widget", "add a filter" |
octoperf-export-bench-report-pdf | "export the report as PDF", "print the bench report" |
octoperf-real-browser-probe | "EUM probe", "Playwright probe", "TruClient equivalent" |
octoperf-scheduling | "schedule the scenario", "run every weekday at 8am" |
octoperf-notifications | "notify Slack when a test fails", "open a JIRA ticket on failure" |
octoperf-onpremise-agent | "run from my own machines", "install an on-premise agent" |
octoperf-workspace | "add someone to the workspace", "change member permissions" |
octoperf-async-polling | invoked automatically by any skill that has to poll a taskId result |
Other clients
The MCP server is not Claude-specific. To connect Claude.ai, Claude Desktop,
Cursor, ChatGPT, Codex, Gemini CLI, GitHub Copilot — or any other MCP client —
see the MCP server documentation. Most
clients just need the server URL https://api.octoperf.com/mcp.
License
Apache-2.0
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.