webhook-relay-mcp · packages

Shared types, configuration loading, AES-256-GCM encryption helpers, a filter DSL evaluator, Prometheus metric registry, and a shared pino logger for the webhook-relay-mcp project. Provides Zod-validated environment config, event/source type definitions, and filter operators (`$eq`, `$gt`, `$in`, `$regex`, `$and`, `$or`, `$not`) as exported modules.

A CLI binary (`webhook-relay-mcp`) that runs an MCP server bridging third-party webhooks (Stripe, GitHub, Replicate, Twilio, SendGrid, Slack, Vercel, and generic sources) into agent workflows, bundling an HTTP ingestion server, MCP transport (stdio or HTTP/SSE), and an admin dashboard. Requires an `ENCRYPTION_KEY` environment variable and transitively depends on `better-sqlite3`.

SQLite storage layer for webhook-relay-mcp, providing schema migrations and repository classes (Events, Subscriptions, Sources, Audit) plus services (Cleanup, Delivery with retry and DLQ, Audit, SourceHealth, PollWaiter) backed by better-sqlite3 with WAL mode and foreign keys.

A library that exposes an MCP server and 15 webhook management tools (subscribe, unsubscribe, list, poll, history, register, stats, replay, update-source, delete-source, rotate-secret, list-sources, audit-log, source-health, event-types) via the `startMCPServer()` function, built on `@modelcontextprotocol/sdk`.

Provides webhook ingestion logic including signature validators (HMAC-SHA256/SHA1 with constant-time comparison), source handlers for Stripe, GitHub, Replicate, Twilio, SendGrid, Slack, Vercel, and a generic handler, plus payload normalization into a unified event schema and ingress-level deduplication by `webhookId`. It exports handler functions and validators intended as internal building blocks for the `@reaatech/webhook-relay-mcp` server.