XActions Documentation

Complete documentation for XActions v3.5.0, the X/Twitter automation toolkit.

Quick Links

Guide	Description
Getting Started	Install, authenticate, run your first command
Ask XActions	Ask anything at xactions.app/ask: sourced answers from the docs and the repo over free LLM lanes
CLI Reference	All 56 `xactions` commands and the subcommands under them
API Reference	REST API across 40 route modules
Hosted MCP server	Point any agent at `https://xactions.app/mcp` and read public X with no API key, no account, no install
MCP Server	Set up the local MCP server for Claude, Cursor, Windsurf, GPT: 153 tools, write access, your own session
Browser Scripts	95 console scripts, generated from the scripts themselves
Search Sweep	Delete, like, repost, or reply to every result of an X search
Engage a profile	Like, repost and reply across a whole profile, from the console or the CLI
Automation Framework	Browser automation system
Scraping Infrastructure	Proxy rotation, stealth browser, pagination, datasets
Streams	Tweet, follower and mention streams with persistent polling
Notifications	Email, Slack, Discord, Telegram and webhook delivery
Dashboard	Web dashboard guide
Video Downloader	Download X/Twitter videos
Media Archive	Bulk-download photos, videos, GIFs, avatars and banners with filename templates and an incremental archive
Configuration	Personas, niches, environment
Database Schema	PostgreSQL models (Prisma)
Browser Extension	Chrome and Edge extension (Manifest V3)
Deployment	Deploy to Railway, Fly.io, Docker, and more
Architecture	System design and project structure
Analytics & Monitoring	Sentiment, reputation, follower tracking
AI Features	AI tweet writer, voice analysis, Grok
Skills Reference	50 agent skills for AI assistants
Plugins	Extend scrapers, MCP tools and automation with `xactions-plugin-*` packages
Workflows	Declarative JSON pipelines with triggers, conditions and chained actions
Spaces Agent	An AI voice agent that joins, listens and speaks in live Spaces
DOM Selectors	X/Twitter DOM selector reference
Troubleshooting	Common issues and fixes
x402 payments	Pay per call in USDC on Solana or Base: no API key, no account, and how identity works over x402 and MCP
Portability	Import your X data archive, export and migrate to Bluesky or Mastodon
Audits	Competitive gap analysis and repo health, with the open backlog
Live site audit	Every feature on xactions.app exercised in a real browser, with the root cause of each failure

Building an agent on top of XActions? Start at AGENTS.md: it answers whether to shell out to the CLI or load the MCP server before anything else, and that choice is the one that costs a session when it is wrong.

Interfaces

XActions provides 5 interfaces to the same underlying toolkit:

┌─────────────────────────────────────────────────────┐
│                   XActions v3.5.0                   │
├──────────┬──────────┬───────┬──────────┬────────────┤
│  CLI     │  MCP     │  API  │ Dashboard│  Browser   │
│ xactions │ server   │ REST  │   Web UI │  Scripts   │
│  ↕       │   ↕      │  ↕    │    ↕     │     ↕      │
│ Terminal │ AI Agent │ HTTP  │ Browser  │  DevTools  │
└──────────┴──────────┴───────┴──────────┴────────────┘

CLI: xactions <command> from your terminal. 56 commands, grouped by task, with 85 subcommands under them.
MCP Server: 153 tools for Claude, Cursor, Windsurf, GPT. stdio or Streamable HTTP, filterable by tool group.
REST API: 40 route modules served at localhost:3001/api.
Web Dashboard: full-featured UI at localhost:3001.
Browser Scripts: 95 scripts you paste into DevTools on x.com, no install at all.

Supported Platforms

Platform	Scraping	Posting	Following	Export
X/Twitter	✅	✅	✅	✅
Bluesky	✅	✅	✅	✅
Mastodon	✅	✅	✅	✅
Threads	✅	no	no	✅

Requirements

Node.js 20 or newer. CI runs the full Vitest suite on Node 20, 22 and 24.

Version

Current version: v3.5.0 (August 2026)

by nichxbt, github.com/nirholas/xactions