SocialData MCP Server

A comprehensive Model Context Protocol (MCP) server that provides tools for interacting with the SocialData API. This server allows you to fetch Twitter/X data, monitor user activity, and analyze social media engagement programmatically.

Features

Data Retrieval

• Search: Advanced Twitter search with operators
• User Profiles: Get detailed user information by username or ID
• Followers/Following: Retrieve follower and following lists
• Tweets: Get user tweets, mentions, highlights, and threads
• Lists & Communities: Access Twitter Lists and Community data
• Spaces: Get Twitter Space details

Social Actions Verification

• Following Verification: Check if one user follows another
• Retweet Verification: Verify if a user retweeted a tweet
• Comment Verification: Check if a user commented on a tweet

Monitoring & Alerts

• User Tweet Monitors: Get alerts for new tweets
• Following Monitors: Monitor when users follow new accounts
• Profile Monitors: Track profile changes
• Pump.fun Monitors: Monitor cryptocurrency mentions

Account Management

• Balance Tracking: Check remaining API credits
• Webhook Management: Set up notification endpoints

Installation

Option 1: Automated Setup (Recommended)

Run the setup script which will create a virtual environment and install dependencies:

chmod +x setup.sh
./setup.sh

Then activate the virtual environment:

source venv/bin/activate

Option 2: Manual Setup

1. Clone or download this repository
2. Create a virtual environment:

python3 -m venv venv
source venv/bin/activate

3. Install the required dependencies:

pip install -r requirements.txt

4. Set up your SocialData API key as an environment variable:

export SOCIALDATA_API_KEY="your_api_key_here"

You can get an API key from your SocialData dashboard.

MCP Client Configuration

To use this server with an MCP client (like Claude Desktop, Continue, or other MCP-compatible tools), add the following configuration:

For MCP Clients

Add this to your MCP client configuration file (usually config.json or similar):

{
    "mcpServers": {
        "socialdata": {
            "type": "stdio",
            "command": "/path/to/your/socialdata/venv/bin/python",
            "args": ["/path/to/your/socialdata/server.py"],
            "env": {
                "SOCIALDATA_API_KEY": "your_actual_api_key_here"
            }
        }
    }
}

Configuration Options

Replace the paths and API key with your actual values:

• /path/to/your/socialdata/ - Replace with the full path to where you installed this server
• your_actual_api_key_here - Replace with your SocialData API key from your dashboard

Example Configurations

Option 1: Using Virtual Environment Python (Recommended)

{
    "mcpServers": {
        "socialdata": {
            "type": "stdio",
            "command": "/Users/yourname/path/to/socialdata/venv/bin/python",
            "args": ["/Users/yourname/path/to/socialdata/server.py"],
            "env": {
                "SOCIALDATA_API_KEY": "your_actual_api_key_here"
            }
        }
    }
}

Option 2: Using System Python

{
    "mcpServers": {
        "socialdata": {
            "type": "stdio",
            "command": "python3",
            "args": ["/Users/yourname/path/to/socialdata/server.py"],
            "env": {
                "SOCIALDATA_API_KEY": "your_actual_api_key_here"
            }
        }
    }
}

Option 3: Using a Wrapper Script

Create a run script:

#!/bin/bash
cd /path/to/your/socialdata
source venv/bin/activate
python3 server.py


... [View full README on GitHub](https://github.com/TheSethRose/SocialData-MCP-Server#readme)