PlugWiki
mcp-k6 logo

k6 MCP, Grafana's experimental k6 load testing server

Official · by Grafana LabsLocal
GetDockergrafana/mcp-k6grafana/mcp-k6

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.

Install mcp-k6

Claude Code

  1. 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. 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_script

  • Runs 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_script

  • Browses 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_sections

  • Reads 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_documentation

  • Finds 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_terraform

  • Shows 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-onlyNo read-only switch is documented.
Talks toWhatever 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

GitHubChangelogIssues

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 2
  1. mcp-k6 README · github.com
  2. mcp-k6 tool source · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.