Keep a reading list worth sharing.
Save anything worth reading in one paste. It becomes a public page with your name on it — and a machine-readable feed your AI agents can follow, or curate for you.
Every list ships as HTML, RSS, Atom, JSON Feed, Markdown, plain text, and
llms.txt, with a bearer-token API and an OpenAPI 3.1 spec behind it.
Free. No credit card. Your handle becomes nowreading.dev/you.
For you
- Save in one paste. Drop in a URL; the title, summary, and keywords are fetched for you.
- Scan and return. A calm, readable library — not a pile of tabs.
- Publish your trail. Your reading becomes part of your identity at
/your-handle.
For your agents
- Read without asking. Six public formats per list, plus content negotiation with
Vary: Accept. - Write with a token. Bearer-token CRUD at
/api/articles, verified via/api/me. - Discover everything. OpenAPI 3.1,
llms.txt, agent card, and MCP card under/.well-known/.
Saving takes one paste
-
Paste a link
An article, a paper, a repo, a video. From the site, the extension, the bookmarklet, or the API.
-
We read it first
Title, source, summary, and keywords are extracted in the background while you move on.
-
It publishes itself
The entry appears in your library and on your public profile — in every format at once.
One list, seven surfaces
Your reading list is a set of URLs, not an export. Each one is first-class, cacheable, and always current.
- /youHTML
- /you.rssRSS 2.0
- /you.atomAtom
- /you.jsonJSON Feed
- /you.mdMarkdown
- /you.txtPlain text
- /you/llms.txtllms.txt
Hand it to an agent in a minute
- Copy your token from
/token— no OAuth dance, no sales call. - Paste the ready-made instruction block into your agent’s setup.
- The agent verifies itself with
GET /api/meand starts saving.
Specs for the curious: /api/openapi.json ·
/llms.txt ·
/.well-known/agent-card.json
$ curl -H "Authorization: Bearer $TOKEN" \
https://nowreading.dev/api/me
{ "handle": "you", "articles_count": 128 }
$ curl -X POST https://nowreading.dev/api/articles \
-H "Authorization: Bearer $TOKEN" \
-d '{"url":"https://example.com/post"}'
{ "status": "created" }
How it compares
| Capability | nowreading.dev | Raindrop.io | Notion | |
|---|---|---|---|---|
| Public reading list URL | Yes, at /:handle | No (private by default) | Optional, per-collection | Shared page only |
| RSS / Atom / JSON Feed | All three + Markdown + llms.txt | No native feeds | RSS export only | No |
| Bearer-token HTTP API | Yes, self-serve | OAuth only | Bearer tokens | Internal API |
| OpenAPI spec | Yes (3.1) | No | No | Partial |
| llms.txt | Yes (global + per-user) | No | No | No |
| MCP discovery | Yes (well-known) | No | No | Third-party |
| Pricing | Free | Freemium | Freemium | Freemium |
Frequently asked
How is this different from Pocket or Raindrop?
nowreading.dev is designed around machine-readable feeds and a self-serve bearer-token API.
Every reading list is public at /:handle in six formats. There is no separate
“export” step and no OAuth consent dance — you hand your agent a token and it works.
Is there a free tier?
Yes. Sign up, get an API token, curate a reading list. No credit card, no paid plan.
How do AI agents authenticate?
Bearer tokens. The human visits /token, copies the paste-ready onboarding
block, and gives it to the agent. The agent sets Authorization: Bearer <token>
on every request. Full machine-readable auth metadata is at
/.well-known/oauth-protected-resource.
Where is the OpenAPI spec?
/api/openapi.json
and /api/openapi.yaml. Also referenced from
/.well-known/api-catalog per RFC 9727.
Can agents read a list without a token?
Yes. Public reads require no authentication. Only writes (create/update/delete an article) need a bearer token scoped to that user.
Start your reading trail
Claim a handle, paste a link, and you have a published reading profile.
Create your reading profile