MCP Tools Reference

Complete reference for all 123 tools exposed by the Hookbase MCP server, across both the local (stdio) and remote HTTP transports. Parameter tables are generated directly from each tool's input schema.

Sources

hookbase_list_sources

List all webhook sources in the organization. Sources are endpoints that receive incoming webhooks.

Parameters: None

hookbase_get_source

Get detailed information about a specific webhook source, including its configuration and statistics.

hookbase_create_source

Create a new webhook source. Sources receive incoming webhooks and can be connected to destinations via routes.

hookbase_update_source

Update an existing webhook source configuration.

hookbase_delete_source

Delete a webhook source. This will also delete all associated routes.

Destinations

hookbase_list_destinations

List all webhook destinations in the organization. Destinations are endpoints where webhooks are forwarded to.

Parameters: None

hookbase_get_destination

Get detailed information about a specific destination, including authentication configuration.

hookbase_create_destination

Create a new webhook destination. Destinations can be HTTP endpoints or warehouse storage (S3, R2, GCS, Azure Blob).

hookbase_update_destination

Update an existing destination configuration.

hookbase_delete_destination

Delete a destination. This will also delete all associated routes.

hookbase_test_destination

Test connectivity to a destination by sending a test request. Returns response status and timing.

Routes

hookbase_list_routes

List all routes in the organization. Routes connect sources to destinations and define how webhooks are processed.

Parameters: None

hookbase_get_route

Get detailed information about a specific route, including filter and transform configuration.

hookbase_create_route

Create a new route connecting a source to a destination. Optionally add filters to control which webhooks are forwarded.

hookbase_update_route

Update an existing route configuration.

hookbase_delete_route

Delete a route.

Events

hookbase_list_events

Query webhook events with optional filters. Events represent incoming webhooks received by sources.

hookbase_get_event

Get detailed information about a specific event, including the full payload and all delivery attempts.

hookbase_get_event_debug

Generate a cURL command to replay an event for debugging purposes.

Deliveries

hookbase_list_deliveries

Query webhook deliveries with optional filters. Deliveries represent attempts to forward webhooks to destinations.

hookbase_get_delivery

Get detailed information about a specific delivery, including the response body and error details.

hookbase_replay_delivery

Retry a failed delivery. This will re-send the original webhook payload to the destination.

hookbase_bulk_replay

Retry multiple failed deliveries at once. Useful for recovering from destination outages.

hookbase_replay_with_edit

Replay a failed delivery with one-shot overrides. Use this to recover from a broken transform, a wrong destination URL, or a missing header without permanently changing the route. Set persist_transform=true to save the new transform code to the route after a successful replay. Always replay one delivery first as a probe before bulk replays — the response includes the new delivery ID so you can poll its status.

hookbase_list_delivery_clusters

List recent failure clusters — distinct failure patterns aggregated by fingerprint (route + destination + status + normalized error). Use this as the entry point when investigating an incident: one cluster row = one root cause, regardless of how many deliveries failed. Returns up to 100 clusters in the chosen time window.

hookbase_replay_cluster

Replay every failed delivery matching a cluster fingerprint with one round trip. Same override shape as hookbase_replay_with_edit. Use this after diagnosing a cluster with hookbase_list_delivery_clusters and probing the fix on a single delivery with hookbase_replay_with_edit. persist_transform requires every delivery in the cluster to share a single route.

Tunnels

hookbase_list_tunnels

List all localhost tunnels in the organization. Tunnels allow forwarding webhooks to local development servers.

Parameters: None

hookbase_create_tunnel

Create a new localhost tunnel. The tunnel can be connected using the Hookbase CLI to forward webhooks to your local server.

hookbase_get_tunnel_status

Check the connection status of a tunnel. Shows whether the tunnel is connected and live statistics.

hookbase_delete_tunnel

Delete a localhost tunnel.

Cron Jobs

hookbase_list_cron_jobs

List all scheduled cron jobs in the organization. Cron jobs make HTTP requests on a schedule.

Parameters: None

hookbase_create_cron_job

Create a new scheduled cron job that makes HTTP requests on a schedule.

hookbase_get_cron_job

Get full details for a single cron job, including schedule, target URL, headers/payload, and last/next run times.

hookbase_update_cron_job

Update a cron job. Pass only the fields you want to change. Changing cron_expression or timezone recalculates next run time.

hookbase_delete_cron_job

Delete a scheduled cron job.

hookbase_trigger_cron

Manually trigger a cron job immediately, regardless of its schedule.

Cron Groups

hookbase_list_cron_groups

List cron job groups. Groups organize cron jobs in the dashboard and can be referenced via group_id when creating/updating jobs.

Parameters: None

hookbase_get_cron_group

Get a single cron group by ID or slug.

hookbase_create_cron_group

Create a cron group. Slug is derived from the name. New groups are appended to the end of the sort order.

hookbase_update_cron_group

Update a cron group's name, description, sort order, or collapsed state.

hookbase_delete_cron_group

Delete a cron group. Jobs in this group are not deleted; their group_id is set to null.

Analytics

hookbase_get_analytics

Get dashboard analytics and metrics for the organization, including event counts, delivery success rates, and top sources/destinations.

Filters

hookbase_list_filters

List filter definitions in the organization. Filters are reusable condition sets attached to routes to gate which events are delivered.

hookbase_get_filter

Get a filter definition including its conditions and AND/OR logic.

hookbase_create_filter

Create a reusable filter that can be attached to routes. A filter evaluates a list of conditions (combined via AND or OR) against incoming event payloads.

hookbase_update_filter

Update a filter's name, description, conditions, or logic. Pass only the fields you want to change.

hookbase_delete_filter

Delete a filter. Routes referencing it will have the reference cleared.

Transforms

hookbase_list_transforms

List transform definitions. Transforms reshape an event payload before delivery (JSONata, XSLT, Liquid, or JavaScript).

hookbase_get_transform

Get a transform definition including its source code, language, and input/output formats.

hookbase_create_transform

Create a transform that reshapes payloads. The code is validated server-side before being saved. Requires the "transforms" feature on the org plan.

hookbase_update_transform

Update a transform. If code changes it is re-validated server-side.

hookbase_delete_transform

Delete a transform. Routes referencing it will have the reference cleared.

hookbase_test_transform

Run a transform expression against a sample payload without saving. Useful for iterating on JSONata/XSLT/Liquid/JS code.

Schemas

hookbase_list_schemas

List JSON Schema definitions in the organization. Schemas validate event payloads on routes and reject malformed deliveries.

Parameters: None

hookbase_get_schema

Get a JSON Schema definition (parsed as an object).

hookbase_create_schema

Create a JSON Schema. Requires the "schemas" feature on the org plan. The slug is derived from the name.

hookbase_update_schema

Update a schema. Pass any subset of name/description/json_schema. Uses HTTP PUT under the hood.

hookbase_delete_schema

Delete a schema. Routes referencing it will have the reference cleared.

hookbase_validate_against_schema

Validate a sample payload against a stored schema and return any validation errors.

Alert Rules

hookbase_list_alert_rules

List configured alert rules. Each rule pairs a trigger condition (failure rate, source silence, latency, volume anomalies, schema drift) with one or more notification channels.

Parameters: None

hookbase_get_alert_rule

Get a single alert rule including its trigger config and notification channel IDs.

hookbase_create_alert_rule

Create an alert rule. trigger_config shape depends on trigger_type: - source_silence: { type, sourceId?, silenceMinutes } - failure_rate: { type, destinationId?, thresholdPercent, windowMinutes } - latency_threshold: { type, destinationId?, thresholdMs, windowMinutes } - volume_spike: { type, sourceId?, maxEvents, windowMinutes } - volume_drop: { type, sourceId?, minEvents, windowMinutes } - anomaly_volume: { type, sourceId, direction?, zThreshold?, windowMinutes?, minBaselineSamples? } (Pro+ only) - schema_drift: { type, sourceId, alertOn? } (Pro+ only) The "type" field inside trigger_config must equal trigger_type.

hookbase_update_alert_rule

Update an alert rule. Pass only fields you want to change.

hookbase_delete_alert_rule

Delete an alert rule.

hookbase_test_alert_rule

Fire a test notification through all channels attached to this alert rule. Useful for verifying channel configuration.

Notification Channels

hookbase_list_notification_channels

List notification channels (email, Slack, webhook, Teams, PagerDuty, Discord). Sensitive fields like webhook URLs and PagerDuty routing keys are masked in the response.

Parameters: None

hookbase_get_notification_channel

Get a single notification channel. Sensitive fields are masked in the response.

hookbase_create_notification_channel

Create a notification channel. config shape depends on type: - email: { addresses: ["[email protected]", ...] } - slack: { webhookUrl } - discord: { webhookUrl } - teams: { webhookUrl } - pagerduty: { routingKey, severity? } - webhook: { url, secret? } (signed with HMAC-SHA256 if secret provided) Requires the "notification_channels" feature on the org plan; admin or owner role required.

hookbase_update_notification_channel

Update a notification channel. Pass any subset of name/config/is_active. Replacing config requires the same shape as create.

hookbase_delete_notification_channel

Delete a notification channel. Alert rules referencing it will lose this channel from their notification list.

Outbound Webhooks (Applications, Endpoints, Subscriptions)

hookbase_list_applications

List webhook applications in the organization. Applications group endpoints that receive outbound webhooks for a customer or integration.

hookbase_get_application

Get detailed information about a specific webhook application, including its endpoints and delivery statistics.

hookbase_create_application

Create a new webhook application. Applications represent a customer or integration that will receive webhooks.

hookbase_update_application

Update a webhook application configuration.

hookbase_delete_application

Delete a webhook application. This also deletes all endpoints and subscriptions for this application.

hookbase_list_endpoints

List webhook endpoints. Endpoints are URLs that receive webhook deliveries.

hookbase_get_endpoint

Get detailed information about a webhook endpoint, including circuit breaker state and delivery statistics.

hookbase_create_endpoint

Create a new webhook endpoint. The signing secret is only returned once on creation - save it securely.

hookbase_update_endpoint

Update a webhook endpoint configuration.

hookbase_delete_endpoint

Delete a webhook endpoint. This also removes all subscriptions for this endpoint.

hookbase_rotate_endpoint_secret

Rotate the signing secret for an endpoint. Returns the new secret (save it securely). Old secret remains valid during grace period.

hookbase_reset_endpoint_circuit

Reset the circuit breaker for an endpoint. Use this to immediately re-enable deliveries after fixing an issue.

hookbase_list_subscriptions

List webhook subscriptions. Subscriptions connect endpoints to event types they should receive.

hookbase_get_subscription

Get detailed information about a webhook subscription.

hookbase_create_subscription

Create a subscription to connect an endpoint to an event type. The endpoint will receive events of this type. Use label_filters to only receive events with matching labels.

hookbase_update_subscription

Update a webhook subscription.

hookbase_delete_subscription

Delete a webhook subscription. The endpoint will no longer receive events of this type.

Event Types

hookbase_list_event_types

List event types defined in the organization. Event types define the different kinds of webhook events that can be sent.

hookbase_get_event_type

Get detailed information about an event type, including its JSON schema and example payload.

hookbase_create_event_type

Create a new event type. Event types define the structure and meaning of webhook events.

hookbase_update_event_type

Update an event type. Use is_deprecated to mark an event type as deprecated.

hookbase_delete_event_type

Delete an event type. This also removes all subscriptions to this event type.

Outbound Messages

hookbase_send_event

Send a webhook event to all subscribed endpoints. The event is queued for delivery to matching subscriptions. Use labels for filtering which subscriptions receive the event.

hookbase_list_outbound_messages

List outbound message delivery records. Messages track the delivery status of each event to each endpoint.

hookbase_get_outbound_message

Get detailed information about an outbound message delivery.

hookbase_get_message_attempts

Get the delivery attempt history for an outbound message. Shows each attempt with response details.

hookbase_replay_message

Replay a failed or exhausted message. Creates a new delivery attempt for the original event payload.

hookbase_get_outbound_stats

Get delivery statistics for outbound webhooks. Shows counts by status (pending, success, failed, etc.).

Parameters: None

Webhook Analytics

hookbase_get_webhook_analytics

Get outbound webhook delivery analytics: status counts, success rate, latency percentiles, top failing endpoints, error type breakdown, DLQ reasons, and a time-bucketed chart series. Optionally filter by application_id and/or endpoint_id.

hookbase_get_webhook_endpoint_analytics

Get analytics for a single outbound webhook endpoint: circuit-breaker state, lifetime totals, status counts, average response time, and the most recent 100 delivery attempts in the window.

API Keys

hookbase_list_api_keys

List API keys for the current org. Returns id, name, key prefix, scopes, expiry — never the raw key (which is only returned once at creation).

Parameters: None

hookbase_create_api_key

Create a new API key (admin or owner only). The raw key is returned ONCE in the response under apiKey.key — store it securely; it cannot be retrieved later. Default scopes are ["read","write"]. Pass expiresIn (seconds from now) for time-limited keys.

hookbase_delete_api_key

Delete (revoke) an API key. Admin or owner only, requires the "delete" scope. The key currently being used to authenticate this request cannot be deleted.

Audit Logs

hookbase_list_audit_logs

List org audit log entries with optional filters. Admins/owners always have access; non-admins require the "audit_logs" feature on the plan. Filter by action, entityType, or userId.

hookbase_list_audit_log_actions

List the distinct action types present in this org's audit log. Useful for discovering filter values.

Parameters: None

hookbase_list_audit_log_users

List the distinct users who appear in this org's audit log. Useful for discovering user_id filter values.

Parameters: None

Redaction Policies

hookbase_list_redaction_policies

List redaction policies for this org. Optionally filter by source_id (org-wide policies have null sourceId).

hookbase_get_redaction_policy

Get a single redaction policy with its full ruleset.

hookbase_create_redaction_policy

Create a redaction policy (admin or owner; requires the "redaction_policies" feature). Each rule has a match (type: path | field_name | regex_value | header, value) and action (type: redact | mask | hash | remove, optional keepLastN for mask). Pass source_id to scope to one source, omit/null for org-wide. scope controls when rules apply: "storage" (before R2 write), "delivery" (before forwarding), or "both" (default).

hookbase_update_redaction_policy

Update a redaction policy. PUT semantics — pass the full policy state (name, rules, scope, isActive). Optional source_id reassigns the policy. Cache busts on save but org-wide policies (sourceId null) may take up to 5 min to propagate.

hookbase_delete_redaction_policy

Delete a redaction policy (admin or owner).

hookbase_preview_redaction_policy

Apply a candidate ruleset to a sample payload (and optional headers) without saving. Returns the redacted payload, redacted headers, and the count of fields touched.

Scheduled Sends

hookbase_list_scheduled_sends

List one-shot scheduled HTTP sends. Optionally filter by status (pending | sending | sent | failed | cancelled). Paginated.

hookbase_get_scheduled_send

Get a single scheduled send including its current status, response, and error info.

hookbase_create_scheduled_send

Schedule a one-shot HTTP request to fire at a future time. URL must be http or https. scheduled_for must be a future ISO-8601 timestamp. Default method POST. headers and payload are arbitrary objects (JSON-encoded server-side).

hookbase_update_scheduled_send

Update a scheduled send. Only allowed while status is "pending". Pass any subset of fields to change.

hookbase_cancel_scheduled_send

Cancel a pending or failed scheduled send. Sent or already-cancelled sends cannot be cancelled.

hookbase_send_scheduled_send_now

Trigger a pending or failed scheduled send immediately, bypassing its scheduled_for time. Returns the live HTTP response status and latency.

Test Webhook Bins

hookbase_create_bin

Create a new test webhook bin. Returns a public ingest URL that captures any HTTP request sent to it. Bins expire after a fixed TTL. Rate-limited to 10 per IP per day.

Parameters: None

hookbase_get_bin

Get a bin's metadata, current event count, configured response, and the 50 most recent captured events (summary form).

hookbase_list_bin_events

List captured events in a bin (summary view, paginated). Use hookbase_get_bin_event for a single event's headers and body.

hookbase_get_bin_event

Get a single bin event with full headers and body. Body is fetched from R2 if it was offloaded.

hookbase_update_bin_response

Configure the response a bin returns to incoming webhook requests. status_code clamped to 100–599, body capped at 10KB. Useful for simulating different upstream behavior during integration testing.