Skip to main content
Glama
sandraschi

rss-mcp

by sandraschi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
RSS_MCP_DBNoSQLite database file pathdata/rss.sqlite3
RSS_MCP_HOSTNoHost address to bind to127.0.0.1
RSS_MCP_PORTNoBackend server port (strict fleet standard)11974
RSS_MCP_LANCE_PATHNoLanceDB vector database directorydata/lancedb
RSS_MCP_WEBAPP_PORTNoWebapp frontend port11975

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": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
extensions
{
  "io.modelcontextprotocol/ui": {}
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
feeds_opsB

feeds_ops - Full feed subscription lifecycle.

RATIONALE: groups subscribe/unsubscribe/list/refresh/fetch/get/mark/star/remove/opml/health into one discoverable tool. Stateful reader, unlike glance-mcp single-shot fetch.

Return Format

Dictionary with success (bool), message (str), and operation-specific payload (e.g. feeds, items, feed, opml).

Examples

  • {"operation": "list_feeds"} -> lists all subscribed feeds.

  • {"operation": "subscribe", "url": "https://news.ycombinator.com/rss"} -> subscribes to RSS feed.

  • {"operation": "refresh_all"} -> polls all feeds for new articles.

  • {"operation": "fetch_items", "limit": 20, "unread_only": true} -> retrieves unread articles.

readability_opsA

readability_ops - Clean article text without ad sites.

RATIONALE: trafilatura primary plus readability-lxml fallback, cached in SQLite. No paywall bypass: if the page needs login, extraction reports failure honestly.

Return Format

Dictionary with success (bool), message (str), and article text fields (title, author, text, html, extractor, cached).

Examples

  • {"operation": "extract", "item_id": 3} -> downloads article and extracts cleaned text.

  • {"operation": "get_cached", "item_id": 3} -> retrieves previously cached clean extraction.

  • {"operation": "list_extractors"} -> lists available readability engines.

reader_opsA

reader_ops - Daily reading surface: inbox, stars, search, stats, RAG sweeps.

RATIONALE: single entry point for what a human checks every morning.

Return Format

{success, message, items/stats/job/job_id/status/chunks}

Examples

  • {"operation": "inbox"} unread items

  • {"operation": "search_text", "query": "vienna"} FTS search

  • {"operation": "search_semantic", "query": "rocket engine"} vector search

  • {"operation": "trigger_sweep", "mode": "incremental", "hours": 4} background index job

rss_helpB

rss_help - Capability summary and op list.

Return Format

Dictionary with success (bool), message (str), registered tools, ports, and comparison vs glance-mcp.

Examples

  • {} -> summary of reader capabilities and registered tools.

rss_shutdownA

rss_shutdown - Graceful shutdown hook for the daemon.

Return Format

Dictionary with success (bool) and acknowledgement message (str).

Examples

  • {} -> acknowledges shutdown request.

show_reader_prefab_cardB

show_reader_prefab_card - Prefab stats card for list/status/stats coverage.

Return Format

ToolResult with PrefabApp structured content plus plain-text fallback.

Examples

  • {} -> renders reader stats card.

Prompts

Interactive templates invoked by user choice

NameDescription
rss_help

Resources

Contextual data attached and managed by the client

NameDescription
rss_status_resourcerss://status - Dynamic reader metrics and system status resource. ## Return Format JSON string containing feed counts, items, unread, starred, and extracts.
rss-expert/SKILL.mdExpert skill for reading RSS feeds, extracting clean article text, and semantic search
rss-expert/_manifestFile listing for rss-expert
Prefab Renderer (show_reader_prefab_card)
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.5/5.0

Scored across 6 tools

Disambiguation3/5

feeds_ops and reader_ops both handle item retrieval and marking (e.g., fetch_items vs. inbox, mark/star in feeds_ops vs. stars in reader_ops), creating overlap that could cause misselection. show_reader_prefab_card also overlaps with reader_ops stats. Descriptions clarify intended separation, but boundaries are not crisp.

Naming Consistency3/5

Most tools use a consistent noun_ops pattern (feeds_ops, readability_ops, reader_ops), but rss_help and rss_shutdown use a different prefix, and show_reader_prefab_card uses a verb_noun format. The mix is readable but not predictable.

Tool Count5/5

Six tools is well-scoped for an RSS reader daemon. Each tool has a clear role: feed lifecycle, extraction, reading surface, help, shutdown, and a presentation card. None feels redundant or excessive.

Completeness5/5

The surface covers the full RSS reader lifecycle: subscription management (subscribe/unsubscribe/list/refresh/remove/OPML/health), article extraction and caching, reading inbox/stars/search/stats, background RAG sweeps, help, and graceful shutdown. No obvious operational gaps remain.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources