
k6 MCP, Grafana's experimental k6 load testing server
Lets your AI assistant check and run k6 load test scripts, search the k6 docs and write scripts from plain-English requirements.
This is Grafana's server for k6, the load testing tool. It lets your assistant check a script, run a load test on your machine, browse the k6 docs and write a script from plain-English requirements. The Docker image includes k6, and the other install options need k6 on your computer. Grafana calls it experimental, so expect rough edges.
Good for
- Performance and QA engineers writing load tests
- Developers adding a first k6 test to a project
- SREs who want to try a scenario quickly before a launch
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install mcp-k6
Claude Code
- 1
Copy this prompt.
Add the mcp-k6 server to Claude Code. Run this command: claude mcp add k6 -- docker run -i --rm grafana/mcp-k6 Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Docker.
Built from the package data we hold. Not yet tested by us.
Tools
Checks a k6 script for errors without a real test
Runs your k6 script once with one virtual user and returns syntax errors, runtime problems and suggested fixes.
Try: “Validate this k6 script and fix whatever fails.”
Runs code ·
validate_scriptRuns a k6 load test on your machine
Runs a k6 script locally with the virtual users, duration or iterations you choose, then returns the output and raw metrics. The test sends real traffic to whatever the script targets.
Try: “Run this script with 20 users for 30 seconds against staging.”
Runs code ·
run_scriptBrowses the k6 documentation tree
Lists k6 documentation sections as a tree, for a chosen k6 version, without the full page text.
Try: “What sections does the k6 docs have about scenarios?”
Network ·
list_sectionsReads one k6 documentation page
Returns the full markdown of a k6 documentation section by its slug.
Try: “Show me the k6 docs page on scenarios.”
Network ·
get_documentationFinds k6 Cloud resources in the Grafana Terraform provider
Searches the installed Grafana Terraform provider schema for resources whose name matches your search term.
Try: “Which k6 Cloud resources can I manage with Terraform?”
Files ·
search_terraformShows server, k6 and k6 Cloud login status
Reports details about the mcp-k6 server, the local k6 binary and whether k6 Cloud is logged in.
Try: “Is k6 installed and am I logged in to k6 Cloud?”
Read ·
info
Read from the source code
Permissions
medium risk · 4 things to watch
Medium risk
The run tool sends real traffic from your machine to whatever the script targets. Point it at staging, not production, and check the users and duration before you approve a run.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
Load tests send real traffic
A script with many virtual users can overload a live service. Test against staging and start with a small number of users. github.com
It runs script code on your machine
Both the check and run tools execute the k6 script they are given. Read scripts the assistant writes before you approve a run. github.com
HTTP mode has no sign-in
The optional HTTP mode has no built-in authentication. Use it only on a trusted network or behind a proxy. github.com
Experimental
Grafana warns of sharp edges and asks you to keep a local clone up to date. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only switch is documented. |
|---|---|
| Talks to | Whatever your test script targets. k6 documentation (downloaded on first use and cached) |
Questions
Do I need k6 installed?
Not with Docker, because the image includes k6. The Homebrew, Linux package and source options need k6 available on your PATH to run scripts.
Does it run tests in k6 Cloud?
The README describes local runs. A separate tool only reports whether k6 Cloud is logged in on your machine.
Is it safe to point at production?
Not without care. It sends real load from your machine to the target in the script, so use staging and small numbers first.
Is it official?
Yes. It lives in Grafana's GitHub organization, and Grafana owns k6. Grafana labels it experimental.
Can I use it over HTTP for a team?
Yes, but the README says it has no built-in sign-in. Deploy it on a private network or behind a proxy that handles authentication.
How do I add it to Claude Code or Cursor?
Use the install box above. It needs Docker running.
Information
updated Nov 2, 2026
- Publisher
- Grafana Labs (official)
- Package
grafana/mcp-k6- Registry
- Docker
- Transport
- stdio
- Auth
- None
- License
- AGPL-3.0
- Last commit
- Oct 30, 2026
- Open issues
- 5
Other Grafana MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 2Hide
- mcp-k6 README · github.com
- mcp-k6 tool source · github.com