[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_128":129},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":21,"_24":25,"_26":27,"_28":29,"_30":31,"_32":33,"_34":25,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":46,"_48":49,"_50":51,"_52":53,"_54":-5,"_55":46,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":11,"_63":46,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":46,"_78":-5,"_79":80,"_81":82,"_83":84,"_85":86,"_87":88,"_89":90,"_91":92},"apiUrl","https://odel.app/api","creator","rmzlb","moduleId","notifyd","@rmzlb/notifyd","displayName","tagline","Operate a self-hosted notifyd instance: digest, jobs, retries, suppressions, projects, test sends.","iconKey","https://avatars.githubusercontent.com/u/25151724?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://{notifyd_host}/mcp\",\"transport\":\"streamable-http\",\"authType\":\"bearer\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1788669993000,"updatedAt","sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.rmzlb%2Fnotifyd","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",1,"upstreamUpdatedAt",1788646100000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/rmzlb/notifyd","githubRepoFullName","rmzlb/notifyd","releaseId","ext-rmzlb-notifyd","version","0.2.0","descriptionMarkdown","

\n $\"notifyd\"$ \n

\n\n

notifyd

\n\n

\n Agent-first notification service. One Rust binary. Postgres only. No Redis, no Mongo, no nonsense.\n

\n\n

\n $\"License\"$ \n $\"Container$ \n $\"CI\"$ \n $\"Rust\"$ \n $\"Image$ \n $\"Memory\"$ \n $\"MCP$ \n $\"Agent$ \n

\n\n

\n Quick Start •\n API Reference •\n Setup Guide •\n Architecture •\n Benchmarks •\n LLM Docs •\n Contributing\n

\n\n---\n\n## The Problem\n\nYour AI agent needs to send an email. Or a push notification. Or update an in-app inbox.\n\nYou look at Novu: MongoDB, Redis, 4 containers, a React SDK, 30 minutes of setup. Your agent doesn't care about any of that. It just wants to `POST /v1/send` and move on.\n\n**notifyd** is what that looks like. A single Rust binary. One `POST` call. Your agent sends notifications and gets back to work.\n\n```\nAgent ──POST /v1/send──→ notifyd ──→ Email (Resend)\n ──→ SMS (Twilio/Telnyx)\n ──→ Push (FCM)\n ──→ In-App (SSE)\n```\n\n---\n\n## Why Agents Love This\n\nMost notification services were designed for humans clicking buttons in a dashboard. notifyd was designed for agents making API calls.\n\n**Flat REST API** — no SDK needed, no WebSocket handshake, no complex auth flows. `curl` works. Your agent's HTTP client works.\n\n**`docs/llms.txt`** — the entire API reference in plain text, optimized for LLM context windows. Point your agent at it and it can call any endpoint. ([View it](https://github.com/rmzlb/notifyd/blob/main/docs/llms.txt))\n\n**Idempotency built-in** — agents retry. That's fine. Pass `idempotency_key` and notifyd deduplicates.\n\n**One binary, one config file** — `docker compose up` and you have a notification service. No infra degree required.\n\n```bash\n# Your agent sends a notification. That's it.\ncurl -X POST http://localhost:3400/v1/send \\\n -H \"X-Api-Key: sk_myapp_xxx\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"channels\": [\"email\", \"in_app\"],\n \"subscriber_id\": \"user-1\",\n \"subject\": \"Your report is ready\",\n \"body\": \"Hey {{first_name}}, the analysis you requested is complete.\",\n \"vars\": {\"first_name\": \"Alice\"},\n \"idempotency_key\": \"report-42-ready\"\n }'\n```\n\n### Connect Your Agent to the Docs\n\nFeed `docs/llms.txt` to any LLM agent and it can operate the full API:\n\n```\nhttps://raw.githubusercontent.com/rmzlb/notifyd/main/docs/llms.txt\n```\n\nOr describe notifyd as a tool:\n\n```json\n{\n \"name\": \"send_notification\",\n \"description\": \"Send email/SMS/push/in-app via notifyd\",\n \"endpoint\": \"POST /v1/send\",\n \"auth\": \"X-Api-Key header\"\n}\n```\n\n---\n\n## vs. The Alternatives\n\n| | **Novu** | **Knock / Courier / SuprSend** | **notifyd** |\n|---|---|---|---|\n| **Infra** | MongoDB + Redis + 4 containers | Hosted SaaS | Postgres only, one 42 MB image |\n| **Setup** | 30+ min | Signup + dashboard | `docker compose up` (2 min) |\n| **Language** | Node.js (multiple services) | N/A (hosted) | Rust (single binary) |\n| **Memory** | not measured by us | N/A | 13 MB idle, 23 MB draining 100k jobs ([method](https://github.com/rmzlb/notifyd/blob/main/docs/BENCHMARKS.md)) |\n| **Throughput** | — | quota-bound | 44k jobs/s enqueued, 3.5k jobs/s drained ([benchmarks](https://github.com/rmzlb/notifyd/blob/main/docs/BENCHMARKS.md)) |\n| **Provider 429** | job fails | managed | lane paused, `Retry-After` honoured, failover provider |\n| **Priorities / send windows** | ❌ | ✅ | ✅ critical → bulk lanes, per-subscriber timezone windows |\n| **Ops for agents** | React dashboard | dashboard + API | `GET /v1/admin/digest`, MCP server, Agent Skills, Prometheus |\n| **Realtime** | WebSocket | WebSocket | SSE (native `EventSource`, multi-replica via Postgres `NOTIFY`) |\n| **Self-hosted** | ✅ (heavy) | ❌ | ✅ (one container per company) |\n| **Queue** | Redis + BullMQ | Managed | Postgres `SKIP LOCKED`, stuck-job reaper |\n| **Cost** | Free tier / paid | per notification | Free forever, MIT |\n\n---\n\n## Features\n\n- **📧 Email** — Resend, Cloudflare Email Service, AgentMail or any SMTP, with an optional failover provider\n- **📱 SMS** — Twilio or Telnyx (swap in config, zero code change)\n- **🔔 Push** — FCM (Firebase Cloud Messaging)\n- **💬 In-app inbox** — REST + realtime SSE stream\n- **⏰ Scheduling** — `scheduled_at` on any notification\n- **🔄 Retry** — backoff 30s → 2m → 10m → 30m → 2h with jitter, provider `Retry-After` honoured\n- **🚥 Priorities** — critical / normal / bulk lanes, a 429 pauses only the lane that hit it\n- **🕰️ Send windows** — per-project quiet hours in each subscriber's timezone\n- **📭 Unsubscribe** — `List-Unsubscribe` one-click on every marketing email, suppression scopes\n- **🔑 Idempotency** — safe agent retries\n- **📋 Templates** — `{{variable}}` substitution, stored per project\n- **🏢 Multi-project** — one instance, many projects, isolated by API key\n- **⚡ Workflows** — event-triggered multi-step sequences\n- **👤 Preferences** — per-subscriber opt-in/opt-out\n- **🔍 Audit log** — every mutation logged\n- **🚦 Rate limiting** — per-project sliding window\n- **📊 Metrics** — `/v1/metrics`, `/v1/metrics/prometheus`, per-template metrics\n- **🧭 Digest + MCP** — `GET /v1/admin/digest` and `POST /mcp` so an agent operates the instance\n- **🪝 Webhooks** — delivery events to your endpoints\n\n---\n\n## Quick Start\n\n### Docker (recommended)\n\nPrebuilt image (linux/amd64 + linux/arm64, 42 MB): `ghcr.io/rmzlb/notifyd`.\n\n```bash\ngit clone https://github.com/rmzlb/notifyd.git && cd notifyd\ncp notifyd.toml.example notifyd.toml\n# Edit notifyd.toml — add your Resend API key at minimum\n\ndocker compose up -d\n# → notifyd running on http://localhost:3400\n```\n\n### From source\n\n```bash\n# Rust 1.75+, PostgreSQL 16+\ngit clone https://github.com/rmzlb/notifyd.git && cd notifyd\ncp notifyd.toml.example notifyd.toml\ncargo run\n```\n\n### Verify\n\n```bash\ncurl http://localhost:3400/v1/health\n# → {\"status\":\"ok\",\"db\":\"ok\",\"version\":\"0.2.0\"}\n```\n\n→ Full setup: [docs/SETUP.md](https://github.com/rmzlb/notifyd/blob/main/docs/SETUP.md)\n\n---\n\n## API at a Glance\n\nEvery endpoint uses `X-Api-Key: sk__xxx`. Inbox endpoints also accept subscriber JWT.\n\n| Method | Endpoint | What it does |\n|--------|----------|--------------|\n| `POST` | `/v1/send` | Send notification (email, SMS, push, in-app) |\n| `POST` | `/v1/batch` | Send to multiple subscribers |\n| `GET` | `/v1/inbox/:id` | List in-app notifications |\n| `GET` | `/v1/inbox/:id/stream` | SSE realtime stream |\n| `POST` | `/v1/workflows/trigger` | Trigger event-based workflow |\n| `GET` | `/v1/health` | Health check |\n| `GET` | `/v1/metrics` | Service metrics |\n\n→ Full reference: [docs/API.md](https://github.com/rmzlb/notifyd/blob/main/docs/API.md) — or feed [docs/llms.txt](https://github.com/rmzlb/notifyd/blob/main/docs/llms.txt) to your agent.\n\n---\n\n## TypeScript SDK\n\nA small official SDK now ships in this repo for backend + frontend apps.\n\n```bash\npnpm add notifyd-sdk@github:rmzlb/notifyd\n```\n\n```typescript\nimport { createNotifydClient } from 'notifyd-sdk';\n\nconst notifyd = createNotifydClient({\n url: process.env.NOTIFYD_URL!,\n apiKey: process.env.NOTIFYD_API_KEY!,\n});\n\nawait notifyd.send({\n channels: ['email', 'in_app'],\n subscriberId: 'user-123',\n subject: 'Your report is ready',\n body: 'Hey {{first_name}}, the analysis is complete.',\n vars: { first_name: 'Alice' },\n});\n\nconst token = await notifyd.createSubscriberToken({\n subscriberId: 'user-123',\n ttlHours: 8,\n});\n```\n\nIt wraps the REST API with typed helpers for send, subscribers, inbox, unread count, mark read, and SSE stream setup.\n\n---\n\n## In-App Inbox\n\nComplete notification inbox with realtime SSE. No WebSocket library, no Redis pub/sub — just native `EventSource`.\n\n```typescript\n// Connect to realtime stream\nconst events = new EventSource(\n `https://notifyd.example.com/v1/inbox/${userId}/stream?token=${jwt}`\n);\n\nevents.onmessage = (e) => {\n const data = JSON.parse(e.data);\n if (data.type === 'new_notification') showToast(data.notification);\n if (data.type === 'count_update') updateBadge(data.unread_count);\n};\n```\n\nFeatures: read/unread, archive, todo/star, pagination, unread count badge, realtime push.\n\n---\n\n## Workflow Engine\n\nMulti-step notification sequences triggered by events:\n\n```bash\ncurl -X POST http://localhost:3400/v1/workflows \\\n -H \"X-Api-Key: sk_myapp_xxx\" \\\n -d '{\n \"id\": \"welcome-series\",\n \"trigger_event\": \"user.signup\",\n \"steps\": [\n {\"type\": \"send\", \"channel\": \"email\", \"template\": \"welcome\"},\n {\"type\": \"delay\", \"duration\": \"24h\"},\n {\"type\": \"send\", \"channel\": \"email\", \"template\": \"getting_started\"},\n {\"type\": \"delay\", \"duration\": \"72h\"},\n {\"type\": \"condition\", \"check\": \"completed_onboarding\", \"if_false\": [\n {\"type\": \"send\", \"channel\": \"email\", \"template\": \"nudge\"}\n ]}\n ]\n }'\n```\n\nState persisted in Postgres — survives restarts. No in-memory state to lose.\n\n---\n\n## Built for agents, not dashboards\n\nNo admin UI. `GET /v1/admin/digest` tells you, in one call, what deserves\nattention and what to do about it; `POST /mcp` exposes the same operations as\nMCP tools so Claude Code, Claude Desktop or Cursor can run the instance:\n\n```json\n{ \"mcpServers\": { \"notifyd\": { \"type\": \"http\", \"url\": \"https://notifyd.example.com/mcp\",\n \"headers\": { \"Authorization\": \"Bearer ${NOTIFYD_ADMIN_API_KEY}\" } } } }\n```\n\n→ [docs/AGENT.md](https://github.com/rmzlb/notifyd/blob/main/docs/AGENT.md)\n\nAgent Skills for Claude Code, Cursor and friends live in [`skills/`](https://github.com/rmzlb/notifyd/blob/main/skills/):\n`notifyd-operate`, `notifyd-integrate`, `notifyd-deploy`.\n\n```bash\nnpx skills add rmzlb/notifyd\n```\n\nMCP registry name: `mcp-name: io.github.rmzlb/notifyd` (see [`server.json`](https://github.com/rmzlb/notifyd/blob/main/server.json)).\n\n## Configuration\n\nSingle TOML file. Minimal setup:\n\n```toml\n[server]\nport = 3400\njwt_secret = \"your-secret-here\"\n\n[database]\nurl = \"postgres://notifyd:pass@localhost:5432/notifyd\"\n\n[connectors.email]\nprovider = \"resend\"\napi_key = \"re_xxx\"\nfrom = \"notifications@yourdomain.com\"\n\n[projects.myapp]\napi_key = \"sk_myapp_xxx\"\nchannels = [\"email\", \"in_app\"]\n```\n\n→ Full config: [notifyd.toml.example](https://github.com/rmzlb/notifyd/blob/main/notifyd.toml.example). Providers and\ntheir environment variables (Resend, Cloudflare Email Service, any SMTP,\nAgentMail, Telnyx, Twilio, web push): [docs/CONNECTORS.md](https://github.com/rmzlb/notifyd/blob/main/docs/CONNECTORS.md).\n\n---\n\n## Project Structure\n\n```\nnotifyd/\n├── src/\n│ ├── main.rs # Server bootstrap, graceful shutdown\n│ ├── config.rs # TOML config\n│ ├── db.rs # sqlx models\n│ ├── worker.rs # Background job processor\n│ ├── workflow_engine.rs # Event-driven workflows\n│ ├── sse.rs # SSE broadcaster (tokio channels)\n│ ├── templates.rs # {{var}} engine\n│ ├── pii.rs # PII masking for logs\n│ ├── middleware.rs # Rate limiter + audit\n│ ├── api/ # 13 route modules\n│ └── connectors/ # Email, SMS, Push, In-App\n├── migrations/ # SQL migrations (auto-run)\n├── Dockerfile # Multi-stage + cargo-chef\n├── docker-compose.yml # notifyd + Postgres\n├── notifyd.toml.example # Config reference\n└── docs/ # API ref, setup, architecture, llms.txt\n```\n\n~12,000 lines of Rust, no `unsafe`. 10.8 MB binary, 42 MB image, 13 MB RSS at idle.\n\n---\n\n## Documentation\n\n| | |\n|---|---|\n| 📦 **[Setup Guide](https://github.com/rmzlb/notifyd/blob/main/docs/SETUP.md)** | Local dev, Docker, production deploy |\n| 🔌 **[API Reference](https://github.com/rmzlb/notifyd/blob/main/docs/API.md)** | Every endpoint with curl/TS/Rust examples |\n| 🏗️ **[Architecture](https://github.com/rmzlb/notifyd/blob/main/docs/ARCHITECTURE.md)** | Queue design, SSE internals, connectors |\n| 📈 **[Benchmarks](https://github.com/rmzlb/notifyd/blob/main/docs/BENCHMARKS.md)** | Footprint, throughput, how to reproduce |\n| 📣 **[Visibility](https://github.com/rmzlb/notifyd/blob/main/docs/VISIBILITY.md)** | Registries, lists and launch channels, in order |\n| 🔌 **[Connectors](https://github.com/rmzlb/notifyd/blob/main/docs/CONNECTORS.md)** | Providers, environment variables, adding one |\n| 🤝 **[Agent operations](https://github.com/rmzlb/notifyd/blob/main/docs/AGENT.md)** | Digest, MCP tools, how an agent runs an instance |\n| 🚀 **[Deployments](https://github.com/rmzlb/notifyd/blob/main/docs/DEPLOYMENTS.md)** | One instance per company, runbook, inventory |\n| 🤖 **[LLM Docs](https://github.com/rmzlb/notifyd/blob/main/docs/llms.txt)** | Full API in plain text — feed to your agent |\n\n---\n\n## Contributing\n\nnotifyd is built in **Grenoble, in the French Alps** 🏔️ — but open to contributors from everywhere.\n\n1. Read the [Contributing Guide](https://github.com/rmzlb/notifyd/blob/main/CONTRIBUTING.md)\n2. Check [open issues](https://github.com/rmzlb/notifyd/issues) — `good first issue` is a great start\n3. Big features → open an issue first\n\n```bash\ngit clone https://github.com/YOUR_USERNAME/notifyd.git\ncd notifyd && cp notifyd.toml.example notifyd.toml\ncargo test && cargo run\n```\n\n---\n\n## License\n\n[MIT](https://github.com/rmzlb/notifyd/blob/main/LICENSE) — use it however you want.\n\n---\n\n

\n Built with 🦀 in Grenoble, France 🏔️\n

\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"iconType","image","upstream",{"_109":110,"_111":112,"_113":114,"_115":116,"_117":65,"_118":119},"requiredSecrets",[],"tags",[95,96,97,98,99,100,101,102,103,104,105,106,107,108],"assets",[],"stats",{"_93":80,"_94":80},"ratingAvg","reviewCount","agent-skills","ai-agents","axum","email","llms-txt","notification-service","notifications","novu-alternative","postgresql","push-notifications","rust","self-hosted","selfhosted","sms","topics",[95,96,97,98,99,125,126,127,100,101,102,103,104,105,106,107,108],"license","MIT","language","Rust","registryName","io.github.rmzlb/notifyd","homepage","packages",[120],{"_121":122,"_123":124,"_70":-5},"registryType","oci","identifier","ghcr.io/rmzlb/notifyd:0.2.0","mcp","mcp-server","model-context-protocol","ENV",{"_130":131,"_132":133,"_134":135},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]