calculate_workload_model

Compute required thread concurrency, pacing delays, ramp-up schedules, and JVM heap recommendations based on target RPS/TPS and SLA response times using Little's Law.

Argument	Type	Description
targetRps*	number	Target throughput in requests / transactions per second (RPS/TPS).
thinkTimeMs	number	Think time / user pause between requests in milliseconds (default: 0).
safetyFactor	number	Headroom safety buffer multiplier (default: 1.25 = 25% buffer).
avgResponseTimeMs*	number	Expected average response time in milliseconds.
testDurationMinutes	number	Steady-state test duration in minutes (default: 10).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "targetRps",
    "avgResponseTimeMs"
  ],
  "properties": {
    "targetRps": {
      "type": "number",
      "description": "Target throughput in requests / transactions per second (RPS/TPS).",
      "exclusiveMinimum": 0
    },
    "thinkTimeMs": {
      "type": "number",
      "minimum": 0,
      "description": "Think time / user pause between requests in milliseconds (default: 0)."
    },
    "safetyFactor": {
      "type": "number",
      "minimum": 1,
      "description": "Headroom safety buffer multiplier (default: 1.25 = 25% buffer)."
    },
    "avgResponseTimeMs": {
      "type": "number",
      "description": "Expected average response time in milliseconds.",
      "exclusiveMinimum": 0
    },
    "testDurationMinutes": {
      "type": "number",
      "description": "Steady-state test duration in minutes (default: 10).",
      "exclusiveMinimum": 0
    }
  }
}

convert_curl_or_har_to_jmx

Convert one or more cURL commands or HAR (HTTP Archive 1.2) JSON traces into a valid, production-ready Apache JMeter .jmx test plan XML with HTTP Request Defaults, Header Managers, Cookie Managers, timeouts, and assertions. Supports GET, POST, PUT, DELETE, PATCH, and RFC 9838 QUERY methods.

Argument	Type	Description
input*	string	cURL command string (single, multiline, or batch) or HAR 1.2 JSON text (max 1MB).
threads	integer	Thread concurrency / virtual users (default: 1).
loopCount	integer	Loop count (-1 for infinite, default: 1).
testPlanName	string	Name of the JMeter Test Plan (default: "cURL Converted Plan").
rampUpSeconds	integer	Ramp-up time in seconds (default: 1).
durationSeconds	integer	Test duration in seconds (0 = disabled, default: 0).
parameterizeAuth	boolean	Extract Bearer token into ${AUTH_TOKEN} variable (default: true).
parameterizeHost	boolean	Extract common host into HTTP Request Defaults and ${BASE_URL} (default: true).

convert_openapi_to_jmx

Convert an OpenAPI 3.0/3.1 or Swagger 2.0 document (JSON or YAML) into a JMeter 5.6.3 .jmx test plan: servers become HTTP Request Defaults/${BASE_URL}, path parameters become User Defined Variables, request bodies are sampled from schemas, bearer/basic/apiKey security becomes ${AUTH_TOKEN}/${BASIC_AUTH}/${API_KEY}, with optional method, tag, and deprecated-operation filters.

Argument	Type	Description
tags	array	Only include operations with one of these tags ("default" = untagged). Empty = all.
input*	string	OpenAPI 3.x or Swagger 2.0 document as JSON or YAML text (max 1MB).
methods	array	HTTP methods to include (default: GET, POST, PUT, PATCH, DELETE).
threads	integer	Thread concurrency / virtual users (default: 10).
loopCount	integer	Loop count (-1 for infinite, default: 1).
serverIndex	integer	Zero-based index of the OpenAPI server to use (default: 0).
testPlanName	string	Name of the JMeter Test Plan.
maxOperations	integer	Maximum number of operations to convert (default: 500).

get_correlation_sandbox

Generate a ready-to-run Apache JMeter 5.6.3 .jmx practice test plan (either "solved" with Boundary/JSON/Header extractors or "challenge" with broken hardcoded tokens) targeting the live docs.jmeter.ai/api/sandbox endpoints or local localhost:8787 server.

Argument	Type	Description
mode	string	"solved" returns a working correlated .jmx plan; "challenge" returns a broken plan with hardcoded recorded tokens for debugging practice. Default: "solved".
flowId	string	Practice flow: "flow1" (CSRF + Cookie), "flow2" (JWT Bearer + Order chain), "flow3" (ASP.NET __VIEWSTATE + Header ticket), or "flow4" (HTTP 429 & JSON Assertion chaos). Default: "flow1".
target	string	"edge" targets https://docs.jmeter.ai/api/sandbox (1-thread debug); "local" targets http://localhost:8787/api/sandbox (high-RPS). Default: "edge".

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "mode": {
      "enum": [
        "solved",
        "challenge"
      ],
      "type": "string",
      "description": "\"solved\" returns a working correlated .jmx plan; \"challenge\" returns a broken plan with hardcoded recorded tokens for debugging practice. Default: \"solved\"."
    },
    "flowId": {
      "enum": [
        "flow1",
        "flow2",
        "flow3",
        "flow4"
      ],
      "type": "string",
      "description": "Practice flow: \"flow1\" (CSRF + Cookie), \"flow2\" (JWT Bearer + Order chain), \"flow3\" (ASP.NET __VIEWSTATE + Header ticket), or \"flow4\" (HTTP 429 & JSON Assertion chaos). Default: \"flow1\"."
    },
    "target": {
      "enum": [
        "edge",
        "local"
      ],
      "type": "string",
      "description": "\"edge\" targets https://docs.jmeter.ai/api/sandbox (1-thread debug); \"local\" targets http://localhost:8787/api/sandbox (high-RPS). Default: \"edge\"."
    }
  }
}

get_jmeter_page

Fetch the full markdown text of one docs.jmeter.ai page. Accepts the page URL (e.g. https://docs.jmeter.ai/topics/api-load-testing/) or a bare path (e.g. topics/api-load-testing).

Argument	Type	Description
url*	string	Page URL or path, e.g. https://docs.jmeter.ai/user-manual/functions/ or user-manual/functions

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "minLength": 1,
      "description": "Page URL or path, e.g. https://docs.jmeter.ai/user-manual/functions/ or user-manual/functions"
    }
  }
}

get_jsr223_recipe

Fetch production-ready, performant Groovy scripts for JMeter JSR223 samplers, preprocessors, and postprocessors (e.g., JWT parsing & expiration, HMAC-SHA256 signing, dynamic header injection, nested JSON array extraction, custom CSV failure logging).

Argument	Type	Description
query	string	Filter by keyword or topic (e.g. "jwt", "hmac", "header", "json", "csv", "logging"). If omitted, returns all recipes.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "query": {
      "type": "string",
      "description": "Filter by keyword or topic (e.g. \"jwt\", \"hmac\", \"header\", \"json\", \"csv\", \"logging\"). If omitted, returns all recipes."
    }
  }
}

lint_groovy_script

Statically analyze a Groovy script for a JMeter JSR223 element. Flags Thread.sleep, ${var} interpolation, System.out, BeanShell APIs, per-call Random or Pattern.compile, and bindings such as prev, SampleResult, or sampler that the selected element type does not expose; optionally returns ready-to-paste JMX element XML.

Argument	Type	Description
code*	string	Groovy script source.
name	string	testname for the generated JMX element (default: element label).
parameters	string	Space-separated parameters available through Parameters and args.
elementType	string	(default: JSR223PostProcessor)
includeJmxElement	boolean	Also return the JSR223 element XML with compilation caching enabled (default: true).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "maxLength": 200000,
      "minLength": 1,
      "description": "Groovy script source."
    },
    "name": {
      "type": "string",
      "maxLength": 120,
      "description": "testname for the generated JMX element (default: element label)."
    },
    "parameters": {
      "type": "string",
      "maxLength": 2000,
      "description": "Space-separated parameters available through Parameters and args."
    },
    "elementType": {
      "enum": [
        "JSR223Sampler",
        "JSR223PreProcessor",
        "JSR223PostProcessor",
        "JSR223Assertion",
        "JSR223Timer",
        "JSR223Listener"
      ],
      "type": "string",
      "description": "(default: JSR223PostProcessor)"
    },
    "includeJmxElement": {
      "type": "boolean",
      "description": "Also return the JSR223 element XML with compilation caching enabled (default: true)."
    }
  }
}

lint_jmx_snippet

Validate a JMeter test plan XML string or snippet against best practices and performance anti-patterns, and return a structural inventory with thread groups, sampler/listener/assertion counts, HTTP Defaults/Header/Cookie/CSV presence, plugin classes, and JMeter version.

Argument	Type	Description
jmxContent*	string	JMX XML string or test plan snippet to analyze (max 1MB).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "jmxContent"
  ],
  "properties": {
    "jmxContent": {
      "type": "string",
      "maxLength": 1000000,
      "minLength": 1,
      "description": "JMX XML string or test plan snippet to analyze (max 1MB)."
    }
  }
}

lookup_component

Find the dedicated reference page for a JMeter test plan component (e.g. "HTTP Request", "JSON Extractor", "Thread Group") and return its full markdown content with properties, defaults, and related guides.

Argument	Type	Description
name*	string	Component name, exact or partial (e.g. "HTTP Request", "JSON Extractor", "CSV Data Set").

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Component name, exact or partial (e.g. \"HTTP Request\", \"JSON Extractor\", \"CSV Data Set\")."
    }
  }
}

lookup_error_playbook

Get immediate root causes, OS/JVM config fixes, and remediation steps for common JMeter exceptions (e.g. "BindException", "SocketTimeoutException", "OutOfMemoryError", "NoHttpResponseException", "SSLHandshakeException", "401/403 after recording"). When keywords miss, unmatched text is sent to classifier.dev for zero-shot semantic matching (public keyless calls are not stored).

Argument	Type	Description
query*	string	Error message, exception name, or status (e.g. "bindexception", "heap", "timeout", "401").
classifierApiKey	string	Your own classifier.dev API key for the semantic fallback (anonymous quota is shared); never logged.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Error message, exception name, or status (e.g. \"bindexception\", \"heap\", \"timeout\", \"401\")."
    },
    "classifierApiKey": {
      "type": "string",
      "description": "Your own classifier.dev API key for the semantic fallback (anonymous quota is shared); never logged."
    }
  }
}

lookup_function

Find the dedicated reference page for a built-in JMeter function (e.g. "__time", "__Random", "__P") and return its full markdown content with syntax, parameters, and examples.

Argument	Type	Description
name*	string	Function name, with or without leading underscores (e.g. "__time", "time", "__RandomString").

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Function name, with or without leading underscores (e.g. \"__time\", \"time\", \"__RandomString\")."
    }
  }
}

lookup_jmeter_property

Search or lookup curated JMeter properties (e.g. "httpclient4.idletimeout", "jmeter.save.saveservice.*", "remote_hosts", "summariser"). Returns category, defaults, and recommendations.

Argument	Type	Description
query*	string	Property name or keyword to search (e.g. "ssl", "timeout", "jtl", "influxdb").

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Property name or keyword to search (e.g. \"ssl\", \"timeout\", \"jtl\", \"influxdb\")."
    }
  }
}

plan_distributed_testing

Generate Master-Worker RMI port assignments, user.properties, CLI commands, firewall/security group rules, and Docker Compose manifests for distributed load testing.

Argument	Type	Description
mode	string	Sample transmission mode (default: "StrippedBatch").
workerIps*	string	Comma or space-separated list of worker / injector IP addresses (e.g. "10.0.1.10, 10.0.1.11, 10.0.1.12").
disableSsl	boolean	Disable RMI SSL (default: false). Only for isolated labs.
serverPort	integer	RMI registry port on workers (default: 1099).
environment	string	Target infrastructure environment for firewall/CLI rules (default: "aws").
controllerIp	string	Controller / Master node IP or hostname (default: "10.0.0.5").
clientRmiLocalPort	integer	Pinned controller callback port (default: 60000).
serverRmiLocalPort	integer	Pinned worker engine port (default: 50000).

Input schema (JSON)

search_jmeter_docs

Search the Apache JMeter documentation on docs.jmeter.ai. Returns the most relevant pages with titles, URLs, and snippets. Use for any question about JMeter test plans, components, functions, properties, distributed testing, reports, or troubleshooting.

Argument	Type	Description
query*	string	Search query, e.g. "how to correlate dynamic values" or "thread group ramp up"

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Search query, e.g. \"how to correlate dynamic values\" or \"thread group ramp up\""
    }
  }
}

triage_errors

Map a run's distinct failure signatures to docs.jmeter.ai error playbooks. Error text is sent to classifier.dev for zero-shot classification (public keyless calls are not stored; obvious secrets are redacted first). Prefer signatures shaped as "sampler | response code | response message".

Argument	Type	Description
tier	string	Classifier tier (default: "fast"). "smart" re-asks only signatures below minConfidence (slower).
errors*	array	Distinct error signatures to triage.
minConfidence	number	Confidence threshold for auto-bucketing a signature to a playbook (default: 0.7).
classifierApiKey	string	Your own classifier.dev API key (anonymous quota is shared); never logged.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "errors"
  ],
  "properties": {
    "tier": {
      "enum": [
        "fast",
        "smart"
      ],
      "type": "string",
      "description": "Classifier tier (default: \"fast\"). \"smart\" re-asks only signatures below minConfidence (slower)."
    },
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "text"
        ],
        "properties": {
          "text": {
            "type": "string",
            "maxLength": 2000,
            "minLength": 1,
            "description": "One distinct failure signature, ideally \"sampler | response code | response message\"."
          },
          "count": {
            "type": "integer",
            "maximum": 9007199254740991,
            "minimum": 0,
            "description": "How many samples showed this signature (default: 1)."
          }
        }
      },
      "maxItems": 1000,
      "minItems": 1,
      "description": "Distinct error signatures to triage."
    },
    "minConfidence": {
      "type": "number",
      "maximum": 1,
      "minimum": 0,
      "description": "Confidence threshold for auto-bucketing a signature to a playbook (default: 0.7)."
    },
    "classifierApiKey": {
      "type": "string",
      "description": "Your own classifier.dev API key (anonymous quota is shared); never logged."
    }
  }
}

tune_linux_os

Generate production sysctl.conf, limits.conf, systemd overrides, and Docker/K8s configs tuned for high-concurrency JMeter load testing (fixing ulimit nofile, BindException port exhaustion, somaxconn backlog, and JVM swappiness).

Argument	Type	Description
role	string	Machine role: "injector" (JMeter client) or "target_sut" (default: "injector").
ramGb	integer	Host machine RAM in GB for TCP buffer sizing (default: 16).
concurrency	integer	Target concurrent connections/threads (default: 10000).
trafficType	string	Traffic profile (default: "http_churn").
targetDistro	string	Linux distro or container target (default: "ubuntu_debian").

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "role": {
      "enum": [
        "injector",
        "target_sut"
      ],
      "type": "string",
      "description": "Machine role: \"injector\" (JMeter client) or \"target_sut\" (default: \"injector\")."
    },
    "ramGb": {
      "type": "integer",
      "maximum": 512,
      "minimum": 2,
      "description": "Host machine RAM in GB for TCP buffer sizing (default: 16)."
    },
    "concurrency": {
      "type": "integer",
      "maximum": 500000,
      "minimum": 100,
      "description": "Target concurrent connections/threads (default: 10000)."
    },
    "trafficType": {
      "enum": [
        "http_churn",
        "http_keepalive",
        "streaming_ws_grpc"
      ],
      "type": "string",
      "description": "Traffic profile (default: \"http_churn\")."
    },
    "targetDistro": {
      "enum": [
        "ubuntu_debian",
        "rhel_rocky",
        "amazon_linux",
        "docker_k8s"
      ],
      "type": "string",
      "description": "Linux distro or container target (default: \"ubuntu_debian\")."
    }
  }
}

JMeter Docs

Try it

calculate_workload_model

JMeter Docs

Try it

calculate_workload_model

Tools (16)