com.tweetsmash/mcp

REMOTE · MCP.TWEETSMASH.COM · SCANNED AUG 3

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

Available components

+6 this week 69 69 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →

Endpoint Security66

The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
Authorisation not fully verified: no authorisation is required to call this server, and 39 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe. See how to fix → View diagnostics → Unverified
HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass

Transport & Reachability100

Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass

Schema Quality & AI Usability70

AI-judged instruction clarity (good).Pass
Tool/resource definitions use about 3495 tokens (~89/item across 39 items; 39 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage91

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
72% of tool parameters carry a description.Partial

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

remote · mcp.tweetsmash.com

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

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

# ~/.codex/config.toml

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

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-tweetsmash-mcp": {
      "type": "remote",
      "url": "https://mcp.tweetsmash.com/api/mcp",
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add com-tweetsmash-mcp --url https://mcp.tweetsmash.com/api/mcp --transport streamable-http

# ~/.hermes/config.yaml

mcp_servers:
  com-tweetsmash-mcp:
    url: "https://mcp.tweetsmash.com/api/mcp"

// mcp.json

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
1 Aug 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.
31 Jul 26 +2
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
29 Jul 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.
28 Jul 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.
27 Jul 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
26 Jul 26 63

First indexed and scored.

Show 6 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Probed https://mcp.tweetsmash.com/api/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject	Issuer	Valid from	Valid until	Key	Signature	Serial
CN=mcp.tweetsmash.com	CN=YR2,O=Let's Encrypt,C=US	30 Jul 2026	28 Oct 2026	RSA 2048	SHA256-RSA	6f650731f1ae888259d1eb27303dbe8c85a
SANs: mcp.tweetsmash.com
CN=YR2,O=Let's Encrypt,C=US (CA)	CN=Root YR,O=ISRG,C=US	3 Sept 2025	2 Sept 2028	RSA 2048	SHA256-RSA	4ebd24947e24d394802d84a52fd5b319
CN=Root YR,O=ISRG,C=US (CA)	CN=ISRG Root X1,O=Internet Security Research Group,C=US	13 May 2026	2 Sept 2032	RSA 4096	SHA256-RSA	f24b6d17f9d9ad7cb1c9fea78782699f

DNSSEC secure

Validation of mcp.tweetsmash.com. — Secure

Zone	DS	Keys	Algorithms	Outcome
.	trust_anchor	20326, 38696	8, 8	Verified
com.	present	19718	13	Verified
tweetsmash.com.	present	2371	13	Verified
mcp.tweetsmash.com.				Verified address RRset verified with the apex keys

Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result	No authorisation required
HTTP status	200

Header	Value
strict-transport-security	max-age=63072000

Transports 2 probes

Transport	URL	Outcome	Status	Location
streamable-http	https://mcp.tweetsmash.com/api/mcp	Verified	200
http (plaintext)	http://mcp.tweetsmash.com/api/mcp	HTTPS enforced	308	https://mcp.tweetsmash.com/api/mcp

MCP tools — 39 exposed · ~3,495 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

add_labels_to_tweets ~105

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.

Input Output Examples

Name	Type	Req	Description
label_id	string	—	ID of existing label (use either label_id or label_name)
label_name	string	—	Name of the label to create/add (use either label_id or label_name)
tweet_ids	array	yes	Array of tweet IDs to add the label to

No output schema declared.

No examples provided.

archive_bookmarks ~86

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.

Input Output Examples

Name	Type	Req	Description
action	string	yes	The action to apply.
tweet_ids	array	yes	Bookmark ids to act on (max 500).

No output schema declared.

No examples provided.

archive_bookmarks_by_filter ~88

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.

Input Output Examples

Name	Type	Req	Description
action	string	yes	The action to apply to every match.
filter	string	—	—
search_query	string	—	—
tags	array	—	—
value	string	—	—

No output schema declared.

No examples provided.

create_share_link ~105

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.

Input Output Examples

Name	Type	Req	Description
filter	string	—	—
search_query	string	—	—
tags	array	—	—
tweet_ids	array	—	Explicit ids to export. Omit to export everything matching the filter, or the whole library.
value	string	—	—

No output schema declared.

No examples provided.

create_smart_view ~86

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

Input Output Examples

Name	Type	Req	Description
base_query	string	—	The filter query that defines the view.
default_sort	string	—	—
description	string	—	—
name	string	yes	View name.
triage_buckets	—	—	Optional tab/bucket definitions.

No output schema declared.

No examples provided.

delete_digest_preference ~28

Remove a digest schedule by id.

Input Output Examples

Name	Type	Req	Description
id	string	yes	The digest preference id.

No output schema declared.

No examples provided.

delete_smart_view ~28

Delete a Smart View by slug.

Input Output Examples

Name	Type	Req	Description
slug	string	yes	The smart view slug.

No output schema declared.

No examples provided.

fetch_recent_bookmarks ~111

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.

Input Output Examples

Name	Type	Req	Description
force	boolean	—	Force the pull even if a recent sync exists.
max	number	—	How many recent bookmarks to pull (max 800).

No output schema declared.

No examples provided.

forget ~37

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

Input Output Examples

Name	Type	Req	Description
key	string	—	The memory key to forget.
kind	string	—	—

No output schema declared.

No examples provided.

get_bookmark ~133

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.

Input Output Examples

Name	Type	Req	Description
id	string	yes	The tweet/bookmark id to fetch.
include	string	—	Comma list of extra content to include: article,thread,notes,replies. Defaults to article,thread,notes.

No output schema declared.

No examples provided.

get_bookmark_count ~208

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

Input Output Examples

Name	Type	Req	Description
author	string	—	Filter by author username. Use this parameter when the user wants to find tweets by a specific author (e.g., 'Show tweets by @user'). Do NOT use 'q' for author names.
bookmarked_from	string	—	Filter bookmarks added after this date (ISO 8601 string)
bookmarked_to	string	—	Filter bookmarks added before this date (ISO 8601 string)
hide_archived	boolean	—	Hide archived bookmarks
is_unread_only	boolean	—	Filter to only unread bookmarks
media_type	string	—	Filter by media type
posted_from	string	—	Filter tweets posted after this date (ISO 8601 string)
posted_to	string	—	Filter tweets posted before this date (ISO 8601 string)
tag	string	—	Filter by tag

No output schema declared.

No examples provided.

get_bookmark_sync_status ~44

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

Input Output Examples

Name	Type	Req	Description
connect_id	string	yes	The integration connection id.
tweet_id	string	yes	—

No output schema declared.

No examples provided.

get_connection_status ~83

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.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_list_digests ~22

List past Twitter-list email digests for the user.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_list_tweets ~111

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.

Input Output Examples

Name	Type	Req	Description
connect_id	string	yes	The list connection id.
hours	number	—	Look-back window in hours (default 24).
limit	number	—	—
sort	string	—	LATEST or POPULARITY (trending/top).

No output schema declared.

No examples provided.

get_me ~48

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

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_smart_view ~39

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

Input Output Examples

Name	Type	Req	Description
slug	string	yes	The smart view slug.

No output schema declared.

No examples provided.

get_smart_view_bookmarks ~102

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.

Input Output Examples

Name	Type	Req	Description
bucket	string	—	Which tab/bucket of the view to read (default: all).
cursor	number	—	Numeric offset for the next page.
limit	number	—	Page size (1-100).
slug	string	yes	The smart view slug.

No output schema declared.

No examples provided.

get_sync_status ~41

Show the user's app-sync integrations (Notion, Google Sheets, Zotero): whether each is connected/enabled, synced vs pending counts, and any errors.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_bookmarks ~304

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.

Input Output Examples

Name	Type	Req	Description
author	string	—	Filter by author username. Use this parameter when the user wants to find tweets by a specific author (e.g., 'Show tweets by @user'). Do NOT use 'q' for author names.
bookmarked_from	string	—	Filter bookmarks added after this date (ISO 8601 string)
bookmarked_to	string	—	Filter bookmarks added before this date (ISO 8601 string)
cursor	string	—	Pagination cursor for next page
hide_archived	boolean	—	Hide archived bookmarks
is_unread_only	boolean	—	Filter to only unread bookmarks
limit	number	—	Number of bookmarks to retrieve (1-100)
media_type	string	—	Filter by media type
posted_from	string	—	Filter tweets posted after this date (ISO 8601 string)
posted_to	string	—	Filter tweets posted before this date (ISO 8601 string)
sort_by	string	—	Sort order for results
sort_cursor	string	—	Cursor for pagination when using sort_by (use value from meta.sort_cursor of previous response)
tag	string	—	Filter by tag

No output schema declared.

No examples provided.

list_digest_preferences ~32

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

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_labels ~27

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

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_past_digests ~25

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

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_smart_views ~33

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

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_twitter_lists ~37

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

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

recall ~34

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

Input Output Examples

Name	Type	Req	Description
query	string	—	Optional substring to filter recalled memories.

No output schema declared.

No examples provided.

remember ~80

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

Input Output Examples

Name	Type	Req	Description
key	string	yes	A short stable key for this memory.
kind	string	yes	The kind of memory.
mode	string	—	—
value	string	yes	The memory content.

No output schema declared.

No examples provided.

remove_labels_from_tweets ~53

Remove a label from a list of tweets using label_name.

Input Output Examples

Name	Type	Req	Description
label_name	string	yes	Name of the label to remove
tweet_ids	array	yes	Array of tweet IDs to remove label from

No output schema declared.

No examples provided.

revoke_share_link ~33

Revoke a previously created share link by its token.

Input Output Examples

Name	Type	Req	Description
token	string	yes	The share link token to revoke.

No output schema declared.

No examples provided.

search_bookmarks ~383

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.

Input Output Examples

Name	Type	Req	Description
author	string	—	Filter by author username. Use this parameter when the user wants to find tweets by a specific author (e.g., 'Show tweets by @user'). Do NOT use 'q' for author names.
bookmarked_from	string	—	Filter bookmarks added after this date (ISO 8601 string)
bookmarked_to	string	—	Filter bookmarks added before this date (ISO 8601 string)
cursor	string	—	Pagination cursor for next page
hide_archived	boolean	—	Hide archived bookmarks
is_unread_only	boolean	—	Filter to only unread bookmarks
limit	number	—	Number of bookmarks to retrieve (1-100)
media_type	string	—	Filter by media type
posted_from	string	—	Filter tweets posted after this date (ISO 8601 string)
posted_to	string	—	Filter tweets posted before this date (ISO 8601 string)
q	string	—	Keyword or text search query for finding bookmarks by exact words or phrases in tweet content. Do NOT use this for author names - use the 'author' parameter instead.
sort_by	string	—	Sort order for results
sort_cursor	string	—	Cursor for pagination when using sort_by (use value from meta.sort_cursor of previous response)
tag	string	—	Filter by tag
vector_search_term	string	—	Semantic search query for retrieving bookmarks based on meaning and context, not just keywords. Use for natural language questions or topic-based searches.

No output schema declared.

No examples provided.

search_docs ~90

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.

Input Output Examples

Name	Type	Req	Description
query	string	—	What the user is asking about the product (pricing, a feature, how-to). Empty returns the list of help topics.

No output schema declared.

No examples provided.

send_list_digest ~55

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

Input Output Examples

Name	Type	Req	Description
connect_id	string	yes	The list connection id.
list_id	string	—	The X list id, if required.

No output schema declared.

No examples provided.

setup_vector_store ~56

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.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

tag_bookmarks_by_filter ~290

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.

Input Output Examples

Name	Type	Req	Description
author	string	—	Filter by author username. Use this parameter when the user wants to find tweets by a specific author (e.g., 'Show tweets by @user'). Do NOT use 'q' for author names.
bookmarked_from	string	—	Filter bookmarks added after this date (ISO 8601 string)
bookmarked_to	string	—	Filter bookmarks added before this date (ISO 8601 string)
hide_archived	boolean	—	Hide archived bookmarks
is_unread_only	boolean	—	Filter to only unread bookmarks
label_id	string	—	Existing label id (use label_id or label_name).
label_name	string	—	Label to create/apply (use label_id or label_name).
media_type	string	—	Filter by media type
posted_from	string	—	Filter tweets posted after this date (ISO 8601 string)
posted_to	string	—	Filter tweets posted before this date (ISO 8601 string)
q	string	—	Keyword search to scope which bookmarks get tagged.
tag	string	—	Filter by tag

No output schema declared.

No examples provided.

trigger_csv_export ~93

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

Input Output Examples

Name	Type	Req	Description
filter	string	—	—
search_query	string	—	—
tags	array	—	—
tweet_ids	array	—	Explicit ids to export. Omit to export everything matching the filter, or the whole library.
value	string	—	—

No output schema declared.

No examples provided.

trigger_json_export ~93

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

Input Output Examples

Name	Type	Req	Description
filter	string	—	—
search_query	string	—	—
tags	array	—	—
tweet_ids	array	—	Explicit ids to export. Omit to export everything matching the filter, or the whole library.
value	string	—	—

No output schema declared.

No examples provided.

trigger_pdf_export ~103

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.

Input Output Examples

Name	Type	Req	Description
filter	string	—	—
search_query	string	—	—
tags	array	—	—
tweet_ids	array	—	Explicit ids to export. Omit to export everything matching the filter, or the whole library.
value	string	—	—

No output schema declared.

No examples provided.

update_digest_preference ~92

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

Input Output Examples

Name	Type	Req	Description
id	string	yes	The digest preference id to update.
is_enabled	boolean	—	—
is_paused	boolean	—	—
schedule_time	string	—	—
send_frequency	string	—	e.g. DAILY, WEEKLY.
time_to_read	—	—	—
week_info	—	—	—

No output schema declared.

No examples provided.

update_smart_view ~77

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

Input Output Examples

Name	Type	Req	Description
base_query	string	—	—
default_sort	string	—	—
description	string	—	—
name	string	—	—
slug	string	yes	The smart view slug to update.
triage_buckets	—	—	—

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

26 Jul 3 Aug

Day	Score
26 Jul	63
27 Jul	63
28 Jul	64
29 Jul	65
30 Jul	65
31 Jul	67
1 Aug	68
2 Aug	68
3 Aug	69