Keyless webhook endpoints: capture, wait, replay, forward, and generate types from real traffic.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer <token>. A keyless read+replay token from POST /api/start (ws_anon_...), or a full-access API key from your dashboard (ws_live_...). See https://webhook-studio.com/mcp/setup
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Turn on HMAC signature verification for a bucket using the provider's own signing secret (e.g. Stripe's whsec_). This is how you finish a "verified webhook" integration end to end. Set secret to the provider secret and hmac_enabled:true in the same call; the signature scheme is auto-detected from the header shape.
The endpoint id.
The provider's signing secret (≥16 chars).
What to do with a failed signature.
Signature header to read (auto-detected if omitted).
Enable verification.
Max timestamp skew allowed, in seconds.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Turn on HMAC signature verification for a bucket using the provider's own signing secret (e.g. Stripe's whsec_). This is how you finish a "verified webhook" integration end to end. Set secret to the provider secret and hmac_enabled:true in the same call; the signature scheme is auto-detected from the header shape.
| Argument | Type | Description |
|---|---|---|
| secret | string | The provider's signing secret (≥16 chars). |
| bucket_id* | string | The endpoint id. |
| on_failure | string | What to do with a failed signature. |
| header_name | string | Signature header to read (auto-detected if omitted). |
| hmac_enabled | boolean | Enable verification. |
| tolerance_seconds | number | Max timestamp skew allowed, in seconds. |
{
"type": "object",
"required": [
"bucket_id"
],
"properties": {
"secret": {
"type": "string",
"description": "The provider's signing secret (≥16 chars)."
},
"bucket_id": {
"type": "string",
"description": "The endpoint id."
},
"on_failure": {
"enum": [
"reject",
"accept_log"
],
"type": "string",
"description": "What to do with a failed signature."
},
"header_name": {
"type": "string",
"description": "Signature header to read (auto-detected if omitted)."
},
"hmac_enabled": {
"type": "boolean",
"description": "Enable verification."
},
"tolerance_seconds": {
"type": "number",
"description": "Max timestamp skew allowed, in seconds."
}
},
"additionalProperties": false
}Provision a new webhook endpoint (a "bucket") that captures incoming HTTP requests. Returns its id, public ingest url to point a provider at, inbox_url (the live human view to hand back), and signing secret. Pass external_ref — your own stable name like "acme-api:stripe" — so you can re-find this exact bucket later with list_buckets after losing context.
| Argument | Type | Description |
|---|---|---|
| name | string | Human label for the bucket. |
| environment | string | Deployment environment. |
| external_ref | string | Your own stable identifier (unique per account) for idempotent re-provisioning and re-finding. |
{
"type": "object",
"required": [],
"properties": {
"name": {
"type": "string",
"description": "Human label for the bucket."
},
"environment": {
"enum": [
"production",
"staging",
"sandbox",
"development"
],
"type": "string",
"description": "Deployment environment."
},
"external_ref": {
"type": "string",
"description": "Your own stable identifier (unique per account) for idempotent re-provisioning and re-finding."
}
},
"additionalProperties": false
}Permanently delete a webhook endpoint and its captured events.
| Argument | Type | Description |
|---|---|---|
| bucket_id* | string | The endpoint id. |
{
"type": "object",
"required": [
"bucket_id"
],
"properties": {
"bucket_id": {
"type": "string",
"description": "The endpoint id."
}
},
"additionalProperties": false
}Compare two versions of a learned schema and get exactly which fields were added, removed or changed type, each flagged as breaking or not. This is the "why did my handler start failing" answer, produced without reading a single payload. from defaults to the version before to.
| Argument | Type | Description |
|---|---|---|
| to | string | Target version number, or "current". |
| from | string | Baseline version number (defaults to the one before "to"). |
| schema_id* | string | The schema id. |
{
"type": "object",
"required": [
"schema_id"
],
"properties": {
"to": {
"type": "string",
"description": "Target version number, or \"current\"."
},
"from": {
"type": "string",
"description": "Baseline version number (defaults to the one before \"to\")."
},
"schema_id": {
"type": "string",
"description": "The schema id."
}
},
"additionalProperties": false
}List the correlation-key candidates for a learned schema — the fields that look like identifiers (e.g. data.object.id), ranked by how consistently they appear. These are the fields to group events by when reconstructing a lifecycle (a Stripe payment_intent across created -> succeeded, a GitHub PR across its events). Derived from real traffic, so it reflects what THIS account actually receives.
| Argument | Type | Description |
|---|---|---|
| version | string | Version number, or "current" (the default). |
| schema_id* | string | The schema id. |
{
"type": "object",
"required": [
"schema_id"
],
"properties": {
"version": {
"type": "string",
"description": "Version number, or \"current\" (the default)."
},
"schema_id": {
"type": "string",
"description": "The schema id."
}
},
"additionalProperties": false
}Set up standing forwarding from a bucket to a URL. Pass forward_all:true to forward every event, or condition_tree to forward only matching events (same AND/OR condition grammar the routing engine uses). Creates the destination and routing rule in one call.
| Argument | Type | Description |
|---|---|---|
| url* | string | Destination URL to forward to. |
| name | string | Optional label for the destination. |
| bucket_id* | string | The endpoint id. |
| rule_name | string | Optional name for the routing rule when using condition_tree. |
| forward_all | boolean | Forward every event unconditionally. |
| condition_tree | object | A condition tree (AND/OR of field comparisons) to forward only matching events. Mutually exclusive with forward_all. |
{
"type": "object",
"required": [
"bucket_id",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Destination URL to forward to."
},
"name": {
"type": "string",
"description": "Optional label for the destination."
},
"bucket_id": {
"type": "string",
"description": "The endpoint id."
},
"rule_name": {
"type": "string",
"description": "Optional name for the routing rule when using condition_tree."
},
"forward_all": {
"type": "boolean",
"description": "Forward every event unconditionally."
},
"condition_tree": {
"type": "object",
"description": "A condition tree (AND/OR of field comparisons) to forward only matching events. Mutually exclusive with forward_all."
}
},
"additionalProperties": false
}Generate types, a runtime validator, or a full handler from a learned schema — the payoff of the knowledge layer. Everything is derived from the payloads this account ACTUALLY received, with genuinely-optional fields marked optional, instead of a plausible-but-wrong guess from a model's memory of the provider docs. Pass lang for a bare type (typescript / json-schema / zod), or framework (next / express) for a ready-to-paste handler that validates and hands back a fully-typed event.
| Argument | Type | Description |
|---|---|---|
| lang | string | Output format for a bare type. |
| version | string | Version number, or "current" (the default). |
| framework | string | Return a ready-to-paste handler scaffold instead of a bare type. Overrides lang. |
| schema_id* | string | The schema id. |
{
"type": "object",
"required": [
"schema_id"
],
"properties": {
"lang": {
"enum": [
"typescript",
"json-schema",
"zod"
],
"type": "string",
"description": "Output format for a bare type."
},
"version": {
"type": "string",
"description": "Version number, or \"current\" (the default)."
},
"framework": {
"enum": [
"next",
"express"
],
"type": "string",
"description": "Return a ready-to-paste handler scaffold instead of a bare type. Overrides lang."
},
"schema_id": {
"type": "string",
"description": "The schema id."
}
},
"additionalProperties": false
}Fetch one webhook endpoint by id, including its url and inbox_url.
| Argument | Type | Description |
|---|---|---|
| bucket_id* | string | The endpoint id. |
{
"type": "object",
"required": [
"bucket_id"
],
"properties": {
"bucket_id": {
"type": "string",
"description": "The endpoint id."
}
},
"additionalProperties": false
}Fetch one captured event by id with its full headers, body, signature verification result (and failure reason), and every outbound delivery attempt. This is how you find out whether your forward actually reached its target and what came back.
| Argument | Type | Description |
|---|---|---|
| event_id* | string | The event id. |
{
"type": "object",
"required": [
"event_id"
],
"properties": {
"event_id": {
"type": "string",
"description": "The event id."
}
},
"additionalProperties": false
}Fetch one learned schema with every field, its type, whether it is optional, and how often it actually appears — the real shape of the payload, derived from what this account received rather than guessed from training data.
| Argument | Type | Description |
|---|---|---|
| version | string | Version number, or "current" (the default). |
| schema_id* | string | The schema id. |
{
"type": "object",
"required": [
"schema_id"
],
"properties": {
"version": {
"type": "string",
"description": "Version number, or \"current\" (the default)."
},
"schema_id": {
"type": "string",
"description": "The schema id."
}
},
"additionalProperties": false
}Get the single most recent event captured by a bucket, optionally filtered by provider and event type. Returns one event with its headers, body and delivery results — the one-shot answer to "what did Stripe last send me". 404 if nothing matches, so you never index into an empty list.
| Argument | Type | Description |
|---|---|---|
| type | string | The provider's own event name, matched exactly (e.g. payment_intent.succeeded). |
| provider | string | Filter to a provider attributed at ingest (e.g. stripe, github). |
| bucket_id* | string | The endpoint id. |
{
"type": "object",
"required": [
"bucket_id"
],
"properties": {
"type": {
"type": "string",
"description": "The provider's own event name, matched exactly (e.g. payment_intent.succeeded)."
},
"provider": {
"type": "string",
"description": "Filter to a provider attributed at ingest (e.g. stripe, github)."
},
"bucket_id": {
"type": "string",
"description": "The endpoint id."
}
},
"additionalProperties": false
}List your webhook endpoints. Pass external_ref to fetch the specific bucket you created earlier under that name — this is how you re-anchor after losing the conversation, since you never need to have stored the bucket id.
| Argument | Type | Description |
|---|---|---|
| external_ref | string | Return only the bucket with this exact external_ref. |
{
"type": "object",
"required": [],
"properties": {
"external_ref": {
"type": "string",
"description": "Return only the bucket with this exact external_ref."
}
},
"additionalProperties": false
}List outbound delivery attempts for a bucket, newest first, with the full request and response of each. Pass success:false to see only failures — the direct answer to "which of my forwards are broken and why".
| Argument | Type | Description |
|---|---|---|
| limit | number | Max deliveries to return (1–100, default 20). |
| cursor | string | Pagination cursor from a previous response. |
| source | string | Delivery source. |
| success | boolean | Filter to succeeded (true) or failed (false) deliveries. |
| bucket_id* | string | The endpoint id. |
{
"type": "object",
"required": [
"bucket_id"
],
"properties": {
"limit": {
"type": "number",
"description": "Max deliveries to return (1–100, default 20)."
},
"cursor": {
"type": "string",
"description": "Pagination cursor from a previous response."
},
"source": {
"enum": [
"rule",
"replay",
"manual_test"
],
"type": "string",
"description": "Delivery source."
},
"success": {
"type": "boolean",
"description": "Filter to succeeded (true) or failed (false) deliveries."
},
"bucket_id": {
"type": "string",
"description": "The endpoint id."
}
},
"additionalProperties": false
}List events captured by a bucket, newest first, with composable filters: since/until (ISO 8601 or YYYY-MM-DD), provider, type, method, signature_valid, and q (case-insensitive substring over body, content type, method, type and labels). Use cursor for the next page.
| Argument | Type | Description |
|---|---|---|
| q | string | Case-insensitive substring search over body/content-type/method/type/labels. |
| type | string | The provider's own event name, matched exactly. |
| limit | number | Max events to return (1–100, default 20). |
| since | string | Only events at or after this time (ISO 8601 or YYYY-MM-DD). |
| until | string | Only events at or before this time. |
| cursor | string | Pagination cursor from a previous response. |
| method | string | HTTP method (GET, POST, ...). |
| provider | string | Filter to a provider (e.g. stripe, github). |
| bucket_id* | string | The endpoint id. |
List the payload schemas Webhook Studio has learned from this account's real traffic, optionally filtered by provider and event_type. These outlive the payloads they were learned from, so this answers "what shapes do I know about" even after old events are gone. Start here to discover what you can generate types or diffs for.
| Argument | Type | Description |
|---|---|---|
| provider | string | Filter to a provider. |
| event_type | string | The provider's own event name. |
{
"type": "object",
"required": [],
"properties": {
"provider": {
"type": "string",
"description": "Filter to a provider."
},
"event_type": {
"type": "string",
"description": "The provider's own event name."
}
},
"additionalProperties": false
}Re-send a captured event to any URL — the test runner for a handler you just wrote. preserve_headers defaults to true so the original signature header (e.g. Stripe-Signature) arrives intact. If you changed the body or the receiver verifies with a different secret, pass resign_with (the dev's own signing secret) so the payload is re-signed and their verification code passes unmodified. Returns the response status, latency and body.
| Argument | Type | Description |
|---|---|---|
| url* | string | Destination URL to send it to. |
| body | string | Replacement request body (defaults to the captured body). |
| headers | object | Header overrides layered on top of the preserved set. |
| event_id* | string | The event id to replay. |
| resign_with | string | Signing secret to re-sign the payload with (≥16 chars). |
| preserve_headers | boolean | Replay the captured headers verbatim (default true). |
| signature_header | string | Header name for resign_with (default x-signature). |
{
"type": "object",
"required": [
"event_id",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Destination URL to send it to."
},
"body": {
"type": "string",
"description": "Replacement request body (defaults to the captured body)."
},
"headers": {
"type": "object",
"description": "Header overrides layered on top of the preserved set."
},
"event_id": {
"type": "string",
"description": "The event id to replay."
},
"resign_with": {
"type": "string",
"description": "Signing secret to re-sign the payload with (≥16 chars)."
},
"preserve_headers": {
"type": "boolean",
"description": "Replay the captured headers verbatim (default true)."
},
"signature_header": {
"type": "string",
"description": "Header name for resign_with (default x-signature)."
}
},
"additionalProperties": false
}Block until the next matching event arrives on a bucket, or until the timeout. Use this to turn "go click Send test webhook in Stripe" into a synchronous step: call it, tell the human to trigger the event, and it returns as soon as one arrives. Filters (provider, type) mean unrelated traffic does not wake it. Returns the event, or nothing if it times out.
| Argument | Type | Description |
|---|---|---|
| type | string | Only resolve on this event type. |
| timeout | number | Seconds to wait (1–55, default 30). |
| provider | string | Only resolve on an event from this provider. |
| bucket_id* | string | The endpoint id. |
{
"type": "object",
"required": [
"bucket_id"
],
"properties": {
"type": {
"type": "string",
"description": "Only resolve on this event type."
},
"timeout": {
"type": "number",
"description": "Seconds to wait (1–55, default 30)."
},
"provider": {
"type": "string",
"description": "Only resolve on an event from this provider."
},
"bucket_id": {
"type": "string",
"description": "The endpoint id."
}
},
"additionalProperties": false
}| signature_valid |
| boolean |
| Only events whose signature verification passed/failed. |
{
"type": "object",
"required": [
"bucket_id"
],
"properties": {
"q": {
"type": "string",
"description": "Case-insensitive substring search over body/content-type/method/type/labels."
},
"type": {
"type": "string",
"description": "The provider's own event name, matched exactly."
},
"limit": {
"type": "number",
"description": "Max events to return (1–100, default 20)."
},
"since": {
"type": "string",
"description": "Only events at or after this time (ISO 8601 or YYYY-MM-DD)."
},
"until": {
"type": "string",
"description": "Only events at or before this time."
},
"cursor": {
"type": "string",
"description": "Pagination cursor from a previous response."
},
"method": {
"type": "string",
"description": "HTTP method (GET, POST, ...)."
},
"provider": {
"type": "string",
"description": "Filter to a provider (e.g. stripe, github)."
},
"bucket_id": {
"type": "string",
"description": "The endpoint id."
},
"signature_valid": {
"type": "boolean",
"description": "Only events whose signature verification passed/failed."
}
},
"additionalProperties": false
}