xactions-mcp-server

XActions MCP Server

The definitive free Twitter/X MCP server. 68+ tools for AI agents.

Quick Start

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

Setup

1. Get auth_token

DevTools (F12) -> Application -> Cookies -> x.com -> copy auth_token value

2. Configure your client

Claude Desktop:

xactions mcp-config --client claude --write

Cursor:

xactions mcp-config --client cursor --write

Windsurf / VS Code:

xactions mcp-config --client windsurf --write
xactions mcp-config --client vscode --write

3. Restart your client

Available Tools (68+)

Scraping

x_get_profile, x_get_followers, x_get_following, x_get_non_followers, x_get_tweets, x_search_tweets, x_get_thread, x_download_video

Actions

x_follow, x_unfollow, x_unfollow_non_followers, x_post_tweet, x_like, x_retweet, x_delete_tweet, x_reply, x_bookmark, x_get_bookmarks, x_clear_bookmarks, x_auto_like

Analysis

x_detect_unfollowers, x_best_time_to_post, x_analyze_sentiment, x_monitor_reputation, x_reputation_report, x_competitor_analysis, x_brand_monitor

Profile & Settings

x_update_profile, x_get_settings, x_toggle_protected, x_get_blocked, x_check_premium

Content

x_post_thread, x_create_poll, x_schedule_post, x_publish_article

Discovery

x_get_trends, x_get_explore

Messaging

x_send_dm, x_get_conversations, x_export_dms

AI (requires OPENROUTER_API_KEY)

x_analyze_voice, x_generate_tweet, x_rewrite_tweet, x_summarize_thread

Advanced

• Streaming: x_stream_start/stop/list/pause/resume/status/history
• Workflows: x_workflow_create/run/list/actions
• Social Graph: x_graph_build/analyze/recommendations/list
• Portability: x_export_account/migrate_account/diff_exports

Example Prompts

"Scrape @nichxbt's profile and last 50 tweets. What topics do they post about most?"

"Find my non-followers and unfollow them"

"Search for tweets about 'AI agents' and analyze the sentiment"

"Post a thread about the top 3 AI trends in 2026"

"Monitor brand mentions of 'XActions' for the last week"

Environment Variables

Variable	Required	Purpose
XACTIONS_SESSION_COOKIE	Yes	X auth_token for authentication
OPENROUTER_API_KEY	No	Enables AI tools (voice analysis, tweet generation)

Full Documentation

See docs/mcp-setup.md for complete setup guide with troubleshooting.