ScrapeBadger

ScrapeBadger MCP Server lets you connect your AI agents to Twitter/X data by exposing ScrapeBadger’s API through the Model Context Protocol. You can ask your AI to fetch user profiles, tweets, trends, places, lists, and more, enabling richer, data-informed conversations.

How to use

You will use an MCP client to connect to the ScrapeBadger MCP Server. After you configure the client with the MCP server, your AI can request Twitter/X data through the available tools. Typical workflows include fetching a user profile, retrieving recent tweets from a user, searching for tweets, and checking global or location-specific trends. Use natural language prompts like fetch the profile for @elonmusk, show recent tweets from @OpenAI, or what are the current Twitter trends.

How to install

Prerequisites: Python or a runtime that can run the MCP server, and a running MCP client that can consume MCP endpoints. You will also need an API key from ScrapeBadger.

Step by step commands to install and run the MCP server via common installation methods are shown below.

# Using uvx (recommended - no installation needed)
uvx scrapebadger-mcp

# Or install globally with pip
pip install scrapebadger-mcp

# Or with uv
uv tool install scrapebadger-mcp

Additional configuration and usage notes

Set your ScrapeBadger API key in your MCP client configuration and start the MCP server as shown in the examples. The key must be supplied to authorize requests from your AI client.

Configuration options

Environment variable required by the server: SCRAPEBADGER_API_KEY.

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

Troubleshooting

If you encounter an issue, verify your API key is set correctly in the MCP client configuration, ensure the MCP server command and arguments are correct, and confirm network access between the client and the server. See the specific error messages for authentication, rate limits, or not found issues and adjust your configuration accordingly.

Tools and capabilities overview

The server exposes 17 tools organized into categories that enable you to access Twitter/X data in a structured way. You can retrieve user profiles, search for users and tweets, obtain followers and following lists, explore trends and places, and interact with lists and communities.

Available tools

get_twitter_user_profile

Fetch a user's Twitter/X profile details, including bio, follower/following counts, and basic profile metadata.

get_twitter_user_about

Retrieve extended account information such as location, username history, and About data.

search_twitter_users

Search for Twitter/X users matching a query string.

get_twitter_followers

Obtain the list of followers for a given user.

get_twitter_following

Obtain the list of accounts followed by a given user.

get_twitter_tweet

Retrieve a single tweet by its ID.

get_twitter_user_tweets

Fetch recent tweets from a specified user.

search_twitter_tweets

Search tweets using queries and operators.

get_twitter_trends

Get global trending topics, optionally filtered by category.

get_twitter_place_trends

Get trends for a specific location identified by WOEID.

search_twitter_places

Search for Twitter places by name.

get_twitter_list_detail

Get details about a specific Twitter list.

search_twitter_lists

Search for Twitter lists by query.

get_twitter_list_tweets

Get tweets from a specific Twitter list.

get_twitter_community_detail

Get details about a Twitter community.

search_twitter_communities

Search for Twitter communities by query.