# feedql

> feedql is a personal feed and knowledge base that builds itself: it collects from chosen sources (Hacker News, Reddit, GitHub, X, Telegram, YouTube, forums, app-store reviews, websites), removes duplicates, groups reports of the same event, scores items against the person's topics and links to the original source. AI agents use it through MCP (https://mcp.feedql.com) or a REST API (https://api.feedql.com/api/v1) with an OAuth connector or an fq_ API key.

## Docs

- [llm.md: the complete guide for agents](https://feedql.com/llm.md): what feedql is, authentication, every MCP tool, every REST route, the FQL query language, webhooks, recipes, limits
- [Connect and authenticate](https://feedql.com/llm.md#2-connect-and-authenticate): OAuth connector for Claude Desktop and claude.ai, fq_ API keys for Claude Code and scripts, read and write scopes, channel keys
- [MCP tools](https://feedql.com/llm.md#tools): every user tool with arguments, an example call and the result shape; prompts
- [REST API](https://feedql.com/llm.md#5-rest-api): base URL, routes, pagination, error format, rate limits
- [FQL, the query language](https://feedql.com/llm.md#6-fql-the-query-language): topic, source, lang, place, kind, score, rating, stars, comments, upvotes, views, since, until, event, meaning search
- [Webhooks](https://feedql.com/llm.md#7-webhooks): signed pushes of new items
- [Recipes](https://feedql.com/llm.md#8-recipes): daily digest, triage and bulk mark read, create a topic and follow sources, export

## Optional

- [Limits and etiquette](https://feedql.com/llm.md#9-limits-and-etiquette)
- [The same guide on the API host](https://api.feedql.com/llm.md)