# Tweetsmash

Manage and organize your Twitter bookmarks efficiently through AI assistants. List, search, filter, and label bookmarks to enhance your Twitter experience. Integrate seamlessly with AI tools supporti…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add RamyaChinnadurai/tweetsmash

# Browse available tools
npx -y @smithery/cli@latest tool list RamyaChinnadurai/tweetsmash

# Get full schema for a tool
npx -y @smithery/cli@latest tool get RamyaChinnadurai/tweetsmash list_bookmarks

# Call a tool
npx -y @smithery/cli@latest tool call RamyaChinnadurai/tweetsmash list_bookmarks '{}'
```

## Direct MCP Connection

Endpoint: `https://tweetsmash.run.tools`

**Required config:**
- `TWEETSMASH_API_KEY` (header) — TWEETSMASH_API_KEY key generated from https://tweetsmash.com/integrations/api

## Tools (7)

- `list_bookmarks` — List user's Twitter bookmarks with optional filtering and pagination. Supports filtering by read status, media type, au…
- `search_bookmarks` — Search through a user's Twitter bookmarks using keyword search (q), semantic search (vector_search_term), or author fil…
- `get_bookmark_count` — Get the total count of user's bookmarks with optional filtering. Useful for understanding the size of bookmark collecti…
- `list_labels` — List all user's labels with their usage counts. Useful for discovering existing labels before adding new ones.
- `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 labe…
- `remove_labels_from_tweets` — Remove a label from a list of tweets using label_name.
- `setup_vector_store` — Initialize the vector store for semantic bookmark search. CRITICAL: When vector/semantic search fails with 'Vector Stor…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get RamyaChinnadurai/tweetsmash <tool-name>
```

---

Source: https://github.com/RamyaChinnadurai/tweetsmash/tree/main//packages/mcp-service