SocialDataX X / Twitter MCP
Server Details
X/Twitter search, posts, comments, user profiles, user posts/replies and video transcripts.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 21 tools
The surface is built from a small number of operations (post detail, post comments, comment replies, user info, user posts, user replies, search) each replicated across identifier variants (post_id/post_url, user_id/username/profile_url). This creates several near-duplicate pairs, but each description states an explicit routing rule ('prefer post_id when known', 'only use when no post_id exists'), so an agent following the text can select correctly. The submit/get video job pair and the points-balance tool are cleanly distinct from everything else.
Names follow a rigid and highly predictable pattern: x_<verb>_<resource>_by_<identifier_type>, with parallel suffixes (_by_post_id, _by_post_url, _by_user_id, _by_username, _by_profile_url) repeated across every resource. The only prefix deviation is socialdatax_get_points_balance, which still uses the same verb_noun convention and is an intentional account-level tool.
21 tools is in the heavy band for what amounts to roughly 8 underlying operations; the identifier-variant matrix (3x user tools, 3x user posts, 3x user replies, 2x post detail, 2x post comments, 2x submit) inflates the count. The expansion is defensible since each variant removes an ID-resolution step for the agent, but it still pushes the set toward the verbose end.
Coverage of the read-only X data domain is solid: post detail, comments, nested replies, user profiles, user timelines, user replies, post and user search, suggestions, plus a video transcription job flow and account balance. Notable gaps remain around social-graph data (followers/following lists), engagement/retweeter listings, and trends, which an agent would hit when asked graph-style questions.
Available Tools
21 toolsx_get_post_comment_replies_by_comment_idARead-onlyInspect
根据 X 帖子 ID 和一级评论 ID 获取公开评论回复列表;用户已提供完整合法的 ID 组合时直接使用;已有 post_id 或帖子链接但缺少必需 ID 时,调用对应一级评论工具补全;缺少帖子定位信息时向用户索取;不要传评论回复结果里的 comment_id 或评论链接。
Inputs: post_id (required), comment_id (required), page_token. Returns: items, points, next_page_token
x_get_post_comments_by_post_idARead-onlyInspect
根据 X 帖子 ID 获取公开帖子的一级评论列表,不内嵌评论回复;已知 post_id 时优先使用,不要传帖子链接或评论 ID。
Inputs: post_id (required), page_token. Returns: items, points, post_url, comment_count, +1 more
x_get_post_comments_by_post_urlARead-onlyInspect
根据 X 帖子链接获取公开帖子的一级评论列表,不内嵌评论回复;仅在没有 post_id、只有帖子链接或结果里的非空 post_url 时使用。
Inputs: post_url (required), page_token. Returns: items, points, post_url, comment_count, +1 more
x_get_post_detail_by_post_idARead-onlyInspect
根据 X 帖子 ID 获取公开帖子详情;已知 post_id 时优先使用,不要传帖子链接。
Inputs: post_id (required). Returns: lang, text, author, points, +21 more
x_get_post_detail_by_post_urlARead-onlyInspect
根据 X 帖子链接获取公开帖子详情;仅在没有 post_id、只有帖子链接或结果里的非空 post_url 时使用。
Inputs: post_url (required). Returns: lang, text, author, points, +21 more
x_get_user_info_by_profile_urlARead-onlyInspect
根据 X 用户主页链接获取公开用户信息;可使用用户搜索结果的非空 items[*].profile_url,或帖子及评论结果的非空 author.profile_url。不要传帖子链接。
Inputs: profile_url (required). Returns: bio, name, points, user_id, +16 more
x_get_user_info_by_user_idARead-onlyInspect
根据 X 用户 ID 获取公开用户信息;已有完整 user_id 时直接使用。
Inputs: user_id (required). Returns: bio, name, points, user_id, +16 more
x_get_user_info_by_usernameBRead-onlyInspect
根据 X 用户名获取公开用户信息;可使用用户搜索结果的非空 items[*].username,或帖子及评论结果的非空 author.username。
Inputs: username (required). Returns: bio, name, points, user_id, +16 more
x_get_user_posts_by_profile_urlARead-onlyInspect
根据 X 用户主页链接获取公开用户帖子列表;可使用用户搜索结果的非空 items[*].profile_url,或帖子及评论结果的非空 author.profile_url。不要传帖子链接。支持 page_token 翻页。
Inputs: profile_url (required), page_token. Returns: items, points, next_page_token
x_get_user_posts_by_user_idARead-onlyInspect
根据 X 用户 ID 获取公开用户帖子列表;已有完整 user_id 时直接使用,支持 page_token 翻页。
Inputs: user_id (required), page_token. Returns: items, points, next_page_token
x_get_user_posts_by_usernameARead-onlyInspect
根据 X 用户名获取公开用户帖子列表;可使用用户搜索结果的非空 items[*].username,或帖子及评论结果的非空 author.username。支持 page_token 翻页。
Inputs: username (required), page_token. Returns: items, points, next_page_token
x_get_user_replies_by_profile_urlARead-onlyInspect
根据 X 用户主页链接获取该博主发布的回复帖子,包括自回复,支持分页;查看博主回复过什么时使用。查看某条帖子下的评论或评论下的回复时,使用对应评论工具。
Inputs: profile_url (required), page_token. Returns: items, points, next_page_token
x_get_user_replies_by_user_idARead-onlyInspect
根据 X 用户 ID获取该博主发布的回复帖子,包括自回复,支持分页;查看博主回复过什么时使用。查看某条帖子下的评论或评论下的回复时,使用对应评论工具。
Inputs: user_id (required), page_token. Returns: items, points, next_page_token
x_get_user_replies_by_usernameARead-onlyInspect
根据 X 用户名获取该博主发布的回复帖子,包括自回复,支持分页;查看博主回复过什么时使用。查看某条帖子下的评论或评论下的回复时,使用对应评论工具。
Inputs: username (required), page_token. Returns: items, points, next_page_token
x_get_video_speech_text_jobARead-onlyInspect
根据用户提供的有效 job_id,或 submit 工具返回的 job_id 查询 X / Twitter 口播转文字任务;每次最多等待 240 秒,不触发重处理,也不要重复提交任务。
Inputs: job_id (required). Returns: error, job_id, status, message, +9 more
x_search_postsARead-onlyInspect
按搜索词搜索 X / Twitter 公开帖子,只返回帖子结果。用户需要按搜索词查找帖子时使用;已有 post_id 或 post_url 时使用帖子详情或评论工具;已有 user_id、username 或 profile_url 时使用用户信息或用户帖子工具;支持 page_token 翻页和热门/最新排序。
Inputs: keyword (required), sort_type, page_token. Returns: items, points, next_page_token
x_search_suggestionsARead-onlyInspect
获取 X / Twitter 搜索框的关键词联想,不返回帖子或推荐用户,不支持分页。可将返回的 text 用于帖子搜索;已有明确搜索词时可直接搜索帖子。
Inputs: keyword (required). Returns: items, points
x_search_usersARead-onlyInspect
按关键词搜索 X / Twitter 用户,返回用户资料和分页令牌,支持 page_token 翻页。用于按名称发现账号;已知 user_id、username 或主页链接时,使用对应用户详情工具。
Inputs: keyword (required), page_token. Returns: items, points, next_page_token
x_submit_video_speech_text_by_post_idAInspect
根据 X / Twitter 视频帖子的 post_id 提交口播转文字任务;只处理当前帖子自身首个可用 MP4 视频,提交后最多等待 240 秒,未完成时返回 job_id 和下一步查询动作。
Inputs: post_id (required). Returns: error, job_id, status, message, +9 more
x_submit_video_speech_text_by_post_urlAInspect
根据 X / Twitter 视频帖子链接提交口播转文字任务;只处理当前帖子自身首个可用 MP4 视频,提交后最多等待 240 秒,未完成时返回 job_id 和下一步查询动作。
Inputs: post_url (required). Returns: error, job_id, status, message, +9 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
X (Twitter) search, profiles and trends, YouTube search, video stats and comments, TikTok comments.
Search X (Twitter) posts and read profiles, followers, trends and X Articles. OAuth sign-in.
Read public posts, comments, profiles and YouTube transcripts from Reddit, X, TikTok and more.
Read public Twitter/X data: tweets, profiles, followers, search. No X developer account.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables real-time search of X (Twitter) posts, user timelines, and trends using either xAI's Responses API or the official X API v2.4-
- AlicenseAqualityBmaintenanceEnables agents to search and read public X/Twitter posts without an API key, fetching single or batched posts by ID or URL, running operator-filtered keyword searches with hydrated full-text results, and retrieving public profile metadata.6MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to read public X (Twitter) data without the paid official API, including tweet and user search, profiles, timelines, media, replies, retweeters, followers, lists, and trends. All tools are read-only and rotate across multiple scraping accounts with proxy and rate-limit support.MIT
- AlicenseBqualityDmaintenanceEnables searching X (formerly Twitter) using xAI's Responses API with support for filtering by handles, date ranges, and media understanding, returning structured results with citations.110 npm1MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.
socialdatax_get_points_balanceARead-only Inspect
查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。
Inputs: no named parameters. Returns: object