Best for
- Developers
- Data analysts
- Marketers needing real-time Twitter account monitoring
- AI assistant users integrating Twitter data into workflows
O
OpenTwitter MCP Server
Community
Twitter/X Data · User Profiles · Tweet Search · Follower Events · KOL Tracking
- Category
- Other #158 of 230
- Stars
- ★ 1.4k Very popular
- Transport
- stdio (local process)
- Runtime
- Python
- Credentials
- API key / credential required
- License
- MIT
- Last commit
- Tools
- 15
49FMRS · D
The server is designed to connect exclusively to the ai.6551.io API. Code review indicates that tools only perform API queries, with no file writes, command execution, or other dangerous operations. Configuration only reads tokens from environment variables or config.json, with no hardcoded secrets. Dependencies are limited to mcp and httpx; no suspicious packages were found.
Strongest · Documentation 14/20 Weakest · Reliability 5/20
Why each score
- Reliability 5/20
- Only the README and repository metadata were supplied; no server.py, tools.py, api_client.py, CI workflows, or tests are available, so the MCP init handshake, tool list, and declared behavior cannot be verified against real code. The README's happy path (uv run twitter-mcp with a token) is plausible but depends on an uncontrolled third-party token service, making errors hard to diagnose. Worse, the 'Available Tools' table lists 15 tools while the 'Project Structure' section says tools.py contains only 8 tools — a visible internal contradiction. Deducted for missing execution evidence and the tool-count discrepancy.
- Security and permissions 7/20
- No red-line indicators in the supplied material: install examples use <your-token> placeholders rather than real secrets, and the described tools are mostly read-oriented queries; the remote watch-list add/delete is the tool's declared purpose and reversible. However, credential handling is weak: the WebSocket endpoint embeds the token in a query string (wss://ai.6551.io/open/twitter_wss?token=...), which can leak via access logs or proxies; the token page is linked over plain HTTP, not HTTPS; and config.json stores the token in plaintext. All Twitter data flows through the third-party ai.6551.io API, and the README's claim that the client 'only connects to ai.6551.io' is unverifiable without source code, with no data-retention or privacy disclosure. Deducted for visible credential-leak vectors, incomplete data-flow disclosure, and no confirmation/scoping around remote side effects.
- Maintenance 10/20
- The repository is not archived, has an MIT license, multi-language docs (Chinese/Japanese/Korean), and 4 open issues, indicating an owned, living project. However, the review material contains no commit history, releases, dependency-update records, issue-response times, or a security-response channel, so maintenance cadence and governance cannot be verified; stars are treated only as a discovery signal and earn no points. Deducted for missing release and governance evidence.
- Documentation 14/20
- The README is layered and strong: install snippets for Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Continue.dev, Cherry Studio, Zed, and generic stdio clients; env/config reference; a 15-tool capability table; user/tweet JSON structures; a complete WebSocket subscription protocol with per-event content schemas; and a development section. Deductions: the project structure comment says '8 tools' which contradicts the 15-tool table; no troubleshooting, error-code, rate-limit, cost, or data-retention disclosure; and the token page uses an HTTP link, which is also a documentation-level security gap.
- Setup experience 13/20
- Setup is a clear few-step flow: obtain a token, set OPENNEWS_TOKEN (or config.json), then launch with `uv --directory <path> run twitter-mcp`; ready-made JSON/YAML config examples are provided for 8 mainstream clients plus generic stdio, and a compatibility table marks each client's status. Deductions: the static calibration caps setup at 15 without verifiable CI and committed tests, and none were supplied; the token must be fetched from a third-party website over HTTP, adding external dependency; every example requires manual path substitution; and the OpenClaw path requires manually copying a skill directory. Overall 13.
Static review · not runListed 2026-08-07
Read the FMRS scoring method →Fit and risk
What it can accessUses the network
Not for
- Users who do not need Twitter data
- Users requiring data from X's official API rather than a third-party API
- Users concerned about sending data to a third-party service
Required permissions
- Network access to connect to api.6551.io and wss://ai.6551.io
- API token from environment variable or config.json
- No file system writes or other local system permissions
Risks and side effects
- Dependence on third-party API service for data
- Token leakage could lead to unauthorized usage
- API service may become unavailable or change
- Data may be incomplete or delayed as it is not from an official source
Setup
Before you start
Runtime：Python
OPENNEWS_TOKEN
Required 6551 API Bearer Token, get it from http://app.newsliquid.com/mcp
Other optional settings (2)
TWITTER_API_BASE
Optional override for the REST API base URL (default https://ai.6551.io)
TWITTER_MAX_ROWS
Optional max results per query (default: 100)
- Obtain an API token from http://app.newsliquid.com/mcp.
- Set the OPENNEWS_TOKEN environment variable.
- Use the uv command: uv --directory /path/to/twitter-mcp run twitter-mcp.
- For Claude Code: claude mcp add twitter -e OPENNEWS_TOKEN=<your-token> -- uv --directory /path/to/twitter-mcp run twitter-mcp.
- Alternatively, configure the server in your client's JSON configuration.
claude_desktop_config.json
{
"mcpServers": {
"twitter": {
"command": "uv",
"args": [
"--directory",
"/path/to/twitter-mcp",
"run",
"twitter-mcp"
],
"env": {
"OPENNEWS_TOKEN": "<your-token>"
}
}
}
}
Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.
.vscode/mcp.json
{
"servers": {
"twitter": {
"command": "uv",
"args": [
"--directory",
"/path/to/twitter-mcp",
"run",
"twitter-mcp"
],
"env": {
"OPENNEWS_TOKEN": "<your-token>"
}
}
}
}
Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).
Terminal
claude mcp add twitter -e 'OPENNEWS_TOKEN=<your-token>' -- uv --directory /path/to/twitter-mcp run twitter-mcp
Run it in a terminal; replace any <…> placeholders with your own values first.
Check that it works
After connecting, check that tools like get_twitter_user appear in the client's tool list, or ask "Show @elonmusk's Twitter profile" — a returned profile confirms the connection works.
Troubleshooting
- Ensure the OPENNEWS_TOKEN environment variable is set correctly
- Check network connectivity
- Verify that the API service is accessible
- Confirm the project path is correct
- Ensure uv is installed and available
Things to try
Once connected, you can ask your AI assistant things like:
- Show @elonmusk's Twitter profile
- Search Bitcoin related tweets
- Find popular tweets about ETH with 1000+ likes
- Add @elonmusk to my watch list with follower tracking
Tools 15
get_twitter_user read-only
Get user profile by username
get_twitter_user_by_id read-only
Get user profile by numeric ID
get_twitter_user_tweets read-only
Get recent tweets from a user
search_twitter read-only
Search tweets with basic filters
search_twitter_advanced read-only
Advanced search with multiple filters
get_twitter_follower_events read-only
Get follower/unfollower events
get_twitter_deleted_tweets read-only
Get deleted tweets from a user
get_twitter_kol_followers read-only
Get KOL (Key Opinion Leader) followers
Show 7 more tools
get_twitter_article_by_id read-only
Get Twitter article by ID
get_twitter_tweet_by_id read-only
Get tweet by ID with nested reply/quote tweets
get_twitter_quote_tweets_by_id read-only
Get tweets that quote a specific tweet
get_twitter_retweet_users_by_id read-only
Get users who retweeted a specific tweet
get_twitter_watch read-only
Get all Twitter monitoring users
add_twitter_watch writes
Add a Twitter user to monitoring list (with event type options)
delete_twitter_watch destructive
Delete a Twitter user from monitoring list
No matching tools
Use cases
Show @elonmusk's Twitter profile
Get recent tweets from @VitalikButerin
Search for Bitcoin-related tweets
Find tweets with #crypto hashtag
Get popular tweets about ETH with 1000+ likes
Monitor @elonmusk with follower tracking
Supported clients
Claude Desktop
Claude Code
Cursor
Windsurf
Cline
Continue
Cherry Studio
Zed
OpenClaw
Listed from the project's documentation, not tested by this site.
Overview
opentwitter-mcp is an MCP server that provides access to Twitter/X data via an API. It enables AI assistants to fetch user profiles, search tweets, monitor follower events, track KOL followers, and manage real-time watch lists. The server authenticates using an OPENNEWS_TOKEN via environment variables or config file, and supports real-time event subscriptions via WebSocket.
Similar servers
Hevy MCP
77 · B
Manage your Hevy workout data from AI assistants via MCP.
Firecrawl MCP Server
75 · B
Firecrawl's official MCP server for web search, scraping, and structured extraction for AI agents
BioMCP
75 · B
One binary. One grammar. Evidence from the biomedical sources you already trust.
Compartment
75 · B
Encrypted, fully offline long-term memory for AI agents
Source revision 8d69ca5e856f Data synced 2026-10-12 Read the FMRS scoring method