{
  "markdown": "# Tweetsmash MCP Server: X (Twitter) Bookmarks for AI Agents\n\nThe Tweetsmash MCP server connects Claude, ChatGPT, Cursor, Raycast, and any\nModel Context Protocol client to your X (Twitter) bookmarks. Search them\nsemantically, count them, and manage labels through natural language.\n\n[Tweetsmash](https://www.tweetsmash.com) is a bookmark manager for X (Twitter):\nit imports the posts you bookmark on X into a searchable library, syncs them to\nNotion, Google Sheets, and Zotero, and exposes them to AI agents through this\nMCP server and an [X bookmarks API](https://www.tweetsmash.com/x-bookmarks-api).\n\n## Quick start\n\n1. Create a Tweetsmash account at [tweetsmash.com](https://www.tweetsmash.com) and\n   import your X bookmarks (one click).\n2. Generate an API token: Settings > Integrations > API.\n3. Add the server to your MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"tweetsmash\": {\n      \"command\": \"npx\",\n      \"args\": [\"@tweetsmash/mcp\"],\n      \"env\": { \"TWEETSMASH_TOKEN\": \"your-token-here\" }\n    }\n  }\n}\n```\n\n### Hosted endpoint (no local install)\n\nPoint any remote MCP client at:\n\n```\nhttps://mcp.tweetsmash.com/api/mcp\n```\n\nwith your Tweetsmash API token as a Bearer header.\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `list_bookmarks` | Page through saved posts with filters |\n| `search_bookmarks` | Keyword and semantic search across every bookmark |\n| `get_bookmark_count` | Count bookmarks, optionally by label |\n| `list_labels` | List every label in your library |\n| `add_labels_to_tweets` | Label bookmarks from your agent |\n| `remove_labels_from_tweets` | Remove labels |\n| `setup_vector_store` | Build the semantic search index |\n\n## Example prompts\n\n- \"Find my bookmarks about prompt engineering\"\n- \"How many bookmarks mention MCP?\"\n- \"Label everything I saved last week as AI\"\n\n## Links\n\n- [X Bookmarks MCP](https://www.tweetsmash.com/x-bookmarks-mcp)\n- [Setup guide: Claude Desktop, Raycast, Smithery](https://www.tweetsmash.com/api-docs/mcp-integration)\n- [X Bookmarks API](https://www.tweetsmash.com/x-bookmarks-api)\n- [npm: @tweetsmash/mcp](https://www.npmjs.com/package/@tweetsmash/mcp)\n- [Smithery listing](https://smithery.ai/server/@RamyaChinnadurai/tweetsmash)\n\n## License\n\nMIT\n",
  "bytes": 2210,
  "sha": "5d7cf4c0341d41d6cd94b20d40ad2d55e31793a3cbfa7a837c54d538ad1ce0ee",
  "repo_slug": "ramyachinnadurai/tweetsmash-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_tweetsmash_mcp_4ec43222/readme"
}