Twitter Username Changes MCP Server

Twitter Username Changes MCP Server

Track historical changes of Twitter usernames to identify potential risks.

2
Stars
7
Forks
2
Watchers
3
Issues
Provides an MCP-compliant server that allows users and AI models to query and retrieve the username change history for Twitter accounts. Integrates with Claude Desktop and supports prompt templating and tool debugging through the MCP Inspector. Facilitates easy tracking of frequent or suspicious username changes, which may indicate scam risks in the crypto space. Minimal dependencies are required for quick setup and deployment.

Key Features

Query historical username changes for any Twitter account
Integrates with Claude Desktop via MCP protocol
Includes prompt templates for query formulation
Lightweight design with minimal dependencies
Tool debugging and inspection through MCP Inspector
Support for development and local server testing
Real-time querying of username change histories
Installation and configuration guides for multiple platforms
Returns structured output for easy downstream consumption
Handles invalid or missing account queries gracefully

Use Cases

Evaluating the credibility and consistency of Twitter accounts
Flagging potential scam or risky crypto project accounts
Providing historical username data to AI assistants
Assisting OSINT and social media intelligence investigations
Integrating social media context into AI model workflows
Enabling moderators to verify history of reported users
Supporting researchers analyzing identity changes on Twitter
Supplying tools for auditors and compliance checks in crypto
Prompt templating for seamless tool integration and querying
Debugging and testing username queries in model development environments

README

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.

License Python Status

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:

    bash
    git clone https://github.com/kukapay/twitter-username-changes-mcp.git
    cd twitter-username-changes-mcp
    
  2. Install Dependencies:

    bash
    pip install mcp[cli] requests
    

Usage

Running the Server

Start the server in development mode to test locally:

bash
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:

    json
    {
      "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:

    bash
    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.

Star History

Star History Chart

Repository Owner

kukapay
kukapay

User

Repository Details

Language Python
Default Branch main
Size 22 KB
Contributors 1
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
100%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Maigret MCP Server

    Maigret MCP Server

    OSINT username and URL search server for the Model Context Protocol.

    Maigret MCP Server provides Model Context Protocol (MCP) integration for the Maigret OSINT tool, enabling AI and context-aware applications to search for usernames across hundreds of social networks and analyze URLs. Designed for seamless operation with MCP-compatible clients like Claude Desktop, it supports multiple output formats and advanced filtering options. The server can be installed via Docker or npm, offers Docker-based deployment for consistent performance, and facilitates responsible OSINT research.

    • 205
    • MCP
    • BurtTheCoder/mcp-maigret
  • Twitter MCP Server

    Twitter MCP Server

    Programmatic Twitter account management via an MCP-compliant server.

    Twitter MCP Server enables programmatic management of Twitter accounts with features such as retrieving home timelines, fetching user tweets, conducting hashtag searches, handling direct messages, and performing tweet creation or deletion. The server appears designed for integration into multi-channel platforms following the Model Context Protocol. It requires Python 3.11+, utilizes environment configuration for credentials, and offers an API-driven interface for various Twitter operations.

    • 47
    • MCP
    • LuniaKunal/mcp-twitter
  • MCP Domain Availability Checker

    MCP Domain Availability Checker

    Seamless domain availability checking across 50+ TLDs for Claude Desktop via MCP integration.

    MCP Domain Availability Checker provides robust domain name availability searching across more than 50 popular TLDs, leveraging both DNS and WHOIS for accurate verification. It offers natural language queries, smart TLD suggestions, and bulk checking capabilities, optimized for integration with Claude Desktop through the Model Context Protocol. The tool enables real-time status updates, fast parallel processing, and organizes results by TLD categories to streamline domain discovery workflows.

    • 22
    • MCP
    • imprvhub/mcp-domain-availability
  • Netwrix Access Analyzer MCP Server

    Netwrix Access Analyzer MCP Server

    An MCP server integrating enterprise access analysis tools with Claude Desktop.

    Netwrix Access Analyzer MCP Server provides a Model Context Protocol (MCP) server designed for integration with Claude Desktop. It enables secure and dynamic access to Active Directory, SQL Server databases, and file system data for auditing and analysis. The server offers a range of tools for effective group membership discovery, permission analysis, sensitive data detection, and more. It streamlines enterprise security assessments by standardizing context-sharing for AI-driven solutions.

    • 1
    • MCP
    • netwrix/mcp-server-naa
  • MCP Status Observer

    MCP Status Observer

    Monitor and query real-time operational status of digital platforms using Model Context Protocol.

    MCP Status Observer enables real-time monitoring and querying of service status for major digital platforms and AI providers through the Model Context Protocol (MCP). It supports integration with tools like Claude Desktop for streamlined status checks, incident tracking, and impact analysis across a range of platforms including GitHub, Slack, OpenAI, and Cloudflare. The tool provides detailed component-level insights, incident histories, and resolution statuses, empowering rapid awareness of operational issues and outages.

    • 5
    • MCP
    • imprvhub/mcp-status-observer
  • Coincap MCP

    Coincap MCP

    Query live cryptocurrency data through Coincap's public API for desktop AI tools.

    Coincap MCP provides seamless access to cryptocurrency market data from Coincap's public API without requiring API keys or registration. Designed to integrate with Claude Desktop using the Model Context Protocol (MCP), it enables users to query crypto asset prices, market capitalization, and a list of available assets. Installation and configuration are streamlined through Smithery or direct setup. The tool includes sample prompts and exposes specialized tools for crypto price lookup and asset listing.

    • 89
    • MCP
    • QuantGeekDev/coincap-mcp
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results