What is Twitter Username Changes Mcp

twitter-username-changes-mcp is an MCP server designed to track the historical changes of Twitter usernames, particularly useful for identifying potential scam risks associated with frequent username changes in crypto projects.

Use cases

Use cases include tracking username changes for specific Twitter accounts, analyzing patterns of username changes in crypto projects, and identifying potential scams based on frequent username alterations.

How to use

To use twitter-username-changes-mcp, clone the repository, install the necessary dependencies, and run the server in development mode. You can then query historical usernames using the MCP Inspector.

Key features

Key features include the ability to query historical usernames by current screen name, prompt support for formulating queries, and a lightweight design with minimal dependencies.

Where to use

twitter-username-changes-mcp can be used in fields such as cybersecurity, social media analysis, and cryptocurrency projects to monitor username changes and assess potential risks.

Twitter Username Changes MCP Server

An MCP server that tracks the historical changes of Twitter usernames—frequent screen name changes in crypto projects can be a red flag for potential scam risks.

Features

• Username Change History: Query the historical usernames of a Twitter user by their current screen name (e.g., @OSINT_Ukraine or @Mormonger).
• Prompt Support: Includes a prompt template to guide users in formulating queries.
• Lightweight Design: Built with minimal dependencies (mcp and requests) for easy setup.

Installation

Prerequisites

• Python 3.10+
• 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

Running the Server

Start the server in development mode to test locally:

mcp dev main.py

This launches the MCP Inspector, where you can:

• List available tools (query_username_changes).
• Test queries (e.g., screen_name: "OSINT_Ukraine").
• Debug prompts.

Integrating with Claude Desktop

1. Configure 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 server:

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

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

2. Install the Server:

   mcp install main.py --name "TwitterUsernameChanges"
   

3. Query in Claude Desktop:

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

     Show the username change history for Twitter user @OSINT_Ukraine
     

   • Expected output:

     Username change history for OSINT_Ukraine:
     
     User ID 4725638310:
     - The_HelpfulHand (2016-01-09 to 2020-09-27)
     - nftpromo_s (2022-02-10 to 2022-02-23)
     - OSINT_Ukraine (2022-02-24 to 2022-02-25)
     

Example Queries

1. Query @Mormonger:

   Tool input: screen_name: "Mormonger"

   Output:

   Username change history for Mormonger:
   
   User ID 1408886100:
   - colenoorda (2016-04-02)
   - Mormonger (2017-01-19 to 2025-02-25)
   

2. Query Invalid Handle:

   Tool input: screen_name: "InvalidUser123"

   Output:

   No username change history found for InvalidUser123
   

License

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