This MCP server exposes a set of tools to interact with the SocialData API. It enables you to search Twitter/X data with advanced operators, fetch user profiles by username or ID, retrieve followers and following lists, pull tweets (including mentions, highlights, and threads), access lists and communities, and gather Space details. It also includes verification utilities to confirm if one user follows another, if a tweet was retweeted or if a user commented on a tweet. For monitoring, you can set up alerts for new tweets from a user, when someone follows new accounts, profile changes, and even track cryptocurrency mentions via Pump.fun monitors. Account management tools let you check remaining API credits and configure webhook notification endpoints. To use these tools, configure the MCP client to point to the SocialData server and provide your SocialData API key via the SOCIALDATA_API_KEY environment variable.

Prerequisites:

• Python 3.8+ installed on the host
• A Python virtual environment ready for the SocialData server
• Access to a SocialData API key

Option A: Automated Setup (Recommended)

1. Create and activate a virtual environment, install dependencies, and run setup if provided by the project (example commands below will vary if a setup script exists): mkdir -p socialdata && cd socialdata python3 -m venv venv source venv/bin/activate

   If a setup script exists, run it here

   ./setup.sh

2. Activate the environment and start the server as described in the README (adjust paths as needed): source venv/bin/activate python server.py

Option B: Manual Setup

1. Clone/download the repository to your preferred location.
2. Create and activate a virtual environment: python3 -m venv venv source venv/bin/activate
3. Install dependencies from requirements.txt: pip install -r requirements.txt
4. Set your SocialData API key as an environment variable before running the server: export SOCIALDATA_API_KEY="your_api_key_here"
5. Run the server: python server.py

Configuring MCP client (example):

• After the server is running, configure your MCP client to connect via stdio with the appropriate python command and server path as shown in the example mcp_config. Ensure the SOCIALDATA_API_KEY is provided in the env block.

Tips and common issues:

• Ensure the SOCIALDATA_API_KEY is kept secret and loaded into the environment before starting the server.
• If the server file path or virtual environment path changes, update the mcp_config accordingly.
• When running in containers or restricted environments, ensure the environment variable is passed through to the MCP client configuration.
• Make sure dependencies listed in requirements.txt are compatible with your Python version.
• If you encounter authentication errors, verify that the API key has the necessary permissions for the requested endpoints.
• For long-running monitors, consider configuring appropriate webhook endpoints and handling retries on failures.