Skip to main content
Glama
metamug

plunger

Official

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
NO_PROXYNoPlunger uses your system proxy settings and the HTTP_PROXY, HTTPS_PROXY and NO_PROXY environment variables.
HTTP_PROXYNoPlunger uses your system proxy settings and the HTTP_PROXY, HTTPS_PROXY and NO_PROXY environment variables.
HTTPS_PROXYNoPlunger uses your system proxy settings and the HTTP_PROXY, HTTPS_PROXY and NO_PROXY environment variables.
PLUNGER_DATA_DIRNoSet 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

CapabilityDetails
tools
{}
prompts
{}
resources
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 save_as to keep it in the user's Saved list so it can be sent later with send_request by name.

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 (saved_request). Describe it like send_request. {{placeholders}} are kept as written, including in Authorization headers. An existing name is refused unless overwrite is true, which replaces it, so a mistake can be fixed.

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 extract (for example {name: "token", from: "json:$.access_token"}, which keeps the value as {{token}} for the steps after it, hidden if it looks like a credential) and expect_status. Use it for logins, create-then-fetch flows and any sequence you will repeat.

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 saved_request, or describe one with method, url, headers and a body.

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 group takes it out of its group. Use it to tidy the Saved list.

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

NameDescription
test_endpointCall an endpoint with Plunger and check the response against what you expect.
login_workflowBuild and save a workflow that logs in and keeps the token for later requests.
debug_failed_requestFind out why a request failed, using the history and saved requests.
record_workflowTurn the requests you just made into a reusable workflow.

Resources

Contextual data attached and managed by the client

NameDescription
guideHow to use Plunger from an agent: the tools, how variables and secrets behave, workflows.
variablesThe {{variables}} in use (secrets by name only) and the built-ins.
saved-requestsThe requests the user saved, with method, URL, headers and the variables each needs.
workflowsSaved workflows: ordered requests where one response feeds the next.
historyThe 20 most recent requests, who sent them, status and time.

TDQS

A3.9/5.0

Scored across 17 tools

Disambiguation5/5

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.

Naming Consistency5/5

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.

Tool Count4/5

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.

Completeness4/5

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.

Maintenance

ActivityActive
ResponsivenessUnresponsive