MCP server

Tweetsmash Official

com.tweetsmash/mcp

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Source

At a glance

Type

MCP server

Publisher

tweetsmash.com (verified by the MCP Registry)

Status

Working at last check

Tools

53

Token cost

About 10,775 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http tweetsmash https://mcp.tweetsmash.com/api/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.tweetsmash]
url = "https://mcp.tweetsmash.com/api/mcp"

Gemini CLI

{"mcpServers":{"tweetsmash":{"httpUrl":"https://mcp.tweetsmash.com/api/mcp"}}}

Cursor

{"mcpServers":{"tweetsmash":{"url":"https://mcp.tweetsmash.com/api/mcp"}}}

VS Code

{"servers":{"tweetsmash":{"type":"http","url":"https://mcp.tweetsmash.com/api/mcp"}}}

Antigravity

agy mcp add tweetsmash https://mcp.tweetsmash.com/api/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"tweetsmash","server_url":"https://mcp.tweetsmash.com/api/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"tweetsmash","server_url":"https://mcp.tweetsmash.com/api/mcp"}

Tools

• add_labels_to_tweets ~196 tokens
  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.
• archive_bookmarks ~189 tokens
  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.
• archive_bookmarks_by_filter ~183 tokens
  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.
• compose_mash_digest ~180 tokens
  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 user asks for a fresh digest — not to inspect the current one (use get_mash_digest_issue for that). Returns an issue_id to read back once c
• correct_interest ~366 tokens
  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` when they agree, `rename` for their own wording, `hide` to stop using an interest while keeping its history, `boost` when they want it wei
• create_share_link ~188 tokens
  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 ~167 tokens
  Create a Smart View from a filter so the user can reuse it. Provide a name and the base_query (filter).
• delete_digest_preference Deletes data · ~89 tokens
  Remove a digest schedule by id.
• delete_label Deletes data · ~254 tokens
  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. IRREVERSIBLE: before calling, tell the user how many bookmarks carry the label (list_labels returns the count) and get an explicit yes. To t
• delete_smart_view Deletes data · ~86 tokens
  Delete a Smart View by slug.
• fetch_recent_bookmarks ~201 tokens
  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
• forget ~113 tokens
  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_author_preferences ~74 tokens
  The user's stated author preferences for list digests: `boost` = never-miss authors, `hide` = muted authors.
• get_bookmark ~218 tokens
  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 sp
• get_bookmark_count ~414 tokens
  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 ~124 tokens
  Show whether a specific bookmark has synced to a given integration connection.
• get_connection_status ~145 tokens
  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 ext
• get_interests ~187 tokens
  Read what this user is actually interested in, inferred from their saved bookmarks, hand labels, questions and digest clicks — not from anything they typed. Returns topics with a 0-1 strength, whether each is active this week, and a `coverage` field saying how much evidence exists (`lite` means a ne
• get_library_overview ~133 tokens
  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 covered. Use this FIRST for anything open-ended (organise, clean up, learn from my saves, 'how many do I have per topic') instead of paging thr
• get_list_digests ~56 tokens
  List past Twitter-list email digests for the user.
• get_list_tweets ~328 tokens
  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 and otherwise fetches from X automatically, so it always returns real tweets; `meta.source` says cache or fetched and `meta.cache_age_hours`
• get_mash_digest_issue ~196 tokens
  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 was in my digest?', 'why was this in there?' or to carry on a conversation about something the user just read. Items carry tweet IDS, not pos
• get_me ~83 tokens
  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_skill ~315 tokens
  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` takes EITHER an exact skill name (learn_from_bookmarks, organise_into_themes, cleanup_library, list_intelligence, get_my_data_out, find_th
• get_smart_view ~96 tokens
  Get a single Smart View by slug (its filter, tabs/buckets, and sort).
• get_smart_view_bookmarks ~198 tokens
  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.
• get_sync_status ~84 tokens
  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 ~620 tokens
  List the user's Twitter BOOKMARKS — posts they deliberately saved. Never includes X Likes; use list_likes for those. Supports 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
• list_digest_preferences ~74 tokens
  List the user's email-digest schedules (frequency, time, paused state) for bookmark and Smart View digests.
• list_labels ~72 tokens
  List all user's labels with their usage counts. Useful for discovering existing labels before adding new ones.
• list_likes ~598 tokens
  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, and this when the user explicitly asks about likes or about what they react to. Same filters and pagination as list_bookmarks.
• list_mash_digest_issues ~177 tokens
  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 whole thing. Pass digest_id to narrow to one digest.
• list_mash_digests ~130 tokens
  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 one), so START HERE and use the returned `id` for the other digest tools. Returns each digest's name, where its sections read from, and its
• list_past_digests ~86 tokens
  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_skills ~136 tokens
  START HERE for any open-ended request. Lists the task playbooks this server supports — systematic learning from bookmarks, organising into themes, cleaning up, X-list intelligence, exporting data out, finding a half-remembered save, digests, and diagnosing sync. Each names when to use it; call get_s
• list_smart_views ~72 tokens
  List the user's Smart Views (saved filtered views). Each has a slug you pass to the other smart-view tools.
• list_twitter_lists ~101 tokens
  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. START HERE for any 'what's in my list' request.
• preview_list_ranking ~374 tokens
  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 = matches what the user builds/studies, affinity = an author they trust, engagement, substance, noise demotions) plus author groups (`group_size`
• recall ~133 tokens
  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 you follow how they already like things done.
• remember ~368 tokens
  Save a durable PREFERENCE about how this user wants their bookmark library handled — the themes they organise by, topics to exclude, preferred summary length/format, which account is their main one. It carries across sessions AND into the Tweetsmash web app, which your own client memory cannot reach
• remove_labels_from_tweets ~140 tokens
  Remove a label from a list of tweets using label_name.
• revoke_share_link Changes accounts · ~96 tokens
  Revoke a previously created share link by its token.
• search_bookmarks ~726 tokens
  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 ~165 tokens
  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 ~125 tokens
  Build and email a digest of a Twitter list's high-signal tweets to the user now.
• set_author_preference ~260 tokens
  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 collapsed rather than dropped); action=hide → mute them; action=clear → forget the preference. Use when the user says things like 'don't let
• setup_vector_store ~111 tokens
  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 ~522 tokens
  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 ~171 tokens
  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 ~172 tokens
  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 ~189 tokens
  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 ~158 tokens
  Update a digest schedule (enable/pause, frequency, time) by id.
• update_smart_view ~136 tokens
  Update a Smart View (name, filter, tabs, sort) by slug.

Browse

• Website monitoring
• Email
• Social media

Related MCP servers

• X Twitter
  X (twitter): x, xapi, Twitter, twitter api, twitters ,tweets, tw, twttr, FollowerIds, friendsIds.
• twitr.sh
  X/Twitter reads, search, monitors and posting. Pay-per-call in USDC — no signup, no API keys.
• YouSpot
  Query one person's second brain: contacts, companies, notes, files and connected accounts.
• SiteCheck Shop & Social
  113 pay-per-call agent tools: e-commerce, product, price and social media data tools. x402
• JobsAI
  Czech AI job board: search jobs, apply for consenting candidates, manage a company's job postings.
• Enchant MCP by usefulapi
  Work with Enchant help desk tickets: list, read, reply, add notes and labels, manage customers.
• Nausika
  Mediterranean marine, nautical, sailing: forecasts, tides, sea routes, anchorages, POIs for AI.
• SimpleFeed MCP
  Search rights-cleared news and video from entitled publisher catalogs.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/com.tweetsmash/mcp.svg)](https://aptlynx.net/servers/com.tweetsmash/mcp)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents