Twitter Username Changes MCP

🚀 Twitter Username Changes MCP Server

A MCP server for tracking the historical changes of Twitter usernames. Frequent screen name changes in crypto projects can be a warning sign of potential fraud risks.

✨ Features

• Username Change History: Query a user's historical usernames by their current screen name (e.g., @OSINT_Ukraine or @Mormonger).
• Prompt Support: Includes a prompt template to help users formulate query questions.
• Lightweight Design: Implemented with minimal dependencies (mcp and requests) for quick deployment.

📦 Installation

Prerequisites

• Python version 3.10 or higher
• pip or uv for dependency management
• Claude Desktop (optional, for MCP integration)

Setup

1. Clone the repository:

   git clone https://github.com/kukapay/twitter-username-changes-mcp.git
   cd twitter-username-changes-mcp
   

2. Install dependencies:

   pip install mcp[cli] requests
   

💻 Usage Examples

Run the server

Start the server in development mode for local testing:

mcp dev main.py

This will start the MCP detector, and you can:

• List all available tools (query_username_changes).
• Test queries (e.g., screen_name: "OSINT_Ukraine").
• Debug the prompt content.

Integrate with Claude Desktop

1. Configure the MCP server: Edit the Claude Desktop configuration file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   Add the following content to the mcpServers section:

   {
     "mcpServers": {
       "twitter-username-changes": {
         "command": "python",
         "args": [
           "/absolute/path/to/twitter-username-changes-mcp/main.py"
         ]
       }
     }
   }
   

   Replace /absolute/path/to/ with the actual path to main.py.

2. Install the server:

   mcp install main.py --name "TwitterUsernameChanges"
   

3. Query in Claude Desktop:

   • Open Claude Desktop and find the hammer icon (indicating MCP tools).
   • Enter a query like:

     Show the username change history of Twitter user @OSINT_Ukraine
     

   • Expected output:

     The username change history is as follows:
     
     User ID 4725638310:
     - The_HelpfulHand (from 2016-01-09 to 2020-09-27)
     - nftpromo_s (from 2022-02-10 to 2022-02-23)
     - OSINT_Ukraine (from 2022-02-24 to 2022-02-25)
     

Example queries

1. Query @Mormonger:

   Tool input: screen_name: "Mormonger"

   Output:

   The username change history is as follows:
   
   User ID 1408886100:
   - colenoorda (2016-04-02)
   - Mormonger (from 2017-01-19 to 2025-02-25)
   

2. Query an invalid username:

   Tool input: screen_name: "invalid_username"

   Output:

   No user information found.
   

📄 License

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