plunger
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NO_PROXY | No | Plunger uses your system proxy settings and the HTTP_PROXY, HTTPS_PROXY and NO_PROXY environment variables. | |
| HTTP_PROXY | No | Plunger uses your system proxy settings and the HTTP_PROXY, HTTPS_PROXY and NO_PROXY environment variables. | |
| HTTPS_PROXY | No | Plunger uses your system proxy settings and the HTTP_PROXY, HTTPS_PROXY and NO_PROXY environment variables. | |
| PLUNGER_DATA_DIR | No | Set PLUNGER_DATA_DIR to run against a throwaway data folder instead of your real history (where history and saved requests live). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| prompts | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| delete_saved_requestA | Remove a saved request by name (its history entries stay). Returns what was removed. |
| delete_variableA | Remove a variable an agent set (with set_variable). Variables the user defined in the window can only be removed there. |
| delete_workflowB | Remove a workflow by name. Returns what was removed. |
| export_curlA | Turn a saved request (by name) or a history entry (by id) into a curl command, for CI scripts or tools that only speak curl. {{variables}} stay as placeholders, so no secret is written out. |
| get_historyA | Recent requests from the shared history, newest first: who sent them (gui = the user, cli or mcp = an agent), method, URL, status and time. Credentials are already blanked. Use it to see what the user tried, or to check what was sent earlier. |
| get_history_entryA | One history entry in full: when it was sent, the status and time, and the request as sent (credentials blanked, {{placeholders}} kept, so it can be re-sent or saved). The response body is not stored. |
| get_saved_requestA | One saved request in full: method, URL, headers, body, and the {{variables}} it needs. |
| import_curlA | Parse a curl command into a Plunger request without sending it: method, URL, headers, body and the
{{variables}} it uses. Use it to check what a curl command would do, or with |
| list_saved_requestsA | List the requests the user saved in Plunger, by name, with method, URL, headers and the {{variables}} each needs. Call this before building a request from scratch: the user may already have the exact call set up. |
| list_variablesA | List the {{variables}} defined in Plunger. Secret variables are listed by name only (their values are never returned); use them in a request as {{name}} and Plunger fills them in. |
| list_workflowsA | List the saved workflows with their steps. |
| run_workflowA | Run a saved workflow: its requests are sent in order, values are carried from one response to the next (never shown if secret), and it stops at the first step that fails. Returns each step's status and the variables it set, plus the last response in full. |
| save_requestA | Save a request in the user's Saved list without sending it, so it can be re-run by name with send_request
( |
| save_workflowA | Save a workflow: an ordered list of requests where a later one can use values from an earlier response.
Each step is described like send_request, plus |
| send_requestA | Send an HTTP request through Plunger and get back status, timing, size, headers and the parsed JSON body.
Use this instead of curl for API calls: {{variables}} (including the user's secrets, by name) are filled in
for you, an undefined {{variable}} makes the request fail safely instead of sending the placeholder, secret
values are masked in the result, and the request is recorded in the history the user sees in Plunger.
Send a saved request by name with |
| set_groupA | File a saved request or a workflow under a group, such as "Jira" or "Jira/Issues", without touching the
request or workflow itself. An empty |
| set_variableA | Set a variable that later requests use as {{name}}, for example a token you read from a login response. It persists between calls and runs and is shared with the Plunger window, the CLI and other agents. A secret (or a credential-looking name such as token or api_key) is kept in the system credential store and masked in results. A variable the user defined in the window cannot be changed. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| test_endpoint | Call an endpoint with Plunger and check the response against what you expect. |
| login_workflow | Build and save a workflow that logs in and keeps the token for later requests. |
| debug_failed_request | Find out why a request failed, using the history and saved requests. |
| record_workflow | Turn the requests you just made into a reusable workflow. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| guide | How to use Plunger from an agent: the tools, how variables and secrets behave, workflows. |
| variables | The {{variables}} in use (secrets by name only) and the built-ins. |
| saved-requests | The requests the user saved, with method, URL, headers and the variables each needs. |
| workflows | Saved workflows: ordered requests where one response feeds the next. |
| history | The 20 most recent requests, who sent them, status and time. |
TDQS
Scored across 17 tools
Each tool has a clearly distinct resource and action: requests vs workflows vs variables vs history vs curl conversion vs grouping. Overlaps like get_history/get_history_entry and save_request/save_workflow are conventional list-vs-detail or resource-type distinctions that the descriptions make clear.
All tool names follow a consistent snake_case verb_noun pattern such as list_saved_requests, save_workflow, delete_variable, and get_history_entry. There are no mixed conventions or vague standalone verbs.
With 17 tools, the set is slightly above the typical well-scoped range but still reasonable for an HTTP client/workflow manager with requests, workflows, variables, history, curl conversion, and grouping. Each tool earns its place, though the surface is somewhat broad.
The server covers request sending, saved request lifecycle, workflow save/list/run/delete, variables list/set/delete, history viewing, curl import/export, and grouping. Minor gaps exist, such as no explicit workflow update operation and no history deletion, but core workflows are well covered.