MCP server · 8 tools · 7 endpoints

X/Twitter MCP server

Tweet stats for 1 credit, profiles, keyword search and transcripts of the video in a post, all from inside Claude or Cursor.

Get a free key Connect in a minute

100 credits on signup · No card · Sign in with OAuth or paste a key

scrapersocial-twitter mcp.scrapersocial.com/twitterconnected

you

Give me the engagement numbers for <tweet-url>.

agent

calls get_post_stats 1 credit / tweet

{ "url": "<X/Twitter tweet url>" }

server

returns

views number likes number comments number shares number reposts number

Shape only. Keys follow the tool's summary; a real call returns the full record. 1 call · 1 credit

Connect

One URL. Your client already knows what to do with it.

The first call opens a sign-in. New accounts get 100 credits, no card. Every client below shares one account and one balance.

Get a free key

server url https://mcp.scrapersocial.com/twitter

claude.aiOAuth

Settings → Connectors → Add custom connector, then paste the server URL.

mcp.scrapersocial.com/twitter

Web, desktop and mobile. Nothing else to paste.

Claude Codeone command

Run this in a terminal.

$ claude mcp add --transport http scrapersocial-twitter https://mcp.scrapersocial.com/twitter

Approve the sign-in prompt on first use.

Cursorone click

Installs the server and opens the MCP panel.

Add to Cursor

or paste the JSON into .cursor/mcp.json

{
  "mcpServers": {
    "scrapersocial-twitter": {
      "url": "https://mcp.scrapersocial.com/twitter",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

Other clients · VS Code, Windsurf, Gemini CLI, anything that speaks MCP

VS Codeone click or JSON

Add to VS Codeor run MCP: Add Server, choose HTTP and use:

{
  "name": "scrapersocial-twitter",
  "type": "http",
  "url": "https://mcp.scrapersocial.com/twitter"
}

Windsurf~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "scrapersocial-twitter": {
      "serverUrl": "https://mcp.scrapersocial.com/twitter",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

Gemini CLI~/.gemini/settings.json

{
  "mcpServers": {
    "scrapersocial-twitter": {
      "httpUrl": "https://mcp.scrapersocial.com/twitter",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

Any clientStreamable HTTP · OAuth 2.1 or Bearer

$ npx add-mcp https://mcp.scrapersocial.com/twitter

One account and one balance across every client and the every-platform hub at mcp.scrapersocial.com.

What it does

What your agent can do with X/Twitter

A post is going around, it has a two-minute video attached, and someone on your team asks what he actually says in it. Paste the link into Claude with this server connected and get_transcript returns the spoken words for 7 credits. Ask for the gist instead and get_summary answers for 9. Want the engagement? get_post_stats is 1 credit.

Those are the three per-post tools. The other three work from a handle or a query. get_profile returns an account’s public record, follower count and bio for 5 credits. get_channel_posts pulls an account’s latest tweets, each with its metrics, at 1 credit apiece. search runs a keyword search across public posts at 2 per result. The seventh live endpoint, the tweets in a curated list, is reachable through call_endpoint at 1 per tweet, and list_endpoints will show it to you for nothing.

Pricing on X’s own API pushed a lot of ordinary read-only use off the platform. At 1 credit for stats or a tweet, with 1,000 credits for $5, the arithmetic for monitoring an account or a keyword looks different. There’s no streaming, though: each call is a point-in-time query, and your agent decides when to make it. For an hourly check on a few handles that’s a handful of credits a day.

Four jobs it finishes on its own

Keep a watch list of accounts

On a schedule, the agent runs get_channel_posts per handle, keeps what's new, and writes a digest. At 1 credit per tweet the daily cost for twenty accounts is small enough not to think about.

Quote a video accurately

Video posts travel faster than the words in them. get_transcript gives your agent the actual speech so it can quote, verify or summarise rather than guess from the caption.

Monitor a keyword or a brand name

search returns public posts for a query at 2 credits each. Run it a few times a day, dedupe on tweet id, and you have mention tracking without a social-listening subscription.

Benchmark engagement across posts

Give the agent a list of tweet URLs and it calls get_post_stats on each for 1 credit. Views, likes, reposts and replies where X publishes them, ready to drop into a sheet.

Limits · read before you connect

What this does not do

Written by a person, not generated. If something here is wrong, tell us.

Public posts and public accounts only. Protected accounts, deleted tweets and anything requiring a session show up as not found, which costs you nothing. Reply threads can’t be walked: the catalog lists a replies endpoint, but it’s unavailable, so there’s no comments tool here. Transcripts need a post with a video in it; a post without speech returns an empty transcript. Timelines, search and list tweets page at 50 items and bill per item, with a 1-credit minimum per successful call. Nothing here posts, replies, likes or sends DMs.

Tools

8 tools, same names as the every-platform hub

Six do one X/Twitter thing each. The last two reach all 7 endpoints by path, so nothing in the catalog is out of an agent's reach.

Full credit table →

Get a video transcript

get_transcript

Spoken-word transcript of a public video, with timestamped segments where the source publishes them.

7 credits / video

Summarise a video

get_summary

Short LLM summary of what a public video actually says, built on its transcript.

9 credits / video

Get post engagement stats

get_post_stats

Engagement stats for one public post or video: views, likes, comments, shares and reposts where the platform publishes them.

1 credit / tweet

Get an account profile

get_profile

Profile, page or channel record for a public account: follower and subscriber counts, bio, and totals.

5 credits / lookup

List an account's posts

get_channel_posts

Recent public posts or videos from one account, with per-item metrics.

1 credit / tweet

Search a platform

search

Keyword search over one platform's public content.

2 credits / result

Reaches the other 1 endpoint

List every X/Twitter endpoint

list_endpoints

Browse every X/Twitter endpoint, its input and its credit cost. Free, and calls nothing upstream.

free

Call any X/Twitter endpoint by path

call_endpoint

Run any X/Twitter endpoint by its path, so nothing X/Twitter offers is out of reach of an agent.

endpoint's own cost

Pricing

100 free credits is 14 transcripts, or 20 profile reads, or 100 posts.

Then $5 a month for 1,000 credits, or $4 per 1,000 as a top-up. No card to start. Calls cost between 1 and 9 credits on X/Twitter.

14 transcriptsget_transcript · 7 each

20 profile readsget_profile · 5 each

100 postsget_channel_posts · 1 each

Get a free key 100 credits on signup · $5 for 1,000 · full credit table

Prompts

Things to ask once it is connected

Copy one, swap the placeholder, paste it into your client.

Give me the engagement numbers for <tweet-url>.

Transcribe the video in <tweet-url> and give me the three main points.

Show me the last 50 tweets from <@handle> and tell me which got the most reposts.

Search X for "<brand name>" and summarise the sentiment of the first 30 results.

Tell me about <@handle>: follower count, bio, and what they mostly post about.

Pull the latest tweets from the list at <list-url> into a bullet digest.

Questions

Before you connect

Do I need an X developer account or a login? #

No. The server authenticates with your ScraperSocial key and reads what X shows a logged-out visitor. No X credentials are involved.

Why was one call 7 credits and another 1? #

The 7 was get_transcript, which processes the video. Stats and tweets are 1 each, search is 2, a profile is 5, a summary is 9.

Is this X's official API? #

It's not. ScraperSocial is independent of X Corp and isn't a partner or reseller. X's own API is the sanctioned route and the only one that lets you post.

Can it read protected accounts? #

No. A protected account gives you not found, with nothing deducted.

Can I get the replies to a tweet? #

Not at the moment. The replies endpoint is listed but turned off, which is why the X spoke has no comments tool.

Does it work for x.com and twitter.com links? #

Both resolve to the same post. Hand the agent whichever URL you have.

Go further

For reading X rather than writing to it, the numbers here are hard to argue with: a credit per tweet, 100 of them free when you sign up, and 1,000 for $5 after that. Hook it up to Claude or Cursor and ask about the next post that crosses your feed.

Get a free key 100 credits, no card

ScraperSocial is independent and not affiliated with, endorsed by or connected to X/Twitter. Publicly available data only.