mcp server

mcp

Search, label, and manage your X (Twitter) bookmarks from any MCP client via Tweetsmash

Description as published by the maintainer. Source

• version 2.0.0
• active
• retrieval

active — Most recent push to the repository was 2026-07-11. Dashed tags are derived by ZBS Index from the published description, not stated by the maintainer.

What this server can do

39 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

add_labels_to_tweets(label_id, tweet_ids, label_name)

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. Required: tweet_ids.

archive_bookmarks(action, tweet_ids)

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 with the user first. Reports how many changed. Required: action, tweet_ids.

archive_bookmarks_by_filter(tags, value, action, filter, search_query)

Apply archive/unarchive/delete/undelete to EVERY bookmark matching a filter, in one call. Destructive by nature — confirm with the user before delete. Reports counts. Required: action.

create_share_link(tags, value, filter, tweet_ids, search_query)

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 share up to 10 bookmarks.

create_smart_view(name, base_query, description, default_sort, triage_buckets)

Create a Smart View from a filter so the user can reuse it. Provide a name and the base_query (filter). Required: name.

delete_digest_preference(id)

Remove a digest schedule by id. Required: id.

delete_smart_view(slug)

Delete a Smart View by slug. Required: slug.

fetch_recent_bookmarks(max, force)

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 extension, this reports that a browser sync is needed. Use when the user asks to refresh / fetch their latest saves. For Twitter-list freshness, use get_list_tweets instead.

forget(key, kind)

Delete a durable memory by key (and optional kind).

get_bookmark(id, include)

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 list of article,thread,notes,replies) to narrow it; defaults to article,thread,notes. Use this when the user wants to read or summarize a specific saved tweet/thread/article in depth. Required: id.

get_bookmark_count(tag, author, posted_to, media_type, posted_from, bookmarked_to, hide_archived, is_unread_only, bookmarked_from)

Get the total count of user's bookmarks with optional filtering. Useful for understanding the size of bookmark collections before listing them.

get_bookmark_sync_status(tweet_id, connect_id)

Show whether a specific bookmark has synced to a given integration connection. Required: tweet_id, connect_id.

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 a rolled-up can_pull + how (x_api or extension). Use this before a sync, or when the user asks why bookmarks aren't updating. Note: the extension is browser-only and can't be driven by an agent.

get_list_digests

List past Twitter-list email digests for the user.

get_list_tweets(sort, hours, limit, connect_id)

Get recent tweets for a followed X list — the latest, or (sort=POPULARITY) the top/trending tweets in a look-back window. Use this to surface high-signal content the user can save. hours defaults to 24. Required: connect_id.

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_smart_view(slug)

Get a single Smart View by slug (its filter, tabs/buckets, and sort). Required: slug.

get_smart_view_bookmarks(slug, limit, bucket, cursor)

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. Required: slug.

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.

list_bookmarks(tag, limit, author, cursor, sort_by, posted_to, media_type, posted_from, sort_cursor, bookmarked_to, hide_archived, is_unread_only, bookmarked_from)

List user's Twitter bookmarks with optional filtering and pagination. Supports filtering by read status, media type, author, tags, date ranges, and sorting options. IMPORTANT: Use this tool (with the 'author' parameter) when the user asks to show tweets by a specific author.

list_digest_preferences

List the user's email-digest schedules (frequency, time, paused state) for bookmark and Smart View digests.

list_labels

List all user's labels with their usage counts. Useful for discovering existing labels before adding new ones.

list_past_digests

List past digests sent to the user's email, newest first.

list_smart_views

List the user's Smart Views (saved filtered views). Each has a slug you pass to the other smart-view tools.

list_twitter_lists

List the X (Twitter) lists the user follows in Tweetsmash. Each has a connection id used by the other list tools.

recall(query)

Retrieve durable memories about the user, optionally filtered by a substring query.

remember(key, kind, mode, value)

Store a durable memory about the user (a preference, style, fact, or instruction) so future sessions can use it. Never store secrets or credentials. Required: kind, key, value.

remove_labels_from_tweets(tweet_ids, label_name)

Remove a label from a list of tweets using label_name. Required: tweet_ids, label_name.

revoke_share_link(token)

Revoke a previously created share link by its token. Required: token.

search_bookmarks(q, tag, limit, author, cursor, sort_by, posted_to, media_type, posted_from, sort_cursor, bookmarked_to, hide_archived, is_unread_only, bookmarked_from, vector_search_term)

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, vector_search_term, or author should be provided. IMPORTANT: Use the 'author' parameter for filtering by author, not the 'q' field.

search_docs(query)

Answer questions about Tweetsmash itself — features, how-to, pricing, plans, limits, account/subscription. Searches the bundled product guide and returns the most relevant sections for you to answer from. Call with an empty query to list the help topics.

send_list_digest(list_id, connect_id)

Build and email a digest of a Twitter list's high-signal tweets to the user now. Required: connect_id.

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 is an async operation that may take a few minutes for large bookmark collections.

tag_bookmarks_by_filter(q, tag, author, label_id, posted_to, label_name, media_type, posted_from, bookmarked_to, hide_archived, is_unread_only, bookmarked_from)

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 author name to its id automatically. Reports matched/tagged/failed counts.

trigger_csv_export(tags, value, filter, tweet_ids, search_query)

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(tags, value, filter, tweet_ids, search_query)

Start a JSON export (explicit ids, a filter, or the whole library). Returns a job id; the file appears in the Export Center.

trigger_pdf_export(tags, value, filter, tweet_ids, search_query)

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 appear in the Export Center.

update_digest_preference(id, is_paused, week_info, is_enabled, time_to_read, schedule_time, send_frequency)

Update a digest schedule (enable/pause, frequency, time) by id. Required: id.

update_smart_view(name, slug, base_query, description, default_sort, triage_buckets)

Update a Smart View (name, filter, tabs, sort) by slug. Required: slug.

Last successful function declaration observed on 2026-08-13. Source: https://mcp.tweetsmash.com/api/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://mcp.tweetsmash.com/api/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/RamyaChinnadurai/tweetsmash-mcp
• Remote endpoint (streamable-http) — https://mcp.tweetsmash.com/api/mcp

Related, by what their authors tagged them

• Prowlo — Reddit & X for AI agents — last commit 2026-06-18, shares twitter, x
  Reddit & X data for AI agents over MCP. Semantic search, hosted, no Reddit API.
• CarryFeed — last commit 2026-05-16, shares twitter, x
  Resolve public X/Twitter profiles, posts, and media through CarryFeed.
• io.github.Fisher521/bookmarks-lifecycle — last commit 2026-08-06, shares bookmarks
  Bookmarks on a decision clock: 24 hours to decide, 30 days to watch, or keep. Never deletes.
• io.github.Fisher521/bookmarks-mcp — last commit 2026-08-06, shares bookmarks
  Read-only MCP server for browser bookmarks: Chrome, Safari, Firefox, and read-later exports.
• io.github.Fisher521/burn-mcp-server — last commit 2026-08-06, shares bookmarks
  AI-powered reading triage MCP. 26 tools with a 24h burn timer. Read less, absorb more.
• io.github.alexcloudstar/makers-page-mcp — last commit 2026-08-03, shares twitter
  Marketing Assistant MCP: draft, approve, and publish posts to X from your coding agent.
• io.github.AutomateLab-tech/content-distribution — last commit 2026-06-08, shares twitter
  Publish content to DEV.to, Hashnode, GitHub Discussions, Reddit, Bluesky, LinkedIn, and Medium.
• Social Profile Enrichment API — last commit 2026-08-06, shares twitter
  Social media profile lookup for GitHub, Twitter/X, LinkedIn, YouTube. x402.
• Twitter Scraper API — last commit 2026-08-06, shares twitter
  Scrape Twitter/X profiles, tweets, search. No API key. Structured JSON. x402 pay-per-call.
• io.github.dorukardahan/twitterapi-docs-mcp — last commit 2026-08-04, shares twitter
  Offline access to TwitterAPI.io docs for AI assistants. 52 endpoints, guides, pricing.

These share tags the maintainers applied themselves, such as twitter, x, bookmarks. Common tags like "mcp" or "ai" are ignored for this: agreeing with six hundred other projects is not a similarity.

This is not a recommendation and not a test result. It is a map of what the authors said their work is about.

How the author describes it

Topics the maintainer set on GitHub: ai-agents, bookmarks, claude, mcp, mcp-server, model-context-protocol, twitter, x.