Skip to main content

Available Tools

The Hooklistener MCP server exposes tools for debug endpoints, captured requests, replay cases, email inboxes, uptime monitors, and secrets.

Debug endpoints

ToolDescription
list_endpointsList debug endpoints in the current organization
get_endpointGet endpoint details and webhook URL
create_endpointCreate a debug endpoint
update_endpointUpdate endpoint name or slug
delete_endpointDelete an endpoint

Captured requests

ToolDescription
list_requestsList captured requests for an endpoint
search_requestsSearch captured requests by method, path, headers, body, or sender
get_requestGet full request details, including headers and body
wait_for_requestWait for a matching request to arrive
delete_requestDelete a captured request
compare_requestsCompare two captured requests
diagnose_requestAsk the assistant to analyze a request for likely issues
forward_requestReplay one captured request to a URL or active CLI listener

Replay cases

Replay cases save captured requests as repeatable integration tests with optional response assertions.

ToolDescription
list_endpoint_casesList saved cases for an endpoint
save_request_caseSave a captured request as a replay case
update_request_caseUpdate case metadata, replay overrides, or assertions
delete_request_caseDelete a saved case
replay_request_caseReplay one saved case
list_endpoint_case_suitesList named suites for an endpoint
create_endpoint_case_suiteCreate a named case suite
update_case_suiteUpdate a suite name or description
delete_case_suiteDelete a suite
add_case_to_suiteAdd a saved case to a suite
remove_case_from_suiteRemove a saved case from a suite
run_endpoint_casesRun all endpoint cases, or one suite
list_endpoint_case_runsList durable case run reports for an endpoint
get_case_runGet a case run report
wait_for_case_runWait for a case run to complete

Common replay case fields:

FieldUsed byDescription
endpoint_idList/save/run toolsDebug endpoint ID
request_idsave_request_caseCaptured request ID to save
case_idCase replay/update/delete toolsSaved request case ID
case_suite_idSuite run/report toolsOptional suite ID
target_urlReplay/run toolsDestination URL
target_idReplay/run toolsSaved endpoint replay target ID
targetReplay/run toolsSet to cli to use an active CLI listener
target_namerun_endpoint_casesOptional name to save for a custom URL
expected_status_codeSave/update toolsResponse status assertion
expected_json_body_subset_jsonSave/update toolsJSON object expected in the replay response body
waitrun_endpoint_casesWait for queued forwards and return aggregate results
timeout_msRun/wait toolsMaximum wait time, capped at 120 seconds

Email inboxes

ToolDescription
list_inboxesList test email inboxes
create_inboxCreate a test inbox
list_emailsList captured emails for an inbox
get_emailGet a captured email
wait_for_emailWait for a matching email to arrive

Uptime monitors

ToolDescription
list_monitorsList uptime monitors
get_monitor_statusGet uptime, status, and recent checks for a monitor
create_monitorCreate an uptime monitor
update_monitorUpdate monitor configuration
delete_monitorDelete a monitor

Secrets

Secrets are encrypted organization-scoped values that can be referenced by tools that support secret interpolation.

ToolDescription
list_secretsList secret names and metadata
create_secretCreate an encrypted secret
delete_secretDelete a secret

Removed tools

Datastore and endpoint action tools are no longer available. Use replay cases for repeatable webhook integration testing, and use secrets for encrypted configuration values.