@practicaltools/twitter-mcp-server

𝕏 (Twitter) MCP Server

Powered by practicaltools/cheap-simple-twitter-api via Apify.

A Model Context Protocol (MCP) server that provides comprehensive access to Twitter (𝕏) data, including advanced search, user profiles, tweets, followers, followings, mentions, and more.

✨ Features

• Advanced Search: Powerful search with filters (from:NASA, min_faves:100, etc.)
• User Intelligence: Profiles, followers, following, and latest tweets.
• Engagement Insights: Mentions, retweeters, quotes, and replies.
• List Support: Fetch tweets from specific Twitter lists.
• Pagination Support: Seamlessly fetch large datasets using cursors.
• Cleaned Data: Optimized for LLM consumption with noise removal and truncation.

🛠️ Tools

The server provides 11 specialized tools:

• twitter_search: Advanced search with type: Latest | Top.
• twitter_user_info: Profile details for any handle.
• twitter_user_tweets: Latest tweets from a user.
• twitter_mentions: Recent mentions of a user.
• twitter_followers: User's follower list.
• twitter_followings: Accounts a user is following.
• twitter_tweet_replies: Threaded conversation replies.
• twitter_tweet_quotes: Quotes of a specific tweet.
• twitter_tweet_retweeters: List of users who retweeted.
• twitter_tweets_by_ids: Lookup specific tweets.
• twitter_list_tweets: Tweets from a Twitter list.

🚀 Quick Start

Prerequisites

• An Apify API Token (Required)

Configuration

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "twitter": {
      "command": "npx",
      "args": ["-y", "@practicaltools/twitter-mcp-server"],
      "env": {
        "APIFY_API_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

GitHub Copilot (via config.yaml)

mcpServers:
  twitter:
    command: npx
    args: ["-y", "@practicaltools/twitter-mcp-server"]
    env:
      APIFY_API_TOKEN: YOUR_APIFY_TOKEN

📖 Authentication

This server requires an Apify API token. The underlying actor used is highly cost-effective (~$0.10 per 1,000 results).

• Get your token from the Apify Console.
• Set it as the APIFY_API_TOKEN environment variable.

🤝 Contributing

Contributions are welcome! Please see our Contributing Guide.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.