mcpbeat

Tweetsmash MCP Server

com.tweetsmash/mcp
answering

Tweetsmash is answering right now. Last checked 3 min ago. It exposes 39 tools. Last commit 11 Jul 2026.

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

Uptime history 41 hours of history
41 hours agonow
100.0%
Uptime 24h
91 of 91 checks
39
Tools
read from the server
244 ms
Response time
average over 24h
0
Stars
last commit 11 Jul 2026

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 3 min ago.

run in your terminal
claude mcp add mcp --transport http https://mcp.tweetsmash.com/api/mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.tweetsmash.com/api/mcp"
    }
  }
}
~/.codex/config.toml
[mcp_servers.mcp]
url = "https://mcp.tweetsmash.com/api/mcp"
.cursor/mcp.json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.tweetsmash.com/api/mcp"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.tweetsmash.com/api/mcp"
    }
  }
}

Available tools 39

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

smart
create_smart_view
Create a Smart View from a filter so the user can reuse it. Provide a name and the base_query (filter).
delete_smart_view
Delete a Smart View by slug.
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.
list_smart_views
List the user's Smart Views (saved filtered views). Each has a slug you pass to the other smart-view tools.
update_smart_view
Update a Smart View (name, filter, tabs, sort) by slug.
bookmark
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 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.
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.
get_bookmark_sync_status
Show whether a specific bookmark has synced to a given integration connection.
digest
delete_digest_preference
Remove a digest schedule by id.
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.
labels
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.
list_labels
List all user's labels with their usage counts. Useful for discovering existing labels before adding new ones.
remove_labels_from_tweets
Remove a label from a list of tweets using label_name.
trigger
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.
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 appear in the Export Center.
archive
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 with the user first. Reports how many changed.
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 counts.
bookmarks
list_bookmarks
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.
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, vector_search_term, or author should be provided. IMPORTANT: Use the 'author' parameter for filtering by author, not the 'q' field.
connection
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.
digests
get_list_digests
List past Twitter-list email digests for the user.
docs
search_docs
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.
forget
forget
Delete a durable memory by key (and optional kind).
get
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'.
past
list_past_digests
List past digests sent to the user's email, newest first.
recall
recall
Retrieve durable memories about the user, optionally filtered by a substring query.
recent
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 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.
remember
remember
Store a durable memory about the user (a preference, style, fact, or instruction) so future sessions can use it. Never store secrets or credentials.
revoke
revoke_share_link
Revoke a previously created share link by its token.
send
send_list_digest
Build and email a digest of a Twitter list's high-signal tweets to the user now.
setup
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.
share
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 share up to 10 bookmarks.
sync
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.
tag
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 author name to its id automatically. Reports matched/tagged/failed counts.
tweets
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. Use this to surface high-signal content the user can save. hours defaults to 24.
twitter
list_twitter_lists
List the X (Twitter) lists the user follows in Tweetsmash. Each has a connection id used by the other list tools.

Endpoints

URLTransportStateLatencyChecked
https://mcp.tweetsmash.com/api/mcp streamable-http answering 248 ms 3 min ago

Tweetsmash — questions

Answers built from our own checks of this server.

What can Tweetsmash do?
It exposes 39 tools, read directly from the server on our last check. Among them: add_labels_to_tweets, archive_bookmarks, archive_bookmarks_by_filter, create_share_link, create_smart_view, delete_digest_preference and 33 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →
What is Tweetsmash mostly used for?
Its tools cluster around smart, trigger and digest. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.
Is Tweetsmash working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 244 ms. The bar chart above shows every period we have measured.
How do I connect Tweetsmash?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does Tweetsmash need an API key?
No. Tweetsmash completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 39 of them are readable on this page. This is what we observed, not what the docs claim.
How fast is Tweetsmash?
It answers our handshake in 244 ms on average, which is faster than 54% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.
Is Tweetsmash open source?
Yes — 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.