freshrss-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FRESHRSS_URL | No | Base URL of FreshRSS, e.g. https://rss.example.com | |
| MCP_BEARER_TOKEN | No | Bearer token clients must send over SSE, at least 32 characters (openssl rand -hex 32). Required for SSE. | |
| FRESHRSS_URL_FILE | No | Read the FreshRSS base URL from a file. | |
| FRESHRSS_USERNAME | No | FreshRSS username. | |
| FRESHRSS_READ_ONLY | No | Set to `true` to remove every write and destructive tool. | |
| FRESHRSS_API_PASSWORD | No | The FreshRSS API password (not the login password). | |
| MCP_BEARER_TOKEN_FILE | No | Read the MCP bearer token from a file. | |
| FRESHRSS_USERNAME_FILE | No | Read the FreshRSS username from a file. | |
| FRESHRSS_API_PASSWORD_FILE | No | Read the FreshRSS API password from a file. |
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": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| freshrss_list_feedsA | List subscribed feeds with id, title, url, categories and unread count. |
| freshrss_list_categoriesA | List categories (folders) with their unread counts. |
| freshrss_get_unread_countsC | Unread totals: overall, per feed and per category. |
| freshrss_list_articlesA | List articles. |
| freshrss_get_articleA | Get one article by its id, with plain text up to |
| freshrss_search_articlesA | Case-insensitive text search over title and body. FreshRSS has no server-side
search, so this scans the newest |
| freshrss_export_opmlA | Export all subscriptions as OPML. |
| freshrss_mark_readB | Mark articles read by id (at most 100). |
| freshrss_mark_unreadB | Mark articles unread by id (at most 100). |
| freshrss_starA | Star articles by id (at most 100). |
| freshrss_unstarA | Unstar articles by id (at most 100). |
| freshrss_subscribeB | Subscribe to the feed at |
| freshrss_edit_feedA | Rename a feed and/or move it to |
| freshrss_rename_categoryC | Rename a category. |
| freshrss_unsubscribeA | Unsubscribe from a feed, deleting its articles. Requires confirm=true. |
| freshrss_delete_categoryB | Delete a category. Requires confirm=true. |
| freshrss_import_opmlA | Import subscriptions from OPML text (at most 1 MB). Requires confirm=true. |
| freshrss_mark_all_readA | Mark every article in a stream (all, starred, feed or category; |
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 18 tools
Each tool maps to a distinct resource/action pair (feeds, categories, articles, OPML, read/star state), and descriptions clarify parameters and stream semantics. Minor overlap exists: freshrss_get_unread_counts partially duplicates data from list_feeds/list_categories, and mark_all_read overlaps conceptually with mark_read, but boundaries remain clear.
All tools share the freshrss_ prefix with a consistent snake_case verb_noun pattern (list_feeds, get_article, mark_read, delete_category). Even the paired state toggles (mark_read/mark_unread, star/unstar) follow a predictable symmetry.
18 tools is slightly on the heavy side but each covers a genuine operation across feeds, categories, articles and OPML. Nothing appears redundant enough to remove, though the count sits at the upper edge of a comfortable set.
Strong lifecycle coverage: feed subscribe/edit/unsubscribe/list, category list/rename/delete, article read/search/mark/star, and bidirectional OPML. Gaps are minor — there is no standalone create_category (only implicit via subscribe) and no feed URL/refresh-settings update.