Twitter Username Changes

An MCP server that tracks the historical changes of Twitter usernames.

python

2

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

This MCP server tracks the historical Twitter usernames for a given current handle, helping you spot red flags when accounts frequently change screen names. It provides a focused way to query past usernames and understand the evolution of a Twitter user’s identity over time.

How to use

You interact with this server through an MCP client. The main function is to query the username change history for a Twitter account by its current screen name, for example querying the history of @OSINT_Ukraine or @Mormonger.

How to install

Prerequisites include Python 3.10 or newer and a dependency manager such as pip or uv. You also need the MCP CLI tools installed to interact with the server.

Step 1: Clone the repository.

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

Step 2: Install dependencies.

pip install mcp[cli] requests

Step 3: Run the server in development mode to test locally.

mcp dev main.py

Configuring integration with Claude Desktop

If you want to integrate with Claude Desktop, add the MCP server entry to Claude Desktop’s MCP configuration. The example below shows how to register the local Python-based server.

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

Query examples and expected results

Use the MCP client to run queries against the server. The following are representative examples.

Tool input: screen_name: "Mormonger"

Expected output:

Username change history for Mormonger:

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

Installation and usage notes for Claude Desktop

To install and use the server via Claude Desktop, perform the following steps.

mcp install main.py --name "TwitterUsernameChanges"

Then open Claude Desktop, locate the MCP tools, and run queries such as: Show the username change history for Twitter user @OSINT_Ukraine. The tool will display the username timeline and user IDs similar to the examples above.

Available tools

query_username_changes

Queries the historical usernames of a Twitter user by their current screen name and returns the username timeline along with user IDs and date ranges.

prompt_template

Includes a prompt template to guide users in formulating queries for username history searches.