SocialData
Twitter (X) API alternative for AI agents: tweet search, profiles, followers.
Connector by socialdata.toolsOfficial · Domain verified by the MCP Registry
Install
Works with Claude Code, VS Code, Cursor, Windsurf. Read the repository before you give any tool access to your data.
npx agentmarket install connector/socialdata-tools-socialdata
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Remote endpoint
https://api.socialdata.tools/mcpRemote (HTTP)
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 14 read · 0 write · 0 deleteRead-only
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- Nothing to install (hosted)
- Runs as
- Hosted (remote endpoint)
Tools by what they do 14
From the running server's own tool list (tools/list) on Oct 25, 2026.
Read 14 · Look things up without changing anything.
check_is_followingget_list_tweetsget_tweetget_tweet_commentsget_tweet_threadget_user_by_idget_user_by_usernameget_user_followersget_user_followingget_user_mentionsget_user_tweetsget_user_tweets_and_replies
Show 2 more tools
search_tweetssearch_users
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
Authorization
Network hosts it talks to 1
api.socialdata.tools· found in remote endpoint, install command
Tools (14)
As the server listed them on Oct 25, 2026. Descriptions are the server’s own words; hidden characters are shown as [U+…].
check_is_followingCheck Is Following Toolread-onlyCheck 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.
get_list_tweetsGet List Tweets Toolread-onlyFetch 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.
get_tweetGet Tweet Toolread-onlyFetch a single Twitter/X post by its numeric ID, including engagement counts. Bills one post request against the caller's balance.
get_tweet_commentsGet Tweet Comments Toolread-onlyFetch 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.
get_tweet_threadGet Tweet Thread Toolread-onlyFetch 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.
get_user_by_idGet User By Id Toolread-onlyLook up a Twitter/X user profile by numeric user ID. Bills one user request against the caller's balance.
get_user_by_usernameGet User By Username Toolread-onlyLook 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.
get_user_followersGet User Followers Toolread-onlyFetch 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.
get_user_followingGet User Following Toolread-onlyFetch 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.
get_user_mentionsGet User Mentions Toolread-onlyFetch 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.
get_user_tweetsGet User Tweets Toolread-onlyFetch 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.
get_user_tweets_and_repliesGet User Tweets And Replies Toolread-onlyFetch 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.
search_tweetsSearch Tweets Toolread-onlySearch 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…
search_usersSearch Users Toolread-onlySearch 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.
Signals
- Last release
- Aug 25, 2026 (2 months ago)
Details
- Registry name
tools.socialdata/socialdata- Version
- 1.0.0
- Auth
- Bearer token
- License
- License unknown
- Website
- socialdata.tools
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
- Source
- Official MCP Registry
Cite this page
SocialData MCP server. Agent Mart. https://agentmart.dev/connectors/socialdata-tools-socialdata (last updated 2026-10-24)