SocialData

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.

python

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": {
    "thesethrose-socialdata-mcp-server": {
      "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"
      }
    }
  }
}

You can run the SocialData MCP Server to programmatically fetch and monitor Twitter/X data, verify social actions, and receive real-time alerts via MCP clients. This setup lets you integrate SocialData capabilities into your workflows, dashboards, or automation.

How to use

Connect your MCP client to the SocialData MCP Server to access tools for data retrieval, monitoring, and account management. You will call functions like searching Tweets, obtaining user profiles, checking followers, and setting up webhooks for alerts. Use the client to drive automated data collection, monitoring, and insights without manual API calls.

How to install

Prerequisites you need before installation: Python 3.9+ and a virtual environment tool (venv). Ensure you have network access to install dependencies and to authenticate with the SocialData API.

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 and start using the server.

source venv/bin/activate

Option 2 — Manual Setup

1. Clone or download the source
2. Create a virtual environment:

python3 -m venv venv source venv/bin/activate

3. Install dependencies:

pip install -r requirements.txt

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

export SOCIALDATA_API_KEY="your_api_key_here" `

## Additional configuration and usage notes

Configure your MCP client to connect to the SocialData MCP Server using a stdio-based interface. You will specify the Python command and the server script path, along with the API key to enable authenticated access.

Environment variable for API key is required to authorize requests. Set SOCIALDATA\_API\_KEY in the client configuration or in your environment before launching the server.

## Available tools

### search\_twitter

Search Twitter with advanced operators and optional pagination to retrieve tweets matching a query.

### get\_user\_by\_username

Fetch a user profile by their Twitter username.

### get\_user\_by\_id

Fetch a user profile by their Twitter user ID.

### get\_user\_followers

Retrieve the list of followers for a given user ID.

### get\_user\_following

Retrieve the accounts followed by a given user ID.

### get\_tweet

Get complete details for a specific tweet by ID.

### get\_tweet\_comments

Fetch comments/replies to a specific tweet.

### get\_tweet\_retweeters

Get users who retweeted a specific tweet.

### get\_tweet\_quotes

Fetch quote Tweets for a given tweet.

### get\_twitter\_thread

Retrieve all tweets within a conversation thread.

### analyze\_tweet\_engagement

Compute comprehensive engagement data for a tweet (comments, retweets, quotes).

### verify\_user\_following

Check if one user follows another.

### verify\_user\_retweeted

Verify whether a user retweeted a specific tweet.

### verify\_user\_commented

Check if a user commented on a tweet.

### create\_user\_tweets\_monitor

Set up monitoring for new tweets from a user and deliver notifications via webhook.

### create\_user\_following\_monitor

Monitor when a user follows new accounts and notify via webhook.

### create\_user\_profile\_monitor

Monitor profile changes and notify via webhook.

### list\_monitors

List all active monitors.

### delete\_monitor

Remove a monitor by its identifier.

### get\_account\_balance

Check remaining API credits for the configured SocialData account.

### set\_global\_webhook

Set a default webhook URL that applies to all monitors.

Built by

VeilStrat

AI signals for GTM teams