@webhooks-cc/mcp 1.11.0 → 1.12.1

package/README.md

@@ -97,13 +97,14 @@ The request tools and resources return emails too (filter with `kind`), without
 
 ### Forwarding tools
 
-Forward every captured email to a URL as signed JSON (owner only):
+Forward every captured HTTP request and email to a URL or a Slack or Discord channel, as received,
+as signed JSON or as a chat message, retried and logged (owner only):
 
-- `configure_forwarding`
+- `configure_forwarding` (URL, on/off, kinds, format, your headers, path, retries, order, sent time field)
 - `get_forwarding_secret` (returns the `whsec_` secret; with `rotate: true`, replaces it)
 - `test_forwarding`
-- `list_deliveries`
-- `redeliver_email`
+- `list_deliveries` (the delivery log with its counts, or every try of one request)
+- `redeliver` (one request, or every failed delivery of an endpoint)
 
 ### Send and test tools
 

package/dist/bin/mcp.js

@@ -157,6 +157,13 @@ function omitHeaders(holder) {
   holder.headers = {};
   holder.headersOmitted = `${count} headers left out to fit the output`;
 }
+function trimSpam(holder) {
+  const spam = holder.spam;
+  if (spam && typeof spam === "object" && !Array.isArray(spam)) {
+    const { score, required, action, error } = spam;
+    holder.spam = { score, required, action, error };
+  }
+}
 function capExtracts(holder) {
   if (Array.isArray(holder.codes) && holder.codes.length > MAX_EXTRACTS) {
     holder.codes = holder.codes.slice(0, MAX_EXTRACTS);
@@ -221,7 +228,8 @@ var ESSENTIAL_EMAIL_FIELDS = [
   "date",
   "text",
   "textTruncated",
-  "htmlSize"
+  "htmlSize",
+  "spam"
 ];
 function compactRequest(request) {
   if (request.kind !== "email") return request;
@@ -248,6 +256,7 @@ function compactRequest(request) {
   const budget = MAX_OUTPUT - 128;
   shrinkToFit(root, budget, [
     () => omitHeaders(compact),
+    () => trimSpam(email),
     () => capLists(email),
     () => cutStringToFit(root, email, "text", "textTruncated", budget, TEXT_FLOOR),
     // Down to the essentials there may be room for more of the text again.
@@ -737,6 +746,7 @@ var ESSENTIAL_DETAIL_FIELDS = [
   "from",
   "size",
   "test",
+  "spam",
   "text",
   "textTruncated",
   "htmlSize",
@@ -765,6 +775,7 @@ function emailDetail(client, email, view, includeHtml) {
   };
   shrinkToFit(detail, MAX_BODY_SIZE, [
     () => omitHeaders(detail),
+    () => trimSpam(detail),
     () => capExtracts(detail),
     () => capLists(detail),
     () => cutStringToFit(detail, detail, "html", "htmlTruncated", MAX_BODY_SIZE),
@@ -1537,25 +1548,52 @@ function registerTools(server, client) {
   );
   server.tool(
     "configure_forwarding",
-    "Set the URL captured emails are forwarded to (as signed JSON) and turn forwarding on or off. Owner only. Saving the first URL creates the signing secret.",
+    "Change an endpoint's forwarding: the URL, on or off, which kinds (HTTP requests, emails), the format, your own headers, and the advanced options. Only the arguments you pass change. Owner only. Saving the first URL creates the signing secret. A Slack or Discord webhook URL gets a chat message automatically.",
     {
       slug: import_zod2.z.string().describe("The endpoint slug"),
       url: httpUrlSchema.nullable().optional().describe("https URL on a public host name, or null to remove it (forwarding must be off)"),
-      enabled: import_zod2.z.boolean().optional().describe("Turn forwarding on (needs a URL) or off (fails deliveries still waiting)")
+      enabled: import_zod2.z.boolean().optional().describe("Turn forwarding on (needs a URL) or off (fails deliveries still waiting)"),
+      http: import_zod2.z.boolean().optional().describe("Forward HTTP requests"),
+      email: import_zod2.z.boolean().optional().describe("Forward emails"),
+      format: import_zod2.z.enum(["auto", "as_received", "json", "chat"]).optional().describe(
+        "auto (pick from the URL), as_received (relay HTTP requests unchanged; emails as signed JSON), json (signed JSON envelope for both kinds) or chat (Slack or Discord message)"
+      ),
+      headers: import_zod2.z.array(
+        import_zod2.z.object({
+          name: import_zod2.z.string().describe("Header name, e.g. Authorization"),
+          value: import_zod2.z.string().nullable().describe("Header value, or null to keep the value stored under this name")
+        })
+      ).max(10).optional().describe(
+        "Your own headers for every delivery (not chat). Replaces the whole list; [] removes them"
+      ),
+      appendPath: import_zod2.z.boolean().optional().describe("Add the path after the slug to the URL for relayed requests (default true)"),
+      retrySeconds: import_zod2.z.union([import_zod2.z.literal(0), import_zod2.z.literal(3600), import_zod2.z.literal(86400)]).optional().describe("Retry failed deliveries for 86400 (default), 3600 or 0 seconds"),
+      keepOrder: import_zod2.z.boolean().optional().describe("One delivery at a time, in capture order (default false)"),
+      sentField: import_zod2.z.string().max(128).nullable().optional().describe(
+        "JSON body field with the sender's own timestamp, e.g. publishedAt or data.publishedAt; null clears it"
+      )
     },
-    withErrorHandling(async ({ slug, url, enabled }) => {
-      const endpoint = await client.forwarding.configure(slug, { url, enabled });
+    withErrorHandling(async ({ slug, ...options }) => {
+      const endpoint = await client.forwarding.configure(slug, options);
       return jsonContent({
         slug: endpoint.slug,
         forwardEnabled: endpoint.forwardEnabled ?? false,
         forwardUrl: endpoint.forwardUrl ?? null,
-        hasForwardSecret: endpoint.hasForwardSecret ?? false
+        hasForwardSecret: endpoint.hasForwardSecret ?? false,
+        forwardHttp: endpoint.forwardHttp ?? false,
+        forwardEmail: endpoint.forwardEmail ?? false,
+        forwardFormat: endpoint.forwardFormat ?? "auto",
+        forwardHeaders: endpoint.forwardHeaders ?? [],
+        forwardAppendPath: endpoint.forwardAppendPath ?? true,
+        forwardRetrySeconds: endpoint.forwardRetrySeconds ?? 86400,
+        forwardKeepOrder: endpoint.forwardKeepOrder ?? false,
+        forwardSentField: endpoint.forwardSentField ?? null
       });
     })
   );
   server.tool(
     "get_forwarding_secret",
-    "Read (or with rotate: true, replace) the whsec_ secret forwarded emails are signed with. Owner only. Treat the value as a credential: put it in the handler's environment, not in code.",
+    "Read (or with rotate: true, replace) the whsec_ secret forwarded deliveries are signed with. Owner only. Treat the value as a credential: put it in the handler's environment, not in code.",
     {
       slug: import_zod2.z.string().describe("The endpoint slug"),
       rotate: import_zod2.z.boolean().default(false).describe("Replace the secret; every delivery from now on uses the new one")
@@ -1567,35 +1605,57 @@ function registerTools(server, client) {
   );
   server.tool(
     "test_forwarding",
-    "Post the endpoint's newest email (or a sample) to its forwarding URL once and report what the server answered. Works with forwarding on or off; nothing is retried or logged.",
-    { slug: import_zod2.z.string().describe("The endpoint slug") },
-    withErrorHandling(async ({ slug }) => {
-      return jsonContent(await client.forwarding.test(slug));
+    "Send the endpoint's newest captured request of a kind (or a sample) to its forwarding URL once, exactly as a delivery would go out, and report the answer. Works with forwarding on or off; nothing is retried or logged.",
+    {
+      slug: import_zod2.z.string().describe("The endpoint slug"),
+      kind: import_zod2.z.enum(["http", "email"]).optional().describe(
+        "Which kind to send (default: http when HTTP requests are forwarded, else email)"
+      )
+    },
+    withErrorHandling(async ({ slug, kind }) => {
+      return jsonContent(await client.forwarding.test(slug, kind ? { kind } : {}));
     })
   );
   server.tool(
     "list_deliveries",
-    "List forwarding deliveries: an endpoint's latest (endpointSlug), or every try of one email (requestId).",
+    "List forwarding deliveries: an endpoint's delivery log with its counts (endpointSlug), or every delivery and try of one captured request or email (requestId). Rows carry senderAt when the request had the sender's own timestamp, so receivedAt - senderAt is the time to reach webhooks.cc.",
     {
-      endpointSlug: import_zod2.z.string().optional().describe("List the endpoint's latest deliveries"),
-      requestId: import_zod2.z.string().optional().describe("List every delivery and try of this email"),
-      limit: import_zod2.z.number().int().min(1).max(20).default(5).describe("With endpointSlug: max deliveries")
+      endpointSlug: import_zod2.z.string().optional().describe("List the endpoint's delivery log"),
+      requestId: import_zod2.z.string().optional().describe("List every delivery and try of this request"),
+      limit: import_zod2.z.number().int().min(1).max(100).default(20).describe("With endpointSlug: max rows"),
+      status: import_zod2.z.enum(["all", "pending", "failed"]).default("all").describe("With endpointSlug: all, pending (queued or retrying) or failed"),
+      before: import_zod2.z.string().optional().describe("With endpointSlug: a row's cursor, to list older rows")
     },
-    withErrorHandling(async ({ endpointSlug, requestId, limit }) => {
+    withErrorHandling(async ({ endpointSlug, requestId, limit, status, before }) => {
       if (requestId === void 0 === (endpointSlug === void 0)) {
         throw new Error("Pass exactly one of endpointSlug or requestId");
       }
-      return jsonContent(
-        requestId ? await client.forwarding.emailDeliveries(requestId) : await client.forwarding.deliveries(endpointSlug, { limit })
-      );
+      if (requestId) return jsonContent(await client.forwarding.requestDeliveries(requestId));
+      const [summary, deliveries] = await Promise.all([
+        client.forwarding.summary(endpointSlug),
+        client.forwarding.deliveries(endpointSlug, { limit, status, before })
+      ]);
+      return jsonContent({
+        summary,
+        deliveries,
+        nextCursor: deliveries.length === limit ? deliveries[deliveries.length - 1]?.cursor ?? null : null
+      });
     })
   );
   server.tool(
-    "redeliver_email",
-    "Forward a captured email again with the endpoint's current URL and secret. Owner only; fails while forwarding is off.",
-    { requestId: import_zod2.z.string().describe("The email's request ID") },
-    withErrorHandling(async ({ requestId }) => {
-      return jsonContent(await client.forwarding.redeliver(requestId));
+    "redeliver",
+    "Forward again with the endpoint's current settings: one captured request or email (requestId; it also sends one that was never forwarded), or every request whose latest delivery failed (endpointSlug, oldest first, up to 1,000 at a time). Owner only; fails while forwarding is off.",
+    {
+      requestId: import_zod2.z.string().optional().describe("The request or email to send again"),
+      endpointSlug: import_zod2.z.string().optional().describe("Send every failed delivery of this endpoint again")
+    },
+    withErrorHandling(async ({ requestId, endpointSlug }) => {
+      if (requestId === void 0 === (endpointSlug === void 0)) {
+        throw new Error("Pass exactly one of requestId or endpointSlug");
+      }
+      return jsonContent(
+        requestId ? await client.forwarding.redeliver(requestId) : await client.forwarding.redeliverFailed(endpointSlug)
+      );
     })
   );
   server.tool(
@@ -1974,7 +2034,7 @@ function registerSandboxTools(server, options = {}) {
 }
 
 // src/index.ts
-var VERSION = true ? "1.11.0" : "0.0.0-dev";
+var VERSION = true ? "1.12.1" : "0.0.0-dev";
 function createServer(options = {}) {
   const apiKey = options.apiKey ?? process.env.WHK_API_KEY;
   const webhookUrl = options.webhookUrl ?? process.env.WHK_WEBHOOK_URL;

package/dist/index.js

@@ -180,6 +180,13 @@ function omitHeaders(holder) {
   holder.headers = {};
   holder.headersOmitted = `${count} headers left out to fit the output`;
 }
+function trimSpam(holder) {
+  const spam = holder.spam;
+  if (spam && typeof spam === "object" && !Array.isArray(spam)) {
+    const { score, required, action, error } = spam;
+    holder.spam = { score, required, action, error };
+  }
+}
 function capExtracts(holder) {
   if (Array.isArray(holder.codes) && holder.codes.length > MAX_EXTRACTS) {
     holder.codes = holder.codes.slice(0, MAX_EXTRACTS);
@@ -244,7 +251,8 @@ var ESSENTIAL_EMAIL_FIELDS = [
   "date",
   "text",
   "textTruncated",
-  "htmlSize"
+  "htmlSize",
+  "spam"
 ];
 function compactRequest(request) {
   if (request.kind !== "email") return request;
@@ -271,6 +279,7 @@ function compactRequest(request) {
   const budget = MAX_OUTPUT - 128;
   shrinkToFit(root, budget, [
     () => omitHeaders(compact),
+    () => trimSpam(email),
     () => capLists(email),
     () => cutStringToFit(root, email, "text", "textTruncated", budget, TEXT_FLOOR),
     // Down to the essentials there may be room for more of the text again.
@@ -760,6 +769,7 @@ var ESSENTIAL_DETAIL_FIELDS = [
   "from",
   "size",
   "test",
+  "spam",
   "text",
   "textTruncated",
   "htmlSize",
@@ -788,6 +798,7 @@ function emailDetail(client, email, view, includeHtml) {
   };
   shrinkToFit(detail, MAX_BODY_SIZE, [
     () => omitHeaders(detail),
+    () => trimSpam(detail),
     () => capExtracts(detail),
     () => capLists(detail),
     () => cutStringToFit(detail, detail, "html", "htmlTruncated", MAX_BODY_SIZE),
@@ -1560,25 +1571,52 @@ function registerTools(server, client) {
   );
   server.tool(
     "configure_forwarding",
-    "Set the URL captured emails are forwarded to (as signed JSON) and turn forwarding on or off. Owner only. Saving the first URL creates the signing secret.",
+    "Change an endpoint's forwarding: the URL, on or off, which kinds (HTTP requests, emails), the format, your own headers, and the advanced options. Only the arguments you pass change. Owner only. Saving the first URL creates the signing secret. A Slack or Discord webhook URL gets a chat message automatically.",
     {
       slug: import_zod2.z.string().describe("The endpoint slug"),
       url: httpUrlSchema.nullable().optional().describe("https URL on a public host name, or null to remove it (forwarding must be off)"),
-      enabled: import_zod2.z.boolean().optional().describe("Turn forwarding on (needs a URL) or off (fails deliveries still waiting)")
+      enabled: import_zod2.z.boolean().optional().describe("Turn forwarding on (needs a URL) or off (fails deliveries still waiting)"),
+      http: import_zod2.z.boolean().optional().describe("Forward HTTP requests"),
+      email: import_zod2.z.boolean().optional().describe("Forward emails"),
+      format: import_zod2.z.enum(["auto", "as_received", "json", "chat"]).optional().describe(
+        "auto (pick from the URL), as_received (relay HTTP requests unchanged; emails as signed JSON), json (signed JSON envelope for both kinds) or chat (Slack or Discord message)"
+      ),
+      headers: import_zod2.z.array(
+        import_zod2.z.object({
+          name: import_zod2.z.string().describe("Header name, e.g. Authorization"),
+          value: import_zod2.z.string().nullable().describe("Header value, or null to keep the value stored under this name")
+        })
+      ).max(10).optional().describe(
+        "Your own headers for every delivery (not chat). Replaces the whole list; [] removes them"
+      ),
+      appendPath: import_zod2.z.boolean().optional().describe("Add the path after the slug to the URL for relayed requests (default true)"),
+      retrySeconds: import_zod2.z.union([import_zod2.z.literal(0), import_zod2.z.literal(3600), import_zod2.z.literal(86400)]).optional().describe("Retry failed deliveries for 86400 (default), 3600 or 0 seconds"),
+      keepOrder: import_zod2.z.boolean().optional().describe("One delivery at a time, in capture order (default false)"),
+      sentField: import_zod2.z.string().max(128).nullable().optional().describe(
+        "JSON body field with the sender's own timestamp, e.g. publishedAt or data.publishedAt; null clears it"
+      )
     },
-    withErrorHandling(async ({ slug, url, enabled }) => {
-      const endpoint = await client.forwarding.configure(slug, { url, enabled });
+    withErrorHandling(async ({ slug, ...options }) => {
+      const endpoint = await client.forwarding.configure(slug, options);
       return jsonContent({
         slug: endpoint.slug,
         forwardEnabled: endpoint.forwardEnabled ?? false,
         forwardUrl: endpoint.forwardUrl ?? null,
-        hasForwardSecret: endpoint.hasForwardSecret ?? false
+        hasForwardSecret: endpoint.hasForwardSecret ?? false,
+        forwardHttp: endpoint.forwardHttp ?? false,
+        forwardEmail: endpoint.forwardEmail ?? false,
+        forwardFormat: endpoint.forwardFormat ?? "auto",
+        forwardHeaders: endpoint.forwardHeaders ?? [],
+        forwardAppendPath: endpoint.forwardAppendPath ?? true,
+        forwardRetrySeconds: endpoint.forwardRetrySeconds ?? 86400,
+        forwardKeepOrder: endpoint.forwardKeepOrder ?? false,
+        forwardSentField: endpoint.forwardSentField ?? null
       });
     })
   );
   server.tool(
     "get_forwarding_secret",
-    "Read (or with rotate: true, replace) the whsec_ secret forwarded emails are signed with. Owner only. Treat the value as a credential: put it in the handler's environment, not in code.",
+    "Read (or with rotate: true, replace) the whsec_ secret forwarded deliveries are signed with. Owner only. Treat the value as a credential: put it in the handler's environment, not in code.",
     {
       slug: import_zod2.z.string().describe("The endpoint slug"),
       rotate: import_zod2.z.boolean().default(false).describe("Replace the secret; every delivery from now on uses the new one")
@@ -1590,35 +1628,57 @@ function registerTools(server, client) {
   );
   server.tool(
     "test_forwarding",
-    "Post the endpoint's newest email (or a sample) to its forwarding URL once and report what the server answered. Works with forwarding on or off; nothing is retried or logged.",
-    { slug: import_zod2.z.string().describe("The endpoint slug") },
-    withErrorHandling(async ({ slug }) => {
-      return jsonContent(await client.forwarding.test(slug));
+    "Send the endpoint's newest captured request of a kind (or a sample) to its forwarding URL once, exactly as a delivery would go out, and report the answer. Works with forwarding on or off; nothing is retried or logged.",
+    {
+      slug: import_zod2.z.string().describe("The endpoint slug"),
+      kind: import_zod2.z.enum(["http", "email"]).optional().describe(
+        "Which kind to send (default: http when HTTP requests are forwarded, else email)"
+      )
+    },
+    withErrorHandling(async ({ slug, kind }) => {
+      return jsonContent(await client.forwarding.test(slug, kind ? { kind } : {}));
     })
   );
   server.tool(
     "list_deliveries",
-    "List forwarding deliveries: an endpoint's latest (endpointSlug), or every try of one email (requestId).",
+    "List forwarding deliveries: an endpoint's delivery log with its counts (endpointSlug), or every delivery and try of one captured request or email (requestId). Rows carry senderAt when the request had the sender's own timestamp, so receivedAt - senderAt is the time to reach webhooks.cc.",
     {
-      endpointSlug: import_zod2.z.string().optional().describe("List the endpoint's latest deliveries"),
-      requestId: import_zod2.z.string().optional().describe("List every delivery and try of this email"),
-      limit: import_zod2.z.number().int().min(1).max(20).default(5).describe("With endpointSlug: max deliveries")
+      endpointSlug: import_zod2.z.string().optional().describe("List the endpoint's delivery log"),
+      requestId: import_zod2.z.string().optional().describe("List every delivery and try of this request"),
+      limit: import_zod2.z.number().int().min(1).max(100).default(20).describe("With endpointSlug: max rows"),
+      status: import_zod2.z.enum(["all", "pending", "failed"]).default("all").describe("With endpointSlug: all, pending (queued or retrying) or failed"),
+      before: import_zod2.z.string().optional().describe("With endpointSlug: a row's cursor, to list older rows")
     },
-    withErrorHandling(async ({ endpointSlug, requestId, limit }) => {
+    withErrorHandling(async ({ endpointSlug, requestId, limit, status, before }) => {
       if (requestId === void 0 === (endpointSlug === void 0)) {
         throw new Error("Pass exactly one of endpointSlug or requestId");
       }
-      return jsonContent(
-        requestId ? await client.forwarding.emailDeliveries(requestId) : await client.forwarding.deliveries(endpointSlug, { limit })
-      );
+      if (requestId) return jsonContent(await client.forwarding.requestDeliveries(requestId));
+      const [summary, deliveries] = await Promise.all([
+        client.forwarding.summary(endpointSlug),
+        client.forwarding.deliveries(endpointSlug, { limit, status, before })
+      ]);
+      return jsonContent({
+        summary,
+        deliveries,
+        nextCursor: deliveries.length === limit ? deliveries[deliveries.length - 1]?.cursor ?? null : null
+      });
     })
   );
   server.tool(
-    "redeliver_email",
-    "Forward a captured email again with the endpoint's current URL and secret. Owner only; fails while forwarding is off.",
-    { requestId: import_zod2.z.string().describe("The email's request ID") },
-    withErrorHandling(async ({ requestId }) => {
-      return jsonContent(await client.forwarding.redeliver(requestId));
+    "redeliver",
+    "Forward again with the endpoint's current settings: one captured request or email (requestId; it also sends one that was never forwarded), or every request whose latest delivery failed (endpointSlug, oldest first, up to 1,000 at a time). Owner only; fails while forwarding is off.",
+    {
+      requestId: import_zod2.z.string().optional().describe("The request or email to send again"),
+      endpointSlug: import_zod2.z.string().optional().describe("Send every failed delivery of this endpoint again")
+    },
+    withErrorHandling(async ({ requestId, endpointSlug }) => {
+      if (requestId === void 0 === (endpointSlug === void 0)) {
+        throw new Error("Pass exactly one of requestId or endpointSlug");
+      }
+      return jsonContent(
+        requestId ? await client.forwarding.redeliver(requestId) : await client.forwarding.redeliverFailed(endpointSlug)
+      );
     })
   );
   server.tool(
@@ -2000,7 +2060,7 @@ function registerAgentRegistrationTools(server) {
 }
 
 // src/index.ts
-var VERSION = true ? "1.11.0" : "0.0.0-dev";
+var VERSION = true ? "1.12.1" : "0.0.0-dev";
 function createServer(options = {}) {
   const apiKey = options.apiKey ?? process.env.WHK_API_KEY;
   const webhookUrl = options.webhookUrl ?? process.env.WHK_WEBHOOK_URL;

package/dist/index.mjs

@@ -151,6 +151,13 @@ function omitHeaders(holder) {
   holder.headers = {};
   holder.headersOmitted = `${count} headers left out to fit the output`;
 }
+function trimSpam(holder) {
+  const spam = holder.spam;
+  if (spam && typeof spam === "object" && !Array.isArray(spam)) {
+    const { score, required, action, error } = spam;
+    holder.spam = { score, required, action, error };
+  }
+}
 function capExtracts(holder) {
   if (Array.isArray(holder.codes) && holder.codes.length > MAX_EXTRACTS) {
     holder.codes = holder.codes.slice(0, MAX_EXTRACTS);
@@ -215,7 +222,8 @@ var ESSENTIAL_EMAIL_FIELDS = [
   "date",
   "text",
   "textTruncated",
-  "htmlSize"
+  "htmlSize",
+  "spam"
 ];
 function compactRequest(request) {
   if (request.kind !== "email") return request;
@@ -242,6 +250,7 @@ function compactRequest(request) {
   const budget = MAX_OUTPUT - 128;
   shrinkToFit(root, budget, [
     () => omitHeaders(compact),
+    () => trimSpam(email),
     () => capLists(email),
     () => cutStringToFit(root, email, "text", "textTruncated", budget, TEXT_FLOOR),
     // Down to the essentials there may be room for more of the text again.
@@ -757,6 +766,7 @@ var ESSENTIAL_DETAIL_FIELDS = [
   "from",
   "size",
   "test",
+  "spam",
   "text",
   "textTruncated",
   "htmlSize",
@@ -785,6 +795,7 @@ function emailDetail(client, email, view, includeHtml) {
   };
   shrinkToFit(detail, MAX_BODY_SIZE, [
     () => omitHeaders(detail),
+    () => trimSpam(detail),
     () => capExtracts(detail),
     () => capLists(detail),
     () => cutStringToFit(detail, detail, "html", "htmlTruncated", MAX_BODY_SIZE),
@@ -1557,25 +1568,52 @@ function registerTools(server, client) {
   );
   server.tool(
     "configure_forwarding",
-    "Set the URL captured emails are forwarded to (as signed JSON) and turn forwarding on or off. Owner only. Saving the first URL creates the signing secret.",
+    "Change an endpoint's forwarding: the URL, on or off, which kinds (HTTP requests, emails), the format, your own headers, and the advanced options. Only the arguments you pass change. Owner only. Saving the first URL creates the signing secret. A Slack or Discord webhook URL gets a chat message automatically.",
     {
       slug: z2.string().describe("The endpoint slug"),
       url: httpUrlSchema.nullable().optional().describe("https URL on a public host name, or null to remove it (forwarding must be off)"),
-      enabled: z2.boolean().optional().describe("Turn forwarding on (needs a URL) or off (fails deliveries still waiting)")
+      enabled: z2.boolean().optional().describe("Turn forwarding on (needs a URL) or off (fails deliveries still waiting)"),
+      http: z2.boolean().optional().describe("Forward HTTP requests"),
+      email: z2.boolean().optional().describe("Forward emails"),
+      format: z2.enum(["auto", "as_received", "json", "chat"]).optional().describe(
+        "auto (pick from the URL), as_received (relay HTTP requests unchanged; emails as signed JSON), json (signed JSON envelope for both kinds) or chat (Slack or Discord message)"
+      ),
+      headers: z2.array(
+        z2.object({
+          name: z2.string().describe("Header name, e.g. Authorization"),
+          value: z2.string().nullable().describe("Header value, or null to keep the value stored under this name")
+        })
+      ).max(10).optional().describe(
+        "Your own headers for every delivery (not chat). Replaces the whole list; [] removes them"
+      ),
+      appendPath: z2.boolean().optional().describe("Add the path after the slug to the URL for relayed requests (default true)"),
+      retrySeconds: z2.union([z2.literal(0), z2.literal(3600), z2.literal(86400)]).optional().describe("Retry failed deliveries for 86400 (default), 3600 or 0 seconds"),
+      keepOrder: z2.boolean().optional().describe("One delivery at a time, in capture order (default false)"),
+      sentField: z2.string().max(128).nullable().optional().describe(
+        "JSON body field with the sender's own timestamp, e.g. publishedAt or data.publishedAt; null clears it"
+      )
     },
-    withErrorHandling(async ({ slug, url, enabled }) => {
-      const endpoint = await client.forwarding.configure(slug, { url, enabled });
+    withErrorHandling(async ({ slug, ...options }) => {
+      const endpoint = await client.forwarding.configure(slug, options);
       return jsonContent({
         slug: endpoint.slug,
         forwardEnabled: endpoint.forwardEnabled ?? false,
         forwardUrl: endpoint.forwardUrl ?? null,
-        hasForwardSecret: endpoint.hasForwardSecret ?? false
+        hasForwardSecret: endpoint.hasForwardSecret ?? false,
+        forwardHttp: endpoint.forwardHttp ?? false,
+        forwardEmail: endpoint.forwardEmail ?? false,
+        forwardFormat: endpoint.forwardFormat ?? "auto",
+        forwardHeaders: endpoint.forwardHeaders ?? [],
+        forwardAppendPath: endpoint.forwardAppendPath ?? true,
+        forwardRetrySeconds: endpoint.forwardRetrySeconds ?? 86400,
+        forwardKeepOrder: endpoint.forwardKeepOrder ?? false,
+        forwardSentField: endpoint.forwardSentField ?? null
       });
     })
   );
   server.tool(
     "get_forwarding_secret",
-    "Read (or with rotate: true, replace) the whsec_ secret forwarded emails are signed with. Owner only. Treat the value as a credential: put it in the handler's environment, not in code.",
+    "Read (or with rotate: true, replace) the whsec_ secret forwarded deliveries are signed with. Owner only. Treat the value as a credential: put it in the handler's environment, not in code.",
     {
       slug: z2.string().describe("The endpoint slug"),
       rotate: z2.boolean().default(false).describe("Replace the secret; every delivery from now on uses the new one")
@@ -1587,35 +1625,57 @@ function registerTools(server, client) {
   );
   server.tool(
     "test_forwarding",
-    "Post the endpoint's newest email (or a sample) to its forwarding URL once and report what the server answered. Works with forwarding on or off; nothing is retried or logged.",
-    { slug: z2.string().describe("The endpoint slug") },
-    withErrorHandling(async ({ slug }) => {
-      return jsonContent(await client.forwarding.test(slug));
+    "Send the endpoint's newest captured request of a kind (or a sample) to its forwarding URL once, exactly as a delivery would go out, and report the answer. Works with forwarding on or off; nothing is retried or logged.",
+    {
+      slug: z2.string().describe("The endpoint slug"),
+      kind: z2.enum(["http", "email"]).optional().describe(
+        "Which kind to send (default: http when HTTP requests are forwarded, else email)"
+      )
+    },
+    withErrorHandling(async ({ slug, kind }) => {
+      return jsonContent(await client.forwarding.test(slug, kind ? { kind } : {}));
     })
   );
   server.tool(
     "list_deliveries",
-    "List forwarding deliveries: an endpoint's latest (endpointSlug), or every try of one email (requestId).",
+    "List forwarding deliveries: an endpoint's delivery log with its counts (endpointSlug), or every delivery and try of one captured request or email (requestId). Rows carry senderAt when the request had the sender's own timestamp, so receivedAt - senderAt is the time to reach webhooks.cc.",
     {
-      endpointSlug: z2.string().optional().describe("List the endpoint's latest deliveries"),
-      requestId: z2.string().optional().describe("List every delivery and try of this email"),
-      limit: z2.number().int().min(1).max(20).default(5).describe("With endpointSlug: max deliveries")
+      endpointSlug: z2.string().optional().describe("List the endpoint's delivery log"),
+      requestId: z2.string().optional().describe("List every delivery and try of this request"),
+      limit: z2.number().int().min(1).max(100).default(20).describe("With endpointSlug: max rows"),
+      status: z2.enum(["all", "pending", "failed"]).default("all").describe("With endpointSlug: all, pending (queued or retrying) or failed"),
+      before: z2.string().optional().describe("With endpointSlug: a row's cursor, to list older rows")
     },
-    withErrorHandling(async ({ endpointSlug, requestId, limit }) => {
+    withErrorHandling(async ({ endpointSlug, requestId, limit, status, before }) => {
       if (requestId === void 0 === (endpointSlug === void 0)) {
         throw new Error("Pass exactly one of endpointSlug or requestId");
       }
-      return jsonContent(
-        requestId ? await client.forwarding.emailDeliveries(requestId) : await client.forwarding.deliveries(endpointSlug, { limit })
-      );
+      if (requestId) return jsonContent(await client.forwarding.requestDeliveries(requestId));
+      const [summary, deliveries] = await Promise.all([
+        client.forwarding.summary(endpointSlug),
+        client.forwarding.deliveries(endpointSlug, { limit, status, before })
+      ]);
+      return jsonContent({
+        summary,
+        deliveries,
+        nextCursor: deliveries.length === limit ? deliveries[deliveries.length - 1]?.cursor ?? null : null
+      });
     })
   );
   server.tool(
-    "redeliver_email",
-    "Forward a captured email again with the endpoint's current URL and secret. Owner only; fails while forwarding is off.",
-    { requestId: z2.string().describe("The email's request ID") },
-    withErrorHandling(async ({ requestId }) => {
-      return jsonContent(await client.forwarding.redeliver(requestId));
+    "redeliver",
+    "Forward again with the endpoint's current settings: one captured request or email (requestId; it also sends one that was never forwarded), or every request whose latest delivery failed (endpointSlug, oldest first, up to 1,000 at a time). Owner only; fails while forwarding is off.",
+    {
+      requestId: z2.string().optional().describe("The request or email to send again"),
+      endpointSlug: z2.string().optional().describe("Send every failed delivery of this endpoint again")
+    },
+    withErrorHandling(async ({ requestId, endpointSlug }) => {
+      if (requestId === void 0 === (endpointSlug === void 0)) {
+        throw new Error("Pass exactly one of requestId or endpointSlug");
+      }
+      return jsonContent(
+        requestId ? await client.forwarding.redeliver(requestId) : await client.forwarding.redeliverFailed(endpointSlug)
+      );
     })
   );
   server.tool(
@@ -1997,7 +2057,7 @@ function registerAgentRegistrationTools(server) {
 }
 
 // src/index.ts
-var VERSION = true ? "1.11.0" : "0.0.0-dev";
+var VERSION = true ? "1.12.1" : "0.0.0-dev";
 function createServer(options = {}) {
   const apiKey = options.apiKey ?? process.env.WHK_API_KEY;
   const webhookUrl = options.webhookUrl ?? process.env.WHK_WEBHOOK_URL;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webhooks-cc/mcp",
-  "version": "1.11.0",
+  "version": "1.12.1",
   "description": "MCP server for webhooks.cc — AI agent integration for webhook testing",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -38,7 +38,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.31.0",
     "zod": "^4.6.5",
-    "@webhooks-cc/sdk": "1.13.0"
+    "@webhooks-cc/sdk": "1.15.0"
   },
   "devDependencies": {
     "@types/node": "^26.6.4",