All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
2.2.2 - 2026-08-16
follow_email_linkopens a verify / magic / reset URL already captured in the inboxwait_for_emailandextract_links_from_requestnow returnverification_codes(OTP)- CI budget: the MCP tool catalog must stay under 5000 tokens
- List and wait tools omit HTML and truncate bodies; use
export_webhook_datafor the full dump - Default MCP install configs no longer mention an API key
2.2.1 - 2026-08-16
- Tool descriptions now say when to use each tool, including the sign-up / verify / magic-link / password-reset email flow
- README install examples pin
uvx webhook-mcp-server==2.2.1so clients do not keep 2.1.3
2.2.0 - 2026-08-16
- Migrated the MCP entry point to Python SDK 2.0
MCPServerwith typed@mcp.tool()handlers - Reuse one HTTP client for the process lifetime and read
WEBHOOK_SITE_API_KEYfrom the environment wait_for_requestandwait_for_emailnow wait for new events by default (addreturn_existing=truefor the old behavior)- SSRF output is split into
callback_payloadsandlocal_bypass_examples - Require
mcp>=2.0.0
- Server failed to start on MCP SDK 2.0 (
Server.list_toolsremoved) ToolResult.to_json()crashed whendatawasNone- Token UUID validation was skipped on several tools, including
get_webhook_dns - Tests called async
get_url/get_email/get_dnswithoutawait
- Offline unit tests and a GitHub Actions test workflow
- Official
server.jsonfor the MCP Registry - Cursor MCP config and authorized-use notes in the README
2.1.3 - 2026-01-27
- Smart waiting:
wait_for_emailandwait_for_requestnow check for existing items first- Returns immediately if matching email/request already exists (with
"waited": false) - Only polls if nothing exists yet
- Eliminates unnecessary 60-120 second waits when emails arrive before the wait call
- Returns immediately if matching email/request already exists (with
- Updated docstrings to document smart behavior
2.1.2 - 2026-01-26
- Removed
clone_webhooktool due to webhook.site API compatibility issues (24 → 23 tools)
- Updated README and badges to reflect 23 tools
2.1.1 - 2026-01-26
- Fixed
clone_webhookbug - was incorrectly calling.raise_for_status()on dict instead of Response object
2.1.0 - 2026-01-26
- 3 New Tools (21 → 24 total):
send_multiple_requests- Send batch of requests for load testingclone_webhook- Copy webhook with all settings to a new tokenexport_webhook_data- Export all requests to JSON format
post_raw()method in HTTP client for absolute URLs
- Updated README badge (21 → 24 tools)
- Added "Batch & Utility" tools section to README
2.0.7 - 2026-01-26
- Complete README rewrite with professional MCP-focused structure
- Updated tool count badge (16 → 21)
- Added natural language examples and use cases
- Improved documentation with JSON response examples
2.0.6 - 2026-01-26
- Removed 5 redundant script/test files (~800 lines)
- Removed unused
get_http_client()function - Removed unused
sanitize_identifier()function - Removed unused
WebhookInfoclass - Removed unused
WebhookRequestclass - Cleaned up unused imports across 5 files
LICENSEfile (MIT)CHANGELOG.md(this file)- Improvement plan documentation
2.0.5 - 2026-01-26
- Console script wrapper for proper uvx execution
- Entry point configuration for MCP server
2.0.4 - 2026-01-26
- F-string syntax error in request service
2.0.3 - 2026-01-26
- uvx compatibility for MCP server startup
- Module path resolution issues
2.0.2 - 2026-01-26
- Syntax error in request_service.py
- Import organization issues
2.0.1 - 2026-01-26
- Package structure and imports
- Build configuration
2.0.0 - 2026-01-25
- Complete rewrite with 21 MCP tools
- Webhook management tools (create, configure, update, delete)
- Request management tools (list, search, delete)
- Bug bounty payload generators (SSRF, XSS, canary tokens)
- Email and DNS endpoint support
- Real-time request waiting with SSE
- Link extraction from captured requests
- Comprehensive validation and error handling
- Async HTTP client with proper connection management
- Structured logging with configurable levels
- Migrated to MCP SDK 1.0.0
- Improved code architecture with service layer pattern
- Enhanced type hints throughout codebase
1.0.0 - 2026-01-24
- Initial release with basic webhook.site integration
- Core webhook creation and management
- Request capture and retrieval