What can you do with this server?

Read-only X/Twitter API access for agents/apps via XFlux, focused on public data, monitors, and Smart Money—not posting or DMs. * Look up public X/Twitter profiles by username, including bio, follower counts, and verified status. * Search recent public tweets using X search operators, cashtags/hashtags, with configurable limits. * Fetch a user's recent timeline or a single tweet by numeric ID. * List your XFlux monitors and retrieve recent alert hits (read-only; create/edit monitors via Dashboard). * Discover ranked Smart Money/KOL accounts by niche and time window, excluding already-tracked handles. * Get a Smart Money profile with recent extracted market/prediction claims. * List recent Smart Money claims across accounts for macro, trading, crypto, and geopolitics feeds.

xflux

by yxs1640-png

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

XFlux

Read-only X/Twitter API for agents and apps: profiles, search, timelines, account monitors with signed webhooks, and Smart Money. Not for posting.

Site: xfluxapi.com · MCP: xfluxapi.com/mcp · Agents: llms.txt

Free tier: 1,000 calls/month, 1 monitor, no credit card. Paid plans add signed HTTP webhooks and higher quotas.

What it does

Read API — public profiles, timelines, single tweets, and search. Bearer key, JSON.
Monitors — watch @handles on a schedule. New tweets are delivered with a signed webhook on paid plans. Create monitors in the Dashboard, not by posting to the API.
Smart Money — ranked KOL accounts and recent calls (read-only).
MCP server — the same read API inside Claude Desktop, Cursor, and other MCP clients.

This service does not post tweets, send DMs, or require official X API approval.

Related MCP server: Spectre

REST API

Base URL: https://www.xfluxapi.com/api/v1

curl -H "Authorization: Bearer xflux_YOUR_KEY" \
  https://www.xfluxapi.com/api/v1/users/x

Get a key at Dashboard → API Keys.

Method	Path	Description
GET	`/api/v1/users/:username`	Profile
GET	`/api/v1/users/:username/tweets`	Timeline
GET	`/api/v1/tweets/:id`	One tweet
GET	`/api/v1/search?q=`	Search tweets
GET	`/api/v1/monitors`	Your monitors (read-only)
GET	`/api/v1/monitors/:id/hits`	Hits for one monitor (read-only)

Docs: https://www.xfluxapi.com/docs

MCP

Registry name io.github.yxs1640-png/xflux. npm package @xflux/xflux-mcp-server.

export XFLUX_API_KEY=xflux_your_key_here
npx -y @xflux/xflux-mcp-server

{
  "mcpServers": {
    "xflux": {
      "command": "npx",
      "args": ["-y", "@xflux/xflux-mcp-server"],
      "env": {
        "XFLUX_API_KEY": "xflux_your_key_here"
      }
    }
  }
}

Tool	Description
`xflux_get_user`	Profile by @username
`xflux_search_tweets`	Search recent tweets
`xflux_get_user_tweets`	User timeline
`xflux_get_tweet`	One tweet by ID
`xflux_list_monitors`	List monitors (read-only)
`xflux_get_monitor_hits`	Hits for one monitor
`xflux_smart_money_list`	Ranked Smart Money accounts
`xflux_smart_money_profile`	One Smart Money profile
`xflux_smart_money_claims`	Recent Smart Money calls

Copy-paste prompts (after MCP is connected)

Using XFlux, search tweets with q="$SOL" OR "Solana" lang:en -is:retweet from the last day. List accounts with clear price calls and >10k followers.

Using XFlux, pull @HyperliquidX profile and latest tweets, then summarize what the account is pushing this week.

Using XFlux Smart Money, list 4 CRYPTO accounts from the last 14 days and note one recent claim each.

Using XFlux, list my monitors and show the most recent hits. If I have none, suggest three @handles worth watching for trading alerts.

More: xfluxapi.com/mcp · mcp-server/README.md · Docs: https://www.xfluxapi.com/docs/integrations/mcp

Recipes

This repository

The public product runs from this repo: the website on Vercel, the API proxy and monitor worker on Fly.io, and the MCP package in mcp-server/. Deploy notes: docs/DEPLOYMENT.md.

License

MIT

Available Tools

9 tools

xflux_get_monitor_hitsA

List recent hits for one XFlux monitor (read-only). Use after xflux_list_monitors when the user wants alert history for a watched @account. Create/edit monitors in the Dashboard.

Inputs: monitor_id (required), limit.

xflux_get_tweetA

Fetch one public tweet/post by numeric status ID via XFlux. Use when the user pastes a tweet ID or needs a single post's text and engagement.

Inputs: id (required).

xflux_get_userA

X/Twitter profile lookup via XFlux. Use when the user asks for a public Twitter/X user profile, bio, follower counts, or verified status by @username. Read-only; not for posting.

Inputs: username (required).

xflux_get_user_tweetsA

Fetch a public X/Twitter user timeline via XFlux. Use when the user asks what someone posted lately, KOL latest tweets, or to summarize a handle's recent activity.

Inputs: username (required), limit.

xflux_list_monitorsA

List the user's XFlux account monitors (read-only): @targets, keywords, status, webhook flag, optional recent hits. Use when they ask what they are watching on XFlux. Creating monitors requires the Dashboard, not this tool.

Inputs: include_hits.

xflux_search_tweetsA

Search recent public tweets/posts on X/Twitter via XFlux (same operators as X search: from:, lang:, quotes). Use when the user wants tweet search, keyword monitoring research, cashtag/hashtag scans, or agent research over live X content. Prefer this over scraping.

Inputs: q (required), limit.

xflux_smart_money_claimsB

List recent Smart Money prediction/market calls across X accounts via XFlux. Use for a feed of forward-looking claims (macro, trading, crypto, geopolitics). Optional niche and exclude list.

Inputs: days, limit, niche, exclude.

xflux_smart_money_listA

Discover ranked Smart Money X/Twitter accounts (macro, trading, crypto, geopolitics) with recent extractable forward-looking market calls. Use when the user wants new KOL/analyst accounts to follow, alpha sources, or predictor discovery — prefer this over googling long analyst prompts. Pass exclude for handles already tracked.

Inputs: days, limit, niche, exclude.

xflux_smart_money_profileA

Get one XFlux Smart Money account profile plus recent extracted prediction calls (default last 14 days). Use when digging into a specific @analyst or KOL already found via xflux_smart_money_list.

Inputs: username (required), days, limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.9/5.0

Scored 2026-10-18 15:20 across 9 tools

Disambiguation4/5

The core X tools (get_user, search_tweets, get_user_tweets, get_tweet) are cleanly separated by resource and input shape, and descriptions reinforce this. The main soft spots are within the smart-money family: smart_money_list vs smart_money_claims both return account/claim feeds, and smart_money_profile overlaps conceptually with get_user plus claims, though the descriptions do enough to steer selection.

Naming Consistency4/5

All tools share the xflux_ prefix and most follow a verb_noun pattern (get_user, search_tweets, list_monitors, get_monitor_hits). The smart_money_list/profile/claims group deviates into noun_noun naming, which is a minor inconsistency but still predictable within its sub-family.

Tool Count5/5

Nine tools is well-scoped for a read-only X/Twitter research server, split sensibly between general tweet/user lookups, monitor inspection, and smart-money discovery. No tool appears redundant enough to drop.

Completeness4/5

The surface covers profile lookup, timeline, keyword search, single-tweet fetch, monitor listing/hits, and smart-money discovery, which is solid lifecycle coverage for a read-only research domain. Gaps are minor but real: no thread/reply traversal, no follower/following lists, and monitor creation is explicitly deferred to the Dashboard, leaving write operations out entirely.

Maintenance

ActivityActive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

TwittrAPIA
io.github.twittrapi
Read public Twitter/X data: tweets, profiles, followers, search. No X developer account.
Data Platforms Search Social Media
301
https://mcp.twittrapi.com/mcp
x-twitterA
io.veezee
X (formerly Twitter) posts, profiles, and search for AI agents. Free key, self-minted, no signup.
Social Media Search
2
https://mcp.veezee.io/x
twitr.shA
sh.twitr
X/Twitter reads, search, monitors and posting. Pay-per-call in USDC — no signup, no API keys.
Social Media Communication
1421
https://twitr.sh/api/mcp
xdataapi: X (Twitter) dataA
io.xdataapi
Read-only public X (Twitter) data: profiles, tweets, threads, followers, search. Pay per result.
Social Media Search
1411
https://api.xdataapi.io/mcp

Related MCP Servers

x-mcp-server
Social Media Web Scraping
afikrim
A
license
A
quality
C
maintenance
Enables reading public X (Twitter) content like profiles, tweets, and search results via a stealth browser, without official API costs.
Updated 4 months ago (2026-06-28 11:23 UTC)
11
MIT
Spectre
Social Media Web Scraping Search
pranrichh
A
license
C
quality
C
maintenance
Enables AI agents to search, read user profiles, timelines, media, follow threads, track trends, and manage accounts on X/Twitter via GraphQL, without browser automation or paid API keys.
Updated 25 days ago (2026-10-17 23:03 UTC)
100
11
MIT
Spectre
Social Media Communication
pranrichh
A
license
Not graded
quality
C
maintenance
Enables AI agents to fully automate X/Twitter interactions including searching, posting, engaging, and managing multiple accounts without paid API keys.
Updated 5 months ago (2026-06-22 12:05 UTC)
MIT
twitter-scraper
Social Media Web Scraping
Br0ski777
A
license
Not graded
quality
C
maintenance
Enables AI agents to scrape Twitter/X profiles, tweets, and search results without an API key, returning structured JSON with bios, stats, and engagement metrics via x402 micropayments.
Updated 2 months ago (2026-09-02 19:57 UTC)
1
MIT