addRuleToGroup
Moves a rule into a group.
LABSCO SUMMARY
Rule edits and traffic inspection happen in the same conversation as the bug they are chasing.
The split worth learning is rules against values: rules say what whistle rewrites, values hold reusable payloads a rule can point at, and both have their own create, rename, group and delete tools. Replay is asynchronous by design — replayRequest returns before the response exists, so the outcome comes from a follow-up getInterceptInfo call on the same URL, and bodies arrive base64-encoded either way. getAllValues can return a large payload, which is why the index-and-name listing exists next to it.
What it is
A server over a whistle proxy's admin interface — rules and rule groups, named values, the proxy's own switches, captured traffic for a URL, and request replay.
What you get
- Rules created, renamed, updated, enabled, disabled and deleted one at a time, or switched together with setAllRulesState
- Rule groups as real objects: create a group, then move rules into and out of it
- Named values with a size-aware read path — getValueList returns index and name only, getValue returns one value with its data, and getAllValues returns the lot
- Five switches under tool control: the proxy itself, HTTP interception, HTTPS interception, HTTP/2 and multi-rule mode
- Captured traffic for a URL through getInterceptInfo, filtered by start time and count, with request and response returned base64-encoded
- replayRequest to re-send a captured request with your own method, headers, body and optional HTTP/2
Requirements
A whistle proxy already running for the server to talk to. No account and no key. MIT.
Setup effort
One command — npx -y whistle-mcp-tool
USE CASES
01
Pointing a page at a local build
Write the mapping as a new rule, fill in its content, and enable it. Reading the rule list back shows which other rules are live and might match the same request first.
02
Reproducing a request with one header changed
Read what whistle captured for the URL, then send it again with your own method, headers or body. The replay call returns before the response does, so the result is read back from the capture.
03
Turning on HTTPS capture for a debugging session
Check what the proxy currently has switched on, then enable interception at the level you need — HTTPS and HTTP/2 are separate switches, and multi-rule mode changes whether more than one rule can match a request.
04
Keeping mock payloads out of the rule text
Store the response body as a named value and have the rule reference it. The listing call returns names without their data, so finding the right one does not drag every payload into the context.
05
Parking one project's rules while you work on another
Group the rules that belong together, then switch the group's members off without deleting them. setAllRulesState clears the board in one call when a capture needs to start clean.
34 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
addValueToGroup
Moves a named value into a group.
createGroup
Creates a rule group with the given name.
createRule
Creates a rule with the given name.
createValue
Creates a named value.
createValuesGroup
Creates a group for named values.
deleteGroup
Deletes a rule group.
deleteRule
Deletes a rule.
deleteValue
Deletes a named value.
deleteValueGroup
Deletes a value group.
disableRule
Disables a rule by name.
enableRule
Enables a rule by name.
getAllValues
Returns every named value with its data; use the value list first and fetch single values when the payload is large.
getCurrentTimestamp
Returns the current local timestamp.
getInterceptInfo
Returns captured requests and responses for a URL, filtered by start time and count, with bodies base64-encoded.
getRules
Returns every rule and rule group.
getValue
Returns one named value in full, including its data.
getValueList
Lists values by index and name only, without their data.
getWhistleStatus
Returns the whistle server's current state.
removeRuleFromGroup
Removes a rule from its group.
removeValueFromGroup
Removes a named value from its group.
renameGroup
Renames a rule group.
renameRule
Renames a rule.
renameValue
Renames a named value.
renameValueGroup
Renames a value group.
replayRequest
Replays a captured request with a chosen method, headers, body and optional HTTP/2; the result is read afterwards from the capture.
setAllRulesState
Enables or disables every rule at once.
toggleHttp2
Turns HTTP/2 on or off.
toggleHttpInterception
Turns HTTP interception on or off.
toggleHttpsInterception
Turns HTTPS interception on or off.
toggleMultiRuleMode
Turns multi-rule mode on or off.
toggleProxy
Turns the whistle proxy on or off.
updateRule
Replaces a rule's content.
updateValue
Replaces the content of a named value.
BEFORE YOU INSTALL
What to know first
Tools you get
34 tools when we connected.
Requires
- npx on PATH
- Node.js 18.20.0 or later
CONTEXT COST
Light Standing cost
Rated by the size of the 34 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"whistle-mcp-tool": {
"command": "npx",
"args": [
"-y",
"whistle-mcp-tool"
]
}
}
}npx
TERMINAL
npx -y whistle-mcp-tool
