The BlazeMeter connector lets your AI agent act in each user's BlazeMeter account. Each user connects their own BlazeMeter API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 56 tools.
- Tools
- 56
- What they doRead · write · destructive
- 29 · 18 · 929 read18 write9 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the BlazeMeter connection
In AgentKit > Connections, create a BlazeMeter connection. The name you give it is the
connection_nameyour code passes. See Configure connections.
Tools
Pass the exact name toexecute_toolblazemeter_folder_files_listList the files in a shared folder.Read-onlyList Shared Folder Files
List the files in a shared folder. Returns files with name, size, lastModified and a download link. Use this to see shared data files.
Inputs
folder_idstringrequired- Shared folder ID. Example: 5b96c41fad67294528f03df8.
blazemeter_folders_listList shared folders (files shared across tests) in a workspace.Read-onlyList Shared Folders
List shared folders (files shared across tests) in a workspace. Returns folders with id, name and file count. Use this to find shared data files.
Inputs
workspace_idintegerrequired- Workspace ID. Example: 123456.
limitinteger- Maximum number of items to return. Example: 20.
skipinteger- Number of items to skip. Example: 0.
sortstring- Sort field; prefix with - for descending (sent as sort[]). Example: -updated.
blazemeter_master_errors_getGet errors of a test run grouped by label, response code and message.Read-onlyGet Error Statistics
Get errors of a test run grouped by label, response code and message. Returns labels with errors, assertions and failed embedded resources, each with counts. Use this to debug failures.
Inputs
master_idintegerrequired- Master (test run) ID. Example: 12345678.
blazemeter_master_getGet one master (test run).Read-onlyGet Master
Get one master (test run). Returns the run with test, status, start/end times, max users, locations, sessions and pass/fail result. Use this for run details. Use blazemeter_master_summary_get for results.
Inputs
master_idintegerrequired- Master (test run) ID. Example: 12345678.
blazemeter_master_logs_listList the log files of a test run session (engine and JMeter logs).Read-onlyList Session Logs
List the log files of a test run session (engine and JMeter logs). Returns log files with filename, dataUrl and location. Use this to download logs. Session IDs come from blazemeter_master_get.
Inputs
session_idstringrequired- Session ID (from the master's sessions). Example: r-v4-5c7e9d133be89.
blazemeter_master_request_stats_getGet aggregate request statistics per label (transaction) for a test run.Read-onlyGet Request Statistics
Get aggregate request statistics per label (transaction) for a test run. Returns labels with samples, average/median/90th/95th/99th response times, latency, throughput, errors count and rate. Use this to find slow requests.
Inputs
master_idintegerrequired- Master (test run) ID. Example: 12345678.
blazemeter_master_status_getGet the live status of a test run.Read-onlyGet Master Status
Get the live status of a test run. Returns status (e.g. CREATED, BOOTING, DATA_RECEIVED, ENDED), progress and per-session engine state. Use this to poll a run after blazemeter_test_start.
Inputs
master_idintegerrequired- Master (test run) ID. Example: 12345678.
eventsboolean- Include status events. Example: false.
levelstring- Detail level, e.g. INFO or DEBUG. Example: INFO.
blazemeter_master_summary_getGet the summary statistics of a test run.Read-onlyGet Run Summary
Get the summary statistics of a test run. Returns summary with hits, failed, avg/min/max/90th-percentile response time, throughput, bytes, concurrency and duration. Use this for headline results. Use blazemeter_master_request_stats_get per label.
Inputs
master_idintegerrequired- Master (test run) ID. Example: 12345678.
blazemeter_master_thresholds_getGet failure-criteria (threshold) results for a test run.Read-onlyGet Threshold Results
Get failure-criteria (threshold) results for a test run. Returns each threshold with field, operator, value, label and whether it passed. Use this to see why a run failed its criteria.
Inputs
master_idintegerrequired- Master (test run) ID. Example: 12345678.
blazemeter_master_timeline_kpis_listList the time-series KPIs and labels available for a test run.Read-onlyList Timeline KPIs
List the time-series KPIs and labels available for a test run. Returns a tree of KPIs (virtual users, hits, errors, response time...) with label IDs. Use this before reading time-series data.
Inputs
master_idintegerrequired- Master (test run) ID. Example: 12345678.
blazemeter_masters_listList masters (test runs) by test, multi-test, project or workspace, optionally by pass/fail and time range.Read-onlyList Masters
List masters (test runs) by test, multi-test, project or workspace, optionally by pass/fail and time range. Returns masters with id, name, testId, created, ended, reportStatus (pass/fail), locations and maxUsers. Use this to find test runs. Use blazemeter_master_get for one.
Inputs
collection_idinteger- Runs of this multi-test. Example: 12345678.
end_timeinteger- Runs started before this Unix time. Example: 1767830400.
limitinteger- Maximum number of items to return. Example: 20.
namestring- Filter by part of the name. Example: Checkout.
passedboolean- Only passed (true) or failed (false) runs. Example: false.
project_idinteger- Project ID. Provide workspace_id or project_id. Example: 123456.
skipinteger- Number of items to skip. Example: 0.
sortstring- Sort field; prefix with - for descending (sent as sort[]). Example: -updated.
start_timeinteger- Runs started after this Unix time. Example: 1767225600.
test_idinteger- Runs of this test. Example: 1234567.
workspace_idinteger- Workspace ID. Provide workspace_id or project_id. Example: 123456.
blazemeter_multi_test_getGet one multi-test.Read-onlyGet Multi-Test
Get one multi-test. Returns the collection with its tests, executions and settings. Use this to read a multi-test.
Inputs
collection_idintegerrequired- Multi-test (collection) ID. Example: 12345678.
populate_testsboolean- Include the full test objects. Example: true.
blazemeter_multi_tests_listList multi-tests (collections of tests run together) in a project or workspace.Read-onlyList Multi-Tests
List multi-tests (collections of tests run together) in a project or workspace. Returns multi-tests with id, name, projectId, tests and lastRunTime. Use this to find a multi-test.
Inputs
limitinteger- Maximum number of items to return. Example: 20.
namestring- Filter by part of the name. Example: Checkout.
project_idinteger- Project ID. Provide workspace_id or project_id. Example: 123456.
skipinteger- Number of items to skip. Example: 0.
sortstring- Sort field; prefix with - for descending (sent as sort[]). Example: -updated.
workspace_idinteger- Workspace ID. Provide workspace_id or project_id. Example: 123456.
blazemeter_private_location_agents_listList the agents (servers) of a private location.Read-onlyList Private Location Agents
List the agents (servers) of a private location. Returns agents with id, name, address, state and last heartbeat. Use this to check that load generators are online.
Inputs
harbor_idstringrequired- Private location (harbor) ID. Example: 5d1641a21726d36d4632fd34.
blazemeter_private_location_getGet one private location.Read-onlyGet Private Location
Get one private location. Returns its name, type, slots, engine settings and workspaces. Use this when you know the ID.
Inputs
harbor_idstringrequired- Private location (harbor) ID. Example: 5d1641a21726d36d4632fd34.
blazemeter_private_locations_listList private locations (your own load generators).Read-onlyList Private Locations
List private locations (your own load generators). Returns locations with id, name, type, workspaces and agent counts. Use this for location IDs in tests.
Inputs
account_idinteger- Locations of this account. Example: 123456.
workspace_idinteger- Locations of this workspace. Provide workspace_id or account_id. Example: 123456.
blazemeter_project_getGet one project.Read-onlyGet Project
Get one project. Returns the project with name, description and workspace. Use this when you know the ID.
Inputs
project_idintegerrequired- Project ID. Example: 123456.
blazemeter_projects_listList projects in a workspace or account.Read-onlyList Projects
List projects in a workspace or account. Returns projects with id, name, description, workspaceId and test counts. Use this for project IDs.
Inputs
account_idinteger- Account ID (instead of workspace_id). Example: 123456.
limitinteger- Maximum number of items to return. Example: 20.
namestring- Filter by name. Example: Web.
skipinteger- Number of items to skip. Example: 0.
sortstring- Sort field; prefix with - for descending (sent as sort[]). Example: -updated.
workspace_idinteger- Workspace ID. Provide workspace_id or project_id. Example: 123456.
blazemeter_schedule_getGet one schedule.Read-onlyGet Schedule
Get one schedule. Returns cron, target test, enabled state and the next execution times. Use this to check when a test runs next.
Inputs
schedule_idstringrequired- Schedule ID. Example: 5c83f8667ffbc232772ad363.
next_executionsinteger- How many upcoming run times to return. Example: 5.
blazemeter_schedules_history_listList past scheduled runs.Read-onlyList Schedule History
List past scheduled runs. Returns entries with runAt, success, schedule and test. Use this to check whether scheduled runs fired.
Inputs
from_dateinteger- From Unix time. Example: 1767225600.
limitinteger- Maximum number of items to return. Example: 20.
project_idinteger- Project ID. Provide workspace_id or project_id. Example: 123456.
schedule_idstring- History of this schedule. Example: 5c83f8667ffbc232772ad363.
skipinteger- Number of items to skip. Example: 0.
sortstring- Sort field; prefix with - for descending (sent as sort[]). Example: -updated.
test_idinteger- History of this test. Example: 1234567.
to_dateinteger- To Unix time. Example: 1767830400.
workspace_idinteger- Workspace ID. Provide workspace_id or project_id. Example: 123456.
blazemeter_schedules_listList test schedules (cron-based automatic runs) by test, multi-test, project or workspace.Read-onlyList Schedules
List test schedules (cron-based automatic runs) by test, multi-test, project or workspace. Returns schedules with id, cron, testId or collectionId, enabled and nextExecutions. Use this to review automation.
Inputs
collection_idinteger- Schedules of this multi-test. Example: 12345678.
enabledboolean- Only enabled schedules. Example: true.
limitinteger- Maximum number of items to return. Example: 20.
project_idinteger- Project ID. Provide workspace_id or project_id. Example: 123456.
skipinteger- Number of items to skip. Example: 0.
sortstring- Sort field; prefix with - for descending (sent as sort[]). Example: -updated.
test_idinteger- Schedules of this test. Example: 1234567.
workspace_idinteger- Workspace ID. Provide workspace_id or project_id. Example: 123456.
blazemeter_searchSearch BlazeMeter entities (accounts, workspaces, projects, masters, tags, tests and multi-tests) with filters, fields, ordering and paging.Read-onlySearch
Search BlazeMeter entities (accounts, workspaces, projects, masters, tags, tests and multi-tests) with filters, fields, ordering and paging. Returns matching entities with the requested fields. Use this for cross-entity queries. Use the list tools for simple listing.
Inputs
entitystringrequired- Root entity to search. Example: test-union.one of
accountworkspacemasterprojecttagtest-union account_idstring- Limit to an account. Example: 123456.
fieldsarray- Fields to return. Example: ["id", "name", "updated"]
filtersarray- Filters, each with field, operator and value(s), as described in the search metadata. Example: [{"field": "name", "operator": "contains", "value": "checkout"}]
limitinteger- Maximum results. Example: 20.
orderingarray- Ordering, each with field and direction. Example: [{"field": "updated", "direction": "desc"}]
skipinteger- Results to skip. Example: 0.
workspace_idstring- Limit to a workspace. Example: 123456.
blazemeter_test_files_listList the asset files (scripts, data files) of a test.Read-onlyList Test Files
List the asset files (scripts, data files) of a test. Returns files with name, size, lastModified and a temporary download link. Use this to see what a test runs.
Inputs
test_idintegerrequired- Test ID. Example: 1234567.
blazemeter_test_getGet one performance test.Read-onlyGet Test
Get one performance test. Returns the test object with configuration, executions (concurrency, ramp-up, hold-for, locations) and dependencies. Use this to read a test before starting it.
Inputs
test_idintegerrequired- Test ID. Example: 1234567.
blazemeter_tests_listList performance tests in a project or workspace, optionally filtered by name or type.Read-onlyList Tests
List performance tests in a project or workspace, optionally filtered by name or type. Returns tests with id, name, projectId, configuration (type, scriptType, filename), executions and lastRunTime, plus skip/limit/total. Use this to find a test. Use blazemeter_test_get for one. Use blazemeter_multi_tests_list for multi-tests.
Inputs
has_executionsboolean- Only tests that have been run. Example: true.
limitinteger- Maximum number of items to return. Example: 20.
namestring- Filter by part of the test name. Example: Checkout.
project_idinteger- Project ID. Provide workspace_id or project_id. Example: 123456.
skipinteger- Number of items to skip. Example: 0.
sortstring- Sort field; prefix with - for descending (sent as sort[]). Example: -updated.
typestring- Filter by test type, e.g. taurus, jmeter, http. Example: taurus.
workspace_idinteger- Workspace ID. Provide workspace_id or project_id. Example: 123456.
blazemeter_user_getGet the user the API key belongs to.Read-onlyGet Current User
Get the user the API key belongs to. Returns id, email, firstName, lastName, timezone, roles and the default account/workspace. Use this to check the connection and find your IDs.
Inputs
This tool takes no inputs.
blazemeter_workspace_getGet one workspace.Read-onlyGet Workspace
Get one workspace. Returns the workspace with name, account, settings and allowed locations. Use this when you know the ID.
Inputs
workspace_idintegerrequired- Workspace ID. Example: 123456.
blazemeter_workspace_users_listList the users of a workspace.Read-onlyList Workspace Users
List the users of a workspace. Returns users with id, email, displayName, roles, enabled and lastAccess. Use this to see who can run tests.
Inputs
workspace_idintegerrequired- Workspace ID. Example: 123456.
enabledboolean- Only enabled users. Example: true.
limitinteger- Maximum number of items to return. Example: 20.
skipinteger- Number of items to skip. Example: 0.
sortstring- Sort field; prefix with - for descending (sent as sort[]). Example: -updated.
text_filterstring- Filter by name or email. Example: jane.
blazemeter_workspaces_listList workspaces in an account.Read-onlyList Workspaces
List workspaces in an account. Returns workspaces with id, name, enabled and account. Use this for workspace IDs.
Inputs
account_idintegerrequired- Account ID (from blazemeter_user_get). Example: 123456.
enabledboolean- Only enabled workspaces. Example: true.
limitinteger- Maximum number of items to return. Example: 20.
skipinteger- Number of items to skip. Example: 0.
sortstring- Sort field; prefix with - for descending (sent as sort[]). Example: -updated.
text_filterstring- Filter by name. Example: Perf.
blazemeter_folder_createCreate a shared folder in a workspace.WriteCreate Shared Folder
Create a shared folder in a workspace. Returns the created folder. Upload files in the BlazeMeter UI.
Inputs
namestringrequired- Folder name. Example: sk-test-data.
workspace_idintegerrequired- Workspace ID. Example: 123456.
blazemeter_master_public_token_createCreate a public token so the run report can be shared without login.WriteCreate Public Report Token
Create a public token so the run report can be shared without login. Returns publicToken (append to the report URL). Use this to share a report. Use blazemeter_master_public_token_delete to revoke it.
Inputs
master_idintegerrequired- Master (test run) ID. Example: 12345678.
blazemeter_master_stopGracefully stop a running test run (results are kept).WriteStop Master
Gracefully stop a running test run (results are kept). Returns the stopped session IDs. Use this to end a run. Use blazemeter_master_terminate if it does not stop.
Inputs
master_idintegerrequired- Master (test run) ID. Example: 12345678.
blazemeter_master_updateRename a test run or set its note.WriteUpdate Master
Rename a test run or set its note. Returns the updated master. Use this to annotate a run.
Inputs
master_idintegerrequired- Master (test run) ID. Example: 12345678.
namestring- Run name. Example: Release 4.2 baseline.
notestring- Note. Example: CDN cache disabled.
blazemeter_multi_test_createCreate an empty multi-test in a project.WriteCreate Multi-Test
Create an empty multi-test in a project. Returns the created collection with its id. Use blazemeter_multi_test_test_add to add tests to it.
Inputs
collection_typestringrequired- Collection type; multi for a performance multi-test. Example: multi.
namestringrequired- Multi-test name. Example: sk-test full site.
project_idintegerrequired- Project ID. Example: 123456.
blazemeter_multi_test_duplicateDuplicate a multi-test.WriteDuplicate Multi-Test
Duplicate a multi-test. Returns the new collection. Use this to copy a multi-test.
Inputs
collection_idintegerrequired- Multi-test (collection) ID. Example: 12345678.
blazemeter_multi_test_startStart a multi-test run.WriteStart Multi-Test
Start a multi-test run. This launches load engines and uses BlazeMeter credits. Returns the master with id and status. Use this to run a collection. Track it with blazemeter_master_status_get.
Inputs
collection_idintegerrequired- Multi-test (collection) ID. Example: 12345678.
delayed_startboolean- Start all engines at once after they are ready. Example: true.
blazemeter_multi_test_test_addAdd a test to a multi-test.WriteAdd Test to Multi-Test
Add a test to a multi-test. Returns the updated collection. Use this after blazemeter_multi_test_create.
Inputs
collection_idintegerrequired- Multi-test (collection) ID. Example: 12345678.
test_idintegerrequired- Test ID to add. Example: 1234567.
blazemeter_multi_test_updateUpdate a multi-test's description.WriteUpdate Multi-Test
Update a multi-test's description. Returns the updated collection. Use this to document a multi-test.
- Idempotent
Inputs
collection_idintegerrequired- Multi-test (collection) ID. Example: 12345678.
descriptionstringrequired- Description. Example: Runs checkout and search together.
blazemeter_project_createCreate a project in a workspace.WriteCreate Project
Create a project in a workspace. Returns the created project. Use this to group tests.
Inputs
namestringrequired- Project name. Example: sk-test project.
workspace_idintegerrequired- Workspace ID. Example: 123456.
descriptionstring- Description. Example: Load tests for the web store.
blazemeter_project_updateRename a project, change its description or move it to another workspace.WriteUpdate Project
Rename a project, change its description or move it to another workspace. Returns the updated project. Use this to edit a project.
Inputs
project_idintegerrequired- Project ID. Example: 123456.
descriptionstring- New description. Example: Moved to Q3 suite.
namestring- New name. Example: sk-test project renamed.
workspace_idinteger- Workspace to move the project to. Example: 123456.
blazemeter_schedule_createSchedule a test or multi-test to run on a cron expression.WriteCreate Schedule
Schedule a test or multi-test to run on a cron expression. Returns the created schedule. Use this to automate runs. Use blazemeter_schedule_update to pause it.
Inputs
cronstringrequired- Cron expression (UTC), minute hour day month weekday. Example: 0 2 * * 1.
test_collection_idinteger- Multi-test to run. Example: 12345678.
test_idinteger- Test to run. Provide test_id or test_collection_id. Example: 1234567.
blazemeter_schedule_updateEnable or disable a schedule.WriteUpdate Schedule
Enable or disable a schedule. Returns the updated schedule. Use this to pause or resume automatic runs.
Inputs
enabledbooleanrequired- true to enable, false to pause. Example: false.
schedule_idstringrequired- Schedule ID. Example: 5c83f8667ffbc232772ad363.
blazemeter_test_createCreate a performance test (then upload its script in the BlazeMeter UI or with the files API).WriteCreate Test
Create a performance test (then upload its script in the BlazeMeter UI or with the files API). Returns the created test with its id. Use this to create a test definition. Use blazemeter_test_start to run it.
Inputs
configurationobjectrequired- Configuration: type (taurus), filename (the script file name), testMode (script or http) and scriptType (jmeter, gatling, locust, taurus, selenium...). Example: {"type": "taurus", "filename": "DemoTest.jmx", "testMode": "script", "scriptType": "jmeter"}
namestringrequired- Test name. Example: sk-test checkout load.
override_executionsarray- Load settings, each with concurrency, rampUp, holdFor, steps and locations (location ID to user count). Example: [{"concurrency": 20, "rampUp": "1m", "holdFor": "10m", "steps": 0, "locations": {"us-east4-a": 20}}]
project_idinteger- Project to create the test in; defaults to your default project. Example: 123456.
blazemeter_test_duplicateDuplicate a test (the reference documents this as a GET).WriteDuplicate Test
Duplicate a test (the reference documents this as a GET). Returns the new test object (201). Use this to copy a test before changing it.
Inputs
test_idintegerrequired- Test ID. Example: 1234567.
blazemeter_test_startStart a test run.WriteStart Test
Start a test run. This launches cloud or private load engines and uses BlazeMeter credits. Returns the master (test run) with id, sessions and status. Use this to run a test. Track it with blazemeter_master_status_get and stop it with blazemeter_master_stop.
Inputs
test_idintegerrequired- Test ID. Example: 1234567.
delayed_startboolean- Start all engines at once after they are ready. Example: true.
is_debug_runboolean- Run as a debug test (low load, extra logging). Example: false.
blazemeter_test_stopGracefully stop all running masters (runs) of a test.WriteStop Test
Gracefully stop all running masters (runs) of a test. Returns the stopped sessions. Use this to stop every run of a test. Use blazemeter_master_stop for one run.
Inputs
test_idintegerrequired- Test ID. Example: 1234567.
blazemeter_test_updateUpdate a test's name, description, configuration or load settings.WriteUpdate Test
Update a test's name, description, configuration or load settings. Returns the updated test. Use this to change load or rename a test.
Inputs
test_idintegerrequired- Test ID. Example: 1234567.
configurationobject- Configuration fields to change. Example: {"filename": "DemoTest.jmx"}
descriptionstring- Test description. Example: Peak-hour checkout scenario.
namestring- New test name. Example: sk-test checkout load v2.
override_executionsarray- Load settings to replace. Example: [{"concurrency": 50, "rampUp": "2m", "holdFor": "15m", "locations": {"us-east4-a": 50}}]
blazemeter_folder_deleteDelete a shared folder and its files.DestructiveDelete Shared Folder
Delete a shared folder and its files. Returns result on success. Use this to remove unused shared data.
- Idempotent
Inputs
folder_idstringrequired- Shared folder ID. Example: 5b96c41fad67294528f03df8.
blazemeter_master_public_token_deleteRevoke the public report token of a run.DestructiveDelete Public Report Token
Revoke the public report token of a run. Returns result on success. Use this to stop sharing a report.
- Idempotent
Inputs
master_idintegerrequired- Master (test run) ID. Example: 12345678.
blazemeter_master_terminateTerminate a test run immediately (engines are killed).DestructiveTerminate Master
Terminate a test run immediately (engines are killed). Returns the terminated session IDs. Use this only when blazemeter_master_stop does not work.
Inputs
master_idintegerrequired- Master (test run) ID. Example: 12345678.
blazemeter_multi_test_deleteDelete a multi-test (its tests stay).DestructiveDelete Multi-Test
Delete a multi-test (its tests stay). Returns result on success. Use this to remove a collection.
- Idempotent
Inputs
collection_idintegerrequired- Multi-test (collection) ID. Example: 12345678.
blazemeter_multi_test_test_removeRemove a test from a multi-test by its position.DestructiveRemove Test from Multi-Test
Remove a test from a multi-test by its position. Returns the updated collection. Use blazemeter_multi_test_get to find the index.
Inputs
collection_idintegerrequired- Multi-test (collection) ID. Example: 12345678.
indexintegerrequired- Zero-based position of the test in the multi-test. Example: 0.
blazemeter_project_deleteDelete a project.DestructiveDelete Project
Delete a project. Returns result on success. Use force=true to delete a project that still has tests.
- Idempotent
Inputs
project_idintegerrequired- Project ID. Example: 123456.
forceboolean- Delete even if the project has tests. Example: false.
blazemeter_schedule_deleteDelete a schedule.DestructiveDelete Schedule
Delete a schedule. Returns result on success. Use this to stop automatic runs permanently.
- Idempotent
Inputs
schedule_idstringrequired- Schedule ID. Example: 5c83f8667ffbc232772ad363.
blazemeter_test_deleteDelete a test.DestructiveDelete Test
Delete a test. Returns result with the deleted test. Use this to remove a test; its run history stays.
- Idempotent
Inputs
test_idintegerrequired- Test ID. Example: 1234567.
blazemeter_test_file_deleteDelete an asset file from a test.DestructiveDelete Test File
Delete an asset file from a test. Returns result true on success. Use this to remove an old script or data file.
Inputs
file_namestringrequired- File name to delete. Example: old-data.csv.
test_idintegerrequired- Test ID. Example: 1234567.
No tools match.