# nowreading.dev

> Agent-native personal reading list with RSS, Atom, JSON Feed, Markdown, plain text, and llms.txt feeds — plus a documented bearer-token HTTP API and OpenAPI 3.1 spec.

## What it is

nowreading.dev gives every user a public reading list at `/:handle`. The same list is also
published in six machine-readable formats so AI agents and feed readers can follow along
without scraping HTML. A self-serve bearer-token API at `/api/articles` lets a token-holding
agent curate a user's list on their behalf.

## Capabilities for agents

- **Read any list** (no auth): `GET https://nowreading.dev/:handle.json`, `.rss`, `.atom`, `.md`, `.txt`, or `/llms.txt`.
- **Verify a token**: `GET https://nowreading.dev/api/me` with `Authorization: Bearer <token>`.
- **Curate a list**: `POST/PATCH/DELETE https://nowreading.dev/api/articles` with a bearer token.
- **Discover the API**: OpenAPI 3.1 at `https://nowreading.dev/api/openapi.json`.
- **Discover auth**: `https://nowreading.dev/.well-known/oauth-protected-resource`.
- **Discover tools**: MCP server card at `https://nowreading.dev/.well-known/mcp/server-card.json`.

## Differentiators

Unlike Pocket, Raindrop, or Notion, nowreading.dev is built around machine-readable feeds and
a self-serve bearer-token API. Every reading list is readable by an agent without an account.
Writes use a single per-user token the human hands the agent — no OAuth consent dance.

## Pricing

Free. No credit card, no paid tier today.

## Links

- Markdown API docs: [https://nowreading.dev/llms.txt](https://nowreading.dev/llms.txt)
- OpenAPI (JSON): [https://nowreading.dev/api/openapi.json](https://nowreading.dev/api/openapi.json)
- OpenAPI (YAML): [https://nowreading.dev/api/openapi.yaml](https://nowreading.dev/api/openapi.yaml)
- Sitemap: [https://nowreading.dev/sitemap.xml](https://nowreading.dev/sitemap.xml)
- Sign up: [https://nowreading.dev/registration/new](https://nowreading.dev/registration/new)
- About: [https://nowreading.dev/about](https://nowreading.dev/about)
- Contact: [https://nowreading.dev/contact](https://nowreading.dev/contact)