# octoperf

**Category:** 📊 Monitoring  
**Repository:** https://github.com/OctoPerf/octoperf-claude-plugins  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/octoperf

## Description
Drive OctoPerf load testing from any AI agent: import, edit, validate, run scenarios, read metrics.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "octoperf": {
    "command": "npx",
    "args": ["-y","octoperf"]
  }
}
```

## Documentation & README

# OctoPerf — Claude Code plugins

[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
[![MCP docs](https://img.shields.io/badge/docs-MCP%20server-6c47ff.svg)](https://api.octoperf.com/doc/mcp/)
[![smithery badge](https://smithery.ai/badge/octoperf/octoperf)](https://smithery.ai/servers/octoperf/octoperf)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_MCP-0098FF?logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522octoperf%2522%252C%2522type%2522%253A%2522http%2522%252C%2522url%2522%253A%2522https%253A%252F%252Fapi.octoperf.com%252Fmcp%2522%257D)

Claude Code [plugin marketplace](https://code.claude.com/docs/en/plugin-marketplaces)
for the [OctoPerf](https://octoperf.com) 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](#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 eight workflow **skills** that drive the MCP tools end-to-end
  (auto-correlation, validation triage, scenario diagnosis, bench-report
  reading, PDF export, real-browser probe, scheduling, async polling);
- ships an `AGENTS.md` reference describing every MCP tool the server
  exposes.

## Install

```text
/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-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-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-export-bench-report-pdf` | "export the report as PDF", "print the bench report", "share a PDF"    |
| `octoperf-real-browser-probe`      | "EUM probe", "Playwright probe", "TruClient equivalent"                |
| `octoperf-scheduling`              | "schedule the scenario", "run every weekday at 8am"                    |
| `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](https://api.octoperf.com/doc/mcp/)**. Most
clients just need the server URL `https://api.octoperf.com/mcp`.

## License

Apache-2.0