twitter-username-changes-mcp
If you are the rightful owner of twitter-username-changes-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
An MCP server that tracks the historical changes of Twitter usernames, useful for identifying potential scam risks in crypto projects.
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_Ukraineor@Mormonger). - Prompt Support: Includes a prompt template to guide users in formulating queries.
- Lightweight Design: Built with minimal dependencies (
mcpandrequests) for easy setup.
Installation
Prerequisites
- Python 3.10+
piporuvfor dependency management- Claude Desktop (optional, for MCP integration)
Setup
-
Clone the Repository:
git clone https://github.com/kukapay/twitter-username-changes-mcp.git cd twitter-username-changes-mcp -
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
-
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 tomain.py. - macOS:
-
Install the Server:
mcp install main.py --name "TwitterUsernameChanges" -
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
-
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) -
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 for details.
