MCP Server
SocialData
tools.socialdata/socialdata
What this MCP does
Provides paid Twitter/X searches and retrieval of posts, profiles, timelines, followers, following lists, mentions, and threads.
Capabilities
Tools
14
tools
check_is_following
Check Is Following Tool
Check whether one Twitter/X user follows another. Far cheaper than fetching a follower list — use this whenever the question is about a specific pair of accounts. Both IDs must be numeric.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['source_user_id', 'target_user_id'], 'properties': {'source_user_id': {'type': 'string', 'description': 'The numeric ID of the user who might be following, as a string.'}, 'target_user_id': {'type': 'string', 'description': 'The numeric ID of the user who might be followed, as a string.'}}}
get_list_tweets
Get List Tweets Tool
Fetch one page of posts from a Twitter/X list, newest first. A page is large — around 100 posts — plus a next_cursor. Billing is per result, so one call here costs several times a single-user timeline call; do not page through a busy list unless the user asked for that.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['list_id'], 'properties': {'cursor': {'type': 'string', 'description': "Pagination cursor from a previous call's next_cursor. Omit for the first page."}, 'list_id': {'type': 'string', 'description': 'The numeric Twitter/X list ID, as a string.'}}}
get_tweet
Get Tweet Tool
Fetch a single Twitter/X post by its numeric ID, including engagement counts. Bills one post request against the caller's balance.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['tweet_id'], 'properties': {'tweet_id': {'type': 'string', 'description': 'The numeric post ID, as a string.'}}}
get_tweet_comments
Get Tweet Comments Tool
Fetch one page of replies to a Twitter/X post. Returns about 20 replies plus a next_cursor. The first item of a page can repeat the last item of the previous page, so de-duplicate by post id when paging. Each call bills against the caller's balance — do not page through the whole conversation unless the user asked for that.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['tweet_id'], 'properties': {'cursor': {'type': 'string', 'description': "Pagination cursor from a previous call's next_cursor. Omit for the first page."}, 'tweet_id': {'type': 'string', 'description': 'The numeric ID of the post whose replies you want, as a string.'}}}
get_tweet_thread
Get Tweet Thread Tool
Fetch one page of a Twitter/X thread — the chain of follow-up posts the author wrote under their own post ("1/", "2/", ...). Give it the ID of any post in the chain and it returns that chain in order. It does NOT return what other people replied; use get_tweet_comments for those. A post the author never followed up on is a one-post thread and correctly returns just that post. Roughly 30 posts per page plus a next_cursor, so a long thread takes several calls. Each call bills against the caller's balance — do not page through a long thread unless the user asked for that.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['tweet_id'], 'properties': {'cursor': {'type': 'string', 'description': "Pagination cursor from a previous call's next_cursor. Omit for the first page."}, 'tweet_id': {'type': 'string', 'description': 'The numeric post ID, as a string.'}}}
get_user_by_id
Get User By Id Tool
Look up a Twitter/X user profile by numeric user ID. Bills one user request against the caller's balance.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['user_id'], 'properties': {'user_id': {'type': 'string', 'description': 'The numeric Twitter/X user ID, as a string (IDs exceed safe integer precision).'}}}
get_user_by_username
Get User By Username Tool
Look up a Twitter/X user profile by username (handle). Returns the profile including follower and following counts. Bills one user request against the caller's balance.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['username'], 'properties': {'username': {'type': 'string', 'description': 'The Twitter/X username (handle), with or without the leading @.'}}}
get_user_followers
Get User Followers Tool
Fetch one page of a user's followers. This is one of the most expensive tools: a page is set upstream and can run to ~100 user records, every one of which is billed. Never page through a large account's followers without the user explicitly asking. Requires a numeric user ID.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['user_id'], 'properties': {'cursor': {'type': 'string', 'description': "Pagination cursor from a previous call's next_cursor. Omit for the first page."}, 'user_id': {'type': 'string', 'description': 'The numeric Twitter/X user ID whose followers you want, as a string.'}}}
get_user_following
Get User Following Tool
Fetch one page of the accounts a user follows. Expensive: a page is set upstream and can run to ~100 user records, every one of which is billed. Never page through a large account's following list without the user explicitly asking. Requires a numeric user ID.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['user_id'], 'properties': {'cursor': {'type': 'string', 'description': "Pagination cursor from a previous call's next_cursor. Omit for the first page."}, 'user_id': {'type': 'string', 'description': 'The numeric Twitter/X user ID whose following list you want, as a string.'}}}
get_user_mentions
Get User Mentions Tool
Fetch one page of posts mentioning a given user, newest first. Returns about 20 posts plus a next_cursor. The first item of a page can repeat the last item of the previous page, so de-duplicate by post id when paging. Each call bills against the caller's balance.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['username'], 'properties': {'cursor': {'type': 'string', 'description': "Pagination cursor from a previous call's next_cursor. Omit for the first page."}, 'username': {'type': 'string', 'description': 'The Twitter/X username (handle) being mentioned, with or without the leading @.'}}}
get_user_tweets
Get User Tweets Tool
Fetch one page of a user's own posts (excluding replies), newest first. Returns about 20 posts plus a next_cursor. If the account has a pinned post it is prepended to every page, so de-duplicate by post id when paging. Each call bills against the caller's balance — do not page through a whole timeline unless the user asked for that. Requires a numeric user ID: call get_user_by_username first if you only have a handle.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['user_id'], 'properties': {'cursor': {'type': 'string', 'description': "Pagination cursor from a previous call's next_cursor. Omit for the first page."}, 'user_id': {'type': 'string', 'description': 'The numeric Twitter/X user ID, as a string.'}}}
get_user_tweets_and_replies
Get User Tweets And Replies Tool
Fetch one page of a user's posts including their replies, newest first. Returns about 20 items plus a next_cursor. If the account has a pinned post it is prepended to every page, so de-duplicate by post id when paging. Each call bills against the caller's balance. Requires a numeric user ID: call get_user_by_username first if you only have a handle.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['user_id'], 'properties': {'cursor': {'type': 'string', 'description': "Pagination cursor from a previous call's next_cursor. Omit for the first page."}, 'user_id': {'type': 'string', 'description': 'The numeric Twitter/X user ID, as a string.'}}}
search_tweets
Search Tweets Tool
Search Twitter/X posts. Returns one page of about 20 results plus a
next_cursor, and bills one search request against the caller's balance.
The query supports Twitter's advanced search operators, and using them is
almost always better than a bare keyword search:
from:handle posts by an account
to:handle replies to an account
@handle posts mentioning an account
#tag hashtag
"exact phrase" phrase match
since:2026-01-01 posts on or after a date
until:2026-02-01 posts before a date
min_faves:100 at least N likes
min_retweets:10 at least N retweets
filter:links posts containing links
-filter:replies exclude replies
Combine them freely: from:jack min_faves:500 since:2026-01-01
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'type': {'enum': ['Latest', 'Top'], 'type': 'string', 'default': 'Latest', 'description': 'Latest returns the newest matching posts; Top returns the most engaged-with. Defaults to Latest.'}, 'query': {'type': 'string', 'description': 'The search query. Supports Twitter advanced search operators such as from:, to:, since:, until:, min_faves: and filter:.'}, 'cursor': {'type': 'string', 'description': "Pagination cursor from a previous call's next_cursor. Omit for the first page."}}}
search_users
Search Users Tool
Search Twitter/X user profiles by name or handle. Returns one page of matching profiles and bills against the caller's balance. Use this when you know roughly who someone is but not their exact handle.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'Name or handle to search for.'}}}
History
Recent tool changes
Added
get_list_tweets
Sept. 17, 2026, 12:55 p.m.
Added
search_tweets
Sept. 17, 2026, 12:55 p.m.
Added
check_is_following
Sept. 17, 2026, 12:55 p.m.
Added
get_user_following
Sept. 17, 2026, 12:55 p.m.
Added
get_user_followers
Sept. 17, 2026, 12:55 p.m.
Added
get_user_mentions
Sept. 17, 2026, 12:55 p.m.
Added
get_user_tweets_and_replies
Sept. 17, 2026, 12:55 p.m.
Added
get_user_tweets
Sept. 17, 2026, 12:55 p.m.
Added
get_tweet_comments
Sept. 17, 2026, 12:55 p.m.
Added
get_tweet_thread
Sept. 17, 2026, 12:55 p.m.
Added
get_tweet
Sept. 17, 2026, 12:55 p.m.
Added
search_users
Sept. 17, 2026, 12:55 p.m.
Added
get_user_by_id
Sept. 17, 2026, 12:55 p.m.
Added
get_user_by_username
Sept. 17, 2026, 12:55 p.m.
Discover
Similar MCP servers
Social Fetch
io.github.social-freak-ltd/socialfetch
Retrieves public content and metadata from social networks, music services, Facebook Marketplace, events, profiles, posts, commen…
API Direct
io.apidirect/api-direct
Searches and retrieves data from social networks, news and Google services, while also providing Amazon product, seller, ranking,…
TERM
app.term/forum
Provides an agent-oriented forum for publishing findings, discussing questions, voting, communities, and deterministic research c…
Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)
ai.xpoz/social-insights
Searches and analyzes posts, comments, users, trends, and tracked topics across Twitter/X, Instagram, Reddit, and TikTok.
linkdapi-the-best-linkedin-professional-data-api
com.jojapi/linkdapi-the-best-linkedin-professional-data-api
Provides LinkedIn professional data on profiles, companies, employees, jobs, posts, articles, comments, reactions, skills, and lo…
Prowlo — Reddit & X for AI agents
com.prowlo/reddit-x
Indexes and searches Reddit and X-related social data, discovers communities, monitors keywords, finds engagement opportunities, …
ZOOQ - LinkedIn Data for AI Agents
io.github.baldiga/zooq
Provides live LinkedIn-derived data on people, companies, jobs, posts, professional relationships, and work email discovery.
Hackernews
io.github.pipeworx-io/hackernews
Searches and retrieves Hacker News stories, individual items, and discussion comments.