mcp-twikit

MCP.Pizza Chef: adhikasp

MCP-Twikit is a specialized Model Context Protocol (MCP) server designed to facilitate real-time interaction with Twitter. It enables AI models to access, search, and retrieve Twitter data securely and efficiently within the MCP ecosystem. MCP-Twikit supports integration with various MCP clients, allowing models to leverage Twitter content for enhanced context, analysis, and automation. Installation is straightforward via Smithery or manual setup, with environment variables for Twitter credentials. This server is ideal for developers building AI agents that require live social media insights, trend monitoring, or user engagement analysis through Twitter.

Use This MCP server To

Retrieve real-time tweets for sentiment analysis Search Twitter for trending topics and hashtags Monitor specific Twitter accounts for updates Integrate Twitter data into AI-driven chatbots Automate Twitter content summarization Enable social media monitoring within AI workflows

README

MCP-Twikit

smithery badge A Model Context Protocol (MCP) server for interacting with Twitter.

mcp-twikit MCP server

Installation

Installing via Smithery

To install Twikit Twitter Search for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install mcp-twikit --client claude

Manual Installation

{
    "mcpServer": {
        "command": "uvx",
        "args": ["--from", "git+https://github.com/adhikasp/mcp-twikit", "mcp-twikit"],
        "env": {
            "TWITTER_USERNAME": "@example",
            "TWITTER_EMAIL": "me@example.com",
            "TWITTER_PASSWORD": "secret",
        }
    }
}

Example usage

Using mcp-client-cli

Comparing sentiments across different twitter accounts

$ llm compare 20 latest tweet directed @IndiHomeCare, @di_cbn, @BiznetHome, @ID_MyRepublic. What are people sentiment to the product? Do 1 search for each account

I'll help you analyze the latest tweets for these internet service providers in Indonesia to understand the public sentiment. I'll use the search_twitter function for each account.

Tool Calls:
  search_twitter
  Args:
    query: to:IndiHomeCare
    count: 20
    sort_by: Latest

Tool Calls:
  search_twitter
  Args:
    query: to:di_cbn
    count: 20
    sort_by: Latest

Tool Calls:
  search_twitter
  Args:
    query: to:BiznetHome
    count: 20
    sort_by: Latest

Tool Calls:
  search_twitter
  Args:
    query: to:ID_MyRepublic
    count: 20
    sort_by: Latest

Sentiment Analysis Summary:

1. IndiHomeCare:
- Predominantly Negative Sentiment
- Key Issues:
  - Unstable internet connection
  - Slow response times
  - Intermittent service disruptions
  - Long waiting times for customer support
- Specific Complaints:
  - Network instability
  - Lagging internet
  - Unresolved technical issues
  - Lack of timely communication

2. CBN (di_cbn):
- Mostly Negative Sentiment
- Key Issues:
  - Prolonged internet outages (some reporting 1-2 days of no service)
  - Slow customer support response
  - Lack of clear communication about service disruptions
- Specific Complaints:
  - LOS (Line of Sight) issues
  - No timely resolution of technical problems
  - Delayed email and support responses

3. BiznetHome:
- Strongly Negative Sentiment
- Key Issues:
  - Frequent network interruptions
  - Slow internet speeds
  - Poor customer support responsiveness
- Specific Complaints:
  - Packet loss
  - Inconsistent connection
  - Long download times
  - Unresolved technical issues

4. MyRepublic (ID_MyRepublic):
- Extremely Negative Sentiment
- Key Issues:
  - Severe and prolonged service disruptions
  - Complete internet outages
  - Inability to access online services and games
  - Extremely poor customer support
- Specific Complaints:
  - Multi-day service interruptions
  - Inability to access websites and online games
  - Missed technician appointments
  - Lack of compensation or clear communication

Overall Sentiment Ranking (from Bad to Worst):
1. IndiHomeCare (Bad)
2. CBN (Worse)
3. BiznetHome (Very Bad)
4. MyRepublic (Extremely Bad)

Common Themes Across Providers:
- Poor network stability
- Slow customer support response
- Lack of transparent communication
- Prolonged service interruptions
- Unresolved technical issues

Recommendation: These Indonesian internet service providers are experiencing significant customer satisfaction issues. Customers are frustrated with unreliable services, poor technical support, and lack of timely problem resolution.

Getting tweets from your home timeline

$ llm what is happening on my twitter timeline?

I'll help you check your Twitter timeline. I'll retrieve the latest tweets from your timeline:

Tool Calls:
  get_timeline
  Args:

I'll summarize the key highlights from your Twitter timeline:

1. Professional/Tech Highlights:
- @ibamarief is preparing to onboard their first intern, noting it's a significant responsibility
- @papanberjalan shared a critique about web developers not understanding computer performance
- @pathofexile is running a Twitch Drops promotion for their game

2. Notable Tweets:
- @elonmusk posted a cryptic "Hmm"
- @realDonaldTrump discussed eliminating Daylight Saving Time
- @blinkist shared an article about billionaires reading up to 50 books per year

3. Miscellaneous Interesting Tweets:
- @nealtaparia shared a thread about 11 companies built around a single product
- @Rixhabh__ posted about creative and iconic ads
- Several tweets in Indonesian covering various topics from personal stories to social issues

Would you like me to elaborate on any of these tweets or provide more context about any specific post?

mcp-twikit FAQ

How do I install MCP-Twikit?
You can install MCP-Twikit automatically via Smithery using 'npx -y @smithery/cli install mcp-twikit --client claude' or manually by configuring the server command with your Twitter credentials.
What environment variables are required for MCP-Twikit?
MCP-Twikit requires TWITTER_USERNAME, TWITTER_EMAIL, and TWITTER_PASSWORD to authenticate and interact with Twitter.
Can MCP-Twikit be used with different MCP clients?
Yes, MCP-Twikit is compatible with various MCP clients, enabling integration with multiple AI models and platforms.
Is MCP-Twikit secure for handling Twitter credentials?
Yes, MCP-Twikit follows secure practices for environment variable management and scoped access within the MCP framework.
Does MCP-Twikit support real-time Twitter data streaming?
MCP-Twikit primarily supports Twitter search and retrieval; real-time streaming depends on client implementation and Twitter API capabilities.
Can MCP-Twikit be used for automated social media monitoring?
Yes, it enables AI models to monitor Twitter accounts, hashtags, and trends automatically within MCP workflows.
What are the prerequisites for running MCP-Twikit?
You need a valid Twitter account and appropriate credentials set as environment variables; also, ensure your MCP client supports server integration.
How does MCP-Twikit handle Twitter API rate limits?
MCP-Twikit relies on Twitter API usage policies; clients should implement rate limiting and error handling accordingly.