scrape-badger/scrapebadger-mcp

Give your AI agents access to Twitter/X data via the Model Context Protocol
---
What is this?
ScrapeBadger MCP Server is a Model Context Protocol (MCP) server that enables AI assistants like **Claude**, **ChatGPT**, **Cursor**, **Windsurf**, and other MCP-compatible clients to access Twitter/X data through the ScrapeBadger API.
**With this MCP server, your AI can:**
- Get Twitter user profiles, followers, and following lists
- Search and retrieve tweets
- Access trending topics globally or by location
- Explore Twitter lists and communities
- Search for places and geolocated content
Quick Start
1. Get Your API Key
Sign up at scrapebadger.com and get your API key.
2. Install
3. Configure Your AI Client
Claude Desktop
Add to your Claude Desktop configuration file:
**macOS:** ~/Library/Application Support/Claude/claude_desktop_config.json
**Windows:** %APPDATA%\Claude\claude_desktop_config.json
Cursor
Add to your Cursor MCP settings (.cursor/mcp.json):
Windsurf
Add to your Windsurf MCP configuration:
VS Code with Copilot
Add to your VS Code settings (.vscode/mcp.json):
4. Start Using It!
Once configured, simply ask your AI to fetch Twitter data:
> "Get the profile of @elonmusk"
> "Search for tweets about AI agents"
> "What's trending on Twitter right now?"
> "Find the top 10 Python developers on Twitter"
---
Available Tools
The MCP server provides 17 tools organized into categories:
User Tools
| Tool | Description |
|------|-------------|
| 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 |
Tweet Tools
| Tool | Description |
|------|-------------|
| 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) |
Trend Tools
| Tool | Description |
|------|-------------|
| get_twitter_trends | Get global trending topics (optionally by category) |
| get_twitter_place_trends | Get trends for a specific location (by WOEID) |
Geo Tools
| Tool | Description |
|------|-------------|
| search_twitter_places | Search for Twitter places by name |
List Tools
| Tool | Description |
|------|-------------|
| get_twitter_list_detail | Get details about a Twitter list |
| search_twitter_lists | Search for Twitter lists |
| get_twitter_list_tweets | Get tweets from a list |
Community Tools
| Tool | Description |
|------|-------------|
| get_twitter_community_detail | Get details about a Twitter community |
| search_twitter_communities | Search for communities |
---
Example Conversations
Research a Twitter Account
**You:** Get the profile and recent tweets from @sama
**Claude:** I'll fetch Sam Altman's Twitter profile and recent tweets.
*Uses get_twitter_user_profile and get_twitter_user_tweets*
Monitor Trending Topics
**You:** What's trending in tech on Twitter today?