Social Media

tweetsmash.com

An MCP server for managing and searching a user's Twitter/X bookmarks, likes, and labels.

WebMCP2 endpoints54 known toolsFirst detected May 29, 2026Last detected September 21, 2026

ENDPOINT 1

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

No auth detected

MCP server metadata

Name: tweetsmash-mcp
Version: 2.1.0

Capabilities

resources.listChangedtools.listChanged

Server instructions

Tweetsmash is the user's personal archive of the X (Twitter) posts they saved. Use it when the user refers to something they already bookmarked, saved or read on X and want it back. Reach for search_bookmarks first; fall back to list_bookmarks with filters when the query is structural (an author, a label, a date range) rather than semantic. Do not use it to search public X, to read someone else's posts, or to post, reply, like or follow. None of that is possible here. A key reaches only the account that issued it. Before concluding that a post is missing, call get_sync_status or get_bookmark_sync_status: an empty result is more often a stale sync than a post that was never saved. Exports (trigger_pdf_export, trigger_csv_export, trigger_json_export) are asynchronous. They return a job id; the file appears in the Export Center. Do not promise the user an immediate download. Tools annotated destructiveHint delete or detach data (delete_label, delete_smart_view, archive_bookmarks, archive_bookmarks_by_filter, remove_labels_from_tweets, revoke_share_link, delete_digest_preference, forget). Confirm with the user before calling one, and never call a *_by_filter variant without first showing how many items the filter matches. Free accounts hit caps: some filters and larger exports answer 402 with an upgrade_url. Surface that to the user rather than retrying. Auth is a bearer API key from https://www.tweetsmash.com/integrations/api. See https://www.tweetsmash.com/auth.md.

Known tools 53

list_bookmarks

List the user's Twitter BOOKMARKS — posts they deliberately saved.

Inferred read-only

list_likes

List the posts the user LIKED on X (not their bookmarks).

Inferred read-only

search_bookmarks

Search through a user's Twitter bookmarks using keyword search (q), semantic search (vector_search_term), or author filtering (author).

Inferred read-only

get_bookmark_count

Get the total count of user's bookmarks with optional filtering.

Inferred read-only

list_labels

List all user's labels with their usage counts.

Inferred read-only

add_labels_to_tweets

Add a label to a list of tweets.

Inferred read-only

remove_labels_from_tweets

Remove a label from a list of tweets using label_name.

Potential side effects

delete_label

Delete a label from the account entirely — the label itself plus every bookmark's assignment of it.

Potential side effects

setup_vector_store

Initialize the vector store for semantic bookmark search.

Inferred read-only

list_skills

START HERE for any open-ended request.

Inferred read-only

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.

Inferred read-only

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 covered.

Inferred read-only

search_docs

Answer questions about Tweetsmash itself — features, how-to, pricing, plans, limits, account/subscription.

Inferred read-only

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.

Inferred read-only

tag_bookmarks_by_filter

Add a label to EVERY bookmark matching a filter, in a single call.

Inferred read-only

archive_bookmarks

Archive, unarchive, delete, undelete, or mark read/unread a list of bookmarks by id (max 500).

Potential side effects

archive_bookmarks_by_filter

Apply archive/unarchive/delete/undelete to EVERY bookmark matching a filter, in one call.

Potential side effects

list_smart_views

List the user's Smart Views (saved filtered views).

Inferred read-only

get_smart_view

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

Inferred read-only

get_smart_view_bookmarks

List the bookmarks inside a Smart View, optionally scoped to one tab/bucket.

Inferred read-only

create_smart_view

Create a Smart View from a filter so the user can reuse it.

Potential side effects

update_smart_view

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

Potential side effects

delete_smart_view

Delete a Smart View by slug.

Potential side effects

create_share_link

Create a public, read-only share link for a set of bookmarks (explicit ids or everything matching a filter).

Potential side effects

revoke_share_link

Revoke a previously created share link by its token.

Inferred read-only

trigger_pdf_export

Start a PDF export of the user's bookmarks (explicit ids, everything matching a filter, or the whole library).

Inferred read-only

trigger_csv_export

Start a CSV export (explicit ids, a filter, or the whole library).

Inferred read-only

trigger_json_export

Start a JSON export (explicit ids, a filter, or the whole library).

Inferred read-only

list_digest_preferences

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

Potential side effects

update_digest_preference

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

Potential side effects

delete_digest_preference

Remove a digest schedule by id.

Potential side effects

list_past_digests

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

Potential side effects

list_mash_digests

The user's Mash Digest 2.0 digests — the AI-composed ones.

Inferred read-only

list_mash_digest_issues

Past issues of the user's Digest 2.0, newest first — what arrived and when.

Inferred read-only

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.

Inferred read-only

compose_mash_digest

Compose one of the user's Digest 2.0 digests NOW rather than waiting for its schedule.

Inferred read-only

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.

Inferred read-only

get_bookmark_sync_status

Show whether a specific bookmark has synced to a given integration connection.

Inferred read-only

list_twitter_lists

List the X (Twitter) lists the user follows in Tweetsmash.

Inferred read-only

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.

Inferred read-only

get_list_digests

List past Twitter-list email digests for the user.

Potential side effects

send_list_digest

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

Potential side effects

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 = matches what the user builds/studies, affinity = an author they trust, engagement, substance, noise demotions) plus author groups (`group_size` + `related_items` = several posts by one author, best one leading).

Inferred read-only

get_author_preferences

The user's stated author preferences for list digests: `boost` = never-miss authors, `hide` = muted authors.

Inferred read-only

set_author_preference

Remember how the user feels about an author in their list digests.

Inferred read-only

get_me

Get the current user's account: identity, current plan and status, and usage (e.g.

Inferred read-only

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).

Inferred read-only

fetch_recent_bookmarks

Force-pull the user's most recent bookmarks from the X API now (server-side).

Inferred read-only

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/format, which account is their main one.

Inferred read-only

recall

Read back the user's saved library preferences (optionally filtered by a substring).

Inferred read-only

forget

Delete a saved library preference by key (optionally narrowed by kind).

Potential side effects

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.

Inferred read-only

correct_interest

Record the user's correction to an inferred interest, using a key from get_interests.

Inferred read-only

CONNECT WITH APPROVAL

Client installation

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

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

Claude Code

.mcp.json

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

Claude Desktop

Settings → Connectors → Add custom connector

Name: tweetsmash-mcp
Remote MCP URL: https://mcp.tweetsmash.com/api/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

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

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

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

Generic MCP

Client-specific MCP configuration

{
  "name": "tweetsmash-mcp",
  "transport": "streamable-http",
  "url": "https://mcp.tweetsmash.com/api/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

ENDPOINT 2

https://www.tweetsmash.com

No auth detected

MCP server metadata

Name: WebMCP

Capabilities

declarative

Known tools 1

search_tweetsmash_faq

Search the Tweetsmash FAQ for an answer about bookmark syncing, exports, search, pricing, the REST API or the MCP server.

Inferred read-only

CONNECT WITH APPROVAL

Client installation

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.webmcp]
url = "https://www.tweetsmash.com"
enabled = true

Claude Code

.mcp.json

{
  "mcpServers": {
    "webmcp": {
      "type": "http",
      "url": "https://www.tweetsmash.com"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector

Name: webmcp
Remote MCP URL: https://www.tweetsmash.com

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "webmcp": {
      "url": "https://www.tweetsmash.com"
    }
  }
}

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

{
  "servers": {
    "webmcp": {
      "type": "http",
      "url": "https://www.tweetsmash.com"
    }
  }
}

Generic MCP

Client-specific MCP configuration

{
  "name": "webmcp",
  "transport": "streamable-http",
  "url": "https://www.tweetsmash.com"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

TRUST AND VERIFICATION EVIDENCE

Loading Trust v2 evidence…

Checking the associated registrable domain. The BuiltWith key remains server-side.

Indexed

Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.