# mcp MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/com-tweetsmash-mcp
- Repository: https://github.com/RamyaChinnadurai/tweetsmash-mcp

## Install
- Endpoint: https://mcp.tweetsmash.com/api/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://mcp.tweetsmash.com/api/mcp

## Tools
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- list_labels - List all user's labels with their usage counts. Useful for discovering existing labels before adding new ones. Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- remove_labels_from_tweets - Remove a label from a list of tweets using label_name. Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- list_smart_views - List the user's Smart Views (saved filtered views). Each has a slug you pass to the other smart-view tools. Endpoint: https://mcp.tweetsmash.com/api/mcp
- get_smart_view - Get a single Smart View by slug (its filter, tabs/buckets, and sort). Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- create_smart_view - Create a Smart View from a filter so the user can reuse it. Provide a name and the base_query (filter). Endpoint: https://mcp.tweetsmash.com/api/mcp
- update_smart_view - Update a Smart View (name, filter, tabs, sort) by slug. Endpoint: https://mcp.tweetsmash.com/api/mcp
- delete_smart_view - Delete a Smart View by slug. Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- revoke_share_link - Revoke a previously created share link by its token. Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- list_digest_preferences - List the user's email-digest schedules (frequency, time, paused state) for bookmark and Smart View digests. Endpoint: https://mcp.tweetsmash.com/api/mcp
- update_digest_preference - Update a digest schedule (enable/pause, frequency, time) by id. Endpoint: https://mcp.tweetsmash.com/api/mcp
- delete_digest_preference - Remove a digest schedule by id. Endpoint: https://mcp.tweetsmash.com/api/mcp
- list_past_digests - List past digests sent to the user's email, newest first. Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- get_bookmark_sync_status - Show whether a specific bookmark has synced to a given integration connection. Endpoint: https://mcp.tweetsmash.com/api/mcp
- list_twitter_lists - List the X (Twitter) lists the user follows in Tweetsmash. Each has a connection id used by the other list tools. Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- get_list_digests - List past Twitter-list email digests for the user. Endpoint: https://mcp.tweetsmash.com/api/mcp
- send_list_digest - Build and email a digest of a Twitter list's high-signal tweets to the user now. Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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'. Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- 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. Endpoint: https://mcp.tweetsmash.com/api/mcp
- recall - Retrieve durable memories about the user, optionally filtered by a substring query. Endpoint: https://mcp.tweetsmash.com/api/mcp
- forget - Delete a durable memory by key (and optional kind). Endpoint: https://mcp.tweetsmash.com/api/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: com.tweetsmash
- Version: 2.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 11, 2026
- Source: https://registry.modelcontextprotocol.io