smry Product
Server Details
Read public sources and manage a smry library, feeds, notes, highlights, files, and page monitors.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 28 tools
Many tools have overlapping domains (library listing/searching, web content fetching, feed discovery), but detailed descriptions with explicit cross-references (e.g., 'use manage_collections for direct collection CRUD') help agents distinguish them. Some ambiguity remains, especially between list_library and list_library_objects, and among get_article, search_article, and open_web_pages.
All tools use snake_case with a clear verb_noun structure (e.g., list_library, get_feed_changes, manage_collections). Minor variations like bulk_update_library_items and manage_feed_filter still follow the same pattern consistently.
28 tools is heavy for a single MCP server; while each tool has a distinct role, some could be consolidated (e.g., multiple discovery tools, library object vs item tools). It's borderline appropriate for the broad feature set but exceeds the typical well-scoped range.
Core library CRUD and feed lifecycle are well covered, but gaps exist: no explicit tool to unfollow a feed source or to create standalone notes/highlights, which agents may need to work around. Overall the surface is comprehensive for most workflows.
Available Tools
28 toolsbulk_update_library_itemsOrganize multiple library itemsBIdempotentInspect
Atomically move, tag, mark read, update progress, or correct classification for up to 100 library items.
Inputs: ids (required), tags, status, starred, +3 more. Returns: items, missing, updated
create_monitorMonitor a web page for changesADestructiveInspect
Create a scheduled web-change monitor whose detected changes arrive as an ordinary followed source — query, watch, and mutate it like any feed. Naming a collection that does not exist creates it. Active monitor limits are Free 3, Patron 10, and Pro 100; scheduled monthly credits are 150, 720, and 7,200, respectively. Page and sitemap runs reserve 1 credit; extract runs reserve 10. The shortest interval is 60 minutes and the default schedule is daily. The response reports remaining slots and scheduled credits. Example: {"name":"Example page changes","target":{"type":"page","url":"https://example.com"},"collection":"Research"}
Inputs: name (required), target (required), tags, schedule, +2 more. Returns: limits, monitor, subscription
create_news_queryCreate a durable query/news inputADestructiveInspect
Creates a Collection-compatible news query. Google News RSS is the current adapter and is intentionally hidden behind this durable product type. Example: {"query":"open source databases","collection":"Research"}
Inputs: query (required), locale, collection. Returns: object, followed, outcomes, collection, +1 more
discover_feed_inputsFind public feeds to followARead-onlyInspect
Find public feeds by topic or find a site's published feeds. This is the compact Developer API discovery adapter; use search_feeds for language, ranking, and source-type controls. Discovery does not subscribe; pass result feedUrl values to follow_feeds. Example: {"query":"https://www.nasa.gov","mode":"site"}
Inputs: query (required), mode. Returns: results
follow_feedsFollow feeds by URL, with per-URL outcomesADestructiveInspect
Follow up to 20 feed or site URLs in one call. Site URLs are resolved to their published feed. Naming a collection that does not exist creates it. Returns a per-URL outcome — partial success is normal and legible, never all-or-nothing. Example: {"urls":["https://www.nasa.gov/feed/"],"collection":"Research"}
Inputs: urls (required), collection. Returns: object, followed, outcomes, collection
get_articleRead an article with smryARead-onlyInspect
Fetch clean, source-grounded text for a public article or YouTube URL, budgeted to a token limit and addressable by paragraph anchor. Returns an outline of headings (empty when the source has none), the requested window, and a next_cursor when more remains. Prefer search_article when you have a specific question rather than needing the whole text.
Inputs: url (required), cursor, max_tokens. Returns: text, title, author, outline, +15 more
get_feed_changesWhat changed since a cursor — the polling primitiveARead-onlyInspect
One stream, two checkpoint owners. Stateful callers pass cursor:"latest", then store each next_cursor themselves; that first call only establishes the checkpoint and returns no events, so poll again with the returned next_cursor. Stateless scheduled agents pass consumer_id; smry retains the acknowledged position and the consumer's saved where predicate. Pass exactly one. Managed batches repeat until their next_cursor is acknowledged. Every response also carries a capped source-health attention block. To read what is already there rather than what changes next, use query_feeds. Example: {"cursor":"latest","limit":20} Example: {"consumer_id":7,"limit":20}
Inputs: limit, where, cursor, fields, +2 more. Returns: events, object, has_more, attention, +2 more
get_library_assetFetch an original library fileARead-onlyInspect
Return an authenticated MCP resource link for an item's original file. Set include_data=true to show images or audio inline, or embed another file up to 8 MiB. Larger originals remain readable through the streaming Developer API byte-range endpoint.
Inputs: id (required), include_data. Returns: asset
get_library_changesSync library changesARead-onlyInspect
Read the append-only library change stream, including deletions. For a race-free first sync, call once with cursor=latest, list the library, then continue from the returned nextCursor.
Inputs: limit, cursor. Returns: changes, hasMore, nextCursor
get_library_objectRead a saved item, note, or highlightARead-onlyInspect
Read one object returned by list_library_objects. Item text and note/highlight bodies are bounded; item asset metadata includes the MCP resource URI for original bytes.
Inputs: ref (required), content_max_characters. Returns: ref, type, object
get_saved_articleRead a library itemARead-onlyInspect
Read one library item by id. Stored article text is token-budgeted and supports a paragraph cursor so long documents never flood the agent context.
Inputs: id (required), cursor, max_tokens, include_content. Returns: item
list_librarySearch library content and reading historyARead-onlyInspect
Search this account's articles, websites, books, emails, PDFs, social posts, videos, podcast episodes, and documents. For a normal text search, pass only query and limit. "Triage my inbox" is {"status":"inbox","limit":10}; "saved this week" is {"saved_after":"7d"}. Matching is shared with app search and REST, including spelling recovery (approximate=true). Optional filters are combined with AND: omit every filter the user did not explicitly request. Filter by exact tag, kind, capture method, format, or lifecycle; set view=history for recently read items. Items are ordered by most recent status change first (history view: last read first); continue with nextCursor. Item IDs select later tools and are not smry.ai routes; cite only each exact returned source URL.
Inputs: tag, view, limit, query, +13 more. Returns: items, counts, nextCursor, approximate, +1 more
list_library_objectsSearch every saved library objectARead-onlyInspect
Search and paginate across the account's saved items, standalone notes, and highlights through one corpus. Uses the same Postgres matching as the app and REST API; approximate=true identifies spelling recovery. Returns stable refs for get_library_object. Use list_library when you specifically need item lifecycle filters or reading history.
Inputs: limit, query, types, cursor. Returns: total, objects, partial, nextCursor, +2 more
manage_collectionsmanage collections (list/create/update/delete)ADestructiveInspect
list: Returns the same owner-scoped Collections shown in /feeds, including canonical filter state and revision. Required fields: none. Example: {"action":"list"} create: Creates the same named Collection used by the production /feeds UI. Required fields: name. Example: {"action":"create","name":"Research"} update: Membership is a complete replacement, matching the production Collection editor. Required fields: id. Example: {"action":"update","id":12,"name":"Engineering"} delete: Deletes a custom Collection and moves its inputs to Unsorted. Required fields: id. Example: {"action":"delete","id":12}
Inputs: action (required), id, name, source_ids. Returns: object
manage_feed_consumersmanage feed consumers (create/list/ack/delete)ADestructiveInspect
create: Save a where predicate and let smry retain one processing checkpoint. New consumers start at the current high-water mark, so they receive future discoveries rather than replaying history. For history, create the Consumer first, query the historical window separately, then poll; that order closes the query/create race. Create one per independent processing loop, not per source. Retrying the same case-insensitive name and predicate returns the existing Consumer; the same name with another predicate is a 409. Required fields: name. Example: {"action":"create","name":"Engineering briefing","where":{"collection":["Research"]}} list: List each saved consumer, its opaque acknowledged_cursor, delivery and acknowledgement timestamps, and how many matching entries are waiting past that checkpoint. Required fields: none. Example: {"action":"list"} ack: After processing every event returned by getFeedChanges for this consumer, acknowledge that response's next_cursor. Crashes before ack cause safe redelivery; stale, foreign, and invented cursors are rejected. Required fields: id, cursor. Example: {"action":"ack","id":7,"cursor":"<next_cursor from get_feed_changes>"} delete: Remove only the saved predicate and checkpoint. Followed sources, entries, and human read state are untouched. Required fields: id. Example: {"action":"delete","id":7}
Inputs: action (required), id, name, where, +1 more. Returns: object
manage_feed_filtermanage feed filter (preview/apply)ADestructiveInspect
preview: Classifies a bounded recent sample and returns both binary decisions, uncertainty counts, reasons, and degradation status. Save with applyFeedFilter using this preview token and Collection revision. Required fields: collection, filter. Example: {"action":"preview","collection":{"id":12},"filter":{"prompt":"Software engineering articles","whenUncertain":"include"}} apply: Atomically applies the exact preview when the Collection revision still matches. Passing a preview created with filter:null clears the filter. Required fields: previewToken, expectedRevision. Example: {"action":"apply","previewToken":"","expectedRevision":0}
Inputs: action (required), filter, collection, previewToken, +1 more. Returns: object
mutate_feedsSelector-based writes with dry-run previewADestructiveInspect
Preview changes to matching sources, entries, or collections. Default dry_run:true returns would_affect, sample, and commit_token without changing them. Commit by sending the same op and commit_token; retries replay the recorded result. Explicit dry_run:false applies immediately. sources.move needs set.collection; sources.rename needs set.title; collections.create/rename need set.name. Collections rename/delete need exactly one where.collection. Use manage_collections for direct collection CRUD. Check partial and each outcome after committing. Example: {"op":"collections.create","set":{"name":"Research"}} Example: {"op":"sources.move","where":{"source":{"include":[42]}},"set":{"collection":"Research"}} Example: {"op":"sources.move","commit_token":"<commit_token from preview>"}
Inputs: op (required), set, where, dry_run, +1 more. Returns: object
open_web_pagesRead public web pagesARead-onlyInspect
Open up to four public pages. Pass a focused context to get only the passages relevant to that question (cheap and precise), or omit it to read the full page as clean Markdown with start-based pagination.
Inputs: pages (required). Returns: pages, failures, budgetReached
query_feedsQuery followed feeds: entries, source health, or aggregatesARead-onlyInspect
Read followed feeds. "What's new?" is {"since":"1d"}: newest published first, one line per entry with format:"compact". Other arguments are optional; add where.collection, where.source.include/exclude, where.unread, or where.match when requested. per_source_limit produces a bounded fair sample across pages; omit it to retrieve every matching article. select:"sources" returns fetch_status and last_fetched_at separately from publisher activity (health, silent_days, entries_7d/28d). Quiet publishers can have working feeds. select:"aggregate" returns grouped counts with optional trends. Classification-filtered queries report classification_coverage: pending articles have not been assessed, not rejected. Times accept "7d"/"36h"/"now" or ISO dates. Example: {"since":"1d","per_source_limit":3,"limit":40,"format":"compact"} Example: {"select":"entries","where":{"unread":true,"collection":["Research"]},"limit":10} Example: {"select":"sources","having":{"silent_days":{"gte":30}},"limit":10} Example: {"select":"aggregate","group_by":"collection","where":{"discovered_after":"7d"}}
Inputs: limit, since, where, cursor, +8 more. Returns: entries: {total, returned, omitted:{by_limit}, next_cursor, entries[] | text} ·…
remove_library_itemRemove a library itemADestructiveInspect
Remove one item from this account's library. Web sources are unaffected. For an uploaded file, its original, extracted text, and synced local copies are permanently deleted; highlights and notes are kept.
Inputs: id (required). Returns: id, ok
save_articleScrape and save an articleAIdempotentInspect
Securely extract a public URL and idempotently add it to the account's library. Returns alreadySaved=true for a duplicate and reports hard paywalls instead of claiming success.
Inputs: url (required), tags, status, starred. Returns: item, extraction, alreadySaved
save_contentSave text or a documentBInspect
Save supplied source text without fetching a public URL. Use external_id for retry-safe creates; content_kind can correct automatic classification.
Inputs: title (required), content (required), url, tags, +11 more. Returns: item, alreadySaved
search_articleFind the passages of an article that answer a questionARead-onlyInspect
Read a public article or YouTube URL and return only the passages relevant to your query, each anchored to its paragraph and labelled with the section it sits under. Use this instead of get_article whenever you have a specific question about a link — it answers in a fraction of the tokens and the anchors stay citable.
Inputs: url (required), query (required), cursor, max_tokens, +1 more. Returns: query, title, author, language, +14 more
search_feedsFind public feedsARead-onlyInspect
Use the same discovery catalog and ranking as smry's Discover feeds page. Browse suggested sources with no query; search websites, RSS, Atom, podcasts, Reddit, and YouTube by topic; create a focused Google News source; or discover every feed published by a site URL. Use sort=popular for popularity ordering. This only discovers sources; use follow_feeds to follow results in an existing or new collection.
Inputs: mode, sort, limit, query, +1 more. Returns: mode, sort, query, total, +6 more
search_saved_itemSearch inside a library itemARead-onlyInspect
Return only the stored passages relevant to a question about one library item. Use after list_library instead of reading a long book, PDF, email, transcript, or document from the beginning.
Inputs: id (required), query (required), cursor, max_tokens, +1 more. Returns: id, query, title, passages, +6 more
search_webSearch the public webARead-onlyInspect
Discover current public sources with up to four focused searches. Search snippets are discovery aids; open the strongest pages before citing substantive claims.
Inputs: queries (required), max_results. Returns: failures, searches, budgetReached
set_feed_feedbackSet or undo explicit feedback on an entryBDestructiveInspect
Less like this hides an included entry. Feedback remains separate agent context and never silently revises the Collection filter. Example: {"entryId":42,"value":"less_like_this"}
Inputs: value (required), entryId (required). Returns: value, object, entryId, filterChanged
update_library_itemOrganize a library itemAIdempotentInspect
Move, tag, mark read, update progress, or correct the classification of one library item.
Inputs: id (required), tags, status, starred, +3 more. Returns: item
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Watch web pages and get a short summary of what changed. Create monitors and read changes.
Search and read public Reddit and X posts, comments, threads, profiles and Articles; run monitors.
Read, search and track your RSS feeds: semantic search, story clustering, watches, OPML import.
Search, read and save to your private vault of images, links and notes.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables searching, reading, and privately archiving news from supported publisher subscriptions, with per-user authentication via human sign-in links and separate tokens, sessions, and archives.321 PyPI1MIT
- AlicenseNot gradedqualityDmaintenanceEnables users to search a curated RSS/Atom catalog, subscribe to and collect feeds, and query collected articles through natural-language tools.2MIT
- AlicenseNot gradedqualityCmaintenanceEnables users to browse curated technology feeds and fetch any RSS/Atom/RDF feed.67 npmMIT
- AlicenseAqualityBmaintenanceEnables users to subscribe to RSS feeds, read clean extracted article text without ad-heavy sites, and perform full-text and semantic searches using local SQLite storage with no account required.6MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.