Skip to main content
Glama

Run k6 Load Test

k6_run_test

Execute a k6 performance test. Returns an execution ID for polling status. Supports overriding VUs, duration, and thresholds.

Input Schema

NameRequiredDescriptionDefault
vusNoNumber of virtual users (overrides script default)
contextNoExplain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): "Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization."
durationNoTest duration (e.g., '30s', '5m')
env_varsNoEnvironment variables for the test
script_idYesk6 script ID to execute

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The annotations already declare readOnlyHint=false, destructiveHint=false and openWorldHint=true, so the safety profile is covered. The description adds genuinely useful context with the async execution model (an execution ID returned for polling), but it does not say whether the call blocks, how long a load test runs, or what happens on failure, and it advertises overriding "thresholds" with no corresponding parameter.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three short sentences with the verb and resource front-loaded, and no filler. The only wasted clause is the "thresholds" override, which does not map to any documented parameter.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description correctly states the return value (an execution ID) and the polling model, which is what an agent needs to chain into k6_check_status. Gaps remain around blocking behavior and result retrieval, but for a five-parameter run tool the essentials are present.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the parameter documentation burden is already met. The description tentatively maps to vus and duration, but its claim of overriding "thresholds" has no matching parameter in the schema, creating a small mismatch rather than adding clarity. Baseline 3 is appropriate when the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ("Execute a k6 performance test") that clearly distinguishes it from k6 script-management siblings like k6_create_script, k6_list_scripts and k6_get_script. It does not explicitly contrast with other run-type siblings such as run_tests or run_native_test, but the k6 qualifier does most of the disambiguation work.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

"Returns an execution ID for polling status" implicitly points at k6_check_status as the follow-up tool, which is useful implied usage. However, there is no explicit when-to-use, no prerequisites (auth profiles, environment targets), and no statement about which alternative to pick versus run_tests or test_deployed_environment.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources