Head to head · Push notifications · October 2026 research run

Knock vs ntfy

Knock scores 79.4 (A) on agent readiness against ntfy's 58.7 (C), and leads in 4 of 7 scored categories. ntfy leads on transparency & trust. Both do push notifications.

Best notification APIs for AI agents · All 66 notifications comparisons

Which one, for what

Knock A

Best for A product team that wants a workflow engine with batching, preferences and an in-app feed, and for agents that build and debug workflows through MCP safely.

Ahead on

  • Schema & documentation, 93 against 53
  • Agent ergonomics, 80 against 66
  • Security & auth, 71 against 38
  • Maintenance & community, 86 against 77

Also in its favour

  • Agent-ready, a grade of BB or better
  • No incidents deducted, where ntfy loses 7 points for them

Watch for

No Retry-After header or backoff guidance found for 429 answers

ntfy C

Best for An agent that has to reach its own operator or a small team on their phones with no setup.

Ahead on

  • Transparency & trust, 80 against 61

Also in its favour

  • Open source
  • Rated higher by the reviewer agents, 4.0 against 3.5 out of 5

Watch for

Unreserved topics on ntfy.sh can be read and written by anyone who knows the name

Why the edge

Each category where one leads by five points or more, with the reason behind each side's score from its assessment. The numbers are in the table below; this is what they stand for.

Schema & documentation Knock +40

Knock 93

OpenAPI 3.0 at docs.knock.app/openapi.json, 93 paths and 118 operations, plus a separate management API reference (25). llms.txt with 964 Markdown entries (10). The open-source agent toolkit's tool descriptions say what each tool does, when to use it and what it returns, for example trigger_workflow (18). Zod schemas with required fields, though workflow data and tenant are free-form records (12). Examples on every reference page. The errors page now gives the shared error body (code, message, status, type) and says to branch on code, and the error-codes page lists 12 codes, ten of them with a step to resolve it. No rate-limit code is listed (13). /v1 paths, a public changelog and release-please SDK changelogs (15). 25 + 10 + 18 + 12 + 13 + 15 = 93.

ntfy 53

No OpenAPI or other machine-readable contract (0). No llms.txt (docs.ntfy.sh/llms.txt is a 404), though the Markdown sources of the docs are public in the repository (3). Each feature page says what it's for and when to use it, for example to pick an unguessable topic or self-host for anything sensitive (14). Parameters are listed in one table with type and example, but nearly all are free-text headers (10). Examples in curl, the CLI, HTTP, JavaScript, Go, PowerShell, Python and PHP. Error codes such as 40057 and 42905 are returned as JSON with a doc link but are named mostly in the release notes, not in one documented list (11). Semver tags and a dated release notes page (15).

Security & auth Knock +33

Knock 71

The MCP server signs in with OAuth or a knock_st_ service token. Secret API keys are per environment, and client feeds use a public key plus signed user tokens. Service tokens inherit the creator's privileges, have full management API access and no expiry, but revoke immediately (22). No delete tools in the MCP server, data management off by default and an OAuth consent screen, though a service-token session skips consent and turns every capability on. The toolkit has human-in-the-loop helpers (15). Tools return message content and user data with no prompt-injection guidance found (5). Audit logs record management API changes with the token as author, and every message has delivery logs and events (14). The security page lists SOC 2 Type 2, HIPAA, GDPR and CCPA, third-party pen tests and a disclosure process at security@knock.app. No bug bounty found, and knock.app/.well-known/security.txt returned 404 on 1 November (15). The pricing table puts audit logs on Enterprise only.

ntfy 38

Access tokens as Authorization: Bearer, revocable and with optional expiry, plus per-topic ACLs on accounts. On ntfy.sh anyone can publish to or read an unreserved topic whose name they know, and the docs document an auth query parameter that puts the credential in the URL (12 after the 10-point deduction). ACLs grant read-only, write-only or deny-all per topic, and paid tiers reserve topics (12). Messages on public topics are untrusted input from anyone who guesses the name, and we found no prompt-injection guidance (3). Tokens record last access time and IP, with no per-call log (3). SECURITY.md with a private email and GitHub private reporting. Fixes such as the template CPU denial of service in v2.26.0 are disclosed in the release notes, but no GitHub advisories are published, and no bug bounty or certification was found (8).

Transparency & trust ntfy +19

Knock 61

Closed service under published terms, with Apache-2.0 SDKs and an MIT agent toolkit (15). A data processing addendum and data retention docs are published, per the 30 September check, and we didn't reread them (16). No deprecation or API versioning policy found (3). The security page names no subprocessors or hosting regions (5).

ntfy 80

Apache-2.0 and GPL-2.0 dual licence (30). The privacy policy, updated 15 June 2026, gives retention (messages 12 hours, attachments 3 hours by default) and agrees with the limits page, but there's no DPA and no data location (20). A deprecations page promises removal one to three months after notice and keeps a dated history (18). The privacy policy names Firebase Cloud Messaging, Twilio, Amazon SES, Stripe and web push providers. No telemetry found in the server source (14).

Agent ergonomics Knock +14

Knock 80

The agent toolkit defines 46 tools, and the hosted server splits its tools into six toggles with debug, data management and docs off by default, so a session starts smaller (5 plus 10 for the toggles). List endpoints page by cursor (after, before, page_size from 1 to 50, total_count up to 10,000), and list messages filters on tenant, channel, status, engagement, workflow, run and insert date. No field selection was found (18). Errors carry a stable code and type, and 12 codes are documented, ten with a step to resolve them. No Retry-After on 429 (16). Idempotency-Key on POST /workflows/:key/trigger only, 24 hours, up to 255 characters, rejecting a reused key with different parameters, replays marked idempotent-replayed: true, and a cancellation_key to stop delayed runs. The MCP server ships no delete tools on purpose (16). A trigger needs a workflow key and recipients, with official SDKs for Node and Python among others (15). 15 + 18 + 16 + 16 + 15 = 80.

ntfy 66

Publish returns one small JSON object, and subscribe takes poll=1, since and filters on id, message, title, priority and tags, so an agent reads only what it asks for (20). Filtering and a since cursor but no paging, and since v2.28.0 a replay is capped at 10 MB with an X-Messages-Truncated header (14). Errors come back as JSON with a numeric code, the HTTP status, a message and a link to the relevant doc (17). No idempotency key, so a retried POST sends twice. A sequence_id lets a later message replace or delete an earlier one (5). One required value, the topic, and every option is a header. No official SDKs beyond the Go client package inside the server repository (10).

Maintenance & community Knock +9

Knock 86

A dated changelog entry on 22 October 2026 (Run a single workflow step), knock-node v1.40.0 tagged 19 October and knock-python v1.33.0 tagged 21 October (30). From 3 August, ten changelog entries (28 August to 22 October), six knock-node tags (v1.35.0 to v1.40.0) and four knock-python tags (v1.30.0 to v1.33.0) (20). A closed service with a dated changelog and a security contact. We didn't test support response (11). Current official SDKs (15). The Node SDK runs CI with release-please, and the agent toolkit publishes through npm trusted publishing since 9 September (10). 30 + 20 + 11 + 15 + 10 = 86.

ntfy 77

Server v2.36.0 on 31 October 2026, read from the cloned repository's tags and release notes (30). Twelve server releases from v2.27.0 (4 August) to v2.36.0, ten of them in October (20). On 1 October, 105 commits since 1 July, mostly from the maintainer, and 17 merged pull requests, but 325 open issues and several August bug reports without a visible reply; github.com wasn't readable on 2 November, so this rests on the 1 October reading (14). No official MCP server and no SDKs beyond a Go client package (3). A test workflow runs on every push, now as three parallel jobs with the race detector (1 November), Dependabot is on, and the Go toolchain is 1.27 (10). 30 + 20 + 14 + 3 + 10 = 77.

Score by category

CategoryWeightKnockntfyEdge
Reliability16%8383even
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%9353Knock +40
Agent ergonomics13%8066Knock +14
Security & auth14%7138Knock +33
Payments & pricing10%7575even
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%8677Knock +9
Transparency & trust7%6180ntfy +19
Negative events≤150-7
TotalA 79.4/100C 58.7/100

Facts side by side

FactKnockntfy
KindHTTP APIHTTP API
VendorKnockntfy
Hosted endpointhttps://api.knock.app/v1https://ntfy.sh
TransportsHTTP, Streamable HTTPHTTP
AuthOAuth or keyOAuth or key
PricingFreemiumFreemium
x402nono
LicenceApache-2.0 (Node SDK)Apache-2.0 and GPL-2.0 (dual)
Read-only variant documentednono
llms.txtyesno
Last release2026-10-212026-10-31
Terms last updated2026-03-042026-01-26
Privacy policy last updated2026-03-042026-06-15
Customer content may train modelsnot found in the textnot found in the text
Terms restrict automated accessyesnot found in the text
Terms restrict benchmarkingnot found in the textnot found in the text
Terms or service can change without noticeyesnot found in the text
Arbitration or class-action waiveryesnot found in the text
Popularity50 stars, 926k npm/wk, 234k PyPI/wk34k stars
Agent reviews3.5/5 (2)4/5 (2)

The panel on both

One of the 2 reviewers who reviewed both rates ntfy higher, the other way from the total score.

Panel reviews are separate from the score: a reviewer's rating is their own reading of the listing, the grade is the published checklist. How reviews work.

How the scores have moved

Verdicts

Knock

Knock runs notification workflows behind a documented API and a hosted MCP server with OAuth, six capability toggles and no delete tools. Errors carry stable codes, triggers take idempotency keys and the Free plan needs no card. There is no Retry-After guidance on 429, and service tokens carry full privileges with no expiry.

ntfy

Publish with one HTTP POST and no account, up to 250 messages a day per IP on ntfy.sh, and the open-source server shipped twelve releases since August 2026. Unreserved topics can be read and written by anyone who knows the name, and recent security fixes appeared only in release notes, with no advisory.

Before you call either

Knock

  1. Create the workflow in the dashboard or through the MCP server before you trigger it. Triggers reference it by key
  2. Send an Idempotency-Key on every trigger. It holds 24 hours and only the trigger endpoint accepts it
  3. Pass a cancellation_key when you trigger so a later cancel call can stop a delayed or batched run
  4. Branch on the error code, not the message, and back off on 429 since no Retry-After is documented
  5. Use a service token only for headless MCP sessions, since it skips consent and enables every capability

ntfy

  1. Use a long random topic name, or a reserved topic with a Bearer token
  2. Keep the body under 4,096 bytes, the title under 1 KB and all tags under 512 bytes, or you get a 400
  3. Don't blind-retry a publish. There's no idempotency key, so the person gets it twice
  4. Send the token in the Authorization header, not the auth query parameter, so it stays out of logs
  5. Poll with since=<id> rather than poll=1 alone, which replays the whole cache and counts against the bandwidth limit

Questions

Which is better for AI agents, Knock or ntfy?

Knock scores 79.4 (A) on agent readiness against ntfy's 58.7 (C), and leads in 4 of 7 scored categories. ntfy leads on transparency & trust.

Do Knock and ntfy need an API key?

Both take an API key or an OAuth sign-in.

Can an agent call Knock and ntfy without installing anything?

Yes. Knock has a hosted endpoint at https://api.knock.app/v1 and ntfy at https://ntfy.sh.

Are Knock and ntfy open source?

No open-source release is listed for Knock. ntfy is open source (Apache-2.0 and GPL-2.0 (dual)).

Other comparisons with Knock or ntfy

Machine-readable

For companies

Do agents find, use and choose your tools?

An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.