AI & Developer

🤖 MCP Server - AI Agent Integration

Integrate X/Twitter automation directly with AI assistants like Claude using the Model Context Protocol.

🧠 What It Is

Model Context Protocol (MCP) is a cutting-edge standard that enables AI assistants to interact with external tools and services. XActions includes a fully-featured MCP server that exposes X/Twitter automation capabilities directly to AI agents.

This means you can:

Ask Claude to analyze your Twitter followers
Have AI find accounts that don't follow you back
Let AI search and analyze tweets on any topic
Automate posting, following, and engagement through natural language

The future of social media automation is conversational.

🚀 Cutting-Edge Technology

MCP is the protocol powering the next generation of AI agent integrations.
XActions is one of the first open-source tools to offer full MCP support for X/Twitter.

📋 Prerequisites

Before using the MCP server:

✅ Node.js 18+ installed
✅ XActions package installed (npm install xactions)
✅ Claude Desktop app (for Claude integration)
✅ Your X/Twitter auth_token cookie (for authenticated operations)

🔧 Setup for Claude Desktop

To connect XActions with Claude Desktop, add the following to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Configuration

{
  "mcpServers": {
    "xactions": {
      "command": "node",
      "args": ["/path/to/your/node_modules/xactions/src/mcp/server.js"],
      "env": {}
    }
  }
}

Or if you cloned the repository:

{
  "mcpServers": {
    "xactions": {
      "command": "node",
      "args": ["/path/to/xactions/src/mcp/server.js"],
      "env": {}
    }
  }
}

Using npx (easiest):

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

After saving, restart Claude Desktop to load the MCP server.

🛠️ Available Tools

The XActions MCP server exposes 12 powerful tools for X/Twitter automation:

🔐 Authentication

Tool	Description
`x_login`	Login to X/Twitter using a session cookie (`auth_token`). Required before authenticated operations.

📊 Data Scraping

Tool	Description
`x_get_profile`	Get profile information for any user including bio, follower count, location, website, and join date.
`x_get_followers`	Scrape followers for an account. Returns usernames, display names, and bios.
`x_get_following`	Scrape accounts a user follows. Includes whether they follow back.
`x_get_non_followers`	Find accounts you follow that don't follow you back.
`x_get_tweets`	Scrape recent tweets from any user's profile with engagement stats.
`x_search_tweets`	Search for tweets matching any query. Supports advanced operators.

⚡ Actions

Tool	Description
`x_follow`	Follow an X/Twitter user.
`x_unfollow`	Unfollow an X/Twitter user.
`x_post_tweet`	Post a new tweet (max 280 characters).
`x_like`	Like a tweet by its URL.
`x_retweet`	Retweet a tweet by its URL.

📖 Tool Reference

x_login

Parameters:

cookie (required): Your auth_token cookie value from X.com

Example:

"Login to X with cookie abc123xyz..."

x_get_profile

Get detailed profile information for any X user.

Parameters:

username (required): Twitter username without @

Returns: Name, username, bio, location, website, join date, follower count, following count

x_get_followers

Scrape a user's followers list.

Parameters:

username (required): Twitter username without @
limit (optional): Maximum followers to scrape (default: 100)

Returns: Array of followers with username, name, and bio

x_get_following

Scrape accounts a user follows.

Parameters:

username (required): Twitter username without @
limit (optional): Maximum to scrape (default: 100)

Returns: Array with username, name, and whether they follow back

x_get_non_followers

Find accounts you follow that don't follow back.

Parameters:

username (required): Your Twitter username without @

Returns: Total following count, list of non-followers, non-follower count

x_get_tweets

Scrape recent tweets from a user's profile.

Parameters:

username (required): Twitter username without @
limit (optional): Maximum tweets (default: 50)

Returns: Array of tweets with text, timestamp, likes, retweets, replies, and URL

x_search_tweets

Search for tweets matching a query.

Parameters:

query (required): Search query (supports operators like from:, to:, #hashtag)
limit (optional): Maximum results (default: 50)

Returns: Array of tweets with text, author, timestamp, and URL