@webhooks-cc/mcp 1.10.1 → 1.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -58,7 +58,7 @@ Get your API key at [webhooks.cc/account](https://webhooks.cc/account).
58
58
 
59
59
  ## What it exposes
60
60
 
61
- The server exposes `44` tools, `3` prompts, and `3` resource surfaces.
61
+ The server exposes `38` tools, `3` prompts, and `3` resource surfaces with an API key, and `10` sandbox tools without one.
62
62
 
63
63
  ### Endpoint tools
64
64
 
@@ -97,13 +97,14 @@ The request tools and resources return emails too (filter with `kind`), without
97
97
 
98
98
  ### Forwarding tools
99
99
 
100
- Forward every captured email to a URL as signed JSON (owner only):
100
+ Forward every captured HTTP request and email to a URL or a Slack or Discord channel, as received,
101
+ as signed JSON or as a chat message, retried and logged (owner only):
101
102
 
102
- - `configure_forwarding`
103
+ - `configure_forwarding` (URL, on/off, kinds, format, your headers, path, retries, order, sent time field)
103
104
  - `get_forwarding_secret` (returns the `whsec_` secret; with `rotate: true`, replaces it)
104
105
  - `test_forwarding`
105
- - `list_deliveries`
106
- - `redeliver_email`
106
+ - `list_deliveries` (the delivery log with its counts, or every try of one request)
107
+ - `redeliver` (one request, or every failed delivery of an endpoint)
107
108
 
108
109
  ### Send and test tools
109
110
 
@@ -127,16 +128,14 @@ Endpoints shared with you already appear in `list_endpoints` (with `fromTeam`) a
127
128
  - `get_usage` (personal plan plus each subscribed team's pool)
128
129
  - `describe`
129
130
 
130
- ### Agent registration tools
131
+ ### Without an API key: the agent sandbox
131
132
 
132
- Registered on every server, with or without an API key, so an agent that has no credential yet can obtain one (auth.md):
133
+ Started without `WHK_API_KEY`, the server registers sandbox tools instead ([auth.md](https://webhooks.cc/auth.md)):
133
134
 
134
- - `how_to_register`
135
- - `register_agent`
136
- - `check_claim`
137
- - `register_agent_with_email`
138
- - `verify_agent_otp`
139
- - `register_agent_with_idjag`
135
+ - `create_endpoint`, `list_endpoints`, `get_endpoint`, `delete_endpoint`, `list_requests`, `get_request`, `wait_for_request`: the same names and arguments as the full tools, in a sandbox of up to 3 endpoints, 25 captured requests each and 100 in all, for 24 hours. The first `create_endpoint` registers it (a few seconds of proof of work).
136
+ - `connect_account`: returns a link and a 6-digit code for a human to connect the agent to their account.
137
+ - `wait_for_connection`: waits for the human, then replaces the sandbox tools with the full tools for that account (`notifications/tools/list_changed`).
138
+ - `about_sandbox`: the limits and how to connect, without a network call.
140
139
 
141
140
  ## Prompts
142
141