Spectre is an X/Twitter automation MCP server that exposes ~100 cookie-authenticated tools — driven by a multi-account pool — for reading, searching, posting, and managing an account without a browser or API keys.
Account pool admin: list accounts and status, set the primary account, toggle auto-rotation on rate limits, remove an account, check pool health.
Search & discovery: search tweets (latest/top/media), search users, trending topics by category, similar posts.
Read tweets & users: fetch a tweet, replies, thread, retweeters, likers, edit history, community notes; user profiles, tweets, media, likes, highlights, mutual/verified followers, followers/following, muted and blocked lists.
Timelines: home feed, list timeline, community tweets, bookmark folder timeline, bookmarks.
Publish & engage: post/reply/quote tweets, upload media (image/video), delete tweets, like/unlike, retweet/unretweet, bookmark/unbookmark, follow/unfollow, mute/unmute, block/unblock.
Drafts & scheduling: full CRUD for drafts and scheduled tweets (create, list, edit, delete).
Lists: create/update/delete, add/remove members, fetch members and timelines, subscribe/unsubscribe, list memberships and ownerships.
Communities: get community info and tweets, join/leave.
Direct messages: send DMs, inbox, read a conversation, search DMs (all / groups / people), view muted conversations, DM block/unblock.
Bookmark folders: create/rename/delete folders, add/remove tweets, list folder contents, search bookmarks, clear all bookmarks.
Profile & settings: read account settings, update bio/name/website/location, change or delete avatar and banner.
Highlights & pins: create/delete/get highlights, pin/unpin tweets and replies, remove a follower.
Topics: follow/unfollow a topic.
Caveat: despite the README insisting X IDs be passed as strings, the schema types most IDs (tweet_id, user_id, list_id, community_id, reply_to, quote_tweet) as integer — an ID-rounding risk the README itself warns about, so agents should double-check large IDs.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Spectre search tweets about artificial intelligence"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Spectre is an MCP server that gives AI agents 104 tools for X/Twitter automation — from search and posting to DMs, lists, and communities. Under the hood, it talks directly to X's internal GraphQL and REST APIs. No browser to spin up, no Puppeteer to maintain, no DOM scraping that breaks on UI changes.
Spectre | XActions | twikit | |
Architecture | Direct GraphQL/REST | Puppeteer (headless browser) | Python API wrapper |
Speed | <1s per request | 3–10s (browser startup) | ~1s per request |
Memory | ~10 MB | ~200 MB+ (Chromium) | ~10 MB |
MCP Server | ✓ 104 tools | ~50 API tools | ✗ None |
Account Pool | ✓ Multi-account auto-rotation | ✗ Single auth_token | ✗ Single session |
Browser Required | ✗ Never | ✓ Always | ✗ Never |
DOM Breakage Risk | ✗ None | ~ breaks on UI changes | ✗ None |
Media Upload | ✓ Cookie-based (no API keys) | ~ requires API keys | ✗ |
Lists | ✓ Full CRUD + members + subscribe | ✗ | ✗ |
Drafts & Scheduled | ✓ Full CRUD | ~ Basic | ✗ |
Bookmark Folders | ✓ Full CRUD + timeline | ✗ | ✗ |
DM Search | ✓ All / groups / people | ✗ | ✗ |
Community Notes | ✓ Read + rate | ✗ | ✗ |
Highlights | ✓ Create, delete, get | ✗ | ✗ |
Notifications | ✓ Full timeline | ✗ | ✗ |
Language | Python | JavaScript | Python |
pipx install spectre-mcp # or: uv tool install spectre-mcpExtract cookies from your browser:
Open x.com and make sure you're logged in
Open DevTools (F12 or Ctrl+Shift+I)
Go to Storage → Cookies → select https://x.com
Find and copy these two values:
auth_token — long hex string (e.g. a1b2c3d4...)
ct0 — 160-character hex string
spectre add myaccount "auth_token=a1b2c3d4...; ct0=e5f6a7b8..."Tip:
ct0is exactly 160 hex characters. Double-check you copied the full value — partial cookies will fail silently.
Add to your MCP client config (~/.hermes/config.yaml, claude_desktop_config.json, .cursor/mcp.json, or equivalent):
{
"mcpServers": {
"spectre": {
"command": "uvx",
"args": ["spectre-mcp"]
}
}
}For client-specific setup (Hermes skill, Claude, Cursor, Python), see Integrations.
No
uv? Install it:curl -LsSf https://astral.sh/uv/install.sh | shOr usepython3 -m spectre.serverto run from a local clone.
Every tool that takes an X ID (tweet_id, user_id, list_id, community_id, reply_to, quote_tweet) takes it as a string:
get_tweet("2111332908657148356")X IDs are 64-bit integers. Most MCP clients and model APIs parse JSON numbers as IEEE-754 doubles, which rounds anything above 2^53 — 2111332908657148356 silently becomes 2111332908657148416, and the tool reports a perfectly good tweet as "not found or deleted". Passing the ID as a string removes the round-trip entirely, so the server sees the exact ID the model meant. A full https://x.com/... URL works too, and a plain integer is still accepted for backwards compatibility.
All 104 Tools — every tool, grouped by feature
Integrations — Hermes, Claude, Cursor, Python
Safety — destructive tools, rate limits
Reference — X query operators, CLI, env vars, limitations
MIT
Add a user to an X/Twitter list.
Inputs: list_id (required), user_id (required). Returns: result
Add a bookmarked tweet to a folder.
Inputs: tweet_id (required), folder_id (required). Returns: result
Block a user on X/Twitter.
Inputs: user_id (required). Returns: result
Bookmark a tweet.
Inputs: tweet_id (required). Returns: result
⚠️ DESTRUCTIVE — Delete ALL bookmarks. Cannot be undone.
Inputs: no named parameters. Returns: result
Create a bookmark folder.
Inputs: name (required). Returns: result
Save a tweet draft (not published).
Inputs: text (required). Returns: result
Add tweets to your profile highlights section.
Inputs: tweet_ids (required). Returns: result
Create a new X/Twitter list.
Inputs: name (required), description. Returns: result
Delete a bookmark folder.
Inputs: folder_id (required). Returns: result
Delete a draft tweet.
Inputs: tweet_id (required). Returns: result
Remove a highlight from your profile.
Inputs: highlight_id (required). Returns: result
Delete an X/Twitter list.
Inputs: list_id (required). Returns: result
⚠️ DESTRUCTIVE — Remove the profile banner/header image.
WARNING: This immediately removes your banner image.
Returns: Confirmation JSON.
Inputs: no named parameters. Returns: result
Delete a scheduled tweet.
Inputs: tweet_id (required). Returns: result
Delete a tweet you posted.
Inputs: tweet_id (required). Returns: result
Block a user from sending you DMs.
Inputs: user_id (required). Returns: result
Unblock a user from DMs.
Inputs: user_id (required). Returns: result
Rename a bookmark folder.
Inputs: name (required), folder_id (required). Returns: result
Edit an existing draft tweet.
Inputs: text (required), draft_id (required). Returns: result
Edit an existing scheduled tweet.
Inputs: text (required), execute_at (required), scheduled_id (required). Returns: result
Follow a topic on X/Twitter.
Inputs: topic_id (required). Returns: result
Follow a user on X/Twitter.
Inputs: user_id (required). Returns: result
Get the authenticated account's settings (language, timezone, country, etc.).
Returns: JSON with account settings including language, country, timezone, protected status, etc.
Inputs: no named parameters. Returns: result
List all accounts you've blocked.
Inputs: limit. Returns: result
Get all bookmark folders.
Returns: JSON with list of bookmark folders.
Inputs: no named parameters. Returns: result
Get tweets inside a specific bookmark folder.
Inputs: folder_id (required), limit. Returns: result
Get the authenticated user's bookmarked tweets.
Inputs: limit. Returns: result
Get details about an X/Twitter community.
Inputs: community_id (required). Returns: result
Get community notes on a tweet.
Inputs: tweet_id (required). Returns: result
Get tweets from an X/Twitter community.
Inputs: community_id (required), limit. Returns: result
Get messages in a direct message conversation.
Inputs: conversation_id (required), limit. Returns: result
Get DM inbox — list recent direct message conversations.
Inputs: limit. Returns: result
Get muted DM conversations.
Inputs: limit. Returns: result
Get all draft tweets.
Returns: JSON with list of drafts.
Inputs: no named parameters. Returns: result
Get users who liked a tweet.
Inputs: tweet_id (required), limit. Returns: result
Get a user's followers.
Inputs: username (required), limit. Returns: result
Get mutual followers (followers you know).
Inputs: user_id (required), limit. Returns: result
Get who a user follows.
Inputs: username (required), limit. Returns: result
Get the authenticated user's home timeline feed.
Inputs: limit. Returns: result
Get members of an X/Twitter list.
Inputs: list_id (required), limit. Returns: result
Get lists a user is a member of.
Inputs: user_id (required), limit. Returns: result
Get lists owned by a user.
Inputs: user_id (required), limit. Returns: result
Get subscribers of a list.
Inputs: list_id (required), limit. Returns: result
Get tweets from an X/Twitter list.
Inputs: list_id (required), limit. Returns: result
List all accounts you've muted.
Inputs: limit. Returns: result
Get notifications timeline.
Inputs: limit. Returns: result
Get users who retweeted a tweet.
Inputs: tweet_id (required), limit. Returns: result
Get all scheduled tweets.
Returns: JSON with list of scheduled tweets.
Inputs: no named parameters. Returns: result
Get similar/related posts to a tweet.
Inputs: tweet_id (required), limit. Returns: result
Get the full conversation thread a tweet belongs to.
Inputs: tweet_id (required), limit. Returns: result
Get topic details by ID.
Inputs: topic_id (required). Returns: result
Get trending topics on X/Twitter.
Inputs: limit, category. Returns: result
Get a single tweet by its ID.
Inputs: tweet_id (required). Returns: result
Get edit history of a tweet.
Inputs: tweet_id (required). Returns: result
Get replies to a tweet.
Inputs: tweet_id (required), limit. Returns: result
Get a user's X/Twitter profile by @handle.
Inputs: username (required). Returns: result
Get a user's profile highlight tweets.
Inputs: user_id (required), limit. Returns: result
Get a user's liked tweets.
Inputs: user_id (required), limit. Returns: result
Get a user's media tweets (photos, videos, GIFs).
Inputs: username (required), limit. Returns: result
Get a user's recent tweets.
Inputs: username (required), limit. Returns: result
Get a user's tweets and replies.
Inputs: username (required), limit. Returns: result
Get Blue-verified followers of a user.
Inputs: user_id (required), limit. Returns: result
Join an X/Twitter community.
Inputs: community_id (required). Returns: result
Leave an X/Twitter community.
Inputs: community_id (required). Returns: result
Like a tweet.
Inputs: tweet_id (required). Returns: result
List all accounts in the pool with their status.
Shows username, state (active/error/locked), and any error messages. Use this to check which accounts are available before operations.
Returns: JSON array of accounts with status details.
Inputs: no named parameters. Returns: result
Mute a user on X/Twitter.
Inputs: user_id (required). Returns: result
Pin a reply to a conversation.
Inputs: tweet_id (required). Returns: result
⚠️ DESTRUCTIVE — Pin a tweet to your profile (replaces any existing pinned tweet).
WARNING: If you already have a pinned tweet, it will be unpinned automatically. Only one tweet can be pinned at a time.
Inputs: tweet_id (required). Returns: result
Check account pool health — how many accounts are active, locked, or errored.
Returns: JSON with pool statistics and per-account status.
Inputs: no named parameters. Returns: result
Post a new tweet on X/Twitter.
Inputs: text (required), reply_to, media_ids, quote_tweet. Returns: result
Rate a community note as helpful or not helpful.
Inputs: rating (required), note_id (required). Returns: result
Remove an account from the pool.
Inputs: username (required). Returns: result
⚠️ DESTRUCTIVE — Remove a follower from your account.
Inputs: user_id (required). Returns: result
Remove a user from an X/Twitter list.
Inputs: list_id (required), user_id (required). Returns: result
Remove a tweet from a bookmark folder.
Inputs: tweet_id (required), folder_id (required). Returns: result
Retweet a tweet.
Inputs: tweet_id (required). Returns: result
Schedule a tweet for future posting.
Inputs: text (required), execute_at (required), reply_to. Returns: result
Search X/Twitter for tweets matching a query.
Inputs: query (required), mode, limit. Returns: result
Search bookmarks by text.
Inputs: query (required), limit. Returns: result
Search direct messages by text.
Inputs: query (required), limit. Returns: result
Search DMs in group conversations.
Inputs: query (required), limit. Returns: result
Search for people in DMs.
Inputs: query (required), limit. Returns: result
Search X/Twitter for users by name or keyword.
Inputs: query (required), limit. Returns: result
Send a direct message to a user.
Inputs: text (required), user_id (required). Returns: result
Set a specific account as the primary account for all operations.
The named account will be used first for reads and writes. If it gets rate-limited, the pool falls back to other active accounts.
Inputs: username (required). Returns: result
Enable or disable automatic account rotation on rate limits.
When enabled (default): if the current account hits a rate limit, Spectre automatically switches to the next available account. The agent sees a note that rotation happened.
When disabled: only the account set via set_active_account() is used. Rate limits are returned as errors instead of rotating silently. Use this when you're managing a specific account and don't want operations accidentally going through a different account.
Inputs: enabled (required). Returns: result
Subscribe to a list.
Inputs: list_id (required). Returns: result
Unblock a user on X/Twitter.
Inputs: user_id (required). Returns: result
Remove a bookmark.
Inputs: tweet_id (required). Returns: result
Unfollow a topic on X/Twitter.
Inputs: topic_id (required). Returns: result
Unfollow a user on X/Twitter.
Inputs: user_id (required). Returns: result
Unlike a tweet.
Inputs: tweet_id (required). Returns: result
Unmute a user on X/Twitter.
Inputs: user_id (required). Returns: result
Unpin a reply from a conversation.
Inputs: tweet_id (required). Returns: result
Unpin a tweet from your profile.
Inputs: tweet_id (required). Returns: result
Undo a retweet.
Inputs: tweet_id (required). Returns: result
Unsubscribe from a list.
Inputs: list_id (required). Returns: result
Update an X/Twitter list's name/description.
Inputs: name (required), list_id (required), description. Returns: result
⚠️ DESTRUCTIVE — Update the authenticated account's profile info.
WARNING: This immediately changes your public profile on X. All fields are optional — only provide the ones you want to change. Empty strings are ignored.
Inputs: bio, name, website, location. Returns: result
⚠️ DESTRUCTIVE — Change the profile banner/header image.
WARNING: This immediately replaces your current banner. Recommended size: 1500x500px. Supported: jpg, png, gif (max 5MB).
Inputs: file_path (required). Returns: result
⚠️ DESTRUCTIVE — Change the profile avatar image.
WARNING: This immediately replaces your current profile picture. Supported: jpg, png, gif (max 2MB recommended).
Inputs: file_path (required). Returns: result
Upload an image or video for use in tweets.
Uses cookie-based auth. No API keys needed. Supports: jpg, png, gif, webp, mp4, mov (up to 5MB images, 512MB video).
Inputs: file_path (required). Returns: result
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 104 tools
Most tools have distinct resource-action targets, but several pairs overlap meaningfully (list_accounts vs pool_status, get_user_tweets vs get_user_tweets_and_replies, get_muted_accounts vs get_dm_muted). The high number of choices increases misselection risk, though the descriptions usually clarify boundaries.
The server consistently uses snake_case verb_noun names like get_tweet, post_tweet, create_list, and unlike_tweet. Minor deviations exist—remove vs delete, pool_status instead of get_pool_status, and phrase-like names such as get_followers_you_know—but the overall pattern remains predictable.
104 tools is an extreme count for an MCP server and creates a heavy selection burden for agents. Even for a broad X/Twitter domain, many niche actions could be consolidated through parameters or grouped resources, so the surface is clearly oversized.
The surface covers nearly the full X/Twitter lifecycle: reading, posting, deleting tweets, engagement, DMs, lists, bookmarks, communities, profiles, scheduling, and drafts. Minor gaps exist—such as no way to add accounts to the pool or fetch the current authenticated profile directly—but these are workable and do not undermine core workflows.
X (formerly Twitter) posts, profiles, and search for AI agents. Free key, self-minted, no signup.
Twitter (X) data for agents: profiles, tweets, search, followers, lists. $0.0006 per call.
Read public Twitter/X data: tweets, profiles, followers, search. No X developer account.
Hosted MCP server from TwitterAPI.io that gives AI agents read-only access to Twitter/X data. 12 tools: tweet search with X operators, user profiles, a user's latest tweets, followers and followings, replies, quotes, retweeters, mentions and trends. Connect at https://mcp.twitterapi.io/mcp with a TwitterAPI.io API key or account sign-in; usage is paid per result returned.
