🔌 MCP Server Documentation

🤖 What is MCP?

Model Context Protocol (MCP) is an open standard that allows AI assistants like Claude, GPT, and Cursor to connect to external tools. XActions provides a full MCP server for X/Twitter automation.

⚡ Quick Start

npm install -g xactions
xactions mcp start

Or add to Claude Desktop's claude_desktop_config.json:

{
  "mcpServers": {
    "xactions": {
      "command": "npx",
      "args": ["xactions", "mcp"]
    }
  }
}

🛠ī¸ Available Tools

unfollow_non_followers

Mass unfollow accounts that don't follow back

detect_unfollowers

Find who unfollowed you recently

get_followers

Retrieve list of followers for any account

get_following

Get list of accounts someone follows

unfollow_user

Unfollow a specific user by username

monitor_account

Track changes to any public account

search_tweets

Search tweets by keyword or hashtag

scrape_profile

Get public profile data for any user

🆓 Local vs đŸ’ŗ Remote Mode

MCP server supports two modes:

Local Mode (Free)

Runs Puppeteer on your machine. Free forever, but requires browser automation setup.

Remote Mode (Paid)

Uses hosted API with x402 micropayments. Fast, reliable, pay-per-request. Learn more →

🔧 Configuration

{
  "sessionCookie": "your_x_session_cookie",
  "rateLimit": 100,
  "delay": 2000,
  "dryRun": false
}

đŸ’Ŧ Usage with Claude

Once configured, just ask Claude:

  • "Unfollow everyone who doesn't follow me back"
  • "Who unfollowed me this week?"
  • "Get the follower list for @elonmusk"
  • "Monitor @nichxbt for new followers"

🧠 Usage with GPT

Create a Custom GPT with XActions API access or use function calling with the REST endpoints.

📊 Rate Limits

  • Default: 100 actions/hour
  • Built-in delays to avoid detection
  • Configurable rate limiting

🔗 REST API

GET  /api/followers/:username
GET  /api/following/:username
POST /api/unfollow
POST /api/detect-unfollowers
GET  /api/profile/:username