MCP Server
twitter-x-aio
com.jojapi/twitter-x-aio
What this MCP does
Provides real-time Twitter/X search and access to tweets, users, followers, trends, media, replies, likes, retweets, subtitles, and related metadata.
Capabilities
Tools
23
tools
get_misc_emojis
Twitter hashtag emojis
Receive a full list of all twitter custom emojis with the hashtag, image and more. Group: Utilities/Misc. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
get_misc_locations
Location (for trends)
This gives you a list of all available locations. Group: Utilities/Misc. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
get_misc_subtitles
Video Subtitles
Get the full subtitles of a video Group: ✨ Exclusive endpoints. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
get_resolve_urls
resolve urls
resolve urls Group: Utilities/Misc. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'properties': {'urls': {'type': 'string'}}, 'additionalProperties': False}
get_search_searchTerm
Search
With the search endpoint you can search all of twitter. You just need to provide a search term. ⚠ If you have a large cursor the GET-request will limit at some length. For that you can use a POST-request which has no limits. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input schema
{'type': 'object', 'required': ['searchTerm'], 'properties': {'count': {'type': 'string', 'title': 'count', 'example': '20', 'description': 'The default count is 20. You can specify a custom one here.'}, 'cursor': {'type': 'string', 'title': 'cursor', 'description': "At the end of the entries array you'll find two objects with the type TimelineTimelineCursor. There is one cursor to go up (Top) and one for going down (bottom) the list."}, 'filters': {'type': 'string', 'title': 'filters', 'example': '{"since": "2020-10-01"}', 'description': 'Learn more about all filters by reading the docs or contact me on telegram @benagain :)'}, 'category': {'type': 'string', 'title': 'category', 'example': 'Latest', 'description': 'ENUM\nTop,Latest,People,Photos,Videos'}, 'searchTerm': {'type': 'string'}, 'includeTimestamp': {'type': 'string', 'title': 'includeTimestamp', 'example': 'false', 'description': 'Decide if you need a unix created_at timestamp. This will slightly increase the speed of the request.'}}, 'additionalProperties': False}
get_trends_locationId
Trends
Get twitter trends for worldwide or a specific region. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'required': ['locationId'], 'properties': {'locationId': {'type': 'string'}}, 'additionalProperties': False}
get_tweet_tweetId
Tweet Details
Receive all tweet informations and comments by tweetId. ⚠️ For large cursors (many replies you want to fetch) you can use the POST-request to be not limited by the GET-request length limit. Group: Tweet. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'required': ['tweetId'], 'properties': {'tweetId': {'type': 'string'}}, 'additionalProperties': False}
get_tweet_tweetId_favorites
Tweet Likes
Receive all likes for a tweet. Group: Tweet. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'required': ['tweetId'], 'properties': {'count': {'type': 'string', 'example': '20', 'description': 'The default count is 20. You can specify a custom one here.'}, 'cursor': {'type': 'string', 'description': "At the end of the entries array you'll find two objects with the type TimelineTimelineCursor. There is one cursor to go up (Top) and one for going down (bottom) the list."}, 'tweetId': {'type': 'string'}}, 'additionalProperties': False}
get_tweet_tweetId_retweets
Tweet Retweets
Receive all retweets for a tweet. Group: Tweet. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'required': ['tweetId'], 'properties': {'count': {'type': 'string', 'example': '20'}, 'cursor': {'type': 'string'}, 'tweetId': {'type': 'string'}}, 'additionalProperties': False}
get_user_by_username_username
User Details by username
Receive follower counts, images and more user related data with this endpoint. Group: User. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'required': ['username'], 'properties': {'username': {'type': 'string'}}, 'additionalProperties': False}
get_username_to_id_username
Convert username to userId
You'll need the userId to receive tweets, media and replies. Group: Utilities/Misc. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'required': ['username'], 'properties': {'username': {'type': 'string'}}, 'additionalProperties': False}
get_user_userId
User Details by userId
This is the prefered method of getting any information. Receive follower counts, images and more user related data with this endpoint. Group: User. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'required': ['userId'], 'properties': {'userId': {'type': 'string'}}, 'additionalProperties': False}
get_user_userId_followers
User Followers by userId
Receive all followers of a user. You can use the cursor and count to navigate around. Group: User. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'required': ['userId'], 'properties': {'count': {'type': 'string', 'example': '20', 'description': 'The default count is 20. You can specify a custom one here.'}, 'cursor': {'type': 'string', 'description': "At the end of the entries array you'll find two objects with the type TimelineTimelineCursor. There is one cursor to go up (Top) and one for going down (bottom) the list."}, 'userId': {'type': 'string'}, 'username': {'type': 'string', 'description': 'If you provide a username value it will automatically be picked and the userId is ignored'}}, 'additionalProperties': False}
get_user_userId_followings
User Followings by userId
Receive all followings of a user. You can use the cursor and count to navigate around. Group: User. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'required': ['userId'], 'properties': {'count': {'type': 'string', 'example': '20', 'description': 'The default count is 20. You can specify a custom one here.'}, 'cursor': {'type': 'string', 'description': "At the end of the entries array you'll find two objects with the type TimelineTimelineCursor. There is one cursor to go up (Top) and one for going down (bottom) the list."}, 'userId': {'type': 'string'}, 'username': {'type': 'string', 'description': 'If you provide a username value it will automatically be picked and the userId is ignored'}}, 'additionalProperties': False}
get_user_userId_followings_basic
Basic user followings by userId
You'll receive a basic list of all followings a user has. Please provide only the userId and you'll receive the following followings data: id, username, createdDate, followings, followers. Group: User. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'required': ['userId'], 'properties': {'userId': {'type': 'string'}, 'username': {'type': 'string', 'title': 'username', 'example': 'elonmusk', 'description': 'If you provide a username value it will automatically be picked and the userId is ignored'}}, 'additionalProperties': False}
get_user_userId_followings_ids
User Followings Ids
Get the ids of the users a certain user follows Group: User. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'required': ['userId'], 'properties': {'count': {'type': 'string', 'example': '20'}, 'cursor': {'type': 'string'}, 'userId': {'type': 'string'}, 'username': {'type': 'string', 'example': 'spacex'}}, 'additionalProperties': False}
get_user_userId_likes
User Likes by userId
Receive all likes of a user. You can use the cursor and count to navigate around. Group: User. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'required': ['userId'], 'properties': {'userId': {'type': 'string'}}, 'additionalProperties': False}
get_user_userId_media
Media by userId
Receive all media items ordered by most recent. You can use the cursor and count to navigate around. Group: User. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'required': ['userId'], 'properties': {'userId': {'type': 'string'}}, 'additionalProperties': False}
get_user_userId_tweets
Tweets by userId
Receive all tweets ordered by most recent. You can use the cursor and count to navigate around. Group: User. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'required': ['userId'], 'properties': {'count': {'type': 'string', 'title': 'count', 'example': '20', 'description': 'The default count is 20. You can specify a custom one here.'}, 'cursor': {'type': 'string', 'title': 'cursor', 'description': "At the end of the entries array you'll find two objects with the type TimelineTimelineCursor. There is one cursor to go up (Top) and one for going down (bottom) the list."}, 'userId': {'type': 'string'}, 'username': {'type': 'string', 'title': 'username', 'description': 'If you provide a username value it will automatically be picked and the userId is ignored. Best is to set userId to -1'}}, 'additionalProperties': False}
get_user_userId_tweetsAndReplies
Tweets and Replies by userId
Receive all tweets and replies ordered by most recent. You can use the cursor and count to navigate around. Group: User. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'required': ['userId'], 'properties': {'count': {'type': 'string', 'title': 'count', 'example': '20', 'description': 'The default count is 20. You can specify a custom one here.'}, 'cursor': {'type': 'string', 'title': 'cursor', 'description': "At the end of the entries array you'll find two objects with the type TimelineTimelineCursor. There is one cursor to go up (Top) and one for going down (bottom) the list."}, 'userId': {'type': 'string'}, 'username': {'type': 'string', 'title': 'username', 'description': 'If you provide a username value it will automatically be picked and the userId is ignored'}}, 'additionalProperties': False}
get_user_usernames_to_ids
[✨ EXCLUSIVE!] Usernames to Ids
This endpoint receives a list of usernames and converts up to 100 of them at the same time to ids. Group: ✨ Exclusive endpoints. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
post_search_searchTerm
Search for large cursors
With the search endpoint you can search all of twitter. You just need to provide a search term. This is the POST-request which allows you to send larger requests. Group: Utilities/Misc. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'required': ['searchTerm'], 'properties': {'searchTerm': {'type': 'string'}}, 'additionalProperties': False}
post_tweet_tweetId
Tweet Details for large cursors
Receive all tweet informations and comments by tweetId. This POST-request allows you to dig deeper into the replies when the cursor is growing. Group: Utilities/Misc. Billing per call: 1 Credits.
Input schema
{'type': 'object', 'required': ['tweetId'], 'properties': {'tweetId': {'type': 'string'}}, 'additionalProperties': False}
History
Recent tool changes
Added
get_misc_subtitles
Sept. 17, 2026, 12:35 p.m.
Added
get_user_usernames_to_ids
Sept. 17, 2026, 12:35 p.m.
Added
get_username_to_id_username
Sept. 17, 2026, 12:35 p.m.
Added
get_misc_locations
Sept. 17, 2026, 12:35 p.m.
Added
get_misc_emojis
Sept. 17, 2026, 12:35 p.m.
Added
post_tweet_tweetId
Sept. 17, 2026, 12:35 p.m.
Added
post_search_searchTerm
Sept. 17, 2026, 12:35 p.m.
Added
get_resolve_urls
Sept. 17, 2026, 12:35 p.m.
Added
get_tweet_tweetId_retweets
Sept. 17, 2026, 12:35 p.m.
Added
get_tweet_tweetId_favorites
Sept. 17, 2026, 12:35 p.m.
Added
get_tweet_tweetId
Sept. 17, 2026, 12:35 p.m.
Added
get_user_userId_followings_ids
Sept. 17, 2026, 12:35 p.m.
Added
get_user_userId_media
Sept. 17, 2026, 12:35 p.m.
Added
get_user_userId_followings
Sept. 17, 2026, 12:35 p.m.
Added
get_user_userId_followings_basic
Sept. 17, 2026, 12:35 p.m.
Added
get_user_userId_followers
Sept. 17, 2026, 12:35 p.m.
Added
get_user_userId_likes
Sept. 17, 2026, 12:35 p.m.
Added
get_user_userId_tweetsAndReplies
Sept. 17, 2026, 12:35 p.m.
Added
get_user_userId_tweets
Sept. 17, 2026, 12:35 p.m.
Added
get_user_by_username_username
Sept. 17, 2026, 12:35 p.m.
Added
get_user_userId
Sept. 17, 2026, 12:35 p.m.
Added
get_trends_locationId
Sept. 17, 2026, 12:35 p.m.
Added
get_search_searchTerm
Sept. 17, 2026, 12:35 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.