# NewsBlur

> NewsBlur is a personal news reader (RSS/Atom aggregator) with training-based intelligence, saved stories, folders, OPML import/export, and a social "blurblog" layer. It is open source (MIT) and exposes a documented HTTP API plus an official hosted Model Context Protocol (MCP) server for AI agents.

This llms.txt was generated by API Evangelist from the public NewsBlur API reference and the open-source repository; NewsBlur does not publish its own llms.txt (probed 2026-07-20, 404).

## APIs
- [NewsBlur API reference](https://www.newsblur.com/api): Full documented endpoint list (auth, feeds, stories, social, classifiers, OPML).
- [OpenAPI (generated)](https://raw.githubusercontent.com/api-evangelist/newsblur/refs/heads/main/openapi/newsblur-openapi.yml): 60+ operations across authentication, feeds, stories, social, feed-management, classifiers and import-export.

## Agent access
- [MCP server](https://newsblur.com/mcp/): Official hosted HTTP MCP server (OAuth browser authorization); ~15 tools including newsblur_list_feeds, newsblur_get_stories, newsblur_search_stories, newsblur_save_story, newsblur_train_classifier, newsblur_discover_feeds.
- [MCP manifest (catalog)](https://raw.githubusercontent.com/api-evangelist/newsblur/refs/heads/main/mcp/newsblur-mcp.yml)
- [Agent skills index](https://raw.githubusercontent.com/api-evangelist/newsblur/refs/heads/main/skills/_index.yml)

## Artifacts
- [Authentication](https://raw.githubusercontent.com/api-evangelist/newsblur/refs/heads/main/authentication/newsblur-authentication.yml): Session cookie + OAuth 2.0 bearer.
- [Conventions](https://raw.githubusercontent.com/api-evangelist/newsblur/refs/heads/main/conventions/newsblur-conventions.yml): Pagination, error envelope, auth styles.
- [Error catalog](https://raw.githubusercontent.com/api-evangelist/newsblur/refs/heads/main/errors/newsblur-problem-types.yml)
- [Data model](https://raw.githubusercontent.com/api-evangelist/newsblur/refs/heads/main/data-model/newsblur-data-model.yml)
- [Conformance](https://raw.githubusercontent.com/api-evangelist/newsblur/refs/heads/main/conformance/newsblur-conformance.yml)

## Docs
- [Developer portal / API](https://www.newsblur.com/api)
- [GitHub (samuelclay/NewsBlur, MIT)](https://github.com/samuelclay/NewsBlur)
- [Forum / support](https://forum.newsblur.com)
- [Blog](https://blog.newsblur.com)