# com.tweetsmash/mcp (remote · mcp.tweetsmash.com)

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

- Trust score: 69/100 (medium)
- Change this week: +5
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-04

## Components

- remote · `mcp.tweetsmash.com`: 69/100 (this document), [markdown](https://verifymcp.io/servers/com-tweetsmash-mcp/api-mcp.md), [page](https://verifymcp.io/servers/com-tweetsmash-mcp/api-mcp)

## Channel facts

- Endpoint: `https://mcp.tweetsmash.com/api/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `2.0.0`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-04.

- **Endpoint Security**: 66/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - 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.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 70/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 3495 tokens (~89/item across 39 items; 39 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 30/100
  - Stability observed for 9 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 91/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 72% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

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

### Codex

```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
    }
  }
}
```

### OpenClaw

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

### Hermes

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

### Other

```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 recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 69, +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.

### 2026-08-01 (score 68, +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.

### 2026-07-31 (score 67, +2)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 65, +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.

### 2026-07-28 (score 64, +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.

### 2026-07-27 (score 63, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 63)

First indexed and scored.

## MCP tools (39)

### `list_bookmarks` (~304 tokens)

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 parameters:

- `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

### `search_bookmarks` (~383 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.

Input parameters:

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

### `get_bookmark_count` (~208 tokens)

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

Input parameters:

- `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

### `list_labels` (~27 tokens)

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

### `add_labels_to_tweets` (~105 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.

Input parameters:

- `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, required): Array of tweet IDs to add the label to

### `remove_labels_from_tweets` (~53 tokens)

Remove a label from a list of tweets using label_name.

Input parameters:

- `label_name` (string, required): Name of the label to remove
- `tweet_ids` (array, required): Array of tweet IDs to remove label from

### `setup_vector_store` (~56 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.

### `search_docs` (~90 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.

Input parameters:

- `query` (string): What the user is asking about the product (pricing, a feature, how-to). Empty returns the list of help topics.

### `get_bookmark` (~133 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 specific saved tweet/thread/article in depth.

Input parameters:

- `id` (string, required): The tweet/bookmark id to fetch.
- `include` (string): Comma list of extra content to include: article,thread,notes,replies. Defaults to article,thread,notes.

### `tag_bookmarks_by_filter` (~290 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.

Input parameters:

- `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

### `archive_bookmarks` (~86 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.

Input parameters:

- `action` (string, required): The action to apply.
- `tweet_ids` (array, required): Bookmark ids to act on (max 500).

### `archive_bookmarks_by_filter` (~88 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.

Input parameters:

- `action` (string, required): The action to apply to every match.
- `filter` (string)
- `search_query` (string)
- `tags` (array)
- `value` (string)

### `list_smart_views` (~33 tokens)

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

### `get_smart_view` (~39 tokens)

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

Input parameters:

- `slug` (string, required): The smart view slug.

### `get_smart_view_bookmarks` (~102 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.

Input parameters:

- `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, required): The smart view slug.

### `create_smart_view` (~86 tokens)

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

Input parameters:

- `base_query` (string): The filter query that defines the view.
- `default_sort` (string)
- `description` (string)
- `name` (string, required): View name.
- `triage_buckets`: Optional tab/bucket definitions.

### `update_smart_view` (~77 tokens)

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

Input parameters:

- `base_query` (string)
- `default_sort` (string)
- `description` (string)
- `name` (string)
- `slug` (string, required): The smart view slug to update.
- `triage_buckets`

### `delete_smart_view` (~28 tokens)

Delete a Smart View by slug.

Input parameters:

- `slug` (string, required): The smart view slug.

### `create_share_link` (~105 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.

Input parameters:

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

### `revoke_share_link` (~33 tokens)

Revoke a previously created share link by its token.

Input parameters:

- `token` (string, required): The share link token to revoke.

### `trigger_pdf_export` (~103 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.

Input parameters:

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

### `trigger_csv_export` (~93 tokens)

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

Input parameters:

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

### `trigger_json_export` (~93 tokens)

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

Input parameters:

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

### `list_digest_preferences` (~32 tokens)

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

### `update_digest_preference` (~92 tokens)

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

Input parameters:

- `id` (string, required): 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`

### `delete_digest_preference` (~28 tokens)

Remove a digest schedule by id.

Input parameters:

- `id` (string, required): The digest preference id.

### `list_past_digests` (~25 tokens)

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

### `get_sync_status` (~41 tokens)

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

### `get_bookmark_sync_status` (~44 tokens)

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

Input parameters:

- `connect_id` (string, required): The integration connection id.
- `tweet_id` (string, required)

### `list_twitter_lists` (~37 tokens)

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

### `get_list_tweets` (~111 tokens)

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 parameters:

- `connect_id` (string, required): The list connection id.
- `hours` (number): Look-back window in hours (default 24).
- `limit` (number)
- `sort` (string): LATEST or POPULARITY (trending/top).

### `get_list_digests` (~22 tokens)

List past Twitter-list email digests for the user.

### `send_list_digest` (~55 tokens)

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

Input parameters:

- `connect_id` (string, required): The list connection id.
- `list_id` (string): The X list id, if required.

### `get_me` (~48 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_connection_status` (~83 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 extension is browser-only and can't be driven by an agent.

### `fetch_recent_bookmarks` (~111 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 get_list_tweets instead.

Input parameters:

- `force` (boolean): Force the pull even if a recent sync exists.
- `max` (number): How many recent bookmarks to pull (max 800).

### `remember` (~80 tokens)

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 parameters:

- `key` (string, required): A short stable key for this memory.
- `kind` (string, required): The kind of memory.
- `mode` (string)
- `value` (string, required): The memory content.

### `recall` (~34 tokens)

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

Input parameters:

- `query` (string): Optional substring to filter recalled memories.

### `forget` (~37 tokens)

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

Input parameters:

- `key` (string): The memory key to forget.
- `kind` (string)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/com-tweetsmash-mcp/api-mcp#diagnostics

## Score history

- 2026-08-04: 69
- 2026-08-03: 69
- 2026-08-02: 68
- 2026-08-01: 68
- 2026-07-31: 67
- 2026-07-30: 65
- 2026-07-29: 65
- 2026-07-28: 64
- 2026-07-27: 63
- 2026-07-26: 63

## Links

- Remote endpoint: https://mcp.tweetsmash.com/api/mcp
- Repository: https://github.com/RamyaChinnadurai/tweetsmash-mcp
- Changelog RSS feed: https://verifymcp.io/servers/com-tweetsmash-mcp/api-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-tweetsmash-mcp/api-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/com-tweetsmash-mcp/api-mcp