XActions MCP Server Setup Guide

Use AI agents (Claude, Cursor, Windsurf, GPT) to automate X/Twitter — for free.

Getting Your auth_token

Most tools require an X/Twitter session cookie for authentication.

1. Go to x.com and log in
2. Open DevTools (F12 or Cmd+Option+I)
3. Go to Application → Cookies → https://x.com
4. Find the cookie named auth_token
5. Copy its value (a long hex string)

⚠️ Treat this like a password. Never share it publicly.

Claude Desktop

1. Open config file

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

2. Add XActions

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

3. Restart Claude Desktop

Quit and reopen Claude Desktop. You should see XActions tools listed.

Auto-generate config

npx xactions mcp-config

This detects your OS and outputs the correct config snippet. Use --write to write it directly.

Cursor

Add to your Cursor Settings → MCP Servers:

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

Or add to .cursor/mcp.json in your project root.

Windsurf

Add to your Windsurf Settings (~/.codeium/windsurf/mcp_config.json):

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

VS Code (GitHub Copilot)

Add to your VS Code user settings.json or .vscode/mcp.json:

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

Local Install (Alternative)

If you prefer a local install instead of npx:

npm install -g xactions

Then use xactions-mcp as the command instead of npx:

{
  "mcpServers": {
    "xactions": {
      "command": "xactions-mcp",
      "env": {
        "XACTIONS_SESSION_COOKIE": "your_auth_token_here"
      }
    }
  }
}

Environment Variables

Available Tools

Scraping (free, no API key needed)

Analysis

Actions (require auth_token)

AI Tools (require OPENROUTER_API_KEY)

Example Prompts

Try these with Claude, Cursor, or any MCP-compatible AI:

Research

"Get the profile and last 20 tweets from @elonmusk. Summarize the main topics."

Growth

"Find everyone I follow who doesn't follow me back. Show me the list sorted by how long ago I followed them."

Content

"Analyze @paulg's writing style, then generate 3 tweet ideas about startups in his voice."

Analytics

"Compare the follower counts, tweet frequency, and engagement of @openai, @anthropic, and @google."

Engagement

"Search for tweets about 'AI agents' from the last day. Like the top 5 most engaging ones."

Troubleshooting

npx xactions-mcp returns 404 / package not found

Make sure you have the latest version. If the xactions-mcp package hasn't been published yet, use either of these alternatives:

# Option 1: Use the -p flag to install from the xactions package
npx -p xactions xactions-mcp

# Option 2: Install globally first
npm install -g xactions
xactions-mcp

For MCP client configs, the -p flag approach:

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

"Tool not found" or no tools showing

1. Make sure the MCP server is configured correctly in your client
2. Restart your AI client after changing config
3. Check that Node.js 18+ is installed: node --version

"Could not follow/unfollow/post"

Auth is required for action tools. Make sure XACTIONS_SESSION_COOKIE is set in your MCP config env.

"OPENROUTER_API_KEY required"

AI tools (voice analysis, tweet generation, thread summarization) need an OpenRouter API key. Get a free one at openrouter.ai.

Server won't start

# Test manually
node node_modules/xactions/src/mcp/server.js

# Or if globally installed
xactions-mcp

Browser automation errors

XActions uses Puppeteer for browser automation. If you see Chrome/Chromium errors:

# Install Chromium dependencies (Linux)
npx puppeteer browsers install chrome

Links

• GitHub: github.com/nirholas/XActions
• npm: npmjs.com/package/xactions
• Dashboard: xactions.app
• Issues: github.com/nirholas/XActions/issues

Built by @nichxbt. MIT License.