@webhooks-cc/mcp 1.10.1 → 1.11.0

package/dist/index.d.mts

@@ -3,12 +3,27 @@ import { WebhooksCC } from '@webhooks-cc/sdk';
 
 /** Register all webhook tools on an MCP server instance. */
 declare function registerTools(server: McpServer, client: WebhooksCC): void;
+
+interface SandboxToolOptions {
+    /** API base URL (default: WHK_BASE_URL or https://webhooks.cc). */
+    baseUrl?: string;
+    /** Webhook receiver URL (default: WHK_WEBHOOK_URL or https://go.webhooks.cc). */
+    webhookUrl?: string;
+    /** The agent's name, shown to the human as self-reported. */
+    clientName?: string;
+    /** Called once a human has connected the agent, with a client for their account. */
+    onConnected?: (client: WebhooksCC) => void;
+}
+/**
+ * Registers the sandbox tools (create_endpoint, list_endpoints,
+ * get_endpoint, delete_endpoint, list_requests, get_request,
+ * wait_for_request) and connect_account, wait_for_connection and
+ * about_sandbox.
+ */
+declare function registerSandboxTools(server: McpServer, options?: SandboxToolOptions): void;
 /**
- * Agent self-registration tools (auth.md). These are UNAUTHENTICATED — they let
- * an agent that does NOT yet have a webhooks.cc credential obtain one, then
- * configure the MCP server with the returned key (WHK_API_KEY). Registered on
- * every server so a probing agent can always discover the on-ramp via
- * `describe` / `how_to_register`.
+ * @deprecated The auth.md v0.1 registration tools are gone; this registers
+ * the sandbox tools that replaced them. Use registerSandboxTools.
  */
 declare function registerAgentRegistrationTools(server: McpServer): void;
 
@@ -38,4 +53,4 @@ interface CreateServerOptions {
  */
 declare function createServer(options?: CreateServerOptions): McpServer;
 
-export { type CreateServerOptions, createServer, registerAgentRegistrationTools, registerPrompts, registerResources, registerTools };
+export { type CreateServerOptions, type SandboxToolOptions, createServer, registerAgentRegistrationTools, registerPrompts, registerResources, registerSandboxTools, registerTools };

package/dist/index.d.ts

@@ -3,12 +3,27 @@ import { WebhooksCC } from '@webhooks-cc/sdk';
 
 /** Register all webhook tools on an MCP server instance. */
 declare function registerTools(server: McpServer, client: WebhooksCC): void;
+
+interface SandboxToolOptions {
+    /** API base URL (default: WHK_BASE_URL or https://webhooks.cc). */
+    baseUrl?: string;
+    /** Webhook receiver URL (default: WHK_WEBHOOK_URL or https://go.webhooks.cc). */
+    webhookUrl?: string;
+    /** The agent's name, shown to the human as self-reported. */
+    clientName?: string;
+    /** Called once a human has connected the agent, with a client for their account. */
+    onConnected?: (client: WebhooksCC) => void;
+}
+/**
+ * Registers the sandbox tools (create_endpoint, list_endpoints,
+ * get_endpoint, delete_endpoint, list_requests, get_request,
+ * wait_for_request) and connect_account, wait_for_connection and
+ * about_sandbox.
+ */
+declare function registerSandboxTools(server: McpServer, options?: SandboxToolOptions): void;
 /**
- * Agent self-registration tools (auth.md). These are UNAUTHENTICATED — they let
- * an agent that does NOT yet have a webhooks.cc credential obtain one, then
- * configure the MCP server with the returned key (WHK_API_KEY). Registered on
- * every server so a probing agent can always discover the on-ramp via
- * `describe` / `how_to_register`.
+ * @deprecated The auth.md v0.1 registration tools are gone; this registers
+ * the sandbox tools that replaced them. Use registerSandboxTools.
  */
 declare function registerAgentRegistrationTools(server: McpServer): void;
 
@@ -38,4 +53,4 @@ interface CreateServerOptions {
  */
 declare function createServer(options?: CreateServerOptions): McpServer;
 
-export { type CreateServerOptions, createServer, registerAgentRegistrationTools, registerPrompts, registerResources, registerTools };
+export { type CreateServerOptions, type SandboxToolOptions, createServer, registerAgentRegistrationTools, registerPrompts, registerResources, registerSandboxTools, registerTools };