Scrapebadger MCP Server

<strong>Give your AI agents access to Twitter/X data via the Model Context Protocol</strong>

Local serverstdioPython

What is the Scrapebadger MCP MCP server?

Give your AI agents access to Twitter/X data via the Model Context Protocol. Exposed over MCP by the scrapebadger mcp mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

Its toolset

Everything the assistant can do here goes through one of these:

  • get_twitter_user_profile — Get a user's profile by username (bio, followers, following, etc.)
  • get_twitter_user_about — Get extended "About" info (account location, username history)
  • search_twitter_users — Search for users by query
  • get_twitter_followers — Get a user's followers
  • get_twitter_following — Get accounts a user follows
  • get_twitter_tweet — Get a single tweet by ID
  • get_twitter_user_tweets — Get recent tweets from a user
  • search_twitter_tweets — Search for tweets (supports Twitter search operators)
  • get_twitter_trends — Get global trending topics (optionally by category)
  • get_twitter_place_trends — Get trends for a specific location (by WOEID)
  • search_twitter_places — Search for Twitter places by name
  • get_twitter_list_detail — Get details about a Twitter list

Adding it to your client

Installation goes through your MCP client rather than a global install: point it at scrapebadger-mcp on PyPI and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

Configuration

You will need one environment variable: SCRAPEBADGER_API_KEY. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

When to reach for it

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Scrapebadger MCP's toolset — get_twitter_user_profile, get_twitter_user_about, search_twitter_users and 11 more — is a fair guide to whether it matches your workflow. It is maintained by scrape-badger; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Scrapebadger MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Scrapebadger MCP.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the scrapebadger mcp mcp server does with a few real requests.

Available tools

ToolWhat it does
get_twitter_user_profileGet a user's profile by username (bio, followers, following, etc.)
get_twitter_user_aboutGet extended "About" info (account location, username history)
search_twitter_usersSearch for users by query
get_twitter_followersGet a user's followers
get_twitter_followingGet accounts a user follows
get_twitter_tweetGet a single tweet by ID
get_twitter_user_tweetsGet recent tweets from a user
search_twitter_tweetsSearch for tweets (supports Twitter search operators)
get_twitter_trendsGet global trending topics (optionally by category)
get_twitter_place_trendsGet trends for a specific location (by WOEID)
search_twitter_placesSearch for Twitter places by name
get_twitter_list_detailGet details about a Twitter list
search_twitter_listsSearch for Twitter lists
get_twitter_list_tweetsGet tweets from a list

How to install the Scrapebadger MCP MCP server

{
  "mcpServers": {
    "scrapebadger": {
      "command": "uvx",
      "args": ["scrapebadger-mcp"],
      "env": {
        "SCRAPEBADGER_API_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
SCRAPEBADGER_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Scrapebadger MCP to get twitter user profile.
  • Use Scrapebadger MCP to get twitter user about.
  • Use Scrapebadger MCP to search twitter users.

Frequently asked questions

It connects Scrapebadger MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (get_twitter_user_profile, get_twitter_user_about, search_twitter_users, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Scrapebadger MCP directly.