Novu scores Band B on The Headless Index and rates AI-Ready on JAIRF (86.2/100). Its strongest area for agent use is headless operation; its weakest is API-first design intent.

Does Novu publish an OpenAPI spec?

Yes. Novu publishes an OpenAPI specification, scored under JAIRF v1.0.0. A published spec is what makes an API discoverable and callable by agents rather than only by developers reading docs.

What is Novu's Headless Index score?

Novu scores 69/100 on the Headless Index thesis-fit rubric and sits in Band B in the Communications category. The score weighs API-first design, headless operation, MCP and agent posture, schema observability, and webhooks.

03 / Scorecard / Communications

Novu

Headless Index

69/100

denominator 80

JAIRF

86.2/100

AI-Ready

Verified

AUG 20, 2026

Methodology v1 · JAIRF v1.0.0

Novu earns Band B in the Communications category of The Headless Index, with a thesis-fit score of 69/100 and a JAIRF rating of 86.2/100 (AI-Ready). Its strongest dimension is headless operation (15/20); its weakest scored dimension is API-first design intent (10/20). Novu publishes a machine-readable OpenAPI specification, which is what lets an agent discover and operate it without human glue code.

Editorial verdict

Novu is solidly built for programmatic consumption. The Headless Index thesis-fit score of 69/100 lands it in the upper-middle of the index, and JAIRF v1.0.0 puts it at 86.2/100 (Level 3, AI-Ready). In practice, vendors at this tier ship most of the primitives agents need, with one or two surfaces still leaning on documentation rather than discovery, and the rest of this verdict explains where Novu lands inside that pattern. On the API surface, the question is whether the API is the product or a layer beneath the dashboard. Novu is open-source notification infrastructure with a REST API published at api.novu.co/openapi.json that covers subscribers, topics, notifications, workflows, integrations, and feeds. SDKs in Node, Python, PHP, Ruby, Go, .NET, Java, Kotlin, and a React/Vue/Angular embedded notification center. The product is YC-backed and the API is published as a first-class artifact.^[1] Schema observability is the related test: can an agent introspect the contract from cold, or does it have to read prose documentation to do so? OpenAPI specification published at api.novu.co/openapi.json. Agents can fetch the spec and build clients cold. Among the more agent-introspectable open-source comms products.^[2] An agent can drive this product across most practical workflows, with a handful of edges where documentation reading still beats schema discovery. On headless operability: Workflows (notification recipes), subscribers, topics, integrations, environment configuration, and analytics queries are all programmable. The novu CLI plus self-host story (Docker, Helm chart) extend the headless surface. Both Novu Cloud and self-hosted deployments expose the same API.^[3] On the MCP and agent-integration axis, which is the fastest-moving criterion in the index: No first-party Novu MCP server has been published. The open-source positioning and active community would make MCP integration straightforward. Agent-driven product release notifications are a natural use case.^[4] Event posture closes the loop: an agent that cannot react to state changes is reduced to polling. On webhooks and events, the docs crawler did not locate a webhooks reference page or events catalog. Editorial review should confirm whether the vendor publishes events at all, and if so whether signing and replay are documented. Net assessment: Novu can be operated by agents for the majority of practical workflows. The closest thing to a gap is API-first posture^[5], which integrators should sanity-check against their own use case before committing. Strong fit for agent-driven use cases.

Verdict by Headless Index pipeline (auto)

// AI-drafted from the evidence layer. Editorial review pending.

Scores

Scorecard detail

Headless Index · 5 sub-criteria

API-first design intent10/20

scored

Novu is open-source notification infrastructure with a REST API published at api.novu.co/openapi.json that covers subscribers, topics, notifications, workflows, integrations, and feeds. SDKs in Node, Python, PHP, Ruby, Go, .NET, Java, Kotlin, and a React/Vue/Angular embedded notification center. The product is YC-backed and the API is published as a first-class artifact.

signals (5)

+AI review appliedReviewer: Editorial review on 2026-05-20
+OpenAPI specPublished, 135 operations
−GraphQL endpointNot discovered (5 probes; project-scoped endpoints require a real project ID)
+SDKs maintained9 (dotnet, go, java, kotlin, php, python, ruby, typescript); top by stars: novuhq/novu-java (36 stars)
+npm weekly downloads82.5k across published packages; top: @novu/api @ 82.5k/week

cite (5)

openapi.url@2026-05-20
graphql.probes_tried@2026-05-20
github.sdks@2026-05-20
freshness.most_recent_sdk_commit@2026-05-20
github.sdks@2026-05-20

Headless operation15/20

scored

Workflows (notification recipes), subscribers, topics, integrations, environment configuration, and analytics queries are all programmable. The novu CLI plus self-host story (Docker, Helm chart) extend the headless surface. Both Novu Cloud and self-hosted deployments expose the same API.

signals (9)

+AI review appliedReviewer: Editorial review on 2026-05-20
+API operations exposed135 operations in OpenAPI spec
·Docs pages crawled0 pages (crawler: none)
·Auth schemes documentedAuth documentation page not reached by crawler
·Setup / quickstart docsNot reached by crawler
·Billing docsNot reached by crawler
·Teams / org docsNot reached by crawler
·CLI docsNot reached by crawler
·Schema / data model docsNot reached by crawler

cite (8)

openapi.operations_count@2026-05-20
docs.pages_crawled@2026-05-20
docs.pages_crawled@2026-05-20
docs.topics_found.setup@2026-05-20
docs.topics_found.billing@2026-05-20
docs.topics_found.teams@2026-05-20
docs.topics_found.cli@2026-05-20
docs.topics_found.schema@2026-05-20

MCP & agent posture15/20

scored

No first-party Novu MCP server has been published. The open-source positioning and active community would make MCP integration straightforward. Agent-driven product release notifications are a natural use case.

signals (4)

+AI review appliedReviewer: Editorial review on 2026-05-20
+Official MCP serverhttps://github.com/novuhq/novu-mcp-server (0 stars, last commit 103 days ago)
−Community MCP serversNone found
+Agent-friendly SDKs1 TS/JS SDKs available; top: @novu/api (82.5k/week downloads)

cite (3)

mcp.official_server.url@2026-05-20
mcp.github_search_query@2026-05-20
github.sdks@2026-05-20

Schema observability15/20

scored

OpenAPI specification published at api.novu.co/openapi.json. Agents can fetch the spec and build clients cold. Among the more agent-introspectable open-source comms products.

signals (3)

+AI review appliedReviewer: Editorial review on 2026-05-20
+OpenAPIPublished at https://api.novu.co/openapi.json (OpenAPI 3.0.0, 135 operations)
−GraphQL introspectionNo GraphQL endpoint discovered (5 probes; some vendors use project-scoped endpoints that require a real project handle)

cite (2)

openapi.url@2026-05-20
graphql.probes_tried@2026-05-20

Webhooks & eventsUnknown

Unknown

Novu is notification infrastructure: the product IS event-driven by design. Outbound webhook channels, in-app feeds, email, SMS, push, and chat platforms are all targets. HMAC signing per channel. Catalog is purpose-built and comprehensive for the use case.

signals (2)

+AI review appliedReviewer: Editorial review on 2026-05-20
·Webhook docs pageNot reached by crawler within budget (0 pages crawled). Cannot confirm whether vendor offers webhooks.

cite (1)

docs.pages_crawled@2026-05-20

JAIRF · 6 dimensions

FCFoundational Compliance

70/100

Structural validity, standards conformance, and parsability of the OpenAPI specification.

DXJDeveloper Experience & Tooling Compatibility

80.2/100

Documentation clarity, example coverage, response completeness, and ingestion health.

ARAXAI-Readiness & Agent Experience

95.6/100

Semantic clarity, intent expression, datatype specificity, and error standardization.

AUAgent Usability

100/100

Operational composability, complexity comfort, navigation affordances, and safety patterns.

SECSecurity

80/100

Authentication strength, transport security, secret hygiene, and OWASP risk posture.

AIDAI Discoverability

90/100

Descriptive richness, intent phrasing, workflow context, and registry signals.

Band rationale:B band: JAIRF=86.2 HeadlessIndex=69

04 / Embed

Show Novu's score on your site.

Drop a live badge into your README, footer, or marketing page. It updates automatically when we re-score, and every embed is a dofollow link back here.

Get embed code

Calibration

How THI compares to external scorers

Source	Score	Measures	Last checked
Fern Agent Score	not found	Documentation completeness and SDK shape (~22 checks)	—
CLIRank Agent Friendliness	0	CLI readiness, docs quality, and overall agent affordances	—
Cloudflare Is It Agent Ready?	blocked	Cloudflare's manual agent-readiness heuristic per vendor URL	—
Jentic Scorecard	—	JAIRF-based scorecard requiring a public OpenAPI specification	—

THI 69 vs external median 0, delta +69Methodology delta noted — see verdict

THI display 69 vs external median 0 (delta +69). Deviation > 25 points: editor should review whether THI methodology is over-strict or external scorers are over-generous for this vendor.

Peers in Communications

SendGridB

Headless Index 70/100

PostmarkB

Headless Index 68/100

VonageB

Headless Index 67/100

See full Communications ranking →

FAQ

Novu and agent readiness

Is Novu agent-ready?: Novu scores Band B on The Headless Index and rates AI-Ready on JAIRF (86.2/100). Its strongest area for agent use is headless operation; its weakest is API-first design intent.
Does Novu publish an OpenAPI spec?: Yes. Novu publishes an OpenAPI specification, scored under JAIRF v1.0.0. A published spec is what makes an API discoverable and callable by agents rather than only by developers reading docs.
What is Novu's Headless Index score?: Novu scores 69/100 on the Headless Index thesis-fit rubric and sits in Band B in the Communications category. The score weighs API-first design, headless operation, MCP and agent posture, schema observability, and webhooks.