advanced_search_tweets
Search tweets with X advanced operators (from:, to:, since:, until:, filter:, exact phrases). Returns a page of tweets plus a next_cursor.
LABSCO SUMMARY
An X client that can act, not only read.
Most X servers stop at search. This one covers the write side too — posting, following, publishing Articles — which is the difference between an agent that reports on a timeline and one that runs an account.
What it is
An MCP server for the X (Twitter) API through OmniX. Unlike read-only Twitter servers it also writes — post, reply, quote, delete, like, retweet, bookmark, follow, edit your profile and publish Articles. It runs from npm with npx and calls are metered per successful call.
What you get
- Tweets searched with X's advanced operators — from:, to:, since:, until:, filter:, exact phrases
- A single tweet with its author, media, entities and engagement counts
- A tweet's ordered self-thread, its replies, and the accounts that reposted it
- A user's profile, account metadata, tweets, replies, media, Articles and mentions
- Followers, verified followers, following, and the followers you have in common
- The follow, DM, block and mute relationship between two accounts
- Your home timeline, your likes, and your bookmarks — listed and searched
- Tweets posted, replied, quoted and deleted; liked, unliked, retweeted, bookmarked
- Users followed and unfollowed
- Profile fields, avatar and banner updated
- Long-form Articles fetched, created from markdown with an optional cover, and partially updated
Requirements
Two environment variables: OMNIX_KEY from the OmniX dashboard, and X_AUTH_TOKEN, which is your normal X login cookie rather than a developer app credential. The write tools act as your own account.
Setup effort
One command plus a key — claude mcp add omnix -e OMNIX_KEY=<YOUR_OMNIX_KEY> -e X_AUTH_TOKEN=<YOUR_AUTH_TOKEN> -- npx -y omnix-mcp@latest
USE CASES
01
Working out what people are actually saying about a launch
Search with X's own operators, then open the threads and reply chains underneath the posts that matter.
02
Publishing something you drafted in the conversation
Post it as your account, as a standalone tweet, a reply, or a quote, with media attached.
03
Deciding whether an account is worth engaging with
Read the profile, the account metadata — when it was created, where it is based, how the username has changed — and who verifies it by following.
04
Finding a warm introduction
See which of a target's followers you already follow, and check the follow relationship in both directions before you reach out.
05
Turning a long draft into an X Article
Create the Article from markdown in one call, then edit it in place afterwards.
06
Getting back to the things you saved
List your bookmarks and search inside them by text or author instead of scrolling.
55 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
bookmark_tweet
Add a tweet to your bookmarks. Idempotent.
check_follow_relationship
Check the follow/DM/block/mute relationship between two X users (whether source follows target and vice-versa).
create_article
Create a long-form X Article in one call: draft → set title + markdown content → optional cover → optional publish. Publishing requires X Premium.
create_tweet
Post a tweet as your X account. Optionally reply, quote, or attach media (pre-uploaded ids, URLs, or inline base64).
delete_article
Permanently delete an article entity (draft or published).
delete_dm
Delete one or more messages by seq_id (from get_dm_conversation). delete_for_all removes for everyone (your own messages only); otherwise removes from your view. Requires encryption_code.
delete_tweet
Permanently delete one of your own tweets. Idempotent; returns 403 if the tweet isn't yours.
edit_dm
Edit the text of a message you sent, identified by its seq_id (from get_dm_conversation). Requires encryption_code.
favorite_tweet
Like (favorite) a tweet as your X account. Idempotent.
follow_user
Follow a user as your X account. Provide user_id or username. Idempotent.
get_account_info
Get your OmniX account details: email, credit balance, credits used and total request count.
get_article
Fetch a full X Article's content. Provide id (the wrapper tweet ID, public) OR article_id (the entity rest_id, owner-only).
get_dm_conversation
Read and decrypt one XChat conversation's message history, newest first. Requires encryption_code (or X_ENCRYPTION_CODE env). Pass cursor (a seq_id) to page to older messages.
get_followers_you_know
Get a target user's followers that YOUR account also follows (mutual context). Provide user_id or user_name.
get_home_timeline
Fetch your authenticated account's home timeline feed.
get_list_members
List the members of a public X List, with cursor pagination.
get_payment_history
Get your OmniX payment / top-up history, newest first.
get_tweet_detail
Fetch a single tweet with its full author, media, entities and engagement counts.
get_tweet_replies
Fetch the replies to a tweet (the conversation below it), with cursor pagination.
get_tweet_retweeters
List the users who reposted (retweeted) a tweet, with cursor pagination.
get_tweet_thread
Fetch the ordered self-thread for a tweet — the root author's reply chain, in order, excluding side replies.
get_user_about
Get account metadata: creation date, account-based-in country, sign-up platform, verification and username-change history.
get_user_affiliates
Get the affiliated accounts of a verified X organization.
get_user_articles_tweets
Fetch a user's published X Articles, as their wrapper tweets. Provide userName or userId.
get_user_followers
Get a user's followers, with cursor pagination. Provide userName or userId.
get_user_following
Get the accounts a user follows, with cursor pagination. Provide userName or userId.
get_user_info
Get an X user's profile: bio, counts, verified status, canDm and more, by screen name.
get_user_info_by_id
Get an X user's profile by numeric user ID.
get_user_likes
Fetch the tweets your authenticated account has liked.
get_user_media
Fetch tweets containing images and videos from a user. Provide userName or userId.
get_user_mentions
Fetch recent tweets that mention a user, authored by other accounts.
get_user_tweets
Fetch the tweets posted by a user (excludes replies). Provide userName or userId.
get_user_tweets_and_replies
Fetch the tweets and replies posted by a user.
get_verified_followers
Get a user's verified (blue check) followers. Provide userName or userId.
list_articles
Paginated list of your own X Articles (drafts by default, or published).
list_bookmarks
List your authenticated account's bookmarked tweets, newest first.
list_direct_messages
List your DM conversations (inbox), newest first. Supply encryption_code to include a decrypted preview of each conversation's latest message; without it you still get metadata and participants.
publish_article
Publish an existing draft article to your timeline. Requires X Premium (403 otherwise).
react_dm
Add or remove an emoji reaction on a message, identified by its seq_id (from get_dm_conversation). Requires encryption_code.
retweet_tweet
Retweet (repost) a tweet as your X account. Idempotent.
search_bookmarks
Search inside your bookmarks by text or author. Pass next_cursor to keep scanning further pages.
search_users
Search for X users by keyword, username or topic.
send_direct_message
Send a DM. Target an existing conversation_id, or a user_id to start/reuse a 1-to-1. Pass encryption_code with a conversation_id to send end-to-end encrypted (deletable for everyone); otherwise the reliable legacy path is used.
send_dm_media
Send an end-to-end encrypted media attachment (image/gif/video/file) into an existing XChat conversation. Requires encryption_code (or X_ENCRYPTION_CODE env).
unbookmark_tweet
Remove a tweet from your bookmarks. Idempotent.
unfollow_user
Unfollow a user as your X account. Provide user_id or username. Idempotent.
unlike_tweet
Remove your like from a tweet. Idempotent.
unpublish_article
Move a published article back to draft and remove its wrapper tweet.
unretweet_tweet
Remove your retweet of a tweet. Idempotent.
update_article
Partial-update an article — only the fields you pass change. Published articles are unpublished, edited, then republished automatically.
update_avatar
Update your profile picture. Provide image_url or image_base64.
update_banner
Update your profile banner. Provide image_url or image_base64.
update_profile
Update one or more profile fields (name, bio, location, URL, link color, birthdate). Only the fields you pass change.
upload_media
Upload an image, GIF or video to X and get a media_id you can attach to create_tweet. Provide either a URL or base64 bytes.
BEFORE YOU INSTALL
What to know first
Tools you get
55 tools when we connected. Without X_AUTH_TOKEN only get_account_info and get_payment_history work. The seven encrypted DM tools also need X_ENCRYPTION_CODE, your XChat PIN.
Requires
- npx on PATH
- OMNIX_KEY in your environment
- X_AUTH_TOKEN in your environment
Where it runs
All 4 documented clients run the server on your machine.
CONTEXT COST
Moderate Standing cost
Rated by the size of the 55 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
Claude Code
TERMINAL
claude mcp add omnix -e OMNIX_KEY=<YOUR_OMNIX_KEY> -e X_AUTH_TOKEN=<YOUR_AUTH_TOKEN> -- npx -y omnix-mcp@latestMCP Clients
Claude Desktop, Cursor, Windsurf
JSON
{
"mcpServers": {
"omnix": {
"command": "npx",
"args": [
"-y",
"omnix-mcp@latest"
],
"env": {
"OMNIX_KEY": "<YOUR_OMNIX_KEY>",
"X_AUTH_TOKEN": "<YOUR_AUTH_TOKEN>"
}
}
}
}
