🔌 MCP Server Documentation

New

Hosted. One URL. No API key.

Give any AI agent live access to public X/Twitter without an account, an API bill, or anything installed on a server. The endpoint runs at the Cloudflare edge and reads the same public data x.com serves a logged-out browser. Four of the six tools are free; two cost a fraction of a cent per call, settled in USDC over x402 with no signup.

https://xactions.app/mcp

Claude Code

claude mcp add --transport http xactions https://xactions.app/mcp

Claude Desktop, Cursor, VS Code, Windsurf

{
  "mcpServers": {
    "xactions": {
      "type": "http",
      "url": "https://xactions.app/mcp"
    }
  }
}

What your agent can do with it

x_post free

One post in full: long-form text, every public metric, media URLs, entities

x_thread free

The whole conversation, up to the root and down through the author's replies

x_video free

Every downloadable MP4 for a post, best quality first, with a download link

xactions_docs free

Search every XActions guide, skill and browser script while it writes code

x_profile

Bio, follower and following counts, links, join date, verification, pinned post

x_posts

Recent posts for an account, newest first, with metrics and media

Read-only by design: nothing in the hosted server can post, follow, like or delete. It also publishes ~700 documentation resources and five prompt templates. Priced tools answer an unpaid call with x402 terms instead of data, so an agent can pay and retry without ever creating an account. For write access, run the local server with your own session.

Or use it as a plain SDK

npx xactions-edge profile nasa
import { createClient } from 'xactions-edge';

const x = createClient();
const nasa = await x.profile('nasa');
const mp4  = await x.videoUrl('https://x.com/SpaceX/status/2092648130856571283');

Zero dependencies. Node, browsers, Cloudflare Workers, Deno and Bun.

Full guide: every client, every tool, and how it works →

🤖 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