Self-hosted, free, multi-channel notification gateway (ntfy, Telegram, Email, Slack, Discord, WhatsApp) with token auth and a durable queue. Ships a Claude Code hook and an MCP server.
notify-hub has 10 tools with consistent naming (verb_noun pattern) and descriptions present for all. However, parameter descriptions are sparse or missing for several tools. Input schemas are visible and mostly well-formed (using Zod), but output schemas are not documented. Error handling exists but lacks recovery guidance. The server exposes sensitive operations (delete_channel, delete_profile, get_config returning secrets) without confirmation patterns or permission gates. Descriptions average ~100 chars, which is acceptable but could be more LLM-optimized. No tool annotations (readOnlyHint, destructiveHint) are present despite clear risk classifications.
Check whether the notify-hub gateway and its queue backend are reachable.
Delete a channel instance by id and prune it from every profile that referenced it as a default.
Delete a token profile by id.
Return every channel instance and profile from the database, including secrets.
Return gateway health, the channel list, and recent worker deliveries -- the same data as the admin panel status view.
List channels active on the notify-hub gateway and this token's default channels.
Destructive operations (delete_channel, delete_profile) lack confirmation/dry-run patterns. No tool annotations (destructiveHint) to signal irreversibility to LLMs.
get_config returns full secrets in plaintext. No permission gate or audit trail documented. Violates secret-injection pattern.
Output schemas not documented. LLMs cannot infer what fields to expect from tool responses (e.g., what does get_status return? what fields are in list_channels?).
Error responses in code (errorResult) do not include recovery guidance. LLMs receive error messages but no hint on what to do next (retry, ask user, call another tool).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 60 | 2026-07-28+ | v2 |
Send a push notification through the notify-hub gateway.
Send a real test notification through the gateway targeting one channel instance and report the actual worker delivery outcome.
Create or update a channel instance. Fails without writing anything if the id is not a valid slug, the type is unknown, or the channel is enabled but missing a required config key.
Create or update a token profile. Fails without writing anything if a default channel does not exist or is not enabled, or if the token is already used by another profile.
No tool annotations present. Tools with clear risk levels (send_notification=WRITE, delete_*=DESTRUCTIVE, get_*=READ_ONLY) should declare readOnlyHint/destructiveHint/idempotentHint.