FreshRSS MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FRESHRSS_URL | Yes | The URL of your FreshRSS instance | |
| FRESHRSS_USERNAME | Yes | Your FreshRSS username | |
| FRESHRSS_API_PASSWORD | Yes | Your FreshRSS API password (Settings → Profile → API Management) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_articlesC | List articles from FreshRSS with optional filtering |
| mark_as_readB | Mark one or more articles as read |
| mark_as_unreadB | Mark one or more articles as unread |
| star_articlesC | Star/favorite one or more articles |
| unstar_articlesB | Remove star from one or more articles |
| mark_all_as_readB | Mark all articles in a stream as read |
| list_feedsB | List all subscribed RSS feeds |
| subscribeC | Subscribe to a new RSS feed |
| unsubscribeC | Unsubscribe from an RSS feed |
| edit_feedA | Edit a feed subscription (rename or move to different category) |
| export_opmlB | Export all subscriptions as OPML |
| import_opmlC | Import subscriptions from OPML |
| quickadd_feedB | Quick-add a feed URL; FreshRSS will detect the actual feed. |
| list_foldersB | List all folders/categories |
| list_labelsC | List all labels/tags |
| add_labelsC | Add labels to articles |
| remove_labelsC | Remove labels from articles |
| rename_folderC | Rename a folder/category |
| rename_labelC | Rename a label |
| delete_folderA | Delete a folder/category (feeds will be moved to default) |
| delete_labelC | Delete a label |
| get_statsC | Get unread counts and statistics |
| get_user_infoB | Get current user information |
| list_faviconsB | List favicons for subscribed feeds (Fever API) |
| get_feed_faviconB | Get a feed favicon as an MCP resource (Fever API) |
| list_unread_article_idsB | List unread article IDs (Fever API) |
| list_starred_article_idsA | List starred/saved article IDs (Fever API) |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 27 tools
Each tool has a clearly distinct purpose targeting specific resources and actions in the FreshRSS domain. For example, list_articles vs. mark_as_read vs. subscribe are unambiguous, and even similar tools like add_labels and remove_labels are clearly differentiated by their opposing actions.
All tools follow a consistent verb_noun naming pattern throughout, such as list_articles, edit_feed, delete_folder, and mark_as_read. There are no deviations in style or convention, making the tool set highly predictable and readable.
With 27 tools, the count is on the high side for an RSS server, bordering on heavy. While it covers many operations, it may feel overwhelming compared to a more streamlined set of 3-15 tools, though it is not extreme like 50+ tools.
The tool set provides comprehensive CRUD and lifecycle coverage for RSS feed management, including subscription handling, article reading/starring, labeling, folder management, and import/export. No obvious gaps exist; agents can perform all core workflows without dead ends.