# Miniflux MCP for AI Agents AI Agent Connect > Miniflux (RSS Reader) MCP lets you manage your news feeds and read articles through your AI agent. You can discover new feeds, list entries, and organize categories without leaving your chat window. It's built for anyone who wants to turn their RSS feed into a conversational knowledge base. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_euinv3QWj1f4TH8W5L7atkSxZeJf3F1wrmB7Rnlh/ai-agent-connect - **Tags:** rss-reader, feed-management, content-aggregation, news-tracking, information-consumption ## Description Imagine you're drowning in tabs, jumping between different news sites and tech blogs to stay current. Instead of manually checking every source, you can just ask your AI agent what's new today. This Connector bridges the gap between your Miniflux instance and your workspace. You can have your agent scan for new articles, summarize the latest headlines, and find specific topics across all your subscriptions in seconds. It turns a passive list of links into an active research tool. Whether you're hunting for a specific piece of documentation or just want a morning briefing on a certain category, you just tell the agent what you need. You can even have it organize your feeds into custom categories or bookmark the stuff that actually matters. It's a much faster way to handle high-volume information. Connecting this to your setup through the Vinkius catalog makes it easy to turn your news flow into a conversational knowledge base. You stop hunting for content and start consuming it on your own terms. You can even have the agent look for new feeds from specific URLs and add them to your list automatically. This means you spend less time managing the plumbing of your news and more time actually reading the content that helps you do your job. It's about getting the right information at the right time without the friction of manual navigation. ## Tools ### create_category Create a new category for your feeds. Use this to group your news by topic or source type. ### create_feed Add a new RSS feed to your subscriptions. This lets you expand your content sources on the fly. ### create_user Create a new user in your Miniflux instance. This tool is restricted to admin users only. ### delete_api_key Remove an existing API key. Use this to clean up old credentials or rotate your security keys. ### delete_category Delete a category you no longer need. This helps keep your feed organization clean and relevant. ### delete_feed Remove a specific feed from your subscriptions. Use this when a source is no longer useful to you. ### delete_user Delete a user account from your Miniflux instance. This is a tool for admin users only. ### discover_subscriptions Find RSS feeds from a provided URL. This makes it easy to add new content to your list without manual entry. ### fetch_entry_content Pull the full text of an article from your feed. This allows your agent to read the whole story instead of just a snippet. ### flush_history Clear your interaction history. Use this to reset your history with the feed. ### get_entry Retrieve a single specific entry from your feeds. This is helpful for looking up a specific past article. ### get_feed_icon Fetch the icon for a specific feed. This helps with identifying feeds in your list. ### get_feed Get the details of a specific feed. This is useful for checking subscription status or metadata. ### get_icon Get an icon by its specific ID. Use this when you need to reference a specific image. ### get_integrations_status Check if any third-party integrations are active. This helps you manage your Miniflux setup. ### get_me Fetch the information for the current user. Use this to verify your login status. ### get_user Get the details for a specific user. This is an admin-only tool for managing accounts. ### get_version Check the current application version. Use this to see if your Miniflux instance is up to date. ### healthcheck Check if the database is responding. Use this to ensure your instance is running correctly. ### import_entry Manually add an entry to your feed. This is useful for backfilling content into your history. ### import_opml Import an OPML file to your instance. This is the best way to migrate feeds from other readers. ### list_category_entries List all entries within a specific category. This helps you find content in a specific group. ### list_entries List entries based on specific filters. Use this to find specific news items quickly. ### list_feed_entries Get all entries for a specific feed. This is great for seeing the full history of a source. ### list_feeds See all your current subscriptions. Use this to get an overview of your active feeds. ### liveness Perform a liveness probe. This is a technical check to see if the system is reachable. ### mark_category_as_read Mark every entry in a category as read. Use this to quickly clear out a group of news. ### mark_feed_as_read Mark every entry in a specific feed as read. Use this to clear a single source. ### mark_user_as_read Mark all entries for a specific user as read. This is another admin tool for bulk updates. ### readiness Perform a readiness probe. This is a technical check to see if the system is ready for traffic. ### create_api_key Generate a new API key for your Miniflux instance. This is the first step in connecting your account to the Connector. ### get_feed_counters Check how many items are read or unread. Use this to see your current progress at a glance. ### list_categories See all the categories you've created. Use this to browse your organized content. ### list_users See all users in your instance. This is an admin-only tool for account management. ### refresh_all_feeds Trigger a background refresh for all feeds. Use this to update your content in bulk. ### refresh_category Refresh all feeds within a specific category. This is good for targeted updates. ### refresh_feed Refresh a specific feed synchronously. Use this to get the latest content from one source immediately. ### save_entry Save an entry to a third-party service. Use this to export important news to other apps. ### toggle_entry_bookmark Bookmark or unbookmark a specific entry. This lets you save the best articles for later. ### update_category Update the details of a category. Use this to rename or reorganize your groups. ### update_entries_status Update the status of multiple entries at once. This is a fast way to mark things as read. ### update_entry Update the title or content of an entry. Use this to fix errors in your feed data. ### update_feed Update the details of a feed. Use this to change your subscription settings. ### update_user Update a user's details. This is an admin-only tool for account management. ### export_opml Export your feeds to an OPML file. Use this to backup your data or move to another reader. ### list_api_keys See all the API keys for your instance. Use this to manage your access credentials. ## Prompt Examples **Prompt:** ``` What are the top 3 most recent news items from my 'Tech Trends' category? ``` **Response:** ``` Here are the latest highlights from your **Tech Trends** category: | Headline | Source | Summary | | :--- | :--- | :--- | | **New LLM Architecture** | TechDaily | A new 100B parameter model with 40% lower latency. | | **Quantum Leap** | ScienceWire | Breakthrough in qubit stability reported by researchers. | | **Coding Trends** | DevBlog | The rise of AI-assisted pair programming in 2024. | Would you like me to fetch the full content for any of these? ``` **Prompt:** ``` Find any new articles in my feeds that mention 'LLM security' and tell me which feeds they came from. ``` **Response:** ``` I found **2** new mentions of 'LLM security': * **Securing the Prompt** (from *CyberSentinel*) - Discusses injection attacks. * **Data Privacy in Training** (from *AI Ethics Weekly*) - A look at PII leaks. I can bookmark both of these for you if you'd like. ``` **Prompt:** ``` I want to bookmark every unread entry from the 'Hacker News' feed. ``` **Response:** ``` I've processed your **Hacker News** feed. I found 12 unread entries and have marked them all as bookmarked for you. You can find them in your starred collection now. ``` ## Capabilities ### Discover new RSS feeds Find and add new content sources to your subscriptions using a URL. ### Read full article content Pull the complete text of a news entry so your agent can read it for you. ### Mark articles as read Instantly update the status of your entries to clear your unread list. ### Organize feeds into categories Group your subscriptions into custom topics for easier navigation. ### Bookmark important entries Save specific articles to a starred list for later review. ### Export and import OPML Move your entire feed list between different readers or create backups. ## Use Cases ### The Researcher's Morning Briefing A researcher asks for the latest 5 entries from their 'AI Research' category and wants a summary of each. The agent uses `list_category_entries` and `fetch_entry_content` to provide a bulleted summary of today's news. ### The Developer's Tech Watch A developer wants to know if there are any new releases from a specific blog. The agent uses `refresh_feed` and `list_feed_entries` to check for new posts and reports back only if new content exists. ### The Content Curator's Archive A curator wants to bookmark every article from a specific feed that mentions 'Cybersecurity'. The agent uses `list_feed_entries`, `fetch_entry_content`, and `toggle_entry_bookmark` to find and save the relevant pieces. ### The News Digester A user wants to clear their unread news from the weekend. The agent uses `mark_feed_as_read` across all their subscriptions to reset their feed for the work week. ## Benefits - Stop manually checking websites. Use `discover_subscriptions` to find and add new content automatically, saving you from endless tab switching. - Get instant summaries. Use `fetch_entry_content` to let your agent read the full article for you, so you only spend time on the stories that matter. - Organize your news better. Use `create_category` and `list_category_entries` to group your feeds by topic, making it easier to find specific information quickly. - Save important stories. Use `toggle_entry_bookmark` to keep a curated list of high-value articles that you want to revisit later without losing them. - Bulk manage your content. Use `mark_category_as_read` or `update_entries_status` to clear out hundreds of old items in a single command instead of clicking through pages. - Easy migrations. Use `import_opml` and `export_opml` to move your entire history to new tools or back up your data without any manual effort. ## How It Works The bottom line is you turn your static RSS feed into a searchable, conversational newsroom. 1. Enter your Miniflux instance URL and API key into the Connector configuration. 2. Ask your agent to list your feeds, find specific entries, or summarize news. 3. Receive a curated summary or a list of articles directly in your chat window. ## Frequently Asked Questions **Can I use the Miniflux MCP with my existing account?** Yes, you just need to provide your Miniflux instance URL and API key. It connects directly to your current setup so you don't have to move any of your data. **How does the Miniflux MCP help me find specific news?** Instead of scrolling, you can ask your agent to search for specific keywords across all your feeds. It will scan your subscriptions and pull the relevant entries for you. **Can I use this to read the full content of articles?** Yes, the Connector can fetch the original article content. This means your agent can read the whole story to give you a better summary rather than just showing you a snippet. **Is it possible to organize my feeds into categories?** Absolutely. You can use the agent to create new categories, move feeds into them, and even list all entries within a specific group to keep things tidy. **Can I move my feeds from another reader to Miniflux?** Yes, you can use the export and import tools. You can export an OPML file from your old reader and have the agent import it into your Miniflux instance. **Can the agent mark my articles as read?** Yes, it can mark individual entries, entire feeds, or even whole categories as read. This helps you keep track of what you've already seen without clicking buttons. **Can I find RSS feeds from a website URL automatically?** Yes! Use the `discover_subscriptions` tool with any website URL. The agent will scan the site and return all available RSS/Atom feed links found. **How do I mark all articles in a specific feed as read?** Simply use the `mark_feed_as_read` action providing the `feed_id`. This will instantly update the status of all entries within that feed to 'read'. **Can I search for specific keywords across all my articles?** Yes. Use the `list_entries` tool and provide a keyword in the `search` parameter. You can also filter by status (read/unread) or starred items.