SocialData

tools.socialdataPublished by socialdata.toolsOfficial publisherv1.0.0Updated Oct 24, 2026

Twitter (X) API alternative for AI agents: tweet search, profiles, followers. $0.0002 per result.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingData & Analytics

Overview

AI-generated overview

A remote MCP server that gives an assistant paid access to Twitter/X data: tweet search, user profiles, threads, replies, followers and lists.

What you can do
Look up Twitter/X user profiles by handle or numeric ID, and search for profiles by name or handle when the exact handle is unknown. Fetch single posts, author threads, replies to a post, and a user's own posts, posts plus replies, or mentions, with cursor paging. Retrieve a user's followers or following lists, and check whether one account follows another. Search posts with Twitter advanced search operators, and read posts from a Twitter/X list.
When to use it
Useful when an assistant needs current Twitter/X content or account data — researching a person or account, reading a thread or replies, monitoring mentions, or searching posts by keyword or operator — without building a direct API integration.
Requirements
Remote streamable HTTP endpoint; no local package. Requires a bearer API key from the provider's dashboard, sent in the Authorization header. A funded account balance is needed because each call is billed.
Before you install
Every call spends money from the caller's balance, billed per request or per result; follower, following and list calls can return around 100 records each and cost several times a normal call, so avoid paging through large accounts or busy lists without explicit user request. The API key is a secret and must be kept out of logs and shared output. Data is fetched from a third-party service.

Installation

In SourceWeft

  1. Open SocialData in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/tools.socialdata%2Fsocialdata/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "socialdata": {
      "type": "http",
      "url": "https://api.socialdata.tools/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

Tools

14

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.

Parametersusernamerequired

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.

Parametersuser_idrequired

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.

Parametersqueryrequired

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.

Parameterstweet_idrequired

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.

Parameterscursortweet_idrequired

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.

Parameterscursortweet_idrequired

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.

Parameterscursoruser_idrequired

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.

Parameterscursoruser_idrequired

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.

Parameterscursorusernamerequired

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.

Parameterscursoruser_idrequired

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.

Parameterscursoruser_idrequired

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.

Parameterssource_user_idrequiredtarget_user_idrequired

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

Parameterstypequeryrequiredcursor

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.

Parameterscursorlist_idrequired

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.