Everything here was measured by our prober or read from a registry. Nothing is self-reported.
30-day availability1/1 checks ok
30 days agotoday
Endpoints
https://mcp.tweetsmash.com/api/mcpmcp streamable http · checked on a schedule
Registry facts
Not distributed through a package registry we index.
when
check
result
http
latency
detail
3 h ago
mcp initialize
ok
200
165 ms
server tweetsmash-mcp 2.1.0 · protocol 2025-06-18 · 53 tools
Tools observed via MCP handshake
list_bookmarks — List the user's Twitter BOOKMARKS — posts they deliberately saved. Never includes X Likes; use list_likes for those. Supports filtering and pagination. Supports
list_likes — List the posts the user LIKED on X (not their bookmarks). Likes are a lighter signal than a save — use list_bookmarks for things the user deliberately saved, an
search_bookmarks — Search through a user's Twitter bookmarks using keyword search (q), semantic search (vector_search_term), or author filtering (author). At least one of q, vecto
get_bookmark_count — Get the total count of user's bookmarks with optional filtering. Useful for understanding the size of bookmark collections before listing them.
list_labels — List all user's labels with their usage counts. Useful for discovering existing labels before adding new ones.
add_labels_to_tweets — Add a label to a list of tweets. Can use an existing label by ID or create a new label by name. Either label_id or label_name must be provided.
remove_labels_from_tweets — Remove a label from a list of tweets using label_name.
delete_label — Delete a label from the account entirely — the label itself plus every bookmark's assignment of it. The BOOKMARKS are not deleted; they simply lose this label.
setup_vector_store — Initialize the vector store for semantic bookmark search. CRITICAL: When vector/semantic search fails with 'Vector Store Not Setup' error, call this tool. This
list_skills — START HERE for any open-ended request. Lists the task playbooks this server supports — systematic learning from bookmarks, organising into themes, cleaning up,
get_skill — Get the full playbook for a task: when to use it, the exact tool sequence with the arguments that matter, tips, and the pitfalls that cause empty results. `name
get_library_overview — A snapshot of the whole library: total bookmarks, unread, untagged, breakdown by type (threads/media/links/notes), every label with its count, and the years cov
Declared by sources
What the publisher says
Attributed to the source that supplied each field. Treated as claims, not facts.
No long description beyond the summary.
kind ← Official MCP Registry
name ← Official MCP Registry
repoUrl ← Official MCP Registry
summary ← Official MCP Registry
version ← Official MCP Registry
description ← Official MCP Registry
publisherName ← Official MCP Registry
Derived by Wellknown
Capabilities
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
5 h ago · declared · summary → "Search, label, and manage your X (Twitter) bookmarks from any MCP client via Tweetsmash"
5 h ago · declared · description → "Search, label, and manage your X (Twitter) bookmarks from any MCP client via Tweetsmash"
5 h ago · declared · publisherName → "com.tweetsmash"
5 h ago · declared · repoUrl → "https://github.com/RamyaChinnadurai/tweetsmash-mcp"
5 h ago · declared · version → "2.0.0"
5 h ago · declared · protocols → ["mcp"]
search_docs — Answer questions about Tweetsmash itself — features, how-to, pricing, plans, limits, account/subscription. Searches the bundled product guide and returns the mo
get_bookmark — Get a single saved bookmark with FULL content in one call — the full X Article body, the unrolled thread, notes, and (optionally) replies. Use `include` (comma
tag_bookmarks_by_filter — Add a label to EVERY bookmark matching a filter, in a single call. Prefer this over listing then looping when the user says 'tag all my … as …'. Resolves an aut
archive_bookmarks — Archive, unarchive, delete, undelete, or mark read/unread a list of bookmarks by id (max 500). This is a bulk write; for destructive actions (delete) confirm wi
archive_bookmarks_by_filter — Apply archive/unarchive/delete/undelete to EVERY bookmark matching a filter, in one call. Destructive by nature — confirm with the user before delete. Reports c
list_smart_views — List the user's Smart Views (saved filtered views). Each has a slug you pass to the other smart-view tools.
get_smart_view — Get a single Smart View by slug (its filter, tabs/buckets, and sort).
get_smart_view_bookmarks — List the bookmarks inside a Smart View, optionally scoped to one tab/bucket. Use the returned ids with archive_bookmarks / tagging tools to act on the view.
create_smart_view — Create a Smart View from a filter so the user can reuse it. Provide a name and the base_query (filter).
update_smart_view — Update a Smart View (name, filter, tabs, sort) by slug.
delete_smart_view — Delete a Smart View by slug.
create_share_link — Create a public, read-only share link for a set of bookmarks (explicit ids or everything matching a filter). Returns a share_url valid for 7 days. Free plans sh
revoke_share_link — Revoke a previously created share link by its token.
trigger_pdf_export — Start a PDF export of the user's bookmarks (explicit ids, everything matching a filter, or the whole library). Returns a job id; tell the user the file will app
trigger_csv_export — Start a CSV export (explicit ids, a filter, or the whole library). Returns a job id; the file appears in the Export Center.
trigger_json_export — Start a JSON export (explicit ids, a filter, or the whole library). Returns a job id; the file appears in the Export Center.
list_digest_preferences — List the user's email-digest schedules (frequency, time, paused state) for bookmark and Smart View digests.
update_digest_preference — Update a digest schedule (enable/pause, frequency, time) by id.
delete_digest_preference — Remove a digest schedule by id.
list_past_digests — List past digests sent to the user's email, newest first. This is Digest 1.0 (the cluster pipeline). For the AI-composed Digest 2.0, use list_mash_digests.
list_mash_digests — The user's Mash Digest 2.0 digests — the AI-composed ones. An account can have SEVERAL (a morning read and an evening skim are two digests, not two sections of
list_mash_digest_issues — Past issues of the user's Digest 2.0, newest first — what arrived and when. Deliberately WITHOUT the content: pick one and call get_mash_digest_issue for the wh
get_mash_digest_issue — One digest issue in full: its title, intro, every section, and per item the summary, why it was picked and why it matters to this user. Use it to answer 'what w
compose_mash_digest — Compose one of the user's Digest 2.0 digests NOW rather than waiting for its schedule. SPENDS A DIGEST CREDIT and takes about a minute, so only call it when the
get_sync_status — Show the user's app-sync integrations (Notion, Google Sheets, Zotero): whether each is connected/enabled, synced vs pending counts, and any errors.
get_bookmark_sync_status — Show whether a specific bookmark has synced to a given integration connection.
list_twitter_lists — List the X (Twitter) lists the user follows in Tweetsmash. Returns each list's name plus its `connect_id` — pass that to get_list_tweets / send_list_digest. STA
get_list_tweets — Get recent tweets for a followed X list — the latest, or (sort=POPULARITY) the top/trending tweets in a look-back window. Serves a cached copy when it's fresh a
get_list_digests — List past Twitter-list email digests for the user.
send_list_digest — Build and email a digest of a Twitter list's high-signal tweets to the user now.
preview_list_ranking — Rank a followed X list exactly the way the digest ranker would, WITHOUT sending anything, and show the work: each unit carries its rank_signals (lane_fit = matc
get_author_preferences — The user's stated author preferences for list digests: `boost` = never-miss authors, `hide` = muted authors.
set_author_preference — Remember how the user feels about an author in their list digests. action=boost → never miss this author's posts (they will always be included, low-signal ones
get_me — Get the current user's account: identity, current plan and status, and usage (e.g. AI chat credits). Use this to answer 'who am I' / 'what plan am I on'.
get_connection_status — Check whether the user's tweets can be pulled: the X (Twitter) API connection (connected / disconnected), whether the browser extension has synced recently, and
fetch_recent_bookmarks — Force-pull the user's most recent bookmarks from the X API now (server-side). Requires a connected X account; if the account only syncs via the browser extensio
remember — Save a durable PREFERENCE about how this user wants their bookmark library handled — the themes they organise by, topics to exclude, preferred summary length/fo
recall — Read back the user's saved library preferences (optionally filtered by a substring). Worth calling before an open-ended organise, summarise or cleanup task so y
forget — Delete a saved library preference by key (optionally narrowed by kind). Use when the user changes their mind or asks you to drop something.
get_interests — Read what this user is actually interested in, inferred from their saved bookmarks, hand labels, questions and digest clicks — not from anything they typed. Ret
correct_interest — Record the user's correction to an inferred interest, using a key from get_interests. Corrections are sticky — they survive every future recompute. Use `confirm