The X (Twitter) MCP server
superagnt's X MCP server lets Claude, ChatGPT, Codex or Cursor search X and read posts, profiles, followers and replies with no X developer account, app or keys of yours.
X runs an official MCP server too, but it needs your own developer app and bills $0.005 for every post it reads. Here one search call returns up to 20 posts for $0.005. It only reads, and never posts, likes or follows.
Connect the X (Twitter) Data MCP server
Copy the setup prompt.
Your agent does the rest.
Connect the superagnt MCP server at https://mcp.superagnt.com/mcp/x to this agent for me (I'll sign in through my browser). The setup guide for each kind of agent is at https://www.superagnt.com/install?facet=x» a new workspace starts with the X (Twitter) Data tools already on. On an existing workspace, your agent switches them on during setup.
Can it post, or only read?
Public posts and replies, search by keyword with like, repost and reply floors and date ranges, profiles, a user's posts, media and likes, followers and following, lists, hashtags and trends.
Posts, replies, likes, reposts, follows or sends DMs, and no X login, developer app or key of yours is involved.
Does X (Twitter) have an MCP server?
Yes. Since June 30, 2026 X hosts one at api.x.com/mcp (X's docs). To connect it you create an app in X's Developer Portal with OAuth 2.0, register a localhost callback, put the client ID and secret in your client's config, run X's local bridge with Node, and enroll the account in pay-per-use billing. It reads posts, search, users, bookmarks and trends, and its only writes are bookmarks and Articles: there is no tool for ordinary posts.
| superagnt | X's official MCP server | |
|---|---|---|
| What you set up | One MCP URL, then sign in to superagnt | A developer app with OAuth 2.0, a localhost callback, client ID and secret, a local bridge, and pay-per-use enrollment |
| Price to read posts | $0.005 a search call of up to 20 posts: 394 posts cost $0.10 in our run | $0.005 per post read, $0.010 per user read (X's price list) |
| Free tier | a free trial with $3 of data credits and no card | None for new developers; up to $70 of one-time credits |
| Runs in | Claude, ChatGPT, Codex, Cursor and any remote MCP client | Clients that can start X's local bridge |
| Writes | None: read-only | Bookmarks and Articles; no ordinary posts |
X's MCP docs and price list checked November 3, 2026.
What does a real X search return?
Two real calls on superagnt's staging server, as the client received them, trimmed where noted.
“Find the most-liked posts about cold email, 100 likes and up, then get the next page.”
- 01Search with an engagement floor2.3 s wall time$0.005 at list price→ call
data_x_discover{ "action": "search", "query": "cold email", "min_likes": 100, "limit": 20, "section": "top" }← result| created_at | text | likes | views | | Oct 13 2026 | cracked the cold email game. works 8 out of 10 ... | 9048 | 3114941 | | Oct 24 2021 | One cold email can change your life. Here's how ... | 20763 | 0 | | Mar 27 2023 | Struggle to write cold emails that convert? I ... | 471 | 50927 | Next page: continuation_token DAACCgACHWNxQTPAJxAK...» Trimmed: to 3 of 20 posts, without post IDs, authors, reposts and replies, and each text cut.
- 02The next page, by its continuation token3.0 s wall time$0.005 at list price→ call
data_x_discover{ "action": "search", "query": "cold email", "min_likes": 100, "limit": 20, "section": "top", "continuation_token": "DAACCgACHWNxQTPAJxAK..." }← result| created_at | text | likes | views | | Apr 27 2022 | I have the SIMPLEST 14 cold email templates that ... | 799 | 0 | | Oct 15 2026 | cracked the cold email game. works 8 out of 10 ... | 350 | 106568 | | Oct 09 2026 | Who else needs the cold email course? ... | 202 | 21616 |» Trimmed: to 3 of the page's posts, the same way.
Two calls, 5.3 seconds, $0.01 at list price, no developer app. The same search over REST:
curl -s "https://api.superagnt.com/v1/data/x/search/search?query=cold+email&min_likes=100&limit=20§ion=top" -H "Authorization: Bearer <YOUR_AGNTDATA_API_KEY>"import requests
resp = requests.get(
"https://api.superagnt.com/v1/data/x/search/search",
headers={"Authorization": "Bearer <YOUR_AGNTDATA_API_KEY>"},
params={
"query": "cold email",
"min_likes": 100,
"limit": 20,
"section": "top",
},
)
data = resp.json()What does it cost to read X posts?
Ten searches on staging on November 3, 2026, two pages each, with a 20-like floor (queries like "claude code", "ai sdr", "meta ads" and "linkedin outreach"):
| Calls | Posts returned | Posts containing the query words | Wall time | Credits | Per post |
|---|---|---|---|---|---|
| 20 | 394 | 371 (94%) | 1 min 36 s | $0.10 | about $0.00025 |
One agent session, one call after another, at superagnt's list price. X's own API charges $0.005 per post read, 20 times as much.
An earlier research run of ours, on September 11, 2026, got the same rate: 31 searches returned 620 posts for about $0.16.
Which X tool do you need for the job?
| Job | Use | Why |
|---|---|---|
| Search, research and listening | This server | No keys, about $0.00025 a post, in any MCP client |
| Posting from your account | X's API with your own app, or an open-source server on your keys | Posting has to run as you; X charges $0.015 a post and $0.20 for a post with a link |
| Scheduling a content calendar | A scheduling tool | It queues posts on your account |
What breaks when you bring your own X keys?
Credentials, mostly. In the most-starred community X MCP server, 2 of its first 10 issues are credential errors (a 401 from search, fixed by regenerating the app and keys, and an invalid-configuration error for missing keys), and X's own open-source server has an open 403 for the wrong authentication type. With superagnt there is no X key, app or token to expire, so none of these can happen.
- Search returns too few posts: loosen the like floor or the date range.
- Search returns loose matches: X's search matches fuzzily, so 6% of the posts in our run didn't contain every query word; filter them after the call.
- Too many calls at once: the ceiling is your plan's rate limit, 60, 300 and 600 requests a minute on Starter, Growth and Scale.
Which tools does a new X (Twitter) Data server list?
data_x_usersaction: details · about · tweets · media · likes · followers · followingdata_x_postsaction: details · replies · favoritersdata_x_discoveraction: search · hashtag · geo_search · list_details · list_tweets · trends · trend_locationsdata_x_textaction: topics · detect_language
per-operation names47older servers list these
data_x_continuation_user_s_media_get_user_medias_continuationdata_x_continuation_user_s_media_post_user_medias_continuationdata_x_user_s_media_get_user_mediasdata_x_user_s_media_post_user_mediasdata_x_continuation_user_s_likes_get_user_likes_continuationdata_x_continuation_user_s_likes_post_user_likes_continuationdata_x_user_s_likes_get_user_likesdata_x_user_s_likes_post_user_likesdata_x_continuation_user_s_followers_get_user_followers_39ed2926data_x_continuation_user_s_followers_post_user_follower_9aa97da1data_x_user_s_followers_get_user_followersdata_x_user_s_followers_post_user_followersdata_x_user_s_following_continuation_get_user_following_657efcd9data_x_user_s_following_continuation_post_user_followin_13bcf780data_x_user_s_tweets_get_user_tweetsdata_x_user_s_tweets_post_user_tweetsdata_x_user_s_tweets_continuation_get_user_tweets_continuationdata_x_user_s_tweets_continuation_post_user_tweets_continuationdata_x_user_details_get_user_detailsdata_x_user_details_post_user_detailsdata_x_user_about_get_user_aboutdata_x_tweet_replies_continuation_get_tweet_replies_continuationdata_x_tweet_replies_continuation_post_tweet_replies_co_01fc069ddata_x_tweet_user_favoriters_continuation_get_tweet_fav_38b0802adata_x_tweet_details_get_tweet_detailsdata_x_tweet_details_post_tweet_detailsdata_x_tweet_user_favoriters_get_tweet_favoritersdata_x_tweet_replies_get_tweet_repliesdata_x_tweet_replies_post_tweet_repliesdata_x_user_s_following_get_user_followingdata_x_user_s_following_post_user_followingdata_x_lists_tweets_continuation_get_lists_tweets_continuationdata_x_search_continuation_get_search_search_continuationdata_x_search_continuation_post_search_search_continuationdata_x_topic_classification_get_ai_topic_classificationdata_x_detect_post_translate_detectdata_x_available_locations_beta_get_trends_availabledata_x_get_trends_near_a_location_beta_get_trendsdata_x_geo_search_beta_get_search_geodata_x_lists_tweets_get_lists_tweetsdata_x_lists_details_get_lists_detailsdata_x_search_get_search_searchdata_x_search_post_search_searchdata_x_hashtag_get_hashtag_hashtagdata_x_hashtag_post_hashtag_hashtagdata_x_hashtag_continuation_get_hashtag_hashtag_continuationdata_x_hashtag_continuation_post_hashtag_hashtag_continuationEvery tool reads; none writes. Use cases and the full field list are on /tools/x.
What does a call cost?
- Any X call: search, post, user, followers or trends
- $0.005 per successful call
The two-call run costs $0.01 at list price, and 394 posts cost $0.10. A failed call costs nothing. Plans and credits
Questions people ask
01Does Twitter (X) have an MCP server?
Yes. X hosts one at api.x.com/mcp since June 30, 2026, but you need your own developer app with OAuth 2.0, a client ID and secret, a local bridge and pay-per-use billing, and it reads at $0.005 a post. superagnt's X server needs none of that.
02Can I get the Twitter API for free?
Not as a new developer: X moved to pay-per-use on February 6, 2026, with one-time credits of up to $70. superagnt starts with a free trial with $3 of data credits and no card.
03Do I need an X developer account and keys?
Not with superagnt. You connect one URL and sign in to superagnt. X's own MCP server and most open-source ones need your developer app and keys.
04Can it post, or only read?
Only read. It never posts, replies, likes, reposts or follows. To post from your account you need X's API with your own app ($0.015 a post, $0.20 with a link) or a scheduling tool.
05Can I get posts from my follow list?
Yes: ask for an account's following list, then each account's latest posts. The server reads any public account's followers and following.
06Can Claude search Twitter?
Not on its own: Claude has no X search tool. With this server connected it searches X by keyword with like and date filters and reads profiles and threads.
07What does it cost?
Each successful call is billed from one credit balance: a search of up to 20 posts is $0.005. New accounts get a free trial with $3 of data credits and no card; plans start at $49 a month.
Connect once and the first call works before you have opened a dashboard.