Skip to main content
Glama
freshrss-mcp

freshrss-mcp

by hrsather

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
FRESHRSS_URLNoBase URL of FreshRSS, e.g. https://rss.example.com
MCP_BEARER_TOKENNoBearer token clients must send over SSE, at least 32 characters (openssl rand -hex 32). Required for SSE.
FRESHRSS_URL_FILENoRead the FreshRSS base URL from a file.
FRESHRSS_USERNAMENoFreshRSS username.
FRESHRSS_READ_ONLYNoSet to `true` to remove every write and destructive tool.
FRESHRSS_API_PASSWORDNoThe FreshRSS API password (not the login password).
MCP_BEARER_TOKEN_FILENoRead the MCP bearer token from a file.
FRESHRSS_USERNAME_FILENoRead the FreshRSS username from a file.
FRESHRSS_API_PASSWORD_FILENoRead 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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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. stream is unread, all, starred, feed or category; target is the feed id (e.g. feed/12) or category name for the last two. limit is at most 50; pass next_cursor from the previous result as cursor for the next page. since is an ISO 8601 date or datetime; order is newest or oldest. unread_only filters feed, category and starred streams. Text is plain, cut to max_chars (see truncated); use freshrss_get_article for more.

freshrss_get_articleA

Get one article by its id, with plain text up to max_chars (see truncated).

freshrss_search_articlesA

Case-insensitive text search over title and body. FreshRSS has no server-side search, so this scans the newest max_scan articles (at most 500) of the stream; the result reports scanned and truncated (true when older articles were not checked).

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 url, optionally with a title and a category (created if missing).

freshrss_edit_feedA

Rename a feed and/or move it to category (an empty string moves it to the default category). feed is the feed id, e.g. feed/12.

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; target as in freshrss_list_articles) as read. Requires confirm=true.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.3/5.0

Scored across 18 tools

Disambiguation4/5

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.

Naming Consistency5/5

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.

Tool Count4/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues