ttrss-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TT_RSS_SID | Yes | The session ID for authenticating with the Tiny Tiny RSS API | |
| TT_RSS_URL | Yes | The URL of the Tiny Tiny RSS server (e.g., https://rss.example.com/tt-rss) |
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 |
|---|---|
| get_configB | 获取 tt-rss 服务器配置信息 (守护进程状态、订阅数等) |
| get_categoriesA | 获取 tt-rss 的分类列表，包含各分类的未读数。可选只返回有未读文章的分类。 |
| get_feedsA | 获取 tt-rss 的订阅源列表。可按分类过滤，支持分页。特殊分类 ID: -1=特殊, -2=标签, -3=所有(不含虚拟), -4=所有(含虚拟), 0=未分类 |
| subscribe_feedC | 订阅新的 RSS 源 |
| unsubscribe_feedC | 取消订阅指定的 RSS 源 |
| get_headlinesB | 获取文章标题列表。特殊 feed_id: -4=全部, -3=最新, -2=已发布, -1=星标, 0=已归档。可按 view_mode 过滤未读/星标等。 |
| get_articleB | 获取一篇或多篇文章的完整内容 (含正文)。支持逗号分隔的多个 ID。 |
| get_unread_countB | 获取当前未读文章总数 |
| update_articleC | 更新文章状态。field: 0=星标, 1=已发布, 2=未读, 3=笔记。mode: 0=取消, 1=设置, 2=切换。 |
| catchup_feedC | 将订阅源或分类中的所有文章标记为已读。mode 可选: all (全部), 1day, 1week, 2week |
| share_to_publishedC | 创建一篇文章到已发布 (Published) 源中 |
| search_articlesC | 在文章中搜索关键词。search_mode: all_feeds=全部源, this_feed=当前源, this_cat=当前分类 |
| get_labelsB | 获取所有已配置的标签列表。可传入 article_id 查看该文章是否有某标签。 |
| set_article_labelC | 为文章设置或移除标签 |
| generate_daily_reportC | 生成日报：汇总近期文章，按分类和订阅源分组输出。默认获取未读文章，可指定时间范围。 |
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 15 tools
Each tool has a distinct purpose targeting specific resources and actions in the tt-rss RSS reader domain, such as managing feeds (subscribe_feed, unsubscribe_feed), handling articles (get_article, update_article), and generating reports (generate_daily_report). No tools appear to overlap in functionality, making it clear for an agent to select the right one.
All tool names follow a consistent verb_noun pattern in snake_case, such as get_article, set_article_label, and generate_daily_report. This uniformity enhances readability and predictability across the tool set.
With 15 tools, the server is well-scoped for managing an RSS reader, covering essential operations like feed management, article retrieval, labeling, and reporting. Each tool serves a clear purpose without bloat or redundancy.
The tool set provides comprehensive coverage for the tt-rss domain, including CRUD-like operations for feeds and articles, status updates, labeling, search, and reporting. There are no obvious gaps; agents can perform full lifecycle management of RSS content.