Maxoperf MCP server

⚡ MaxoPerf MCP Server

Drive the entire MaxoPerf platform from any AI agent — with your API key.

A remote, hosted Model Context Protocol server that turns Claude, Cursor, Codex, VS Code Copilot, and ChatGPT into a full performance-testing operator. Create tests, launch load runs on managed cloud runners, read results, and get root-cause analysis — all in natural language, all authenticated with your own key.

https://app.maxoperf.com/mcp

Configuration

It's a remote, hosted server — nothing to install or run. Add this to your MCP client config and set MAXOPERFAPIKEY (create one in the console → Settings → API keys):

{
  "mcpServers": {
    "maxoperf": {
      "type": "http",
      "url": "https://app.maxoperf.com/mcp",
      "headers": {
        "Authorization": "Bearer ${MAXOPERF_API_KEY}"
      }
    }
  }
}

Your key is validated on every call by the real platform (auth, tenancy, OpenFGA, audit) — the server stores nothing and adds no new trust boundary. Revoke the key, access dies instantly. Send the header X-MaxoPerf-MCP-Mode: read-only for a look-but-don't-touch session (write tools hidden).

Install (pick your client)

Claude Code — the plugin bundles the server and the agent skill:

/plugin marketplace add MaxoPerf/mcp
/plugin install maxoperf

Or add just the connector:

claude mcp add --transport http maxoperf https://app.maxoperf.com/mcp \
  --header "Authorization: Bearer ${MAXOPERF_API_KEY}"

Cursor · VS Code / Copilot · Codex · ChatGPT · Claude Desktop — one-click deeplinks and copy-paste config in packaging/. All use the same mcpServers block above.

Tools

29 curated tools. Reads default to responseformat: "concise" (pass "detailed" for the full payload); write tools require a non-read-only session, and cancelrun is hidden in read-only mode.

Context & tenancy

• whoami — Resolve the account + default workspace behind your API key
• list_workspaces — List workspaces visible to the account
• setactiveworkspace — Set the active workspace for the session
• list_projects — List projects (with edit/delete permissions)
• create_project — Create a project

Tests

• list_tests — List tests (filter by project / workspace / type)
• get_test — Get one test + its validation summary
• create_test — Create a test shell (choose the engine/executor)
• gettestoverview — Run-history overview for a test

Test files

• uploadtestfile — Upload a script/data file in one call (real 3-step presigned flow)
• listtestfiles — List a test's files + upload state
• downloadtestfile — Get a short-lived download URL for a file

Runs

• start_run — Launch a load/browser run on managed cloud runners (idempotent)
• getrunstatus — Poll lifecycle status (queued → running → passed/failed/cancelled)
• list_runs — Paginated run history with filters
• cancel_run — Cancel a run (destructive; hidden in read-only)
• rerun_run — Re-run from a snapshot or the current test
• add_runners — Scale a live run up at existing locations

Results

• getrunresults — KPI overview: throughput, latency percentiles, error rate
• queryrunmetrics — Time-series metrics (latency / throughput / errors / load / health)
• getrunerrors — Grouped error rows (message / count / code)

Shortened. The full README is on GitHub.