trackmcp
Back to directory

OmniX is the fast, affordable X (Twitter) API — one key for full read & write access (tweets, users, DMs, media, articles), no official X developer account needed. Start free.

0 stars TypeScriptOthers Updated Jun 15, 2026

Documentation

OmniX MCP — Free X (Twitter) API for Claude, Cursor & any MCP client

npm version
License: MIT
Model Context Protocol

The official **OmniX** MCP server — give Claude, Cursor, and any

Model Context Protocol client **direct access to the

X (Twitter) API. Search tweets, look up users, read followers and replies, post

tweets, send DMs, follow users, and publish articles** — all from your AI assistant.

Unlike read-only Twitter MCP servers, OmniX MCP can act: post, reply, like, retweet,

bookmark, follow, send DMs, and publish long-form articles — not just read. 55 tools in all.

> ⚡ Start freeget a free API key and free trial credits.

> No X developer account, no OAuth app, no approval wait. Flat $0.001 per call after your free credits.

→ **Get your free API key · Docs · Pricing**


Why OmniX MCP?

  • 🆓 Free to start — a free API key and free trial credits, no credit card to try it.
  • ✍️ **Read *and* write** — post tweets, send DMs, follow, like, retweet, publish articles.
  • 🧩 Works everywhere — Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP client.
  • 🚀 No X developer account needed — use your normal X login (`auth_token` cookie).
  • 💸 Simple pricing — flat $0.001 per successful call; account tools are free.
  • 🛠️ 55 tools across tweets, users, articles, lists, media, and direct messages.

Install

Add it to your MCP client config (Claude Desktop, Cursor, Windsurf, …):

json
{
  "mcpServers": {
    "omnix": {
      "command": "npx",
      "args": ["-y", "omnix-mcp@latest"],
      "env": {
        "OMNIX_KEY": "omnix_live_...",
        "X_AUTH_TOKEN": "your_x_auth_token"
      }
    }
  }
}

Or with the Claude Code CLI:

bash
claude mcp add omnix \
  -e OMNIX_KEY=omnix_live_... \
  -e X_AUTH_TOKEN=your_x_auth_token \
  -- npx -y omnix-mcp@latest

Get your free `OMNIX_KEY` from the OmniX dashboard.


Configuration (env)

VarRequiredWhat it does
`OMNIX_KEY`Your OmniX API key (`omnix_live_...`). Get one free. Sent as `Authorization: Bearer`.
`X_AUTH_TOKEN`✅ for X toolsThe X account `auth_token` cookie the actions run as. Sent as the `x-account-token` header. The two account tools work without it.
`X_PROXY`optionalOutbound proxy for the X traffic (`http://` or `https://`). SOCKS not supported.
`X_ENCRYPTION_CODE`optionalYour XChat PIN for encrypted DM tools. When set, it's injected so the PIN never enters the model's context.

Your credentials are never exposed to the model as tool arguments — the server injects

them as headers only on the calls that need them.

Getting your `auth_token`

It's the cookie `x.com` sets after you log in — copy it with the free Cookie-Editor

extension, or from dev tools: Application → Cookies → `https://x.com` → `auth_token`.

Full guide: docs.omnixapi.com/authentication.


What you can ask your assistant

> "Find Elon Musk's latest tweets"

> "Search X for posts about OpenAI from the last week"

> "Who are @vercel's verified followers?"

> "Post 'shipping 🚀' to my X account"

> "Send a DM to @jack saying hi"

> "Publish this markdown as an X Article"

Tools (55)

GroupTools
Tweets (13)`advanced_search_tweets`, `get_tweet_detail`, `get_tweet_thread`, `get_tweet_replies`, `get_tweet_retweeters`, `create_tweet`, `delete_tweet`, `favorite_tweet`, `unlike_tweet`, `retweet_tweet`, `unretweet_tweet`, `bookmark_tweet`, `unbookmark_tweet`
Users (24)`get_user_info`, `get_user_info_by_id`, `get_user_about`, `search_users`, `get_user_affiliates`, `check_follow_relationship`, `get_user_tweets`, `get_user_tweets_and_replies`, `get_user_articles_tweets`, `get_user_media`, `get_user_mentions`, `get_user_followers`, `get_verified_followers`, `get_user_following`, `get_followers_you_know`, `get_user_likes`, `get_home_timeline`, `list_bookmarks`, `search_bookmarks`, `update_profile`, `update_avatar`, `update_banner`, `follow_user`, `unfollow_user`
Articles (7)`get_article`, `create_article`, `update_article`, `list_articles`, `publish_article`, `unpublish_article`, `delete_article`
Lists (1)`get_list_members`
Media (1)`upload_media`
Direct Messages (7)`list_direct_messages`, `get_dm_conversation`, `send_direct_message`, `send_dm_media`, `delete_dm`, `react_dm`, `edit_dm`
Account (2)`get_account_info`, `get_payment_history`

Read tools are marked `readOnlyHint`; `delete_tweet`, `unpublish_article`, `delete_article`

and `delete_dm` are marked `destructiveHint` so clients can confirm before running them.


Pricing

  • Free API key + free trial credits to start — sign up.
  • Flat $0.001 per successful call (no per-endpoint pricing).
  • The two account tools (`get_account_info`, `get_payment_history`) are free.

See omnixapi.com/pricing.


FAQ

Is there a free X (Twitter) API?

Yes. OmniX gives you a free API key and free trial credits so you can start without a

credit card. After the free credits, it's a flat $0.001 per successful call.

How do I use the X / Twitter API inside Claude or Cursor?

Install this MCP server (see Install) with your free `OMNIX_KEY`. Your assistant

can then search tweets, read users, post, and send DMs through natural language.

Do I need an X developer account or API keys from X?

No. You don't need X's official developer program or an OAuth app. You authenticate with your

normal X login cookie (`auth_token`) plus a free OmniX key.

Can it post tweets and send DMs, or is it read-only?

It can act — post tweets, reply, like, retweet, bookmark, follow/unfollow, send and react

to DMs, and publish X Articles — as well as read.

Which MCP clients are supported?

Any Model Context Protocol client — Claude Desktop, Claude Code, Cursor, Windsurf, and more.

Is this the official X API?

No. OmniX is an independent third-party X (Twitter) API for developers and researchers. It is

not affiliated with, endorsed by, or sponsored by X Corp.


Develop

bash
npm install
npm run build      # tsc → dist/
npm start          # run the built server over stdio

Tools live in `src/tools/*.ts`, one declarative `ToolDef` per endpoint; `src/register.ts`

turns each into a `registerTool` call and `src/client.ts` forwards it to the API.

License

MIT

Frequently asked questions

What is OmniX-mcp?

OmniX-mcp is OmniX is the fast, affordable X (Twitter) API — one key for full read & write access (tweets, users, DMs, media, articles), no official X developer account needed. Start free.

How do I install OmniX-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is OmniX-mcp open source?

Yes — it is hosted on GitHub at https://github.com/OmniXapi/OmniX-mcp.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP