Skip to content
Back to search

opentwitter-mcp

Twitter/X Data · User Profiles · Tweet Search · Follower Events · KOL Tracking

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/6551Team/opentwitter-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/6551Team/opentwitter-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/6551team--opentwitter-mcp/badge.svg)](/listings/6551team--opentwitter-mcp)

HTML

<a href="/listings/6551team--opentwitter-mcp"><img src="/api/listings/6551team--opentwitter-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

> **First, go to [http://app.newsliquid.com/mcp](http://app.newsliquid.com/mcp) to get your API Token.**

Claude Code

claude mcp add twitter \
  -e OPENNEWS_TOKEN=<your-token> \
  -- uv --directory /path/to/twitter-mcp run twitter-mcp

> Replace `/path/to/twitter-mcp` with your local project path, and `<your-token>` with your Token.

OpenClaw

export OPENNEWS_TOKEN="<your-token>"
cp -r openclaw-skill/opentwitter ~/.openclaw/skills/

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 521 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <b>Twitter MCP Server</b><br>
  3. Twitter/X Data · User Profiles · Tweet Search · Follower Events · KOL Tracking
  4. </p>
  5. <p align="center">
  6. <a href="./docs/README_ZH.md">中文</a> | <a href="./docs/README_JA.md">日本語</a> | <a href="./docs/README_KO.md">한국어</a>
  7. </p>
  8. ---
  9. ## Quick Install
  10. > **First, go to [http://app.newsliquid.com/mcp](http://app.newsliquid.com/mcp) to get your API Token.**
  11. ### Claude Code
  12. ```bash
  13. claude mcp add twitter \
  14. -e OPENNEWS_TOKEN=<your-token> \
  15. -- uv --directory /path/to/twitter-mcp run twitter-mcp
  16. ```
  17. > Replace `/path/to/twitter-mcp` with your local project path, and `<your-token>` with your Token.
  18. ### OpenClaw
  19. ```bash
  20. export OPENNEWS_TOKEN="<your-token>"
  21. cp -r openclaw-skill/opentwitter ~/.openclaw/skills/
  22. ```
  23. ---
  24. ## Let AI Review & Install For You
  25. Not sure if this MCP is safe? Paste the prompt below to your AI assistant — it will review the source code first, then install if safe:
  26. > **Copy this prompt and send it to your AI assistant (replace `<project-path>` and `<your-token>` with actual values):**
  27. ```text
  28. Please review and install the twitter-mcp MCP server for me. The project is at <project-path>.
  29. Steps:
  30. 1. Review these files for security:
  31. - src/twitter_mcp/api_client.py — Confirm it only connects to ai.6551.io, no data sent elsewhere
  32. - src/twitter_mcp/config.py — Confirm token is only read from local config.json or env vars, no hardcoded secrets or leaks
  33. - src/twitter_mcp/tools.py — Confirm all tools only perform API queries, no file writes, command execution, or dangerous operations
  34. - pyproject.toml — Confirm dependencies are only mcp, httpx, no suspicious packages
  35. 2. Tell me your conclusion: safe / risky / problematic, with specific reasons
  36. 3. If safe, run the install (get Token from http://app.newsliquid.com/mcp):
  37. claude mcp add twitter -e OPENNEWS_TOKEN=<your-token> -- uv --directory <project-path> run twitter-mcp
  38. ```
  39. ---
  40. ## What Can It Do?
  41. Once connected, just ask your AI assistant:
  42. | You say | It does |
  43. |---------|---------|
  44. | "Show @elonmusk's Twitter profile" | Get user profile info |
  45. | "What did @VitalikButerin tweet recently" | Get user's recent tweets |
  46. | "Search Bitcoin related tweets" | Keyword search |
  47. | "Find tweets with #crypto hashtag" | Hashtag search |
  48. | "Popular tweets about ETH with 1000+ likes" | Search with engagement filters |
  49. | "Monitor @elonmusk with follower tracking and a custom note" | Add user to watch list with options |
  50. | "Who quoted this tweet" | Get quote tweets for a tweet |
  51. | "Who retweeted this tweet" | Get users who retweeted a tweet |
  52. | "Who followed @elonmusk recently" | Get new follower events |
  53. | "Who unfollowed @elonmusk" | Get unfollower events |
  54. | "What tweets did @elonmusk delete" | Get deleted tweets |
  55. | "Which KOLs follow @elonmusk" | Get KOL followers |
  56. | "Show the thesis and callout evidence for this meme token" | Get token evidence from fomo/pump feeds |
  57. | "Show the later statements and buys/sells for this token" | Get meme activity and trade evidence |
  58. ---
  59. ## Available Tools
  60. | Tool | Description |
  61. |------|-------------|
  62. | `get_twitter_user` | Get user profile by username |
  63. | `get_twitter_user_by_id` | Get user profile by numeric ID |
  64. | `get_twitter_user_tweets` | Get recent tweets from a user |
  65. | `search_twitter` | Search tweets with `query` and basic filters |
  66. | `search_twitter_advanced` | Advanced search with multiple filters |
  67. | `get_twitter_follower_events` | Get follower/unfollower events |
  68. | `get_twitter_deleted_tweets` | Get deleted tweets from a user |
  69. | `get_twitter_kol_followers` | Get KOL (Key Opinion Leader) followers |
  70. | `get_meme_token_evidence` | Get thesis and callout evidence for a meme token |
  71. | `get_meme_activity` | Get meme token statements and buy/sell evidence |
  72. | `get_twitter_article_by_id` | Get Twitter article by ID |
  73. | `get_twitter_tweet_by_id` | Get tweet by ID with nested reply/quote tweets |
  74. | `get_twitter_quote_tweets_by_id` | Get tweets that quote a specific tweet |
  75. | `get_twitter_retweet_users_by_id` | Get users who retweeted a specific tweet |
  76. | `get_twitter_watch` | Get all Twitter monitoring users |
  77. | `add_twitter_watch` | Add a Twitter user to monitoring list (with event type options, `remark`, and optional `group_name`) |
  78. | `delete_twitter_watch` | Delete a Twitter user from monitoring list |
  79. ---
  80. ## Configuration
  81. ### Get API Token
  82. Go to [http://app.newsliquid.com/mcp](http://app.newsliquid.com/mcp) to get your API Token.
  83. Set the environment variable:
  84. ```bash
  85. # macOS / Linux
  86. export OPENNEWS_TOKEN="<your-token>"
  87. # Windows PowerShell
  88. $env:OPENNEWS_TOKEN = "<your-token>"
  89. ```
  90. | Variable | Required | Description |
  91. |----------|----------|-------------|
  92. | `OPENNEWS_TOKEN` | **Yes** | 6551 API Bearer Token (get from http://app.newsliquid.com/mcp) |
  93. | `TWITTER_API_BASE` | No | Override REST API URL |
  94. | `TWITTER_MAX_ROWS` | No | Max results per query (default: 100) |
  95. Also supports `config.json` in the project root (env vars take precedence):
  96. ```json
  97. {
  98. "api_base_url": "https://ai.6551.io",
  99. "api_token": "<your-token>",
  100. "max_rows": 100
  101. }
  102. ```
  103. ---
  104. ## WebSocket Real-time Subscriptions
  105. **Endpoint**: `wss://ai.6551.io/open/twitter_wss?token=YOUR_TOKEN`
  106. **US endpoint (lower latency for servers in the US)**: `wss://open-api.us.newsliquid.com/open/twitter_wss?token=YOUR_TOKEN`
  107. If your client runs in the US (for example AWS us-east-1), connect to the US endpoint instead. It uses the same token, protocol and message format as `wss://ai.6551.io`, so only the URL changes. Measured from us-east-1, most tweets arrive about **250 ms earlier** (median: about 200 ms after posting, versus about 450 ms on the default endpoint); for the remaining accounts latency is about the same as on the default endpoint. Clients outside the US should keep using the default endpoint.
  108. Subscribe to real-time events from your monitored Twitter accounts.
  109. ### Heartbeat
  110. To keep the connection alive, the client can send `ping`, and the server responds with `pong`.
  111. ### Subscribe to Twitter Events
  112. ```json
  113. {
  114. "jsonrpc": "2.0",
  115. "id": 1,
  116. "method": "twitter.subscribe"
  117. }
  118. ```
  119. **Response**:
  120. ```json
  121. {
  122. "jsonrpc": "2.0",
  123. "id": 1,
  124. "result": {
  125. "success": true
  126. }
  127. }
  128. ```
  129. ### Unsubscribe
  130. ```json
  131. {
  132. "jsonrpc": "2.0",
  133. "id": 2,
  134. "method": "twitter.unsubscribe"
  135. }
  136. ```
  137. ### Server Push - Twitter Event
  138. When a monitored account has activity, the server pushes:
  139. ```json
  140. {
  141. "jsonrpc": "2.0",
  142. "method": "twitter.event",
  143. "params": {
  144. "id": 123456,
  145. "twAccount": "elonmusk",
  146. "twUserName": "Elon Musk",
  147. "profileUrl": "https://twitter.com/elonmusk",
  148. "eventType": "NEW_TWEET",
  149. "content": "...",
  150. "ca": "0x1234...",
  151. "remark": "Custom note",
  152. "createdAt": "2026-03-06T10:00:00Z"
  153. }
  154. }
  155. ```
  156. **Note**: The `content` field structure varies by event type (see below).
  157. ```
  158. **Event Types and Content Structure**:
  159. #### Tweet Events
  160. - `NEW_TWEET` - New tweet posted
  161. - `NEW_TWEET_REPLY` - New reply tweet
  162. - `NEW_TWEET_QUOTE` - New quote tweet
  163. - `NEW_RETWEET` - Retweeted
  164. - `CA` - Tweet with CA address
  165. Content structure for tweet events:
  166. ```json
  167. {
  168. "id": "1234567890",
  169. "text": "Tweet content...",
  170. "createdAt": "2026-03-06T10:00:00Z",
  171. "language": "en",
  172. "retweetCount": 100,
  173. "favoriteCount": 500,
  174. "replyCount": 20,
  175. "quoteCount": 10,
  176. "viewCount": 10000,
  177. "userScreenName": "elonmusk",
  178. "userName": "Elon Musk",
  179. "userIdStr": "44196397",
  180. "userFollowers": 170000000,
  181. "userVerified": true,
  182. "conversationId": "1234567890",
  183. "isReply": false,
  184. "isQuote": false,
  185. "hashtags": ["crypto", "bitcoin"],
  186. "media": [
  187. {
  188. "type": "photo",
  189. "url": "https://...",
  190. "thumbUrl": "https://..."
  191. }
  192. ],
  193. "urls": [
  194. {
  195. "url": "https://...",
  196. "expandedUrl": "https://...",
  197. "displayUrl": "example.com"
  198. }
  199. ],
  200. "mentions": [
  201. {
  202. "username": "VitalikButerin",
  203. "name": "Vitalik Buterin"
  204. }
  205. ]
  206. }
  207. ```
  208. #### Follower Events
  209. - `NEW_FOLLOWER` - This account followed a user
  210. - `NEW_UNFOLLOWER` - This account unfollowed a user
  211. Content structure for follower events (array):
  212. ```json
  213. [
  214. {
  215. "id": 123,
  216. "twId": 44196397,
  217. "twAccount": "elonmusk",
  218. "twUserName": "Elon Musk",
  219. "twUserLabel": "Verified",
  220. "description": "User bio...",
  221. "profileUrl": "https://...",
  222. "bannerUrl": "https://...",
  223. "followerCount": 170000000,
  224. "friendCount": 500,
  225. "createdAt": "2026-03-06T10:00:00Z"
  226. }
  227. ]
  228. ```
  229. #### Profile Update Events
  230. - `UPDATE_NAME` - Username changed (content: new name string)
  231. - `UPDATE_DESCRIPTION` - Bio updated (content: new description string)
  232. - `UPDATE_AVATAR` - Profile picture changed (content: new avatar URL string)
  233. - `UPDATE_BANNER` - Banner image changed (content: new banner URL string)
  234. #### Other Events
  235. - `TWEET_TOPPING` - Tweet pinned
  236. - `DELETE` - Tweet deleted
  237. - `SYSTEM` - System event
  238. - `TRANSLATE` - Tweet translation
  239. - `CA_CREATE` - CA token created
  240. ---
  241. ## Data Structures
  242. ### Twitter User
  243. ```json
  244. {
  245. "userId": "44196397",
  246. "screenName": "elonmusk",
  247. "name": "Elon Musk",
  248. "description": "...",
  249. "followersCount": 170000000,
  250. "friendsCount": 500,
  251. "statusesCount": 30000,
  252. "verified": true
  253. }
  254. ```
  255. ### Tweet
  256. ```json
  257. {
  258. "id": "1234567890",
  259. "text": "Tweet content...",
  260. "createdAt": "2024-02-20T12:00:00Z",
  261. "retweetCount": 1000,
  262. "favoriteCount": 5000,
  263. "replyCount": 200,
  264. "userScreenName": "elonmusk",
  265. "hashtags": ["crypto", "bitcoin"],
  266. "urls": [{"url": "https://..."}]
  267. }
  268. ```
  269. ### Meme Feed Item
  270. Meme evidence tools return fomo/pump feed data, including `platform`, `kind`,
  271. `author`, `text`, `createdAt`, and (for trades) a `trade` object. Use
  272. `get_meme_token_evidence` for the initial `thesis`/`callout` view and
  273. `get_meme_activity` for later statements and `buy`/`sell` evidence.
  274. ---
  275. <details>
  276. <summary><b>Other Clients — Manual Install</b> (click to expand)</summary>
  277. > In all configs below, replace `/path/to/twitter-mcp` with your actual local project path, and `<your-token>` with your Token from [http://app.newsliquid.com/mcp](http://app.newsliquid.com/mcp).
  278. ### Claude Desktop
  279. Edit config (macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`, Windows: `%APPDATA%\Claude\claude_desktop_config.json`):
  280. ```json
  281. {
  282. "mcpServers": {
  283. "twitter": {
  284. "command": "uv",
  285. "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
  286. "env": {
  287. "OPENNEWS_TOKEN": "<your-token>"
  288. }
  289. }
  290. }
  291. }
  292. ```
  293. ### Cursor
  294. `~/.cursor/mcp.json` or Settings > MCP Servers:
  295. ```json
  296. {
  297. "mcpServers": {
  298. "twitter": {
  299. "command": "uv",
  300. "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
  301. "env": {
  302. "OPENNEWS_TOKEN": "<your-token>"
  303. }
  304. }
  305. }
  306. }
  307. ```
  308. ### Windsurf
  309. `~/.codeium/windsurf/mcp_config.json`:
  310. ```json
  311. {
  312. "mcpServers": {
  313. "twitter": {
  314. "command": "uv",
  315. "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
  316. "env": {
  317. "OPENNEWS_TOKEN": "<your-token>"
  318. }
  319. }
  320. }
  321. }
  322. ```
  323. ### Cline
  324. VS Code sidebar > Cline > MCP Servers > Configure, edit `cline_mcp_settings.json`:
  325. ```json
  326. {
  327. "mcpServers": {
  328. "twitter": {
  329. "command": "uv",
  330. "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
  331. "env": {
  332. "OPENNEWS_TOKEN": "<your-token>"
  333. },
  334. "disabled": false,
  335. "autoApprove": []
  336. }
  337. }
  338. }
  339. ```
  340. ### Continue.dev
  341. `~/.continue/config.yaml`:
  342. ```yaml
  343. mcpServers:
  344. - name: twitter
  345. command: uv
  346. args:
  347. - --directory
  348. - /path/to/twitter-mcp
  349. - run
  350. - twitter-mcp
  351. env:
  352. OPENNEWS_TOKEN: <your-token>
  353. ```
  354. ### Cherry Studio
  355. Settings > MCP Servers > Add > Type stdio: Command `uv`, Args `--directory /path/to/twitter-mcp run twitter-mcp`, Env `OPENNEWS_TOKEN`.
  356. ### Zed Editor
  357. `~/.config/zed/settings.json`:
  358. ```json
  359. {
  360. "context_servers": {
  361. "twitter": {
  362. "command": {
  363. "path": "uv",
  364. "args": ["--directory", "/path/to/twitter-mcp", "run", "twitter-mcp"],
  365. "env": {
  366. "OPENNEWS_TOKEN": "<your-token>"
  367. }
  368. }
  369. }
  370. }
  371. }
  372. ```
  373. ### Any stdio MCP client
  374. ```bash
  375. OPENNEWS_TOKEN=<your-token> \
  376. uv --directory /path/to/twitter-mcp run twitter-mcp
  377. ```
  378. </details>
  379. ---
  380. ## Compatibility
  381. | Client | Install Method | Status |
  382. |--------|---------------|--------|
  383. | **Claude Code** | `claude mcp add` | One-liner |
  384. | **OpenClaw** | Copy skill directory | One-liner |
  385. | Claude Desktop | JSON config | Supported |
  386. | Cursor | JSON config | Supported |
  387. | Windsurf | JSON config | Supported |
  388. | Cline | JSON config | Supported |
  389. | Continue.dev | YAML / JSON | Supported |
  390. | Cherry Studio | GUI | Supported |
  391. | Zed | JSON config | Supported |
  392. ---
  393. ## Development
  394. ```bash
  395. cd /path/to/twitter-mcp
  396. uv sync
  397. uv run twitter-mcp
  398. ```
  399. ```bash
  400. # MCP Inspector
  401. npx @modelcontextprotocol/inspector uv --directory /path/to/twitter-mcp run twitter-mcp
  402. ```
  403. ### Project Structure
  404. ```
  405. ├── README.md
  406. ├── docs/
  407. │ ├── README_JA.md # 日本語
  408. │ └── README_KO.md # 한국어
  409. ├── openclaw-skill/opentwitter/ # OpenClaw Skill
  410. ├── pyproject.toml
  411. ├── config.json
  412. └── src/twitter_mcp/
  413. ├── server.py # Entry point
  414. ├── app.py # FastMCP instance
  415. ├── config.py # Config loader
  416. ├── api_client.py # HTTP client
  417. └── tools.py # 8 tools
  418. ```
  419. ## License
  420. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.