virtuals-tweepy-mcp

MCP server for X (Twitter) via Virtuals Protocol's GAME SDK. Provides 37 tools for AI agents to search tweets, post content, manage engagement, and more—with higher rate limits than standard Twitter API.

Quick Start

1. Get Credentials

1. Register at GAME Console

2. Create a project and get your API key

3. Run OAuth to get Twitter access token:

   uvx virtuals-tweepy-mcp auth
   

2. Add to Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "twitter": {
      "command": "uvx",
      "args": ["virtuals-tweepy-mcp"],
      "env": {
        "GAME_API_KEY": "your-api-key",
        "GAME_TWITTER_ACCESS_TOKEN": "apx-your-token"
      }
    }
  }
}

Restart Claude Desktop. You now have 37 Twitter tools available.

Available Tools

CLI Usage

The package also includes a CLI (vobs) for direct Twitter interaction:

# Install
uvx virtuals-tweepy-mcp

# Or with uv/pip
uv pip install virtuals-tweepy-mcp

# Commands
vobs me                              # Your profile
vobs search "bitcoin"                # Search tweets
vobs timeline elonmusk               # User's tweets
vobs user VitalikButerin             # User info
vobs mentions                        # Your mentions
vobs home                            # Home timeline
vobs post "Hello world!"             # Post tweet
vobs fetch <tweet-url>               # Fetch tweet with media URLs

Search Syntax

Supports Twitter's advanced operators:

vobs search "from:elonmusk crypto"           # Tweets by user
vobs search "#AI min_faves:100 lang:en"      # High-engagement
vobs search "(ETH OR BTC) -scam has:links"   # Complex queries

Rate Limits

• Tier 1: 50 calls / 5 minutes
• Tier 2: Higher limits (requires Virtuals approval)

License

MIT