Twitter/X API & scraper
MCP server, 250x cheaper
Give Claude Code, Cursor, Codex, Grok or Hermes 40 read-only tools that scrape public X data, with no browser and no X login. One line to connect, one Sorsa API key, no X developer app, and tweets from $0.014 per 1,000 instead of $5.00 on the official X MCP.
No credit card, and they never expire.
Add it to your agent in one line.
Pick your agent, copy its line and put your key in place of YOUR_API_KEY.
claude mcp add sorsa --scope user -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcpRun it once. --scope user makes Sorsa API available in every project. Check with claude mcp get sorsa.
Everything your agent can read on X.
Ask in plain words and your agent picks the tool. One call is one request; batch tools bring back 100 at once.
- 3
Search
Posts by keyword and X operators back to 2006, mentions and accounts.
- 7
Posts
Any post or 100 at once, its replies, quotes and reposters, X Articles and trends.
- 4
Accounts
Profiles, 100 at once, About this account, and their posts.
- 3
Audience
Followers and following, 200 a page, and verified followers.
- 5
Checks
Did they follow, repost, quote or reply? Are they in a Community?
- 7
Lists, Communities, Spaces
Members and feeds of Lists and Communities, and Spaces with their speakers.
- 4
Utilities
Handles, IDs and links converted, and the requests left on your key.
- +7
Sorsa Score
Crypto accounts scored by who follows them. Off unless you turn it on.
Not in the box: posting, replies, likes, reposts, follows and DMs.
Every tool by name
Searchsearch_tweets search_users search_mentions
Postsget_tweet_info get_tweet_info_bulk get_tweet_comments get_tweet_quotes get_retweeters get_article get_trends
Accountsget_user_info get_user_info_batch get_account_about get_user_tweets
Audienceget_followers get_following get_verified_followers
Checkscheck_follow check_retweet check_quoted check_comment check_community_member
Lists, Communities, Spacesget_list_members get_list_tweets get_list_followers get_community_members get_community_tweets search_community_tweets get_space_info
Utilitiesusername_to_id id_to_username link_to_id get_key_usage_info
Sorsa Scoreget_sorsa_score get_sorsa_score_changes get_followers_stats get_top_followers get_top_following get_new_followers_7d get_new_following_7d
Full reference in the docs.
One key instead of an X developer app.
The official X MCP runs on your own X developer app and bills every read at X’s rates. Sorsa MCP takes one key, reads public data only and costs a fraction.
Official X MCP: before your first call
- Create an X developer app.
- Turn on OAuth 2.0 and register a callback address.
- Copy its client ID and secret into your config.
- Move the app to the Pay-per-use package.
- Run the xurl bridge and sign in with X in a browser.
- Give your client a 300-second start timeout.
Sorsa MCP: before your first call
- Get a key: 100 free requests, no card.
- Add one line to your agent.
The X MCP acts with your X account’s permissions. Sorsa MCP can’t write to X at all.
Followers cost $10.00 per 1,000 on the official X MCP and from $0.007 on Sorsa API, and a follow or repost check is one call from $0.0014, a tool the X MCP doesn’t have.
The Twitter/X MCP server your agent can’t break.
It runs on your computer and only reads. Your key stays in your own config, and X never learns who is asking.
- 0tools that post, like, follow or DM
- 1address it calls: api.sorsa.io
- 0X logins, cookies or developer apps
const BASE_URL = process.env.SORSA_BASE_URL ?? "https://api.sorsa.io/v3";One address: Sorsa API.const API_KEY = process.env.SORSA_API_KEY;Your key, read from your own config.Sorsa API has run in production since 2022 (formerly TweetScout API), with 99.9% uptime guaranteed in our terms on every paid plan. How we run it in production: trust page
•••• •••• •••• 7f3aReady after sign-upMCP questions, answered.
npx -y sorsa-mcp, takes one Sorsa API key, and works in Claude Code, Cursor, Codex, Grok, Hermes Agent and any app that runs local MCP servers.npx, and an AI app that runs local MCP servers. Nothing to clone or build: your app downloads and starts the server itself.get_key_usage_info and answers with a number. In Claude Code, claude mcp get sorsa also shows the server.sorsa-mcp@latest in the line; to stay on one release, write its number, for example sorsa-mcp@1.0.4.Twitter/X API & scraper
MCP server, 250x cheaper
40 read-only tools for your agent. One line, one key, tweets from $0.014 per 1,000.
Add it to your agent in one line.
Copy the line for your agent and add your key.
claude mcp add sorsa --scope user -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcpRun it once. --scope user makes Sorsa API available in every project. Check with claude mcp get sorsa.
Everything your agent can read on X.
One call is one request. Batch tools bring back 100 at once.
Not in the box: posting, replies, likes, reposts, follows and DMs.
One key instead of an X developer app.
Followers cost $10.00 per 1,000 on the official X MCP and from $0.007 on Sorsa API, and a follow or repost check is one call from $0.0014, a tool the X MCP doesn’t have.
- Create an X developer app.
- Turn on OAuth 2.0 and register a callback address.
- Copy its client ID and secret into your config.
- Move the app to the Pay-per-use package.
- Run the xurl bridge and sign in with X in a browser.
- Give your client a 300-second start timeout.
The Twitter/X MCP server your agent can’t break.
- 0tools that post, like, follow or DM
- 1address it calls: api.sorsa.io
- 0X logins, cookies or developer apps
sorsa-mcp/src/index.tsRead it on GitHub7const BASE_URL = process.env.SORSA_BASE_URL ?? "https://api.sorsa.io/v3";One address: Sorsa API.8const API_KEY = process.env.SORSA_API_KEY;Your key, read from your own config.
Sorsa API has run in production since 2022 (formerly TweetScout API), with 99.9% uptime guaranteed in our terms on every paid plan. How we run it in production: trust page
Up to 10K tweets or 20K profiles.
•••• •••• •••• 7f3aReady after sign-upMCP questions, answered.
What you need
- An AI app that runs local MCP servers: Claude Code, Cursor, Codex, Grok, Hermes Agent, Claude Desktop, VS Code, Gemini CLI or OpenClaw.
- Node.js 18 or newer. Check with
node -v. - A Sorsa API key: 100 free requests, no credit card. You can install first and add the key later.
Check it works
Ask your agent:
“How many Sorsa API requests do I have left?”
get_key_usage_info9,842 requests left this monthIf you see a number, you’re connected.
You’ll also see:
claude mcp get sorsa shows the server; /mcp lists sorsa with its tools.
Customize lists sorsa with its tools, switched on.
/mcp lists sorsa.
grok mcp doctor sorsa reports the server started and its tools.
The Bot lists the server’s tools.
After /reload-mcp, the agent can call sorsa tools.
After the restart, sorsa’s tools are in the + menu, under Connectors.
MCP: List Servers shows sorsa.
/mcp lists sorsa.
openclaw mcp doctor sorsa --probe reports the server and its tools.
Each agent lists sorsa among its MCP servers.
Your app lists sorsa with its tools.
Not working?
“npx: command not found”, or the server never starts.
Install Node.js 18 or newer from nodejs.org, then restart your AI app.
Claude Code says “Invalid environment variable format”.
Put the server name before -e, as in the line above.
The server is added but no tools show up.
Restart the app (Claude Desktop: quit it fully), run /reload-mcp in Hermes, or switch sorsa on in Cursor’s Customize.
It times out the first time.
The first start downloads the package. Try again, or raise the start timeout (startup_timeout_sec = 30 in Codex).
Every call says “invalid api key” or “missing key”.
Paste the key from your dashboard into SORSA_API_KEY without spaces, and restart.
Calls stop with a 403 after a while.
Your requests ran out. Upgrade the plan or switch on pay as you go: the same key keeps working at once.
Your agent pages through followers for too long.
Say how many you need (“the newest 1,000”). Each page is one request.
Claude.ai, ChatGPT and grok.com
Claude.ai, ChatGPT and grok.com connect to servers by URL, so they can’t start this one. Use Claude Desktop or Claude Code with the same key.
Search 3 tools
search_tweetsPosts that match X search operators, back to 2006about 20 postssearch_usersAccounts that match a word or phrasea page of accountssearch_mentionsPosts that mention an account, with likes, replies and date filtersabout 20 posts
Posts 7 tools
get_tweet_infoOne post with its metrics and author1 postget_tweet_info_bulkUp to 100 posts by ID or link100 postsget_tweet_commentsReplies to a post, by relevance, recency or likesabout 20 repliesget_tweet_quotesQuote posts of a postabout 20 postsget_retweetersAccounts that reposted a posta page of accountsget_articleAn X Article in full1 Articleget_trendsTrending topics for a place1 list
Accounts 4 tools
get_user_infoA profile: bio, counts, verification1 profileget_user_info_batchUp to 100 profiles at once100 profilesget_account_aboutCountry, username changes and other About data1 accountget_user_tweetsAn account’s postsabout 20 posts
Audience 3 tools
get_followersFollowers of an account200 profilesget_followingAccounts it follows200 profilesget_verified_followersIts verified followersa page of profiles
Checks 5 tools
check_followDoes one account follow anotheryes or nocheck_retweetDid an account repost a post100 reposts checkedcheck_quotedDid an account quote or repost a postyes or nocheck_commentDid an account reply to a postyes or no, with the replycheck_community_memberIs an account in a Communityyes or no
Lists, Communities, Spaces 7 tools
get_list_membersA List’s members, its feed, its followersa page each
get_list_tweets
get_list_followersget_community_membersA Community’s members, posts and searcha page each
get_community_tweets
search_community_tweetsget_space_infoA Space: title, state, hosts and speakers1 Space
Utilities 4 tools
username_to_idHandles, IDs and links converted1 answer
id_to_username
link_to_idget_key_usage_infoRequests left on your key and the plan’s end date1 answer
Sorsa Score 7 tools
Crypto accounts scored by who follows them. Off unless you turn it on.
get_sorsa_scoreget_sorsa_score_changesget_followers_statsget_top_followersget_top_followingget_new_followers_7dget_new_following_7d
More questions
What is the Sorsa MCP server?
An MCP server that gives AI agents 40 read-only tools for public X (Twitter) data: search back to 2006, profiles, followers, posts, replies, quotes, Lists, Communities, Spaces, trends, and follow, repost, quote and comment checks. It runs on your computer with npx -y sorsa-mcp, takes one Sorsa API key, and works in Claude Code, Cursor, Codex, Grok, Hermes Agent and any app that runs local MCP servers.
Which AI apps does it work with?
Any app that runs local MCP servers: Claude Code, Cursor, Codex, Grok Build, Grok Bot, Hermes Agent, Claude Desktop, VS Code, Gemini CLI and OpenClaw, each with the line above. Claude.ai, ChatGPT and grok.com only connect to servers by URL, so use Claude Desktop or Claude Code there.
Do I need an X developer account, OAuth or my X login?
No. One Sorsa API key is all it takes: no X developer app, no OAuth, no approval. Sorsa API never asks for your X login or cookies.
What does it cost?
One tool call is one request on your plan, and batch tools return up to 100 posts or profiles in that call. Tweets cost from $0.014 per 1,000, 250x less than on the official X MCP, followers from $0.007 and a check from $0.0014. Every account starts with 100 free requests.
Can my agent post, like, follow or DM through it?
No, and that’s the point. Sorsa API is read-only by design: none of the Sorsa API endpoints writes to X, so no tool can, whatever your agent is told.
What do I need installed?
Node.js 18 or newer for npx, and an AI app that runs local MCP servers. Nothing to clone or build: your app downloads and starts the server itself.
How do I know it’s working?
Ask your agent how many Sorsa API requests you have left. It calls get_key_usage_info and answers with a number. In Claude Code, claude mcp get sorsa also shows the server.
Can I use it in Claude.ai or ChatGPT?
Not by URL yet: Claude.ai and ChatGPT add servers by URL, and Sorsa MCP runs on your computer. Claude Desktop runs it with the same key, and so do Claude Code and the other apps above.
How is it different from the official X MCP?
The official X MCP needs your own X developer app, OAuth and a local bridge, bills every read at X’s rates ($5.00 per 1,000 posts) and acts with your X account’s permissions. Sorsa MCP runs on one Sorsa API key, reads public data only, costs from $0.014 per 1,000 posts, 250x less, and adds one-call follow and repost checks the X MCP doesn’t have.
How does it compare with TwitterAPI.io’s MCP server?
Sorsa MCP has 40 read-only tools against 12, including follow, repost, quote, comment and Community checks, plus Lists, Communities and Spaces. Tweets cost from $0.014 per 1,000 against $0.15, and Sorsa API has no write endpoints at all, so the key you give an agent can never post.
Will 40 tools crowd my agent’s context?
No. Claude Code loads only the tool names until one is needed, Codex and Hermes Agent let you list just the tools you want, and the Sorsa Score tools for crypto accounts stay off unless you turn them on. Results come back compact, so a page of posts costs your agent a few thousand tokens. Results come back compact, so a page of posts costs your agent a few thousand tokens.
What happens when my requests run out?
Calls stop until you add more: upgrade your plan, or switch on pay as you go, up to the monthly limit you set. The same key keeps working, and failed requests are never charged.
How do I update it?
Your app starts the server through npx, which can keep a copy it downloaded before. To get the newest release, write sorsa-mcp@latest in the line; to stay on one release, write its number, for example sorsa-mcp@1.0.4.
Is it open source?
Yes. The server is MIT-licensed on GitHub (Sorsa-io/sorsa-mcp) and published on npm as sorsa-mcp. It calls only https://api.sorsa.io/v3.
Can I try it for free?
Yes. Every new account gets 100 free requests, up to 10K tweets or 20K profiles through batch tools, with no credit card, and they never expire. They work with every tool.