Tools¶
The rampa MCP server provides six tools for load test lifecycle management, metric retrieval, and threshold evaluation.
Start a new load test from a script path.
Gracefully stop a running test.
Poll whether a run is active or completed.
List all active and completed runs.
Retrieve metric snapshots with percentiles.
Evaluate threshold pass/fail results.
Run Lifecycle mutating¶
start_run¶
Start a load test from a Python script.
Start a new load test from a script path. Returns the run_id and
initial status.
Parameters
Parameter |
Type |
Required |
Default |
Description |
|---|---|---|---|---|
|
t.Annotated[str, Field(description='Path to the test script.')] |
yes |
— |
— |
|
t.Annotated[int | |
no |
— |
— |
|
t.Annotated[str | |
no |
— |
— |
|
t.Annotated[str | |
no |
— |
— |
stop_run¶
Stop a running load test. Idempotent.
Gracefully stop a running test. Idempotent — calling on a completed
run returns already_completed.
Parameters
get_status¶
list_runs¶
Metrics readonly¶
get_metrics¶
Get metrics for a test run. Optionally filter by metric name.
Retrieve the latest metric snapshot for a run. Without a
metric_name filter, returns all metrics including timing
percentiles, counters, and rates.
Parameters
Thresholds readonly¶
get_thresholds¶
Get threshold evaluation results for a test run.
Evaluate threshold results for a completed run. Returns pass/fail status with actual vs expected values for each threshold expression.
Parameters
Parameter |
Type |
Required |
Default |
Description |
|---|---|---|---|---|
|
t.Annotated[str, Field(description='The run identifier.')] |
yes |
— |
— |